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

package/dist/esm/main/main.js

@@ -63,6 +63,7 @@ import { logger } from '../utils/logger';
 import { filterVisibleMessages, trailingInteractionRow } from '../utils/message-partition';
 import { CONTEXT_ABORT_MARGIN_TOKENS, resolveContextBudget, } from '../utils/resolve-context-budget';
 import { resolveCostHistoryConfig, } from '../utils/resolve-cost-history-config';
+import { normalizeDebugLogNote, resolveDebugLogNoteConfig, } from '../utils/resolve-debug-log-note';
 import { resolvePreferenceBaseline } from '../utils/resolve-preference-baseline';
 import { stripAgentHandlers } from '../utils/strip-agent-handlers';
 import { addUsage, emptyUsage, sumUsage, totalTokens } from '../utils/sum-usage';
@@ -112,6 +113,11 @@ const COMPOSER_MENU_MIN_HEIGHT = 140;
  * assistant is running — the Usage tab renders the in-memory list — so the delay is invisible.
  */
 const LEDGER_FLUSH_DEBOUNCE_MS = 2000;
+/**
+ * How long the agent-log Send button shows its 'Sent'/'Failed' outcome before
+ * returning to idle — long enough to read, short enough that a retry is never blocked.
+ */
+const DEBUG_LOG_SUBMIT_RESULT_FLASH_MS = 4000;
 /**
  * The image types BOTH vendors accept, and therefore the only ones sent as image blocks.
  *
@@ -384,6 +390,25 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
          * element has its own settings modal.
          */
         this.downloadingDebugLog = false;
+        /**
+         * 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.
+         */
+        this.submittingDebugLog = false;
+        /**
+         * Outcome of the last log submission, shown briefly on the button ('Sent' /
+         * 'Failed — retry') then cleared by `setDebugLogSubmitResult`'s timer. `null` when idle.
+         */
+        this.debugLogSubmitResult = null;
+        /**
+         * 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.
+         */
+        this.debugLogComposeOpen = false;
+        /** The note typed in the compose box, raw (trimmed only at submit time). */
+        this.debugLogNote = '';
         /** Active tab inside the settings modal. */
         this.settingsModalTab = 'settings';
         /**
@@ -2986,6 +3011,9 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
         super.disconnectedCallback();
         this._sessionActive = false;
         this.stopLoadingTimer();
+        // The 'Sent'/'Failed' flash timer would otherwise fire against a torn-down element.
+        clearTimeout(this.debugLogSubmitResultTimer);
+        this.debugLogSubmitResultTimer = undefined;
         this.state = 'idle';
         // Note: `compacting`/`restoring` are NOT cleared here. They're written through the
         // in-flight op's captured session store (see `initPersistenceForNewStore` /
@@ -4348,6 +4376,42 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
         void this.chatConfig;
         return this.resolvedCostHistory.showTokens;
     }
+    /**
+     * 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() {
+        void this.chatConfig;
+        const ui = this.chatConfig.ui;
+        return (ui === null || ui === void 0 ? void 0 : ui.allowDebugDownload) === true || (ui === null || ui === void 0 ? void 0 : ui.debugLogSubmit) != null;
+    }
+    /**
+     * 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() {
+        var _a;
+        void this.chatConfig;
+        return resolveDebugLogNoteConfig((_a = this.chatConfig.ui) === null || _a === void 0 ? void 0 : _a.debugLogSubmit);
+    }
+    /**
+     * 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() {
+        if (this.submittingDebugLog)
+            return true;
+        const note = this.debugLogNoteConfig;
+        return (note === null || note === void 0 ? void 0 : note.required) === true && normalizeDebugLogNote(this.debugLogNote) === undefined;
+    }
+    /** Live "typed / max" counter for the compose box. */
+    get debugLogNoteCounter() {
+        var _a;
+        const max = (_a = this.debugLogNoteConfig) === null || _a === void 0 ? void 0 : _a.maxLength;
+        return max ? `${this.debugLogNote.length}/${max}` : '';
+    }
     /** Whether the chat header (and settings cog) should render. */
     get settingsCogVisible() {
         void this.chatConfig;
@@ -4360,6 +4424,7 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
             (ui === null || ui === void 0 ? void 0 : ui.showNarration) != null ||
             (ui === null || ui === void 0 ? void 0 : ui.showAgentSwitchIndicator) != null ||
             (ui === null || ui === void 0 ? void 0 : ui.allowDebugDownload) === true ||
+            (ui === null || ui === void 0 ? void 0 : ui.debugLogSubmit) != null ||
             (ui === null || ui === void 0 ? void 0 : ui.animations) != null ||
             cost.showCost ||
             cost.showTokens ||
@@ -4742,6 +4807,96 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
             }
         });
     }
