@genesislcap/ai-assistant 15.27.0 → 15.27.1

package/dist/ai-assistant.api.json

@@ -3338,11 +3338,11 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getActiveAgent:member(1)",
-              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer. Both drivers implement it since GENC-1580; see {@link AiDriver.primeRestoredAgentState} for why the `?` stays for now.\n */\n",
+              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer — and since GENC-1580's breaking release the second case cannot arise, because the method is required.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getActiveAgent?(): "
+                  "text": "getActiveAgent(): "
                 },
                 {
                   "kind": "Reference",
@@ -3358,7 +3358,7 @@
                   "text": ";"
                 }
               ],
-              "isOptional": true,
+              "isOptional": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 3
@@ -3901,11 +3901,11 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#primeRestoredAgentState:member(1)",
-              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Implemented by every driver since GENC-1580 — each owns an `AgentSession` — so \"only multi-agent drivers implement it\" is no longer true. Still declared optional: this interface is exported and `@beta`, so requiring it would break any third party implementing it. The `?` comes off with the `installAgent` rename, which is the ticket's one breaking release.\n */\n",
+              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Required since GENC-1580's breaking release: every driver owns an `AgentSession`, so both shipped drivers implement it and a host no longer has to feature-detect before restoring.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "primeRestoredAgentState?(snapshots: "
+                  "text": "primeRestoredAgentState(snapshots: "
                 },
                 {
                   "kind": "Reference",
@@ -3929,7 +3929,7 @@
                   "text": ";"
                 }
               ],
-              "isOptional": true,
+              "isOptional": false,
               "returnTypeTokenRange": {
                 "startIndex": 4,
                 "endIndex": 5
@@ -4199,11 +4199,11 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#setFlowOwner:member(1)",
-              "docComment": "/**\n * Set the transient flow lock — used to restore state on driver reconstruction (agents-array changes, pop-in/pop-out), **not** to steer routing; that is {@link AiDriver.setPinnedAgent}'s job. Writes without firing lifecycle hooks, because the flow it names is already running.\n *\n * Added to the interface in GENC-1580, as for {@link AiDriver.setPinnedAgent}.\n */\n",
+              "docComment": "/**\n * Set the transient flow lock — used to restore state on driver reconstruction (agents-array changes, pop-in/pop-out), **not** to steer routing; that is {@link AiDriver.setPinnedAgent}'s job. Writes without firing lifecycle hooks, because the flow it names is already running.\n *\n * Added to the interface in GENC-1580, as for {@link AiDriver.setPinnedAgent}, and required since that ticket's breaking release.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "setFlowOwner?(name: "
+                  "text": "setFlowOwner(name: "
                 },
                 {
                   "kind": "Content",
@@ -4222,7 +4222,7 @@
                   "text": ";"
                 }
               ],
-              "isOptional": true,
+              "isOptional": false,
               "returnTypeTokenRange": {
                 "startIndex": 3,
                 "endIndex": 4
@@ -4244,11 +4244,11 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#setPinnedAgent:member(1)",
-              "docComment": "/**\n * Pin routing to an agent by name, or `null` for automatic routing. A pin is sticky: it survives a stateful flow completing, so the next turn starts fresh on the same agent.\n *\n * On a driver with nothing to route between this is recorded rather than acted on — the pick belongs to the session, which outlives the question of which driver holds it.\n *\n * Added to the interface in GENC-1580 — it was previously reached by narrowing to `OrchestratingDriver` with `instanceof`. Optional, so adding it breaks no implementor.\n */\n",
+              "docComment": "/**\n * Pin routing to an agent by name, or `null` for automatic routing. A pin is sticky: it survives a stateful flow completing, so the next turn starts fresh on the same agent.\n *\n * On a driver with nothing to route between this is recorded rather than acted on — the pick belongs to the session, which outlives the question of which driver holds it.\n *\n * Added to the interface in GENC-1580 — it was previously reached by narrowing to `OrchestratingDriver` with `instanceof`. Required since that ticket's breaking release.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "setPinnedAgent?(name: "
+                  "text": "setPinnedAgent(name: "
                 },
                 {
                   "kind": "Content",
@@ -4267,7 +4267,7 @@
                   "text": ";"
                 }
               ],
