@tylertech/forge-ai 0.14.0 → 0.15.0

package/custom-elements.json

@@ -737,156 +737,156 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/ai-button/ai-button.ts",
+      "path": "src/lib/ai-chain-of-thought/ai-chain-of-thought.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "AiButtonComponentTagName",
+          "name": "AiChainOfThoughtComponentTagName",
           "type": {
             "text": "keyof HTMLElementTagNameMap"
           },
-          "default": "'forge-ai-button'"
+          "default": "'forge-ai-chain-of-thought'"
         },
         {
           "kind": "class",
           "description": "",
-          "name": "AiButtonComponent",
-          "slots": [
-            {
-              "description": "Default slot for button content",
-              "name": ""
-            }
-          ],
+          "name": "AiChainOfThoughtComponent",
           "members": [
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "expanded",
               "type": {
                 "text": "boolean"
               },
               "privacy": "public",
               "default": "false",
-              "description": "Whether the button is disabled",
-              "attribute": "disabled",
+              "description": "Whether the chain of thought is expanded",
+              "attribute": "expanded",
               "reflects": true
             }
           ],
           "attributes": [
             {
-              "name": "disabled",
+              "name": "expanded",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the button is disabled",
-              "fieldName": "disabled"
+              "description": "Whether the chain of thought is expanded",
+              "fieldName": "expanded"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "forge-ai-button",
+          "tagName": "forge-ai-chain-of-thought",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiButtonComponentTagName",
+          "name": "AiChainOfThoughtComponentTagName",
           "declaration": {
-            "name": "AiButtonComponentTagName",
-            "module": "src/lib/ai-button/ai-button.ts"
+            "name": "AiChainOfThoughtComponentTagName",
+            "module": "src/lib/ai-chain-of-thought/ai-chain-of-thought.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AiButtonComponent",
+          "name": "AiChainOfThoughtComponent",
           "declaration": {
-            "name": "AiButtonComponent",
-            "module": "src/lib/ai-button/ai-button.ts"
+            "name": "AiChainOfThoughtComponent",
+            "module": "src/lib/ai-chain-of-thought/ai-chain-of-thought.ts"
           }
         },
         {
           "kind": "custom-element-definition",
           "declaration": {
-            "name": "AiButtonComponent",
-            "module": "src/lib/ai-button/ai-button.ts"
+            "name": "AiChainOfThoughtComponent",
+            "module": "src/lib/ai-chain-of-thought/ai-chain-of-thought.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/ai-chain-of-thought/ai-chain-of-thought.ts",
+      "path": "src/lib/ai-button/ai-button.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "AiChainOfThoughtComponentTagName",
+          "name": "AiButtonComponentTagName",
           "type": {
             "text": "keyof HTMLElementTagNameMap"
           },
-          "default": "'forge-ai-chain-of-thought'"
+          "default": "'forge-ai-button'"
         },
         {
           "kind": "class",
           "description": "",
-          "name": "AiChainOfThoughtComponent",
+          "name": "AiButtonComponent",
+          "slots": [
+            {
+              "description": "Default slot for button content",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
-              "name": "expanded",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "privacy": "public",
               "default": "false",
-              "description": "Whether the chain of thought is expanded",
-              "attribute": "expanded",
+              "description": "Whether the button is disabled",
+              "attribute": "disabled",
               "reflects": true
             }
           ],
           "attributes": [
             {
-              "name": "expanded",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the chain of thought is expanded",
-              "fieldName": "expanded"
+              "description": "Whether the button is disabled",
+              "fieldName": "disabled"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "forge-ai-chain-of-thought",
+          "tagName": "forge-ai-button",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiChainOfThoughtComponentTagName",
+          "name": "AiButtonComponentTagName",
           "declaration": {
-            "name": "AiChainOfThoughtComponentTagName",
-            "module": "src/lib/ai-chain-of-thought/ai-chain-of-thought.ts"
+            "name": "AiButtonComponentTagName",
+            "module": "src/lib/ai-button/ai-button.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AiChainOfThoughtComponent",
+          "name": "AiButtonComponent",
           "declaration": {
-            "name": "AiChainOfThoughtComponent",
-            "module": "src/lib/ai-chain-of-thought/ai-chain-of-thought.ts"
+            "name": "AiButtonComponent",
+            "module": "src/lib/ai-button/ai-button.ts"
           }
         },
         {
           "kind": "custom-element-definition",
           "declaration": {
-            "name": "AiChainOfThoughtComponent",
-            "module": "src/lib/ai-chain-of-thought/ai-chain-of-thought.ts"
+            "name": "AiButtonComponent",
+            "module": "src/lib/ai-button/ai-button.ts"
           }
         }
       ]
@@ -1078,6 +1078,17 @@
               "description": "Shows the conversations button (hamburger menu) for accessing conversation history",
               "attribute": "show-conversations-button"
             },
+            {
+              "kind": "field",
+              "name": "hasConversationsError",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "description": "Shows an error badge on the conversations button, indicating a failure inside the conversations panel (default: false)",
+              "attribute": "has-conversations-error"
+            },
             {
               "kind": "method",
               "name": "showAgentInfo",
@@ -1233,6 +1244,15 @@
               "default": "false",
               "description": "Shows the conversations button (hamburger menu) for accessing conversation history",
               "fieldName": "showConversationsButton"
+            },
+            {
+              "name": "has-conversations-error",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows an error badge on the conversations button, indicating a failure inside the conversations panel (default: false)",
+              "fieldName": "hasConversationsError"
             }
           ],
           "superclass": {
@@ -3695,6 +3715,16 @@
               "description": "When true, shows a loading indicator in the conversations panel's recent chats list while threads are loading (default: false)",
               "attribute": "threads-loading"
             },
+            {
+              "kind": "field",
+              "name": "threadsError",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "public",
+              "description": "Message describing a failed thread load. When set, the conversations panel shows the message with a retry button instead of its empty state or loading indicator. The conversations button also shows an error badge so the failure is visible with the panel closed. If threads are already loaded the list stays visible and the message renders as a compact single line with a retry - at the bottom of the list when a page was in flight, otherwise above it. Clear it once a load succeeds.",
+              "attribute": "threads-error"
+            },
             {
               "kind": "method",
               "name": "sendMessage",
@@ -4351,7 +4381,7 @@
               "type": {
                 "text": "CustomEvent<ForgeAiChatbotThreadSelectEventData>"
               },
-              "description": "Fired when user selects a thread",
+              "description": "Fired when user selects a thread. Cancelable - prevents selectedThreadId from being set, leaving the host to commit it once its own load resolves",
               "name": "forge-ai-chatbot-thread-select"
             },
             {
@@ -4388,6 +4418,13 @@
               },
               "description": "Fired when user deletes a thread. Cancelable - if prevented, call onSuccess() to commit deletion or onError() to revert. Otherwise optimistically removed.",
               "name": "forge-ai-chatbot-thread-delete"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when the retry button in the conversations panel's error state is clicked. Re-request the threads and clear threadsError once the load succeeds",
+              "name": "forge-ai-chatbot-thread-retry"
             }
           ],
           "attributes": [
@@ -4474,6 +4511,14 @@
               "description": "When true, shows a loading indicator in the conversations panel's recent chats list while threads are loading (default: false)",
               "fieldName": "threadsLoading"
             },
+            {
+              "name": "threads-error",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Message describing a failed thread load. When set, the conversations panel shows the message with a retry button instead of its empty state or loading indicator. The conversations button also shows an error badge so the failure is visible with the panel closed. If threads are already loaded the list stays visible and the message renders as a compact single line with a retry - at the bottom of the list when a page was in flight, otherwise above it. Clear it once a load succeeds.",
+              "fieldName": "threadsError"
+            },
             {
               "name": "file-upload",
               "type": {
@@ -5441,13 +5486,6 @@
                   "type": {
                     "text": "string"
                   }
-                },
-                {
-                  "name": "event",
-                  "optional": true,
-                  "type": {
-                    "text": "MessageStartEvent"
-                  }
                 }
               ]
             },