+    /**
+     * 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() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            if (this.submittingDebugLog || this.debugLogSendDisabled)
+                return;
+            const config = (_a = this.chatConfig.ui) === null || _a === void 0 ? void 0 : _a.debugLogSubmit;
+            if (!config)
+                return;
+            const agentName = (_d = (_c = (_b = this.activeAgent) === null || _b === void 0 ? void 0 : _b.name) !== null && _c !== void 0 ? _c : this.headerTitle) !== null && _d !== void 0 ? _d : 'chat';
+            const timestamp = new Date().toISOString().replace(/:/g, '-');
+            const fileStem = agentName.toLowerCase().replace(/\s+/g, '-');
+            // Only a note the user could actually type travels with the log: with the compose box
+            // opted out there is no note, whatever a stale `debugLogNote` might hold.
+            const message = this.debugLogNoteConfig === null ? undefined : normalizeDebugLogNote(this.debugLogNote);
+            this.submittingDebugLog = true;
+            try {
+                const payload = yield this.buildDownloadLog();
+                yield config.send({
+                    logJson: JSON.stringify(payload, null, 2),
+                    filename: `${fileStem}-${timestamp}.json`,
+                    agentName,
+                    host: window.location.host,
+                    message,
+                });
+                // Success consumes the note; a failure (below) keeps the box open with it intact.
+                this.debugLogComposeOpen = false;
+                this.debugLogNote = '';
+                this.setDebugLogSubmitResult('sent');
+            }
+            catch (e) {
+                logger.error('Submitting agent log failed:', e);
+                this.setDebugLogSubmitResult('error');
+            }
+            finally {
+                this.submittingDebugLog = false;
+            }
+        });
+    }
+    /**
+     * 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() {
+        if (this.submittingDebugLog)
+            return;
+        if (this.debugLogNoteConfig === null) {
+            void this.submitDebugLog();
+            return;
+        }
+        // Opening again resets a lingering 'Failed' flash so the box starts clean.
+        clearTimeout(this.debugLogSubmitResultTimer);
+        this.debugLogSubmitResultTimer = undefined;
+        this.debugLogSubmitResult = null;
+        this.debugLogComposeOpen = true;
+        // Next frame so the `when` block has rendered the text-area. The design-system
+        // text-area does not delegate focus (see `maybeAutoFocusChatInput`), so drill in.
+        requestAnimationFrame(() => {
+            var _a, _b, _c;
+            if (!this.debugLogComposeOpen || !this.isConnected)
+                return;
+            const el = this.debugLogNoteEl;
+            (_c = ((_b = (_a = el === null || el === void 0 ? void 0 : el.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector('textarea')) !== null && _b !== void 0 ? _b : el)) === null || _c === void 0 ? void 0 : _c.focus();
+        });
+    }
+    /** Close the compose box and discard the typed note. */
+    cancelDebugLogCompose() {
+        if (this.submittingDebugLog)
+            return;
+        this.debugLogComposeOpen = false;
+        this.debugLogNote = '';
+    }
+    /** Flash the submit outcome on the Send button, then fall back to idle. */
+    setDebugLogSubmitResult(result) {
+        clearTimeout(this.debugLogSubmitResultTimer);
+        this.debugLogSubmitResult = result;
+        this.debugLogSubmitResultTimer = setTimeout(() => {
+            this.debugLogSubmitResult = null;
+            this.debugLogSubmitResultTimer = undefined;
+        }, DEBUG_LOG_SUBMIT_RESULT_FLASH_MS);
+    }
     /**
      * 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
@@ -5597,6 +5752,18 @@ __decorate([
 __decorate([
     observable
 ], FoundationAiAssistant.prototype, "downloadingDebugLog", void 0);
+__decorate([
+    observable
+], FoundationAiAssistant.prototype, "submittingDebugLog", void 0);
+__decorate([
+    observable
+], FoundationAiAssistant.prototype, "debugLogSubmitResult", void 0);
+__decorate([
+    observable
+], FoundationAiAssistant.prototype, "debugLogComposeOpen", void 0);
+__decorate([
+    observable
+], FoundationAiAssistant.prototype, "debugLogNote", void 0);
 __decorate([
     observable
 ], FoundationAiAssistant.prototype, "settingsModalTab", void 0);
@@ -5744,6 +5911,18 @@ __decorate([
 __decorate([
     volatile
 ], FoundationAiAssistant.prototype, "settingsSessionTokensVisible", null);
+__decorate([
+    volatile
+], FoundationAiAssistant.prototype, "settingsAgentLogSectionVisible", null);
+__decorate([
+    volatile
+], FoundationAiAssistant.prototype, "debugLogNoteConfig", null);
+__decorate([
+    volatile
+], FoundationAiAssistant.prototype, "debugLogSendDisabled", null);
+__decorate([
+    volatile
+], FoundationAiAssistant.prototype, "debugLogNoteCounter", null);
 __decorate([
     volatile
 ], FoundationAiAssistant.prototype, "settingsCogVisible", null);

package/dist/esm/utils/resolve-debug-log-note.js

@@ -0,0 +1,31 @@
+/** Default cap on the user's note. Short by design — it is a caption for the log, not a report. */
+export const DEBUG_LOG_NOTE_DEFAULT_MAX_LENGTH = 500;
+/** Default prompt in the empty note. */
+export const DEBUG_LOG_NOTE_DEFAULT_PLACEHOLDER = 'What were you doing, or what went wrong? (optional)';
+/**
+ * Resolve `debugLogSubmit.note` — `undefined`/`true` mean "compose box with defaults",
+ * `false` means "no compose box, send on first click" (→ `null`), and an object customises
+ * the box. Keeps the template free of the boolean-or-object dance.
+ */
+export function resolveDebugLogNoteConfig(config) {
+    var _a;
+    if (!config || config.note === false)
+        return null;
+    const note = typeof config.note === 'object' ? config.note : {};
+    const maxLength = typeof note.maxLength === 'number' && note.maxLength > 0
+        ? Math.floor(note.maxLength)
+        : DEBUG_LOG_NOTE_DEFAULT_MAX_LENGTH;
+    return {
+        placeholder: (_a = note.placeholder) !== null && _a !== void 0 ? _a : DEBUG_LOG_NOTE_DEFAULT_PLACEHOLDER,
+        required: note.required === true,
+        maxLength,
+    };
+}
+/**
+ * Normalise the typed note for the submission: trimmed, and `undefined` when empty so a
+ * host can `message ?? fallback` without checking for whitespace.
+ */
+export function normalizeDebugLogNote(note) {
+    const trimmed = note.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "15.23.1-agent-rules.1",
+  "version": "15.23.1-agent-log-submit.2",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -74,26 +74,26 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.23.1-agent-rules.1",
-    "@genesislcap/genx": "15.23.1-agent-rules.1",
-    "@genesislcap/rollup-builder": "15.23.1-agent-rules.1",
-    "@genesislcap/ts-builder": "15.23.1-agent-rules.1",
-    "@genesislcap/uvu-playwright-builder": "15.23.1-agent-rules.1",
-    "@genesislcap/vite-builder": "15.23.1-agent-rules.1",
-    "@genesislcap/webpack-builder": "15.23.1-agent-rules.1",
+    "@genesislcap/foundation-testing": "15.23.1-agent-log-submit.2",
+    "@genesislcap/genx": "15.23.1-agent-log-submit.2",
+    "@genesislcap/rollup-builder": "15.23.1-agent-log-submit.2",
+    "@genesislcap/ts-builder": "15.23.1-agent-log-submit.2",
+    "@genesislcap/uvu-playwright-builder": "15.23.1-agent-log-submit.2",
+    "@genesislcap/vite-builder": "15.23.1-agent-log-submit.2",
+    "@genesislcap/webpack-builder": "15.23.1-agent-log-submit.2",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2",
     "esbuild": "0.25.12"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "15.23.1-agent-rules.1",
-    "@genesislcap/foundation-logger": "15.23.1-agent-rules.1",
-    "@genesislcap/foundation-notifications": "15.23.1-agent-rules.1",
-    "@genesislcap/foundation-redux": "15.23.1-agent-rules.1",
-    "@genesislcap/foundation-ui": "15.23.1-agent-rules.1",
-    "@genesislcap/foundation-utils": "15.23.1-agent-rules.1",
-    "@genesislcap/rapid-design-system": "15.23.1-agent-rules.1",
-    "@genesislcap/web-core": "15.23.1-agent-rules.1",
+    "@genesislcap/foundation-ai": "15.23.1-agent-log-submit.2",
+    "@genesislcap/foundation-logger": "15.23.1-agent-log-submit.2",
+    "@genesislcap/foundation-notifications": "15.23.1-agent-log-submit.2",
+    "@genesislcap/foundation-redux": "15.23.1-agent-log-submit.2",
+    "@genesislcap/foundation-ui": "15.23.1-agent-log-submit.2",
+    "@genesislcap/foundation-utils": "15.23.1-agent-log-submit.2",
+    "@genesislcap/rapid-design-system": "15.23.1-agent-log-submit.2",
+    "@genesislcap/web-core": "15.23.1-agent-log-submit.2",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },