@genesislcap/ai-assistant 15.59.0 → 15.61.0

package/dist/esm/components/message-feedback/message-feedback.template.js

@@ -0,0 +1,80 @@
+import { html, ref, when } from '@genesislcap/web-core';
+import { DEBUG_LOG_NOTE_DEFAULT_MAX_LENGTH } from '../../utils/resolve-debug-log-note';
+const thumbLabel = {
+    positive: 'Good response',
+    negative: 'Bad response',
+};
+const panelTitle = {
+    positive: 'What went well?',
+    negative: 'What went wrong?',
+};
+export const MessageFeedbackTemplate = (designSystemPrefix) => {
+    const buttonTag = `${designSystemPrefix}-button`;
+    const textareaTag = `${designSystemPrefix}-text-area`;
+    const iconTag = `${designSystemPrefix}-icon`;
+    const thumb = (rating) => html `
+    <button
+      type="button"
+      class="thumb"
+      part="message-feedback-button message-feedback-${rating}"
+      aria-label="${thumbLabel[rating]}"
+      title="${(x) => x.sentRating === rating && !x.open ? 'Thanks for your feedback' : thumbLabel[rating]}"
+      aria-pressed="${(x) => String(x.activeRating === rating)}"
+      ?disabled="${(x) => x.status === 'sending'}"
+      @click="${(x) => x.toggle(rating)}"
+    >
+      <${iconTag}
+        name="${rating === 'positive' ? 'thumbs-up' : 'thumbs-down'}"
+        variant="${(x) => (x.activeRating === rating ? 'solid' : 'regular')}"
+      ></${iconTag}>
+    </button>
+  `;
+    return html `
+    <div class="root" @keydown="${(x, c) => x.handleKeydown(c.event)}">
+      <div class="thumbs" part="message-feedback-thumbs">
+        ${thumb('positive')}${thumb('negative')}
+      </div>
+      <span class="visually-hidden" role="status" aria-live="polite">${(x) => x.announcement}</span>
+      ${when((x) => x.open && x.draftRating !== null, html `
+          <div class="panel" part="message-feedback-panel" role="group" aria-label="Send feedback">
+            <p class="panel-title" part="message-feedback-title">
+              ${(x) => panelTitle[x.draftRating]}
+            </p>
+            <${textareaTag}
+              ${ref('noteEl')}
+              class="note"
+              part="message-feedback-note"
+              rows="3"
+              resize="vertical"
+              aria-label="Feedback note (optional)"
+              placeholder="Add a note (optional)"
+              maxlength="${() => DEBUG_LOG_NOTE_DEFAULT_MAX_LENGTH}"
+              :value="${(x) => x.note}"
+              ?disabled="${(x) => x.status === 'sending'}"
+              @input="${(x, c) => x.noteInput(c.event.target.value)}"
+            ></${textareaTag}>
+            <p class="hint ${(x) => (x.status === 'error' ? 'is-error' : '')}" part="message-feedback-hint">
+              ${(x) => x.status === 'error' ? "Couldn't send your feedback. Try again." : x.description}
+            </p>
+            <div class="actions">
+              <${buttonTag}
+                part="message-feedback-cancel-button"
+                appearance="outline"
+                @click="${(x) => x.cancel()}"
+              >
+                Cancel
+              </${buttonTag}>
+              <${buttonTag}
+                part="message-feedback-send-button"
+                appearance="accent"
+                ?disabled="${(x) => x.status === 'sending'}"
+                @click="${(x) => x.send()}"
+              >
+                ${(x) => x.status === 'sending' ? 'Sending…' : x.status === 'error' ? 'Retry' : 'Send'}
+              </${buttonTag}>
+            </div>
+          </div>
+        `)}
+    </div>
+  `;
+};

package/dist/esm/main/main.js

@@ -36,6 +36,7 @@ import { AiChatInteractionWrapper } from '../components/chat-interaction-wrapper
 import { AiChatMarkdown } from '../components/chat-markdown/chat-markdown';
 import { AiFlowingWavesIndicator } from '../components/flowing-waves-indicator';
 import { AiHaloOverlay } from '../components/halo-overlay';
+import { isRateableReply, MessageFeedback, replyKey, } from '../components/message-feedback/message-feedback';
 import { asOrchestrator, OrchestratingDriver, } from '../components/orchestrating-driver/orchestrating-driver';
 import { AiPlasmaOrbIndicator } from '../components/plasma-orb-indicator';
 import { SettingsModalController, } from '../components/settings-modal';
@@ -165,7 +166,7 @@ const TIMESTAMP_CLOCK_INTERVAL_MS = 30000;
  */
 export { budgetPercentOf, formatBlockedReason } from './budget-controller';
 // Register supporting components when the main component module is imported.