-              "isOptional": true,
+              "isOptional": false,
               "returnTypeTokenRange": {
                 "startIndex": 3,
                 "endIndex": 4
@@ -5318,7 +5318,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#activateAgent:member(1)",
-              "docComment": "/**\n * Make `config` the active agent, firing its lifecycle hooks — `onDeactivate` on the outgoing agent, then `onActivate` on this one — before installing it.\n *\n * This is the entry point a host should use. {@link ChatDriver.applyAgent} installs a config *without* firing hooks, which is right for the two callers that need it (the orchestrator, which fires them through the shared session, and `invokeSubAgent`, where a child's config is not an activation) and wrong for everyone else.\n *\n * @beta\n */\n",
+              "docComment": "/**\n * Make `config` the active agent, firing its lifecycle hooks — `onDeactivate` on the outgoing agent, then `onActivate` on this one — before installing it.\n *\n * This is the entry point a host should use. {@link ChatDriver.installAgent} installs a config *without* firing hooks, which is right for the two callers that need it (the orchestrator, which fires them through the shared session, and `invokeSubAgent`, where a child's config is not an activation) and wrong for everyone else.\n *\n * @beta\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5369,55 +5369,6 @@
               "isAbstract": false,
               "name": "activateAgent"
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#applyAgent:member(1)",
-              "docComment": "/**\n * Install `config` as the active agent **without firing lifecycle hooks**.\n *\n * Prefer {@link ChatDriver.activateAgent} unless you are deliberately skipping the hooks. Two callers are: `OrchestratingDriver`, which fires them through the shared {@link ChatDriver.agentSession} and then installs a decorated config, and `invokeSubAgent`, where the child driver's config is a tool surface rather than an activation.\n *\n * Renamed to `installAgent` in a follow-up (GENC-1580) — see `docs/migration-GENC-1580.md`. Until then the name says less than it should, so do not add a third caller to this path without checking which of the two above it resembles.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "applyAgent(config: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "AgentConfig",
-                  "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
-              },
-              "releaseTag": "Public",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "config",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "applyAgent"
-            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#cancel:member(1)",
@@ -5667,7 +5618,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getActiveAgent:member(1)",
-              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer. Both drivers implement it since GENC-1580; see {@link AiDriver.primeRestoredAgentState} for why the `?` stays for now.\n *\n * @beta\n */\n",
+              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer — and since GENC-1580's breaking release the second case cannot arise, because the method is required.\n *\n * @beta\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -6342,6 +6293,55 @@
               "isAbstract": false,
               "name": "getTurnSnapshots"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#installAgent:member(1)",
+              "docComment": "/**\n * Install `config` as the active agent **without firing lifecycle hooks**.\n *\n * Prefer {@link ChatDriver.activateAgent} unless you are deliberately skipping the hooks. Two callers are: `OrchestratingDriver`, which fires them through the shared {@link ChatDriver.agentSession} and then installs a decorated config, and `invokeSubAgent`, where the child driver's config is a tool surface rather than an activation.\n *\n * Do not add a third caller to this path without checking which of the two above it resembles — whether the hooks should fire is the whole difference between this and `activateAgent`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "installAgent(config: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AgentConfig",
+                  "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "config",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "installAgent"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#isBusy:member(1)",
@@ -6460,7 +6460,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#primeRestoredAgentState:member(1)",
-              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Implemented by every driver since GENC-1580 — each owns an `AgentSession` — so \"only multi-agent drivers implement it\" is no longer true. Still declared optional: this interface is exported and `@beta`, so requiring it would break any third party implementing it. The `?` comes off with the `installAgent` rename, which is the ticket's one breaking release.\n */\n",
+              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Required since GENC-1580's breaking release: every driver owns an `AgentSession`, so both shipped drivers implement it and a host no longer has to feature-detect before restoring.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7179,7 +7179,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig:interface",
-          "docComment": "/**\n * Construction-time configuration for {@link ChatDriver}. Everything except the provider registry is optional — most fields are also settable per-agent via `applyAgent`, so a bare `new ChatDriver(registry)` is valid. Mirrors the `(registry, options)` shape of `OrchestratingDriver`.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Construction-time configuration for {@link ChatDriver}. Everything except the provider registry is optional — most fields are also settable per-agent via `installAgent`, so a bare `new ChatDriver(registry)` is valid. Mirrors the `(registry, options)` shape of `OrchestratingDriver`.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -17064,7 +17064,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getActiveAgent:member(1)",
-              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer. Both drivers implement it since GENC-1580; see {@link AiDriver.primeRestoredAgentState} for why the `?` stays for now.\n */\n",
+              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer — and since GENC-1580's breaking release the second case cannot arise, because the method is required.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -17666,7 +17666,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#primeRestoredAgentState:member(1)",
-              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Implemented by every driver since GENC-1580 — each owns an `AgentSession` — so \"only multi-agent drivers implement it\" is no longer true. Still declared optional: this interface is exported and `@beta`, so requiring it would break any third party implementing it. The `?` comes off with the `installAgent` rename, which is the ticket's one breaking release.\n */\n",
+              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Required since GENC-1580's breaking release: every driver owns an `AgentSession`, so both shipped drivers implement it and a host no longer has to feature-detect before restoring.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",

package/dist/ai-assistant.d.ts

@@ -760,12 +760,10 @@ export declare interface AiDriver extends EventTarget {
      * (keyed by agent name) is handed to that agent's `onActivate`/`init` as
      * `ctx.restored` on its next activation, then consumed.
      *
-     * Implemented by every driver since GENC-1580 — each owns an `AgentSession` — so "only
-     * multi-agent drivers implement it" is no longer true. Still declared optional: this interface
-     * is exported and `@beta`, so requiring it would break any third party implementing it. The `?`
-     * comes off with the `installAgent` rename, which is the ticket's one breaking release.
+     * Required since GENC-1580's breaking release: every driver owns an `AgentSession`, so both
+     * shipped drivers implement it and a host no longer has to feature-detect before restoring.
      */
-    primeRestoredAgentState?(snapshots: Record<string, unknown>): void;
+    primeRestoredAgentState(snapshots: Record<string, unknown>): void;
     /**
      * Return the full, unredacted conversation history.
      */
@@ -784,10 +782,10 @@ export declare interface AiDriver extends EventTarget {
      * which may mint fresh, never-activated configs.
      *
      * `undefined` means no agent is active (before the first activation, after a release), which is
-     * a different statement from the driver not being able to answer. Both drivers implement it
-     * since GENC-1580; see {@link AiDriver.primeRestoredAgentState} for why the `?` stays for now.
+     * a different statement from the driver not being able to answer — and since GENC-1580's
+     * breaking release the second case cannot arise, because the method is required.
      */
-    getActiveAgent?(): AgentConfig | undefined;
+    getActiveAgent(): AgentConfig | undefined;
     /**
      * Pin routing to an agent by name, or `null` for automatic routing. A pin is sticky: it
      * survives a stateful flow completing, so the next turn starts fresh on the same agent.
@@ -796,18 +794,19 @@ export declare interface AiDriver extends EventTarget {
      * belongs to the session, which outlives the question of which driver holds it.
      *
      * Added to the interface in GENC-1580 — it was previously reached by narrowing to
-     * `OrchestratingDriver` with `instanceof`. Optional, so adding it breaks no implementor.
+     * `OrchestratingDriver` with `instanceof`. Required since that ticket's breaking release.
      */
-    setPinnedAgent?(name: string | null): void;
+    setPinnedAgent(name: string | null): void;
     /**
      * Set the transient flow lock — used to restore state on driver reconstruction (agents-array
      * changes, pop-in/pop-out), **not** to steer routing; that is
      * {@link AiDriver.setPinnedAgent}'s job. Writes without firing lifecycle hooks, because the
      * flow it names is already running.
      *
-     * Added to the interface in GENC-1580, as for {@link AiDriver.setPinnedAgent}.
+     * Added to the interface in GENC-1580, as for {@link AiDriver.setPinnedAgent}, and required
+     * since that ticket's breaking release.
      */
-    setFlowOwner?(name: string | null): void;
+    setFlowOwner(name: string | null): void;
     /**
      * Headroom the next turn could need, and which agent set that requirement
      * (GENC-1582). `undefined` when no agent the turn could land on declares a
@@ -1541,7 +1540,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
     private turnSeq;
     /**
      * Monotonic agent-activation counter — the `agentEnd` clock. Advances when the
-     * active flow ends: a swap to a different-named agent (`applyAgent`) OR an
+     * active flow ends: a swap to a different-named agent (`installAgent`) OR an
      * explicit `releaseAgent` / `completeSubAgent`. A stateful agent re-resolving
      * the same name across turns keeps one activation. `agentEnd` fires for a
      * payload once a LATER activation is current (`callActivation < currentActivation`)
@@ -1572,7 +1571,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * Union of every tool name advertised at any point during the current agent
      * activation. Lets the unknown-tool path tell a *stale* call (a real tool from
      * an earlier state, now retired — or one an open exclusive fold is hiding)
-     * apart from a *hallucinated* one. Reset on agent swap in `applyAgent`.
+     * apart from a *hallucinated* one. Reset on agent swap in `installAgent`.
      */
     private readonly everSeenToolNames;
     /**
@@ -1689,7 +1688,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      */
     private activeFallbacks?;
     /**
-     * Active agent's unresolved-tool hook, captured from `applyAgent`. Consulted
+     * Active agent's unresolved-tool hook, captured from `installAgent`. Consulted
      * only when a tool call cannot be dispatched (a stale or hallucinated name);
      * `undefined` keeps the framework's default messages. See
      * `resolveUnresolvedToolContent`.
@@ -1697,7 +1696,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
     private activeOnUnresolvedTool?;
     /**
      * Caches validated provider lookups per name within the current agent. Cleared
-     * by `applyAgent` so each new agent's static/function-resolved names are
+     * by `installAgent` so each new agent's static/function-resolved names are
      * validated fresh.
      */
     private resolvedProviderCache;
@@ -1795,7 +1794,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * would make that case stop ending the turn.
      *
      * It matters most for a sub-agent's wall. The child can sit on a different
-     * vendor from its parent — `applyAgent` reads `config.provider` — so without
+     * vendor from its parent — `installAgent` reads `config.provider` — so without
      * this the parent's short-circuit reports `lastResolvedProvider`, i.e. the one
      * vendor that did NOT refuse. Under a mixed registry that walls Gemini because
      * an Anthropic child 402'd, and if those are the only two reachable vendors the
@@ -1924,7 +1923,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * Make `config` the active agent, firing its lifecycle hooks — `onDeactivate` on the outgoing
      * agent, then `onActivate` on this one — before installing it.
      *
-     * This is the entry point a host should use. {@link ChatDriver.applyAgent} installs a config
+     * This is the entry point a host should use. {@link ChatDriver.installAgent} installs a config
      * *without* firing hooks, which is right for the two callers that need it (the orchestrator,
      * which fires them through the shared session, and `invokeSubAgent`, where a child's config is
      * not an activation) and wrong for everyone else.
@@ -1967,11 +1966,10 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * {@link ChatDriver.agentSession} and then installs a decorated config, and `invokeSubAgent`,
      * where the child driver's config is a tool surface rather than an activation.
      *
-     * Renamed to `installAgent` in a follow-up (GENC-1580) — see `docs/migration-GENC-1580.md`.
-     * Until then the name says less than it should, so do not add a third caller to this path
-     * without checking which of the two above it resembles.
+     * Do not add a third caller to this path without checking which of the two above it resembles —
+     * whether the hooks should fire is the whole difference between this and `activateAgent`.
      */
-    applyAgent(config: AgentConfig): void;
+    installAgent(config: AgentConfig): void;
     /**
      * Resolve the tool-result content for an unresolved tool call. Consults the
      * active agent's `onUnresolvedTool` hook (if any) with the attempted tool
@@ -2296,7 +2294,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
 
 /**
  * Construction-time configuration for {@link ChatDriver}. Everything except the provider
- * registry is optional — most fields are also settable per-agent via `applyAgent`, so a
+ * registry is optional — most fields are also settable per-agent via `installAgent`, so a
  * bare `new ChatDriver(registry)` is valid. Mirrors the `(registry, options)` shape of
  * `OrchestratingDriver`.
  *
@@ -4806,7 +4804,7 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
      * **The inner driver's session, not one of our own.** One session is the invariant: two would
      * let the outer and inner driver disagree about which agent is active, and the inner one would
      * never be activated at all, because this driver installs a *decorated* config through
-     * `applyAgent` rather than going via `ChatDriver.activateAgent`. This driver keeps the routing
+     * `installAgent` rather than going via `ChatDriver.activateAgent`. This driver keeps the routing
      * decisions; the session owns the lifecycle.
      */
     private get agentSession();
@@ -4913,7 +4911,7 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
     getContextReserve(): ContextReserveResolution | undefined;
     /** {@inheritDoc AiDriver.getActiveAgent} */
     getActiveAgent(): AgentConfig | undefined;
-    private applyAgent;
+    private installAgent;
     /**
      * Release the current stateful agent: fire `onDeactivate`, clear the
      * flow-owner lock, dispatch events so the host (and Redux) reflect the

package/dist/chat-driver.cjs

@@ -5304,7 +5304,7 @@ var ChatDriver = class _ChatDriver extends EventTarget {
     this.turnSeq = 0;
     /**
      * Monotonic agent-activation counter — the `agentEnd` clock. Advances when the
-     * active flow ends: a swap to a different-named agent (`applyAgent`) OR an
+     * active flow ends: a swap to a different-named agent (`installAgent`) OR an
      * explicit `releaseAgent` / `completeSubAgent`. A stateful agent re-resolving
      * the same name across turns keeps one activation. `agentEnd` fires for a
      * payload once a LATER activation is current (`callActivation < currentActivation`)
@@ -5345,7 +5345,7 @@ var ChatDriver = class _ChatDriver extends EventTarget {
      * Union of every tool name advertised at any point during the current agent
      * activation. Lets the unknown-tool path tell a *stale* call (a real tool from
      * an earlier state, now retired — or one an open exclusive fold is hiding)
-     * apart from a *hallucinated* one. Reset on agent swap in `applyAgent`.
+     * apart from a *hallucinated* one. Reset on agent swap in `installAgent`.
      */
     this.everSeenToolNames = /* @__PURE__ */ new Set();
     /**
@@ -5396,7 +5396,7 @@ var ChatDriver = class _ChatDriver extends EventTarget {
     this.turnCancelled = false;
     /**
      * Caches validated provider lookups per name within the current agent. Cleared
-     * by `applyAgent` so each new agent's static/function-resolved names are
+     * by `installAgent` so each new agent's static/function-resolved names are
      * validated fresh.
      */
     this.resolvedProviderCache = /* @__PURE__ */ new Map();
@@ -5702,7 +5702,7 @@ var ChatDriver = class _ChatDriver extends EventTarget {
    * Make `config` the active agent, firing its lifecycle hooks — `onDeactivate` on the outgoing
    * agent, then `onActivate` on this one — before installing it.
    *
-   * This is the entry point a host should use. {@link ChatDriver.applyAgent} installs a config
+   * This is the entry point a host should use. {@link ChatDriver.installAgent} installs a config
    * *without* firing hooks, which is right for the two callers that need it (the orchestrator,
    * which fires them through the shared session, and `invokeSubAgent`, where a child's config is
    * not an activation) and wrong for everyone else.
@@ -5711,7 +5711,7 @@ var ChatDriver = class _ChatDriver extends EventTarget {
    */
   async activateAgent(config) {
     await this.agentSession.activate(config);
-    this.applyAgent(config);
+    this.installAgent(config);
   }
   /**
    * {@inheritDoc AiDriver.getActiveAgent}
@@ -5756,11 +5756,10 @@ var ChatDriver = class _ChatDriver extends EventTarget {
    * {@link ChatDriver.agentSession} and then installs a decorated config, and `invokeSubAgent`,
    * where the child driver's config is a tool surface rather than an activation.
    *
-   * Renamed to `installAgent` in a follow-up (GENC-1580) — see `docs/migration-GENC-1580.md`.
-   * Until then the name says less than it should, so do not add a third caller to this path
-   * without checking which of the two above it resembles.
+   * Do not add a third caller to this path without checking which of the two above it resembles —
+   * whether the hooks should fire is the whole difference between this and `activateAgent`.
    */
-  applyAgent(config) {
+  installAgent(config) {
     if (config.name !== this.activeAgentName) this.currentActivation += 1;
     this.systemPrompt = config.systemPrompt;
     if (typeof config.toolDefinitions === "function") {
@@ -6452,7 +6451,7 @@ var ChatDriver = class _ChatDriver extends EventTarget {
     } else {
       this.lifecycleController.signal.addEventListener("abort", disposeChild, { once: true });
     }
-    child.applyAgent({ ...subConfig, primerHistory: effectivePrimer });
+    child.installAgent({ ...subConfig, primerHistory: effectivePrimer });
     child.setHostInteractionRequester(
       (componentName, data, opts) => this.requestInteraction(componentName, data, opts)
     );
@@ -7507,7 +7506,7 @@ var OrchestratingDriver = class extends EventTarget {
    * **The inner driver's session, not one of our own.** One session is the invariant: two would
    * let the outer and inner driver disagree about which agent is active, and the inner one would
    * never be activated at all, because this driver installs a *decorated* config through
-   * `applyAgent` rather than going via `ChatDriver.activateAgent`. This driver keeps the routing
+   * `installAgent` rather than going via `ChatDriver.activateAgent`. This driver keeps the routing
    * decisions; the session owns the lifecycle.
    */
   get agentSession() {
@@ -7665,7 +7664,7 @@ var OrchestratingDriver = class extends EventTarget {
     let lastResult;
     while (true) {
       if (this.cancelled) break;
-      await this.applyAgent(currentAgent);
+      await this.installAgent(currentAgent);
       let result;
       if (isHandoff) {
         const contextPrimer = handoffSummary ? [{ role: "user", content: `[Context from previous agent]: ${handoffSummary}` }] : [];
@@ -7747,7 +7746,7 @@ var OrchestratingDriver = class extends EventTarget {
   getActiveAgent() {
     return this.agentSession.getActive();
   }
-  async applyAgent(agent) {
+  async installAgent(agent) {
     const { previousAgent, flowOwnerChangedTo } = await this.agentSession.activate(agent);
     if (flowOwnerChangedTo !== void 0) {
       this.dispatchEvent(new CustomEvent("flow-owner-changed", { detail: flowOwnerChangedTo }));
@@ -7772,7 +7771,7 @@ var OrchestratingDriver = class extends EventTarget {
       ]);
     }
     this.chatDriver.setProviderHistoryTransform((h) => transformHistoryForAgent(h, agent.name));
-    this.chatDriver.applyAgent(agentToApply);
+    this.chatDriver.installAgent(agentToApply);
     this.dispatchEvent(new CustomEvent("orchestrating-stop"));
     this.dispatchEvent(new CustomEvent("agent-changed", { detail: agent }));
   }