@artooi/ag-ui-web-component 0.43.0 → 0.44.0

package/dist/ui/history/conversation_history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation_history.d.ts","sourceRoot":"","sources":["../../../src/ui/history/conversation_history.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation_history.d.ts","sourceRoot":"","sources":["../../../src/ui/history/conversation_history.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,uDAAuD;IACvD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;IAC1D,0CAA0C;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,qBAAqB,GAAG,IAAI,CAAC;IAChE,wCAAwC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,oBAAoB,KAAK,OAAO,CAAC;IAC/E,mFAAmF;IACnF,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7D,yDAAyD;IACzD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,kBAAkB,GAAG,SAAS,CAAC;IAClE,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,KAAK,cAAc,CAAC;IAC/E;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC;IACvC,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,UAAU,GAAG,IAAI,CAAC;IACzC,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,UAAU,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC;IACvD;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC;IAC9D,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD;AAED;;;;;;;;GAQG;AACH,UAAU,OAAO;IACf;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAYD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAmB;;IAgD9B,YAAY,IAAI,EAAE,uBAAuB,EAExC;IAED,8BAA8B;IAC9B,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,qEAAqE;IACrE,IAAI,QAAQ,IAAI,SAAS,OAAO,EAAE,CAEjC;IAED,6EAA6E;IAC7E,IAAI,YAAY,IAAI,UAAU,GAAG,IAAI,CAEpC;IAED,oDAAoD;IACpD,iBAAiB,IAAI,IAAI,CAExB;IAED,mDAAmD;IACnD,WAAW,IAAI,IAAI,CAElB;IAED;;;;;;;;OAQG;IACH,gBAAgB,IAAI,IAAI,CAGvB;IAED,6EAA6E;IAC7E,cAAc,IAAI,IAAI,CAgBrB;IASD,+DAA+D;IAC/D,UAAU,IAAI,IAAI,CAOjB;IAED,yEAAyE;IACzE,IAAI,IAAI,QAAQ,GAAG,IAAI,CAatB;IAED,mEAAmE;IACnE,WAAW,IAAI,IAAI,CAQlB;IAED,mEAAmE;IACnE,eAAe,IAAI,IAAI,CAKtB;IAED,0EAA0E;IACpE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlD;IAED,kEAAkE;IAClE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGlD;IAED,4EAA4E;IAC5E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAYnC;IAED,kEAAkE;IAC5D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnC;IAWD;;;;;;;;;;;;;;;;;;OAkBG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiJpE;IAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2EG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA8H/B;IAsID;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsG7B;CA2DF"}

package/dist/ui/transcript/answer_actions.d.ts

@@ -1,3 +1,4 @@
+import type { AgUiMessageIds } from "../../core/agui_client.js";
 import type { UiStrings } from "../ui_strings.js";
 /** What the answer actions need from the element that owns them. */
 export interface AnswerActionsHost {
@@ -7,6 +8,12 @@ export interface AnswerActionsHost {
     readonly strings: () => UiStrings;
     /** Retry the last turn, as the element's public `retryLastTurn` does. */
     readonly retry: () => void;
+    /** The element's current conversation thread. */
+    readonly threadId: () => string;
+}
+/** A finished bubble that is not an answer, and so carries no rating. */
+interface Unrateable {
+    readonly rateable: false;
 }
 /**
  * The action row under a finished answer -- copy, retry, feedback -- and the
@@ -31,9 +38,11 @@ export declare class AnswerActions {
      * something survives to go in it: an empty row still takes its margin, still
      * answers to the `message-actions` part, and still reads to a screen reader
      * as a group of actions with none in it.
+     *
+     * `message` names the answer, which is what a rating is filed under; a bubble
+     * that is not an answer says so instead, and has no id to give.
      */
-    attach(bubble: HTMLDivElement, options?: {
-        rateable?: boolean;
-    }): void;
+    attach(bubble: HTMLDivElement, message: AgUiMessageIds | Unrateable): void;
 }
+export {};
 //# sourceMappingURL=answer_actions.d.ts.map

