@genesislcap/ai-assistant 15.23.1-agent-rules.1 → 15.23.1-agent-log-submit.2

package/dist/ai-assistant.api.json

@@ -8518,6 +8518,37 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#cancelDebugLogCompose:member(1)",
+              "docComment": "/**\n * Close the compose box and discard the typed note.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "cancelDebugLogCompose(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "cancelDebugLogCompose"
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#chatConfig:member",
@@ -9238,6 +9269,222 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogComposeOpen:member",
+              "docComment": "/**\n * 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.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "debugLogComposeOpen: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "debugLogComposeOpen",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNote:member",
+              "docComment": "/**\n * The note typed in the compose box, raw (trimmed only at submit time).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "debugLogNote: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "debugLogNote",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteConfig:member",
+              "docComment": "/**\n * 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.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get debugLogNoteConfig(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ResolvedDebugLogNoteConfig",
+                  "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | null"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "debugLogNoteConfig",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteCounter:member",
+              "docComment": "/**\n * Live \"typed / max\" counter for the compose box.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get debugLogNoteCounter(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "debugLogNoteCounter",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteEl:member",
+              "docComment": "/**\n * Bound to the compose box's text-area via the template ref, for focus on open.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "debugLogNoteEl?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HTMLElement",
+                  "canonicalReference": "!HTMLElement:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "debugLogNoteEl",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSendDisabled:member",
+              "docComment": "/**\n * 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.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get debugLogSendDisabled(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "debugLogSendDisabled",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitResult:member",
+              "docComment": "/**\n * Outcome of the last log submission, shown briefly on the button ('Sent' / 'Failed — retry') then cleared by `setDebugLogSubmitResult`'s timer. `null` when idle.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "debugLogSubmitResult: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "'sent' | 'error' | null"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "debugLogSubmitResult",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugRedux:member",
@@ -10729,6 +10976,37 @@
               "isAbstract": false,
               "name": "onSettingsModalTabsChange"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#openDebugLogCompose:member(1)",
+              "docComment": "/**\n * 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.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "openDebugLogCompose(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "openDebugLogCompose"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#openSettingsModal:member(1)",
@@ -12395,6 +12673,36 @@
               "isAbstract": false,
               "name": "setSettingsModalTab"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsAgentLogSectionVisible:member",
+              "docComment": "/**\n * 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.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get settingsAgentLogSectionVisible(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "settingsAgentLogSectionVisible",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsAppSectionVisible:member",
@@ -13668,6 +13976,42 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submitDebugLog:member(1)",
+              "docComment": "/**\n * 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.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "submitDebugLog(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "submitDebugLog"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submitMessage:member(1)",
@@ -13739,6 +14083,36 @@
               "isAbstract": false,
               "name": "submitMessage"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submittingDebugLog:member",
+              "docComment": "/**\n * 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.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "submittingDebugLog: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "submittingDebugLog",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#suggestionsState:member",
@@ -17250,6 +17624,105 @@
             "endIndex": 0
           }
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig:interface",
+          "docComment": "/**\n * `ChatDebugLogNoteConfig` with every option resolved.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ResolvedDebugLogNoteConfig "
+            }
+          ],
+          "fileUrlPath": "src/utils/resolve-debug-log-note.ts",
+          "releaseTag": "Public",
+          "name": "ResolvedDebugLogNoteConfig",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig#maxLength:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "maxLength: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "maxLength",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig#placeholder:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "placeholder: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "placeholder",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig#required:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "required: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "required",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/ai-assistant!ResponseSchemaInput:type",

package/dist/ai-assistant.d.ts

@@ -3715,6 +3715,29 @@ 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;
     /** Active tab inside the settings modal. */
     settingsModalTab: SettingsModalTab;
     /** Bound to the design-system modal via the template ref. */
@@ -4561,6 +4584,25 @@ 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 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;
@@ -4641,6 +4683,26 @@ 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 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;
+    /** Close the compose box and discard the typed note. */
+    cancelDebugLogCompose(): void;
+    /** Flash the submit outcome on the Send button, then fall back to idle. */
+    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
@@ -5462,6 +5524,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