@@ -5472,13 +5510,6 @@
                   "type": {
                     "text": "string"
                   }
-                },
-                {
-                  "name": "event",
-                  "optional": true,
-                  "type": {
-                    "text": "MessageDeltaEvent"
-                  }
                 }
               ]
             },
@@ -5497,13 +5528,6 @@
                   "type": {
                     "text": "string"
                   }
-                },
-                {
-                  "name": "event",
-                  "optional": true,
-                  "type": {
-                    "text": "MessageEndEvent"
-                  }
                 }
               ]
             },
@@ -5522,13 +5546,6 @@
                   "type": {
                     "text": "ToolCall"
                   }
-                },
-                {
-                  "name": "event",
-                  "optional": true,
-                  "type": {
-                    "text": "ToolCallStartEvent"
-                  }
                 }
               ]
             },
@@ -5553,13 +5570,6 @@
                   "type": {
                     "text": "Partial<ToolCall>"
                   }
-                },
-                {
-                  "name": "eventData",
-                  "optional": true,
-                  "type": {
-                    "text": "{\n      eventType: 'tool-call-args' | 'tool-call-end';\n      event: ToolCallArgsEvent | ToolCallEndEvent;\n    }"
-                  }
                 }
               ]
             },
@@ -5637,13 +5647,6 @@
                   "type": {
                     "text": "ChatMessage"
                   }
-                },
-                {
-                  "name": "event",
-                  "optional": true,
-                  "type": {
-                    "text": "MessageStartEvent"
-                  }
                 }
               ]
             },
@@ -5724,13 +5727,6 @@
                   "type": {
                     "text": "ChatMessage['status']"
                   }