package/dist/ui/transcript/answer_actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer_actions.d.ts","sourceRoot":"","sources":["../../../src/ui/transcript/answer_actions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;;IAaxB,YAAY,IAAI,EAAE,iBAAiB,EAElC;IAED,mEAAmE;IACnE,MAAM,IAAI,IAAI,CAEb;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI,CAwCzE;CAwCF"}
+{"version":3,"file":"answer_actions.d.ts","sourceRoot":"","sources":["../../../src/ui/transcript/answer_actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC;CACjC;AAED,yEAAyE;AACzE,UAAU,UAAU;IAClB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;;IAaxB,YAAY,IAAI,EAAE,iBAAiB,EAElC;IAED,mEAAmE;IACnE,MAAM,IAAI,IAAI,CAEb;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,UAAU,GAAG,IAAI,CAyDzE;CAwCF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artooi/ag-ui-web-component",
-  "version": "0.43.0",
+  "version": "0.44.0",
   "description": "Framework-free <ag-ui-chat> Web Component over the AG-UI protocol. Drop-in chat sidebar with a pluggable client-side tool registry, DOM driver primitives, animations, and destructive-action confirmation modal.",
   "type": "module",
   "main": "./dist/index.js",

package/src/constants.ts

@@ -102,10 +102,18 @@ export const INVALIDATE_EVENT = "ag-ui-invalidate";
 /**
  * Fired when the user rates an assistant message from its action row.
  *
- * `detail` is a {@link FeedbackDetail}: the rated message's text and the
- * rating. **Nothing is stored** -- a rating belongs to whatever the host
- * already uses to hold product signals, and a write-only table inside a chat
- * widget is a schema nobody reads.
+ * `detail` is a {@link FeedbackDetail}: which message was rated -- its AG-UI
+ * `messageId` and the `threadId` it belongs to, plus the `runId` that streamed
+ * it when it arrived live (absent on a restored message, which carries no run
+ * id) -- with its text and the rating. A host stores the rating against
+ * `messageId`, not `content`: two answers can read the same. A restored
+ * message is named by the id its store returns, so with a server-backed store
+ * the id holds across a reload only where the server persists the ids it
+ * streamed; the built-in browser store keeps them as they streamed.
+ *
+ * **Nothing is stored** -- a rating belongs to whatever the host already uses
+ * to hold product signals, and a write-only table inside a chat widget is a
+ * schema nobody reads.
  */
 export const FEEDBACK_EVENT = "ag-ui-feedback";
 

package/src/core/ag_ui_chat.ts

@@ -445,6 +445,8 @@ export class AgUiChat extends HTMLElement {
     retry: () => {
       void this.retryLastTurn();
     },
+    // Late-bound: the history is built in the constructor, after this field.
+    threadId: () => this.#history.threadId,
   });
 
   readonly #root: ShadowRoot;

package/src/core/agui_client.ts

@@ -25,6 +25,29 @@ export interface AgUiToolCall {
   readonly args: Record<string, unknown>;
 }
 
+/**
+ * Which message an answer surfaced by {@link AgUiClient} is, as the stream
+ * named it.
+ */
+export interface AgUiMessageIds {
+  /** The id the message streamed under, on its `TEXT_MESSAGE_START`/`END`. */
+  readonly messageId: string;
+  /**
+   * The run that streamed it, as that run's `RUN_STARTED` declared it.
+   *
+   * Absent when no `RUN_STARTED` was seen. `@ag-ui/client` 1.0 rejects a
+   * stream whose first event is anything else, so over a real agent this is
+   * always present; nothing else names the run the server recorded, so
+   * nothing is substituted when it is not.
+   *
+   * Text a sub-agent streams through the parent run carries the parent's run
+   * id: that is the stream it arrived on, and the delegation's
+   * `subagentRunId` names the child's work rather than a run the answer is
+   * recorded under.
+   */
+  readonly runId?: string;
+}
+
 /** The result of executing a frontend tool, destined for a tool-result message. */
 export interface ToolExecution {
   /** String content for the AG-UI tool-result message. */
@@ -92,8 +115,11 @@ export interface AgUiClientHandlers {
   onRunStart(): void;
   /** Fired on every streamed token; `buffer` is the full text so far. */
   onTextDelta(buffer: string): void;
-  /** Fired when the assistant message completes; `buffer` is the final text. */
-  onTextEnd(buffer: string): void;
+  /**
+   * Fired when the assistant message completes; `buffer` is the final text,
+   * and `message` names it as the stream did.
+   */
+  onTextEnd(buffer: string, message: AgUiMessageIds): void;
   /** Fired when the agent finishes calling a tool (server- or frontend-side). */
   onToolCall(call: AgUiToolCall): void;
   /**
@@ -786,10 +812,21 @@ export class AgUiClient {
     // Charts whose patch has been dispatched but not yet applied. Scoped to the
     // subscriber, so it cannot outlive the run that created it.
     const pendingDeltas = new Set<string>();
+    // The run this round's stream declared. Per subscriber, so per round: a
+    // turn that calls a tool is two runs, and its answer belongs to the second.
+    //
+    // Taken from `RUN_STARTED` rather than the `runId` the request carried.
+    // The client mints that one, and a server is free to record the run under
+    // the id it streams back; the event is the server's own statement of
+    // which run this is, so it is the id a host can find again.
+    let runId: string | undefined;
     return {
       onRunInitialized() {
         h.onRunStart();
       },
+      onRunStartedEvent({ event }) {
+        runId = event.runId;
+      },
       onTextMessageStartEvent({ event }) {
         // A reused message id merges two answers into one persisted transcript
         // entry. The protocol has no rule to enforce and refusing the event
@@ -809,7 +846,10 @@ export class AgUiClient {
       },
       onTextMessageEndEvent({ event, textMessageBuffer }) {
         closed.add(event.messageId);
-        h.onTextEnd(textMessageBuffer);
+        h.onTextEnd(textMessageBuffer, {
+          messageId: event.messageId,
+          ...(runId === undefined ? {} : { runId }),
+        });
       },
       onToolCallEndEvent({ event, toolCallName, toolCallArgs }) {
         const call: AgUiToolCall = {

package/src/core/events/feedback_detail.ts

@@ -3,4 +3,25 @@ export interface FeedbackDetail {
   /** The rated message's text, as rendered. */
   readonly content: string;
   readonly rating: "up" | "down";
+  /**
+   * The AG-UI id of the rated assistant message: the id it streamed under, or
+   * the stored message's `id` when it was restored from history.
+   *
+   * What a host stores a rating against. `content` cannot be: two answers can
+   * read the same, and the text says nothing about which stored message it
+   * was. A restored message carries whatever id its store returns: the
+   * built-in browser store keeps the streamed ids, and a server-backed one
+   * keeps them only where the server persists the ids it streamed.
+   */
+  readonly messageId: string;
+  /** The conversation the message belongs to: the element's thread when it was drawn. */
+  readonly threadId: string;
+  /**
+   * The run that streamed the message, as its `RUN_STARTED` named it.
+   *
+   * Present only on a message that arrived live. A restored one has none to
+   * give -- an AG-UI message carries no run id -- so the key is absent there
+   * rather than holding a value that only looks like one.
+   */
+  readonly runId?: string;
 }

package/src/core/run_handlers.ts

@@ -235,7 +235,7 @@ export class RunHandlers {
         this.#host.stream.queue(buffer);
         this.#host.stream.countDelta();
       },
-      onTextEnd: (buffer) => {
+      onTextEnd: (buffer, message) => {
         // A text message that carried no content is a declaration, not an
         // answer, and drawing one puts an empty bubble above every tool call.
         //
@@ -265,7 +265,7 @@ export class RunHandlers {
           this.#host.transcript.revealWords(bubble);
         }
         attachCopyButtons(bubble, this.#host.strings());
-        this.#host.actions.attach(bubble);
+        this.#host.actions.attach(bubble, message);
         this.#host.stream.end();
         this.#host.noteUnread();
       },

package/src/index.ts

@@ -34,6 +34,7 @@ export {
   AgUiClient,
   type AgUiClientConfig,
   type AgUiClientHandlers,
+  type AgUiMessageIds,
   type AgUiRunInputs,
   type AgUiToolCall,
   ConnectionLostError,

package/src/ui/history/conversation_history.ts

@@ -916,7 +916,20 @@ export class ConversationHistory {
         // wrap words.
         const restoredBubble = this.#host.appendMessage(MESSAGE_ROLE.ASSISTANT, text);
         restoredBubble.classList.add("message--restored");
-        this.#host.actions.attach(restoredBubble);
+        // The stored id, which is the streamed one wherever the store kept
+        // it. A Retry re-renders the turns it keeps through here too, so a
+        // kept answer stays the message it was. No run id: a stored message
+        // does not carry one.
+        //
+        // Narrowed rather than trusted, like the fields below: a host store or
+        // a `data-threads-url` server can return a message with no id, and a
+        // rating that names nothing is a pair of buttons that lead nowhere.
+        // Such an answer keeps its copy and loses only the rating.
+        const id: unknown = message.id;
+        this.#host.actions.attach(
+          restoredBubble,
+          typeof id === "string" && id !== "" ? { messageId: id } : { rateable: false },
+        );
       }
       // Narrowed rather than trusted, for the same reason `messageAttachments`
       // narrows the neighbouring field: anything that throws in this loop aborts

package/src/ui/transcript/answer_actions.ts

@@ -1,4 +1,5 @@
 import { FEEDBACK_EVENT, ICON_RETRY, MESSAGE_ACTIONS } from "../../constants.js";
+import type { AgUiMessageIds } from "../../core/agui_client.js";
 import type { FeedbackDetail } from "../../core/events/feedback_detail.js";
 import { commaTokens } from "../../core/utils.js";
 import { copyPayload } from "../excerpts/copy_payload.js";
@@ -13,6 +14,13 @@ export interface AnswerActionsHost {
   readonly strings: () => UiStrings;
   /** Retry the last turn, as the element's public `retryLastTurn` does. */
   readonly retry: () => void;
+  /** The element's current conversation thread. */
+  readonly threadId: () => string;
+}
+
+/** A finished bubble that is not an answer, and so carries no rating. */
+interface Unrateable {
+  readonly rateable: false;
 }
 
 /**
@@ -55,15 +63,26 @@ export class AnswerActions {
    * something survives to go in it: an empty row still takes its margin, still
    * answers to the `message-actions` part, and still reads to a screen reader
    * as a group of actions with none in it.
+   *
+   * `message` names the answer, which is what a rating is filed under; a bubble
+   * that is not an answer says so instead, and has no id to give.
    */
-  attach(bubble: HTMLDivElement, options: { rateable?: boolean } = {}): void {
+  attach(bubble: HTMLDivElement, message: AgUiMessageIds | Unrateable): void {
     const enabled = this.#enabled();
     const copyable = enabled.has(MESSAGE_ACTIONS.COPY);
     // A failed run is copyable -- error text is what people paste into a bug
     // report -- but not rateable: a rating is a statement about an *answer*,
     // and mixing "the connection dropped" into that signal makes the host's
     // feedback data say less than it did before.
-    const rateable = options.rateable !== false && enabled.has(MESSAGE_ACTIONS.FEEDBACK);
+    const answer = "messageId" in message ? message : null;
+    const rateable = answer !== null && enabled.has(MESSAGE_ACTIONS.FEEDBACK);
+    // Read now rather than at click time. Every path that moves the element to
+    // another thread -- New chat, a switch, a change of principal -- clears
+    // the transcript, so today the two agree; the bubble can only be rated
+    // while the thread it was drawn in is current. Were a later path to change
+    // the thread and keep the bubbles, the thread the message was drawn from is
+    // still the one it is stored in, and that is what a host files it under.
+    const threadId = this.#host.threadId();
     if (copyable || rateable) {
       attachMessageActions(bubble, {
         strings: this.#host.strings(),
@@ -83,7 +102,16 @@ export class AnswerActions {
               onFeedback: (rating: "up" | "down") => {
                 this.#host.element.dispatchEvent(
                   new CustomEvent<FeedbackDetail>(FEEDBACK_EVENT, {
-                    detail: { content: copyPayload(bubble).text, rating },
+                    detail: {
+                      content: copyPayload(bubble).text,
+                      rating,
+                      messageId: answer.messageId,
+                      threadId,
+                      // Omitted rather than undefined: a restored message has
+                      // no run, and a key holding nothing reads as one that
+                      // was looked up and came back empty.
+                      ...(answer.runId === undefined ? {} : { runId: answer.runId }),
+                    },
                     bubbles: true,
                     composed: true,
                   }),

package/src/version.ts

@@ -1 +1 @@
-export const VERSION: string = "0.43.0";
+export const VERSION: string = "0.44.0";