@genesislcap/ai-assistant 15.27.0-agent-log-submit.3 → 15.27.1

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`.
  *
@@ -3610,38 +3608,6 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * element has its own settings modal.
      */
     downloadingDebugLog: boolean;
-    /**
-     * True while `submitDebugLog` is building and handing off the log. Same role as
-     * `downloadingDebugLog` for the Send button: the lifetime-stitch and the host's
-     * `send` callback are async, so the button needs a visible in-flight state.
-     */
-    submittingDebugLog: boolean;
-    /**
-     * Outcome of the last log submission, shown briefly on the button ('Sent' /
-     * 'Failed — retry') then cleared by `setDebugLogSubmitResult`'s timer. `null` when idle.
-     */
-    debugLogSubmitResult: 'sent' | 'error' | null;
-    /** Timer that clears `debugLogSubmitResult` back to idle. */
-    private debugLogSubmitResultTimer?;
-    /**
-     * Whether the agent-log compose box (note + Send/Cancel) is open. Opened by the row's
-     * Send button when `debugLogSubmit.note` is not `false`; closed by Cancel or a
-     * successful send. Stays open after a failure so the typed note is not lost.
-     */
-    debugLogComposeOpen: boolean;
-    /** The note typed in the compose box, raw (trimmed only at submit time). */
-    debugLogNote: string;
-    /** Bound to the compose box's text-area via the template ref, for focus on open. */
-    debugLogNoteEl?: HTMLElement;
-    /** How long 'Sent' shows before idle. Overridable so tests need not wait 4 seconds. */
-    debugLogSubmitResultFlashMs: number;
-    /**
-     * Bumped by `resetDebugLogSubmitState`. An in-flight `submitDebugLog` captures it and
-     * drops its continuation when a reset (disconnect, session switch, Clear) happened
-     * while it awaited — otherwise the stale submission would write state, arm a timer on
-     * a torn-down element, or report 'Sent' into a session it never belonged to.
-     */
-    private debugLogSubmitGeneration;
     /** Active tab inside the settings modal. */
     get settingsModalTab(): SettingsModalTab;
     set settingsModalTab(value: SettingsModalTab);
@@ -4293,65 +4259,6 @@ export declare class FoundationAiAssistant extends GenesisElement {
     get settingsCostTabVisible(): boolean;
     /** Whether session token usage should render on the Usage tab. */
     get settingsSessionTokensVisible(): boolean;
-    /**
-     * Whether the settings "Agent log" section renders — shown when either action is
-     * enabled: the download button (`allowDebugDownload`) or the host-transport Send
-     * button (`debugLogSubmit`). Each button is additionally gated on its own flag
-     * inside the section, so a host can enable one without the other.
-     */
-    get settingsAgentLogSectionVisible(): boolean;
-    /**
-     * The resolved compose-box settings for the agent-log Send button, or `null` when the
-     * host opted out (`debugLogSubmit.note: false`) and the button sends on first click.
-     */
-    get debugLogNoteConfig(): ResolvedDebugLogNoteConfig | null;
-    /**
-     * Whether the typed note counts as empty — the ONE emptiness rule, shared by the
-     * compose box's disabled state and its "required" hint so the two cannot drift apart.
-     */
-    get debugLogNoteMissing(): boolean;
-    /** The Send button's idle label, as the host configured it. */
-    get debugLogSubmitLabel(): string;
-    /**
-     * Label on the agent-log row's Send button. While the compose box is open the row
-     * button is just the (disabled) trigger, so it keeps its idle label; otherwise it
-     * reflects the in-flight / flashed outcome of the last submission.
-     */
-    get debugLogSubmitButtonLabel(): string;
-    /**
-     * The compose box's footer hint: a failure first, then the "required" nudge, else the
-     * live counter. Visual only — the same information reaches assistive technology via
-     * `debugLogNoteAriaLabel` (counter, required) and `debugLogSubmitAnnouncement` (outcome),
-     * because IDREF attributes such as `aria-describedby` cannot point across the
-     * design-system text-area's shadow boundary.
-     */
-    get debugLogComposeHint(): string;
-    /**
-     * Accessible name for the note. Deliberately STATIC apart from "(required)": a name
-     * that changed per keystroke would be re-read in full by NVDA on every key and never
-     * updated by JAWS. The running count reaches AT through `debugLogSubmitAnnouncement`
-     * at the thresholds where it matters.
-     */
-    get debugLogNoteAriaLabel(): string;
-    /**
-     * Text for the always-present live region beside the agent-log row, so the outcome of
-     * a submission is announced even when the compose box is closed or opted out
-     * (`note: false`), where the only visible change is the button label.
-     */
-    get debugLogSubmitAnnouncement(): string;
-    /**
-     * The agent-log row's description, phrased for whichever actions the host enabled.
-     * Send is called out as transmitting: Download keeps the log on the user's machine,
-     * Send hands the full conversation to wherever the host's transport delivers it.
-     */
-    get debugLogRowDescription(): string;
-    /**
-     * Whether the compose box's Send button is inert: a send is already in flight, or the
-     * host made the note required and it is still blank.
-     */
-    get debugLogSendDisabled(): boolean;
-    /** Live "typed / max" counter for the compose box. */
-    get debugLogNoteCounter(): string;
     /** Whether the chat header (and settings cog) should render. */
     get settingsCogVisible(): boolean;
     openSettingsModal(): void;
@@ -4422,62 +4329,6 @@ export declare class FoundationAiAssistant extends GenesisElement {
      */
     private buildMetaSnapshot;
     downloadDebugLog(): Promise<void>;
-    /**
-     * Hand the agent log to the host's `ui.debugLogSubmit.send` callback — the Send
-     * button next to Download. Reuses `buildDownloadLog`, so the submitted log is
-     * byte-identical to what Download saves (lifetime-stitched when the provider
-     * persists diagnostics). The assistant is vendor-agnostic: the callback owns the
-     * transport (Sentry feedback, a support API, an upload endpoint). Outcome lands in
-     * `debugLogSubmitResult` so the button can flash 'Sent'/'Failed'; failures also go
-     * to the logger with the cause.
-     */
-    submitDebugLog(): Promise<void>;
-    /** The agent name stamped on the log: the active agent, else the header title. */
-    private get debugLogAgentName();
-    /**
-     * Filename for the agent log — the ONE derivation Download saves under and Send hands
-     * to the host, so `ChatDebugLogSubmission.filename`'s "same stem as the download"
-     * promise is enforced rather than relying on two copies agreeing.
-     */
-    private debugLogFilename;
-    /**
-     * Back to idle: nothing in flight, no flash, no open compose box, no note. Called on
-     * disconnect and on a session switch / Clear (a note typed against one conversation
-     * must not caption the next one's log). On disconnect — the
-     * flash timer would otherwise fire against a torn-down element, and clearing ONLY the
-     * timer would strand `debugLogSubmitResult` at 'sent'/'error' for good on a pop-out /
-     * pop-in (nothing else resets it), with the box remounting open on a stale note.
-     */
-    private resetDebugLogSubmitState;
-    /**
-     * The row's Send button. With a compose box configured (the default) it opens the box
-     * and focuses the note so the user can caption the log; with `note: false` it sends
-     * straight away, as before.
-     */
-    openDebugLogCompose(): void;
-    /** The note's `@input`: track the text, and let typing dismiss a standing failure. */
-    noteDebugLogInput(value: string): void;
-    /** Close the compose box and discard the typed note. */
-    cancelDebugLogCompose(): void;
-    /**
-     * Closing the compose box unmounts the focused text-area, which drops focus to the
-     * document body and strands keyboard and screen-reader users. Hand it back to the row's
-     * Send button — next frame, once the `when` block has torn down and the button, disabled
-     * while the box was open, is interactive again.
-     */
-    private restoreDebugLogTriggerFocus;
-    /**
-     * After a FAILED send the controls come back but the element that started the send
-     * was disabled meanwhile, so focus has already dropped to the document body. Put it
-     * where the retry happens: the note when the box is open, else the row trigger.
-     */
-    private restoreDebugLogRetryFocus;
-    /**
-     * Record the submit outcome. 'sent' flashes and falls back to idle; 'error' PERSISTS
-     * until the user acts (types, reopens the box, cancels, or retries) — a failure that
-     * silently reverted to the counter after four seconds left no trace it had happened.
-     */
-    private setDebugLogSubmitResult;
     /**
      * The log to download (GENC-1351 §5.8). When the provider persists diagnostics,
      * stitch the **whole lifetime** stream (every page load) rather than just the
@@ -4953,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();
@@ -5060,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
@@ -5294,13 +5145,6 @@ declare interface ResolvedCostHistoryConfig {
     summaryHint?: string;
 }
 
-/** `ChatDebugLogNoteConfig` with every option resolved. */
-export declare interface ResolvedDebugLogNoteConfig {
-    placeholder: string;
-    required: boolean;
-    maxLength: number;
-}
-
 /**
  * Structured-output schema for an agent. When set, the model's final (non-tool) answer is
  * constrained to this JSON Schema instead of free text. Either a static schema or a function

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 }));
   }