-                },
-                {
-                  "name": "event",
-                  "optional": true,
-                  "type": {
-                    "text": "MessageEndEvent"
-                  }
                 }
               ]
             },
@@ -5875,6 +5871,66 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/ai-chatbot/request-serialization.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "toRequestToolCall",
+          "return": {
+            "type": {
+              "text": "RequestToolCall"
+            }
+          },
+          "parameters": [
+            {
+              "name": "toolCall",
+              "type": {
+                "text": "ToolCall"
+              }
+            }
+          ],
+          "description": "Projects a tool call onto its wire shape. This is the single boundary at which\nlocal state is dropped, so adapters never have to remember to omit it."
+        },
+        {
+          "kind": "function",
+          "name": "toRequestMessages",
+          "return": {
+            "type": {
+              "text": "RequestMessage[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "messages",
+              "type": {
+                "text": "ChatMessage[]"
+              }
+            }
+          ],
+          "description": "Projects the thread onto the messages an agent endpoint is sent: client-only\nmessages and empty assistant turns are dropped, and every remaining message is\nrebuilt field by field rather than spread, so no local state can leak into a\nrequest body."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "toRequestToolCall",
+          "declaration": {
+            "name": "toRequestToolCall",
+            "module": "src/lib/ai-chatbot/request-serialization.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "toRequestMessages",
+          "declaration": {
+            "name": "toRequestMessages",
+            "module": "src/lib/ai-chatbot/request-serialization.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/lib/ai-chatbot/types.ts",
@@ -6232,6 +6288,17 @@
               "description": "The name of the current thread (shown in conversation view breadcrumb)",
               "attribute": "thread-name"
             },
+            {
+              "kind": "field",
+              "name": "showHistoryButton",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "description": "Controls the prompt bar's chat history button and its popover (default: false). Visibility is yours to decide - the component never infers it from whether chats are loaded, so an empty `threads` shows \"No chats yet\" rather than removing the entry point",
+              "attribute": "show-history-button"
+            },
             {
               "kind": "field",
               "name": "showThreadRename",
@@ -6283,9 +6350,19 @@
               },
               "privacy": "public",
               "default": "false",
-              "description": "Whether chats are currently loading, used to gate the history button and its disabled state",
+              "description": "Whether chats are currently loading, used to show a spinner on the history button and disable it",
               "attribute": "threads-loading"
             },
+            {
+              "kind": "field",
+              "name": "threadsError",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "public",
+              "description": "Message describing a failed chat history load. When set, the history popover/view shows the message with a retry button instead of the empty state, and the history button shows an error badge so the failure is visible with the popover closed. If chats are already loaded the list stays visible and the message renders as a compact single line with a retry - at the bottom of the list when a page was in flight, otherwise above it. Clear it once a load succeeds.",
+              "attribute": "threads-error"
+            },
             {
               "kind": "field",
               "name": "selectedThreadId",
@@ -6307,6 +6384,17 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "showWelcome",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Returns to the welcome view without touching conversation state. Unlike `startNewChat()`, this\nleaves messages, `selectedThreadId`, and the adapter's thread untouched, so an abandoned thread\nselection can be undone without discarding the conversation the user was already in."
+            },
             {
               "kind": "method",
               "name": "showHistory",
@@ -6923,7 +7011,7 @@
               "type": {
                 "text": "CustomEvent<ForgeAiChatbotLauncherThreadSelectEventData>"
               },
-              "description": "Fired when a thread is selected from the history popover or full history view",
+              "description": "Fired when a thread is selected from the history popover or full history view. Cancelable - prevents selectedThreadId from being set and the transition to the conversation view, leaving the host to commit both once its own load resolves",
               "name": "forge-ai-chatbot-launcher-thread-select"
             },
             {
@@ -6946,6 +7034,13 @@
               },
               "description": "Fired when \"New chat\" is clicked from the full history view. Cancelable - prevents startNewChat() from being called",
               "name": "forge-ai-chatbot-launcher-new-chat"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when the retry button in the history error state is clicked. Re-request the chats and clear threadsError once the load succeeds",
+              "name": "forge-ai-chatbot-launcher-thread-retry"
             }
           ],
           "attributes": [
@@ -6965,6 +7060,15 @@
               "description": "The name of the current thread (shown in conversation view breadcrumb)",
               "fieldName": "threadName"
             },