-avoidTreeShaking(AiChatMarkdown, AiChatInteractionWrapper, AiHaloOverlay, AiWavesIndicator, AiFlowingWavesIndicator, AiPlasmaOrbIndicator, AiChatBubble, AiActivityHalo, ChatSuggestions, AgentPicker);
+avoidTreeShaking(AiChatMarkdown, AiChatInteractionWrapper, AiHaloOverlay, AiWavesIndicator, AiFlowingWavesIndicator, AiPlasmaOrbIndicator, AiChatBubble, AiActivityHalo, ChatSuggestions, AgentPicker, MessageFeedback);
 /**
  * Foundation AI Assistant component.
  *
@@ -3681,6 +3682,48 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
         const stem = this.debugLogAgentName.toLowerCase().replace(/\s+/g, '-');
         return `${stem}-${new Date().toISOString().replace(/:/g, '-')}.json`;
     }
+    /**
+     * The most recent rateable reply, whose thumbs stay visible without a hover.
+     *
+     * @internal
+     */
+    get latestReply() {
+        for (let i = this.messages.length - 1; i >= 0; i -= 1) {
+            if (isRateableReply(this.messages[i]))
+                return this.messages[i];
+        }
+        return undefined;
+    }
+    /** @internal */
+    get messageFeedbackDescription() {
+        var _a, _b, _c;
+        return ((_c = (_b = (_a = this.chatConfig.ui) === null || _a === void 0 ? void 0 : _a.messageFeedback) === null || _b === void 0 ? void 0 : _b.description) !== null && _c !== void 0 ? _c : 'Sends your rating and note on this reply.');
+    }
+    /**
+     * Hand a rated reply to the host's `ui.messageFeedback.send`, with a getter for the same
+     * lifetime log the agent-log Send button submits — built only if the host asks for it.
+     * Rejects when the host does, or does not settle in time.
+     *
+     * @internal
+     */
+    submitMessageFeedback(reply, rating, note) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const config = (_a = this.chatConfig.ui) === null || _a === void 0 ? void 0 : _a.messageFeedback;
+            if (!config)
+                throw new Error('ui.messageFeedback is not configured');
+            yield settleWithin(config.send({
+                rating,
+                reply,
+                replyKey: replyKey(reply),
+                message: note,
+                filename: this.debugLogFilename(),
+                agentName: (_b = reply.agentName) !== null && _b !== void 0 ? _b : this.debugLogAgentName,
+                host: window.location.host,
+                getLogJson: () => __awaiter(this, void 0, void 0, function* () { return JSON.stringify(yield this.getLifetimeDebugLog(), null, 2); }),
+            }), (_c = config.timeoutMs) !== null && _c !== void 0 ? _c : DEBUG_LOG_SUBMIT_TIMEOUT_MS, 'messageFeedback.send');
+        });
+    }
     /**
      * 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

package/dist/esm/main/main.styles.js

@@ -459,6 +459,33 @@ const baseStyles = css `
     }
   }
 
+  /* Revealed like the 'hover' timestamps, with space reserved so the bubble never reflows.
+     Always shown on the latest reply, once rated, and while the note panel is open. */
+  .message-feedback {
+    opacity: 0%;
+    transition: opacity 0.12s ease-out;
+  }
+
+  .message-row:hover .message-feedback,
+  .message-row:focus-within .message-feedback,
+  .message-feedback[latest],
+  .message-feedback[open],
+  .message-feedback[rated] {
+    opacity: 100%;
+  }
+
+  @media (hover: none) {
+    .message-feedback {
+      opacity: 100%;
+    }
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    .message-feedback {
+      transition: none;
+    }
+  }
+
   .payload {
     font-family: monospace;
     white-space: pre-wrap;

package/dist/esm/main/main.template.js

@@ -17,6 +17,7 @@
 import { isChatToolCallUnknown } from '@genesislcap/foundation-ai';
 import { classNames, html, ref, repeat, slotted, when } from '@genesislcap/web-core';
 import { MARKDOWN_EXPORTPARTS } from '../components/chat-markdown/chat-markdown';
+import { isRateableReply, MESSAGE_FEEDBACK_EXPORTPARTS, } from '../components/message-feedback/message-feedback';
 import { SettingsModalTemplate } from '../components/settings-modal';
 import { SUGGESTIONS_EXPORTPARTS } from '../suggestions/chat-suggestions';
 import { formatAbsoluteTimestamp, formatMessageTimestamp, messageTimestampDateTime, } from '../utils/format-message-timestamp';
@@ -651,6 +652,18 @@ ${(tc) => { var _a; return (((_a = tc.foldPath) === null || _a === void 0 ? void
                 `)}
               ${when((m) => m.interaction, interactionWrapperTemplate)}
             </div>
+            ${when((m, c) => { var _a; return isRateableReply(m) && ((_a = c.parent.chatConfig.ui) === null || _a === void 0 ? void 0 : _a.messageFeedback) != null; }, html `
+                <foundation-ai-message-feedback
+                  class="message-feedback"
+                  part="message-feedback"
+                  exportparts="${MESSAGE_FEEDBACK_EXPORTPARTS}"
+                  ?latest="${(m, c) => m === c.parent.latestReply}"
+                  :designSystemPrefix="${(_, c) => c.parent.designSystemPrefix}"
+                  :description="${(_, c) => c.parent.messageFeedbackDescription}"
+                  :submit="${(_, c) => c.parent.submitMessageFeedback.bind(c.parent)}"
+                  :message="${(m) => m}"
+                ></foundation-ai-message-feedback>
+              `)}
           </div>
         </div>
       `)}

package/dist/react.cjs

@@ -13,6 +13,7 @@ const { AiChatInteractionWrapper: AiChatInteractionWrapperWC } = require('./esm/
 const { AiChatMarkdown: AiChatMarkdownWC } = require('./esm/components/chat-markdown/chat-markdown.js');
 const { AiFlowingWavesIndicator: AiFlowingWavesIndicatorWC } = require('./esm/components/flowing-waves-indicator.js');
 const { AiHaloOverlay: AiHaloOverlayWC } = require('./esm/components/halo-overlay.js');
+const { MessageFeedback: MessageFeedbackWC } = require('./esm/components/message-feedback/message-feedback.js');
 const { AiPlasmaOrbIndicator: AiPlasmaOrbIndicatorWC } = require('./esm/components/plasma-orb-indicator.js');
 const { FoundationAiPopoutManager: FoundationAiPopoutManagerWC } = require('./esm/components/popout-manager/popout-manager.js');
 const { AiWavesIndicator: AiWavesIndicatorWC } = require('./esm/components/waves-indicator.js');
@@ -140,6 +141,11 @@ const AiChatMarkdown = React.forwardRef(function AiChatMarkdown(props, ref) {
   return React.createElement(customElements.getName(AiChatMarkdownWC) ?? 'ai-chat-markdown', { ...rest, ref }, children);
 });
 
+const MessageFeedback = React.forwardRef(function MessageFeedback(props, ref) {
+  const { children, ...rest } = props;
+  return React.createElement(customElements.getName(MessageFeedbackWC) ?? 'foundation-ai-message-feedback', { ...rest, ref }, children);
+});
+
 const FoundationAiPopoutManager = React.forwardRef(function FoundationAiPopoutManager(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(FoundationAiPopoutManagerWC) ?? 'foundation-ai-popout-manager', { ...rest, ref }, children);
@@ -174,6 +180,7 @@ module.exports = {
   AiChatBubble,
   AiChatInteractionWrapper,
   AiChatMarkdown,
+  MessageFeedback,
   FoundationAiPopoutManager,
   GenesisWriteReview,
 };

package/dist/react.mjs

@@ -11,6 +11,7 @@ import { AiChatInteractionWrapper as AiChatInteractionWrapperWC } from './esm/co
 import { AiChatMarkdown as AiChatMarkdownWC } from './esm/components/chat-markdown/chat-markdown.js';
 import { AiFlowingWavesIndicator as AiFlowingWavesIndicatorWC } from './esm/components/flowing-waves-indicator.js';
 import { AiHaloOverlay as AiHaloOverlayWC } from './esm/components/halo-overlay.js';
+import { MessageFeedback as MessageFeedbackWC } from './esm/components/message-feedback/message-feedback.js';
 import { AiPlasmaOrbIndicator as AiPlasmaOrbIndicatorWC } from './esm/components/plasma-orb-indicator.js';
 import { FoundationAiPopoutManager as FoundationAiPopoutManagerWC } from './esm/components/popout-manager/popout-manager.js';
 import { AiWavesIndicator as AiWavesIndicatorWC } from './esm/components/waves-indicator.js';
@@ -138,6 +139,11 @@ export const AiChatMarkdown = React.forwardRef(function AiChatMarkdown(props, re
   return React.createElement(customElements.getName(AiChatMarkdownWC) ?? 'ai-chat-markdown', { ...rest, ref }, children);
 });
 
+export const MessageFeedback = React.forwardRef(function MessageFeedback(props, ref) {
+  const { children, ...rest } = props;
+  return React.createElement(customElements.getName(MessageFeedbackWC) ?? 'foundation-ai-message-feedback', { ...rest, ref }, children);
+});
+
 export const FoundationAiPopoutManager = React.forwardRef(function FoundationAiPopoutManager(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(FoundationAiPopoutManagerWC) ?? 'foundation-ai-popout-manager', { ...rest, ref }, children);

package/package.json

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

package/sandbox/README.md

@@ -31,7 +31,7 @@ The panel covers, roughly in the order you'll want them:
 | **Context window** | **Jump to state** (the four gate states in one click), the simulated window and fill, `chatConfig.context`, a flow-in-progress toggle, live readouts of the gate / thresholds / compaction plan, and Compact |
 | **Simulated state** | Forces `idle` / busy / cancelling / blocked / compacting / restoring onto the element |
 | **Transcript** | Seeds an empty, short, tool-and-markdown-heavy, 28-turn, ~20k-token, or ~22k-token tool-loop conversation, and how far back to shift its timestamps |
-| **Chrome** | Header title, popout mode, suggestions, the tool-call / reasoning / narration toggles, the timestamp mode, animations |
+| **Chrome** | Header title, popout mode, suggestions, the tool-call / reasoning / narration toggles, the timestamp mode, animations, per-reply thumbs (`messageFeedback`, with a stub send that succeeds or fails) |
 | **Stage** | Frame size (floored at 400px — see below), light/dark, remount, full reset |
 
 Panel state persists in `localStorage`, so a reload picks up where you left off. **Reset sandbox**

package/sandbox/sandbox.ts

@@ -137,6 +137,7 @@ interface SandboxState {
   showNarration: boolean;
   showTimestamps: TimestampDisplay;
   animations: boolean;
+  messageFeedback: 'off' | 'succeeds' | 'fails';
   // Context window (GENC-1567)
   contextPreset: ContextPresetName | typeof CUSTOM_PRESET;
   contextWindow: number;
@@ -182,6 +183,7 @@ const DEFAULT_STATE: SandboxState = {
   showNarration: true,
   showTimestamps: 'always',
   animations: true,
+  messageFeedback: 'succeeds',
   // Chosen so the `huge` (~20k) and `loop` (~22k) seeds actually clear the tail
   // budget these produce (~12.8k) and so have something to compact. Verified, not
   // guessed — a slightly roomier pairing leaves the tail larger than either seed,
@@ -334,6 +336,9 @@ const ACCEPTED_FILES: Record<SandboxState['attachments'], string | undefined> =
   images: 'image/png,image/jpeg,image/gif,image/webp,.txt,.md,.csv,.json,text/*',
 };
 
+/** Long enough to see the thumbs' Sending… state. */
+const STUB_FEEDBACK_SEND_MS = 600;
+
 const buildChatConfig = (s: SandboxState): ChatConfig => ({
   ui: {
     acceptedFiles: ACCEPTED_FILES[s.attachments],
@@ -348,6 +353,25 @@ const buildChatConfig = (s: SandboxState): ChatConfig => ({
     // `undefined` disables the feature outright (no cog control, nothing enabled);
     // `userConfigurable` turns the defaults on and adds the multiselect to the cog.
     animations: s.animations ? { userConfigurable: true } : undefined,
+    messageFeedback:
+      s.messageFeedback === 'off'
+        ? undefined
+        : {
+            send: async ({ rating, reply, replyKey, message, filename, getLogJson }) => {
+              await new Promise((resolve) => {
+                setTimeout(resolve, STUB_FEEDBACK_SEND_MS);
+              });
+              console.info('[sandbox] message feedback', {
+                rating,
+                reply: reply.content,
+                replyKey,
+                note: message,
+                filename,
+                logBytes: (await getLogJson()).length,
+              });
+              if (s.messageFeedback === 'fails') throw new Error('Sandbox transport refused');
+            },
+          },
   },
   context: {
     enabled: s.contextGateEnabled,
@@ -969,6 +993,17 @@ const GROUPS: ReadonlyArray<ControlGroup<SandboxState>> = [
         hint: 'Also settable from the cog. Whichever you moved last wins; moving other panel controls will not disturb a cog choice.',
       },
       { kind: 'toggle', key: 'animations', label: 'Animations' },
+      {
+        kind: 'select',
+        key: 'messageFeedback',
+        label: 'Message feedback',
+        options: [
+          { value: 'off', label: 'Off' },
+          { value: 'succeeds', label: 'Send succeeds' },
+          { value: 'fails', label: 'Send fails' },
+        ],
+        hint: 'chatConfig.ui.messageFeedback — thumbs on each reply; the stub send logs to the console.',
+      },
     ],
   },
   {