@genesislcap/ai-assistant 15.29.0 → 15.30.1

package/dist/ai-assistant.d.ts

@@ -3608,6 +3608,38 @@ 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);
@@ -4259,6 +4291,65 @@ 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;
@@ -4329,6 +4420,62 @@ 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
@@ -5145,6 +5292,13 @@ 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