+            {
+              "name": "show-history-button",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Controls the prompt bar's chat history button and its popover (default: false). Visibility is yours to decide - the component never infers it from whether chats are loaded, so an empty `threads` shows \"No chats yet\" rather than removing the entry point",
+              "fieldName": "showHistoryButton"
+            },
             {
               "name": "show-thread-rename",
               "type": {
@@ -6998,9 +7102,17 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether chats are currently loading, used to gate the history button and its disabled state",
+              "description": "Whether chats are currently loading, used to show a spinner on the history button and disable it",
               "fieldName": "threadsLoading"
             },
+            {
+              "name": "threads-error",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Message describing a failed chat history load. When set, the history popover/view shows the message with a retry button instead of the empty state, and the history button shows an error badge so the failure is visible with the popover closed. If chats are already loaded the list stays visible and the message renders as a compact single line with a retry - at the bottom of the list when a page was in flight, otherwise above it. Clear it once a load succeeds.",
+              "fieldName": "threadsError"
+            },
             {
               "name": "selected-thread-id",
               "type": {
@@ -7842,6 +7954,16 @@
               "attribute": "loading",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "errorMessage",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "public",
+              "description": "Message describing a failed thread load. When no threads are loaded, an error banner with a\nretry button replaces the empty state and loading indicator. When threads are already on screen\nthe list stays visible and the message shows as a compact single line with a retry - at the bottom\nof the list if a page was in flight, otherwise above it. The host owns this value and should clear\nit once a load succeeds.",
+              "attribute": "error-message"
+            },
             {
               "kind": "method",
               "name": "resetToMainView",
@@ -7902,8 +8024,15 @@
               },
               "description": "Fired when thread delete confirmed. Cancelable - if prevented, call onSuccess() to commit deletion or onError() to revert. Otherwise optimistically removed.",
               "name": "forge-ai-conversations-panel-delete"
-            }
-          ],
+            },
+            {
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when the retry button in the error state is clicked. The host should re-request the threads and clear errorMessage once the load succeeds.",
+              "name": "forge-ai-conversations-panel-retry"
+            }
+          ],
           "attributes": [
             {
               "name": "threads",
@@ -7953,6 +8082,14 @@
               },
               "default": "false",
               "fieldName": "loading"
+            },
+            {
+              "name": "error-message",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Message describing a failed thread load. When no threads are loaded, an error banner with a\nretry button replaces the empty state and loading indicator. When threads are already on screen\nthe list stays visible and the message shows as a compact single line with a retry - at the bottom\nof the list if a page was in flight, otherwise above it. The host owns this value and should clear\nit once a load succeeds.",
+              "fieldName": "errorMessage"
             }
           ],
           "superclass": {
@@ -9195,6 +9332,17 @@
               "privacy": "public",
               "default": "''",
               "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "density",
+              "type": {
+                "text": "EditThreadDensity"
+              },
+              "privacy": "public",
+              "default": "'small'",
+              "description": "The density of the cancel/save buttons",
+              "attribute": "density"
             }
           ],
           "events": [
@@ -9228,6 +9376,15 @@
               },
               "default": "''",
               "fieldName": "value"
+            },
+            {
+              "name": "density",
+              "type": {
+                "text": "EditThreadDensity"
+              },
+              "default": "'small'",
+              "description": "The density of the cancel/save buttons",
+              "fieldName": "density"
             }
           ],
           "superclass": {
@@ -9264,6 +9421,79 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/ai-empty-state/ai-empty-state.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiEmptyStateComponentTagName",
+          "type": {
+            "text": "keyof HTMLElementTagNameMap"
+          },
+          "default": "'forge-ai-empty-state'"
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AiEmptyStateComponent",
+          "slots": [
+            {
+              "description": "The welcome message content (overrides the default message).",
+              "name": ""
+            },
+            {
+              "description": "The icon/graphic to display.",
+              "name": "icon"
+            },
+            {
+              "description": "The custom heading/title to display.",
+              "name": "heading"
+            },
+            {
+              "description": "The custom body message content.",
+              "name": "body"
+            },
+            {
+              "description": "The actions or suggestions to display below the message.",
+              "name": "actions"
+            }
+          ],
+          "members": [],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "forge-ai-empty-state",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiEmptyStateComponentTagName",
+          "declaration": {
+            "name": "AiEmptyStateComponentTagName",
+            "module": "src/lib/ai-empty-state/ai-empty-state.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiEmptyStateComponent",
+          "declaration": {
+            "name": "AiEmptyStateComponent",
+            "module": "src/lib/ai-empty-state/ai-empty-state.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "declaration": {
+            "name": "AiEmptyStateComponent",
+            "module": "src/lib/ai-empty-state/ai-empty-state.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/lib/ai-embedded-chat/ai-embedded-chat.ts",
@@ -9500,79 +9730,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/lib/ai-empty-state/ai-empty-state.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AiEmptyStateComponentTagName",
-          "type": {
-            "text": "keyof HTMLElementTagNameMap"
-          },
-          "default": "'forge-ai-empty-state'"
-        },
-        {
-          "kind": "class",
-          "description": "",
-          "name": "AiEmptyStateComponent",
-          "slots": [
-            {
-              "description": "The welcome message content (overrides the default message).",
-              "name": ""
-            },
-            {
-              "description": "The icon/graphic to display.",
-              "name": "icon"
-            },
-            {
-              "description": "The custom heading/title to display.",
-              "name": "heading"
-            },
-            {
-              "description": "The custom body message content.",
-              "name": "body"
-            },
-            {
-              "description": "The actions or suggestions to display below the message.",
-              "name": "actions"
-            }
-          ],
-          "members": [],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "forge-ai-empty-state",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AiEmptyStateComponentTagName",
-          "declaration": {
-            "name": "AiEmptyStateComponentTagName",
-            "module": "src/lib/ai-empty-state/ai-empty-state.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AiEmptyStateComponent",
-          "declaration": {
-            "name": "AiEmptyStateComponent",
-            "module": "src/lib/ai-empty-state/ai-empty-state.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "declaration": {
-            "name": "AiEmptyStateComponent",
-            "module": "src/lib/ai-empty-state/ai-empty-state.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/lib/ai-error-message/ai-error-message.ts",
@@ -9591,7 +9748,7 @@
           "name": "AiErrorMessageComponent",
           "slots": [
             {
-              "description": "The error title text",
+              "description": "The error title text. When empty the banner collapses to a single row alongside the icon.",
               "name": "title"
             },
             {
@@ -9599,7 +9756,31 @@
               "name": ""
             }
           ],
-          "members": [],
+          "members": [
+            {
+              "kind": "field",
+              "name": "density",
+              "type": {
+                "text": "ErrorMessageDensity"
+              },
+              "privacy": "public",
+              "default": "'medium'",
+              "description": "The density of the banner. `'small'` tightens the padding, gap, and icon for use in compact surfaces like lists and panels (default: 'medium')",
+              "attribute": "density",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "density",
+              "type": {
+                "text": "ErrorMessageDensity"
+              },
+              "default": "'medium'",
+              "description": "The density of the banner. `'small'` tightens the padding, gap, and icon for use in compact surfaces like lists and panels (default: 'medium')",
+              "fieldName": "density"
+            }
+          ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
@@ -9699,6 +9880,17 @@
               "description": "Whether the button is extended",
               "attribute": "extended",
               "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "default": "'Launch chatbot'",
+              "description": "Accessible label for the button, announced by screen readers.",
+              "attribute": "label"
             }
           ],
           "attributes": [
@@ -9719,6 +9911,15 @@
               "default": "false",
               "description": "Whether the button is extended",
               "fieldName": "extended"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Launch chatbot'",
+              "description": "Accessible label for the button, announced by screen readers.",
+              "fieldName": "label"
             }
           ],
           "superclass": {
@@ -12370,6 +12571,17 @@
               "privacy": "public",
               "default": "false",
               "attribute": "show-delete"
+            },
+            {
+              "kind": "field",
+              "name": "density",
+              "type": {
+                "text": "DropdownMenuDensity"
+              },
+              "privacy": "public",
+              "default": "'small'",
+              "description": "The density of the trigger button",
+              "attribute": "density"
             }
           ],
           "events": [
@@ -12425,6 +12637,15 @@
               },
               "default": "false",
               "fieldName": "showDelete"
+            },
+            {
+              "name": "density",
+              "type": {
+                "text": "DropdownMenuDensity"
+              },
+              "default": "'small'",
+              "description": "The density of the trigger button",
+              "fieldName": "density"
             }
           ],
           "superclass": {
@@ -12756,18 +12977,19 @@
                 "text": "string"
               },
               "privacy": "public",
-              "default": "'Search chats...'",
+              "default": "'Find a chat'",
+              "description": "Placeholder text for the search input. The input's aria-label is \"Search\" - avoid reusing\nthat word here so screen readers don't announce the same word twice.",
               "attribute": "placeholder"
             },
             {
               "kind": "field",
-              "name": "emptyMessage",
+              "name": "errorMessage",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
               "privacy": "public",
-              "default": "'No chats found'",
-              "attribute": "empty-message"
+              "description": "Message describing a failed thread load. When no threads are loaded, an error banner with a\nretry button replaces the empty state. When threads are already on screen the list stays visible\nand the message shows as a compact single line with a retry - at the bottom of the list if a page\nwas in flight, otherwise above it. The host owns this value and should clear it once a load succeeds.",
+              "attribute": "error-message"
             },
             {
               "kind": "field",
@@ -12876,6 +13098,13 @@
               },
               "description": "Fired when the back button (shown via showBackButton) is clicked.",
               "name": "forge-ai-threads-search-back"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when the retry button in the error state is clicked. The host should re-request the threads and clear errorMessage once the load succeeds.",
+              "name": "forge-ai-threads-search-retry"
             }
           ],
           "attributes": [
@@ -12937,16 +13166,17 @@
               "type": {
                 "text": "string"
               },
-              "default": "'Search chats...'",
+              "default": "'Find a chat'",
+              "description": "Placeholder text for the search input. The input's aria-label is \"Search\" - avoid reusing\nthat word here so screen readers don't announce the same word twice.",
               "fieldName": "placeholder"
             },
             {
-              "name": "empty-message",
+              "name": "error-message",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
-              "default": "'No chats found'",
-              "fieldName": "emptyMessage"
+              "description": "Message describing a failed thread load. When no threads are loaded, an error banner with a\nretry button replaces the empty state. When threads are already on screen the list stays visible\nand the message shows as a compact single line with a retry - at the bottom of the list if a page\nwas in flight, otherwise above it. The host owns this value and should clear it once a load succeeds.",
+              "fieldName": "errorMessage"
             },
             {
               "name": "show-thread-rename",
@@ -15387,14 +15617,14 @@
       "path": "src/lib/ai-attachment/ai-attachment.ts",
       "lineNumber": 41
     },
-    "AiButtonComponent": {
-      "path": "src/lib/ai-button/ai-button.ts",
-      "lineNumber": 22
-    },
     "AiChainOfThoughtComponent": {
       "path": "src/lib/ai-chain-of-thought/ai-chain-of-thought.ts",
       "lineNumber": 17
     },
+    "AiButtonComponent": {
+      "path": "src/lib/ai-button/ai-button.ts",
+      "lineNumber": 22
+    },
     "ForgeAiChatHeaderAgentChangeEventData": {
       "path": "src/lib/ai-chat-header/ai-chat-header.ts",
       "lineNumber": 39
@@ -15409,7 +15639,7 @@
     },
     "AiChatHeaderComponent": {
       "path": "src/lib/ai-chat-header/ai-chat-header.ts",
-      "lineNumber": 81
+      "lineNumber": 82
     },
     "AiChatInterfaceComponent": {
       "path": "src/lib/ai-chat-interface/ai-chat-interface.ts",
@@ -15428,92 +15658,92 @@
       "lineNumber": 40
     },
     "MessageStartEvent": {
-      "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 120
+      "path": "src/lib/ai-chatbot/agent-adapter.ts",
+      "lineNumber": 4
     },
     "MessageDeltaEvent": {
-      "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 124
+      "path": "src/lib/ai-chatbot/agent-adapter.ts",
+      "lineNumber": 9
     },
     "MessageEndEvent": {
-      "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 129
+      "path": "src/lib/ai-chatbot/agent-adapter.ts",
+      "lineNumber": 15
     },
     "ToolCallEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
       "lineNumber": 20
     },
     "ToolCallStartEvent": {
-      "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 133
+      "path": "src/lib/ai-chatbot/agent-adapter.ts",
+      "lineNumber": 28
     },
     "ToolCallArgsEvent": {
-      "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 139
+      "path": "src/lib/ai-chatbot/agent-adapter.ts",
+      "lineNumber": 35
     },
     "ToolCallEndEvent": {
-      "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 147
+      "path": "src/lib/ai-chatbot/agent-adapter.ts",
+      "lineNumber": 45
     },
     "ToolResultEvent": {
-      "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 154
+      "path": "src/lib/ai-chatbot/agent-adapter.ts",
+      "lineNumber": 53
     },
     "AdapterState": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 60
+      "lineNumber": 61
     },
     "FileUploadEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 66
+      "lineNumber": 67
     },
     "FileRemoveEvent": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 282
+      "lineNumber": 229
     },
     "ErrorEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 76
+      "lineNumber": 77
     },
     "CustomAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 80
+      "lineNumber": 81
     },
     "RawAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 86
+      "lineNumber": 87
     },
     "RunStartedAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 91
+      "lineNumber": 92
     },
     "StepStartedAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 97
+      "lineNumber": 98
     },
     "StepFinishedAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 102
+      "lineNumber": 103
     },
     "StateSnapshotAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 107
+      "lineNumber": 108
     },
     "StateDeltaAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 112
+      "lineNumber": 113
     },
     "ActivitySnapshotAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 117
+      "lineNumber": 118
     },
     "ActivityDeltaAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 124
+      "lineNumber": 125
     },
     "AgentAdapter": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 130
+      "lineNumber": 131
     },
     "AgentRunnerConfig": {
       "path": "src/lib/ai-chatbot/agent-runner.ts",
@@ -15545,35 +15775,35 @@
     },
     "ForgeAiChatbotMessageEventData": {
       "path": "src/lib/ai-chatbot/ai-chatbot.ts",
-      "lineNumber": 78
+      "lineNumber": 79
     },
     "ForgeAiChatbotToolCallEventData": {
       "path": "src/lib/ai-chatbot/ai-chatbot.ts",
-      "lineNumber": 82
+      "lineNumber": 83
     },
     "ForgeAiChatbotErrorEventData": {
       "path": "src/lib/ai-chatbot/ai-chatbot.ts",
-      "lineNumber": 88
+      "lineNumber": 89
     },
     "ForgeAiChatbotFileSelectEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 286
+      "lineNumber": 233
     },
     "ForgeAiChatbotFileRemoveEventData": {
       "path": "src/lib/ai-chatbot/ai-chatbot.ts",
-      "lineNumber": 104
+      "lineNumber": 105
     },
     "ForgeAiChatbotResponseFeedbackEventData": {
       "path": "src/lib/ai-chatbot/ai-chatbot.ts",
-      "lineNumber": 108
+      "lineNumber": 109
     },
     "ForgeAiChatbotAgentChangeEventData": {
       "path": "src/lib/ai-chatbot/ai-chatbot.ts",
-      "lineNumber": 114
+      "lineNumber": 115
     },
     "AiChatbotComponent": {
       "path": "src/lib/ai-chatbot/ai-chatbot.ts",
-      "lineNumber": 177
+      "lineNumber": 180
     },
     "CreateToolRendererElementConfig": {
       "path": "src/lib/ai-chatbot/create-tool-renderer.ts",
@@ -15621,11 +15851,19 @@
     },
     "MessageStateControllerConfig": {
       "path": "src/lib/ai-chatbot/message-state-controller.ts",
-      "lineNumber": 23
+      "lineNumber": 14
     },
     "MessageStateController": {
       "path": "src/lib/ai-chatbot/message-state-controller.ts",
-      "lineNumber": 36
+      "lineNumber": 27
+    },
+    "RequestToolCall": {
+      "path": "src/lib/ai-chatbot/request-serialization.ts",
+      "lineNumber": 9
+    },
+    "RequestMessage": {
+      "path": "src/lib/ai-chatbot/request-serialization.ts",
+      "lineNumber": 18
     },
     "HeadingLevel": {
       "path": "src/lib/ai-chatbot/types.ts",
@@ -15683,101 +15921,97 @@
       "path": "src/lib/ai-chatbot/types.ts",
       "lineNumber": 92
     },
-    "StreamEvent": {
-      "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 161
-    },
     "ChatMessage": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 170
+      "lineNumber": 120
     },
     "ClientMessageKind": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 192
+      "lineNumber": 141
     },
     "ClientMessageAction": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 194
+      "lineNumber": 143
     },
     "ClientMessageInput": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 204
+      "lineNumber": 153
     },
     "ToolCall": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 212
+      "lineNumber": 161
     },
     "ResponseItem": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 226
+      "lineNumber": 174
     },
     "FeedbackType": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 230
+      "lineNumber": 178
     },
     "ResponseFeedback": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 232
+      "lineNumber": 180
     },
     "AssistantResponse": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 237
+      "lineNumber": 185
     },
     "FileAttachment": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 247
+      "lineNumber": 194
     },
     "UploadedFileMetadata": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 260
+      "lineNumber": 207
     },
     "FileUploadCallbacks": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 268
+      "lineNumber": 215
     },
     "FileUploadHandler": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 275
+      "lineNumber": 222
     },
     "FileRemoveCallbacks": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 277
+      "lineNumber": 224
     },
     "MessageItem": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 299
+      "lineNumber": 246
     },
     "ThreadState": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 304
+      "lineNumber": 251
     },
     "ForgeAiChatbotThreadSelectEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 311
+      "lineNumber": 258
     },
     "ForgeAiChatbotThreadSearchEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 316
+      "lineNumber": 263
     },
     "ForgeAiChatbotThreadLoadMoreEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 321
+      "lineNumber": 268
     },
     "ForgeAiChatbotThreadRenameEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 326
+      "lineNumber": 273
     },
     "ForgeAiChatbotThreadDeleteEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 334
+      "lineNumber": 281
     },
     "ContextItem": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 341
+      "lineNumber": 288
     },
     "ForgeAiChatbotContextRemoveEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 350
+      "lineNumber": 297
     },
     "LauncherViewState": {
       "path": "src/lib/ai-chatbot-launcher/ai-chatbot-launcher.ts",
@@ -15805,7 +16039,7 @@
     },
     "AiChatbotLauncherComponent": {
       "path": "src/lib/ai-chatbot-launcher/ai-chatbot-launcher.ts",
-      "lineNumber": 147
+      "lineNumber": 151
     },
     "AiClientMessageComponent": {
       "path": "src/lib/ai-client-message/ai-client-message.ts",
@@ -15829,27 +16063,27 @@
     },
     "ForgeAiConversationsPanelSelectEventData": {
       "path": "src/lib/ai-conversations-panel/ai-conversations-panel.ts",
-      "lineNumber": 31
+      "lineNumber": 33
     },
     "ForgeAiConversationsPanelSearchEventData": {
       "path": "src/lib/ai-conversations-panel/ai-conversations-panel.ts",
-      "lineNumber": 36
+      "lineNumber": 38
     },
     "ForgeAiConversationsPanelLoadMoreEventData": {
       "path": "src/lib/ai-conversations-panel/ai-conversations-panel.ts",
-      "lineNumber": 41
+      "lineNumber": 43
     },
     "ForgeAiConversationsPanelRenameEventData": {
       "path": "src/lib/ai-conversations-panel/ai-conversations-panel.ts",
-      "lineNumber": 46
+      "lineNumber": 48
     },
     "ForgeAiConversationsPanelDeleteEventData": {
       "path": "src/lib/ai-conversations-panel/ai-conversations-panel.ts",
-      "lineNumber": 54
+      "lineNumber": 56
     },
     "AiConversationsPanelComponent": {
       "path": "src/lib/ai-conversations-panel/ai-conversations-panel.ts",
-      "lineNumber": 77
+      "lineNumber": 80
     },
     "ForgeAiCopyButtonCopyEventData": {
       "path": "src/lib/ai-copy-button/ai-copy-button.ts",
@@ -15931,25 +16165,33 @@
       "path": "src/lib/ai-dropdown-menu/selection-manager.ts",
       "lineNumber": 85
     },
+    "EditThreadDensity": {
+      "path": "src/lib/ai-edit-thread/ai-edit-thread.ts",
+      "lineNumber": 7
+    },
     "ForgeAiEditThreadSaveEventData": {
       "path": "src/lib/ai-edit-thread/ai-edit-thread.ts",
-      "lineNumber": 19
+      "lineNumber": 22
     },
     "AiEditThreadComponent": {
       "path": "src/lib/ai-edit-thread/ai-edit-thread.ts",
-      "lineNumber": 35
+      "lineNumber": 38
+    },
+    "AiEmptyStateComponent": {
+      "path": "src/lib/ai-empty-state/ai-empty-state.ts",
+      "lineNumber": 23
     },
     "AiEmbeddedChatComponent": {
       "path": "src/lib/ai-embedded-chat/ai-embedded-chat.ts",
       "lineNumber": 47
     },
-    "AiEmptyStateComponent": {
-      "path": "src/lib/ai-empty-state/ai-empty-state.ts",
-      "lineNumber": 23
+    "ErrorMessageDensity": {
+      "path": "src/lib/ai-error-message/ai-error-message.ts",
+      "lineNumber": 13
     },
     "AiErrorMessageComponent": {
       "path": "src/lib/ai-error-message/ai-error-message.ts",
-      "lineNumber": 22
+      "lineNumber": 27
     },
     "AiFabComponent": {
       "path": "src/lib/ai-fab/ai-fab.ts",
@@ -16109,19 +16351,19 @@
     },
     "ForgeAiThreadActionsMenuRenameEventData": {
       "path": "src/lib/ai-thread-actions-menu/ai-thread-actions-menu.ts",
-      "lineNumber": 24
+      "lineNumber": 25
     },
     "ForgeAiThreadActionsMenuDeleteClickEventData": {
       "path": "src/lib/ai-thread-actions-menu/ai-thread-actions-menu.ts",
-      "lineNumber": 28
+      "lineNumber": 29
     },
     "ForgeAiThreadActionsMenuOpenEventData": {
       "path": "src/lib/ai-thread-actions-menu/ai-thread-actions-menu.ts",
-      "lineNumber": 32
+      "lineNumber": 33
     },
     "AiThreadActionsMenuComponent": {
       "path": "src/lib/ai-thread-actions-menu/ai-thread-actions-menu.ts",
-      "lineNumber": 51
+      "lineNumber": 52
     },
     "Thread": {
       "path": "src/lib/ai-threads/ai-threads.ts",
@@ -16149,31 +16391,31 @@
     },
     "ForgeAiThreadsSearchQueryEventData": {
       "path": "src/lib/ai-threads-search/ai-threads-search.ts",
-      "lineNumber": 34
+      "lineNumber": 36
     },
     "ForgeAiThreadsSearchLoadMoreEventData": {
       "path": "src/lib/ai-threads-search/ai-threads-search.ts",
-      "lineNumber": 39
+      "lineNumber": 41
     },
     "ForgeAiThreadsSearchSelectEventData": {
       "path": "src/lib/ai-threads-search/ai-threads-search.ts",
-      "lineNumber": 44
+      "lineNumber": 46
     },
     "ForgeAiThreadsSearchRenameEventData": {
       "path": "src/lib/ai-threads-search/ai-threads-search.ts",
-      "lineNumber": 49
+      "lineNumber": 51
     },
     "ForgeAiThreadsSearchDeleteEventData": {
       "path": "src/lib/ai-threads-search/ai-threads-search.ts",
-      "lineNumber": 57
+      "lineNumber": 59
     },
     "ForgeAiThreadsSearchDeleteConfirmEventData": {
       "path": "src/lib/ai-threads-search/ai-threads-search.ts",
-      "lineNumber": 64
+      "lineNumber": 66
     },
     "AiThreadsSearchComponent": {
       "path": "src/lib/ai-threads-search/ai-threads-search.ts",
-      "lineNumber": 88
+      "lineNumber": 91
     },
     "AiToolCallIndicatorComponent": {
       "path": "src/lib/ai-tool-call-indicator/ai-tool-call-indicator.ts",