@tylertech/forge-ai 0.13.11 → 0.13.12

package/custom-elements.json

@@ -3108,6 +3108,45 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "addClientMessage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "ClientMessageInput"
+                  },
+                  "description": "Content and optional kind ('text' | 'info' | 'warning' | 'error' | 'success'),\nheader, and actions. Pass the same `id` on a later call to upsert (replace) a\npreviously added message."
+                }
+              ],
+              "description": "Inserts or upserts a client-only status message into the thread - never sent to\nthe agent adapter and never included in the conversation history the adapter sees.\nUse this for host-driven UI feedback (e.g. \"Your session expired\", upload progress)\ninstead of splicing getMessages/setMessages directly.\n\nSafe to call at any time, including while a response is streaming - it never\nfinalizes or otherwise touches the in-progress response."
+            },
+            {
+              "kind": "method",
+              "name": "removeClientMessage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Removes a client-only message previously added via addClientMessage.\nNo-ops if no message with that id exists. Safe to call at any time, including\nwhile a response is streaming. Removal is never automatic - call this when your\nhost logic determines the message is no longer relevant."
+            },
             {
               "kind": "method",
               "name": "sendMessage",
@@ -3577,6 +3616,17 @@
               "description": "The id of the currently selected conversation thread. Set this to highlight a thread in the conversations panel (e.g. when restoring a conversation loaded from the backend). Updated internally when a thread is selected or a new chat starts.",
               "attribute": "selected-thread-id"
             },
+            {
+              "kind": "field",
+              "name": "threadsLoading",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "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": "method",
               "name": "sendMessage",
@@ -3981,6 +4031,53 @@
                 "module": "src/lib/ai-chatbot/ai-chatbot-base.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "addClientMessage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "ClientMessageInput"
+                  },
+                  "description": "Content and optional kind ('text' | 'info' | 'warning' | 'error' | 'success'),\nheader, and actions. Pass the same `id` on a later call to upsert (replace) a\npreviously added message."
+                }
+              ],
+              "description": "Inserts or upserts a client-only status message into the thread - never sent to\nthe agent adapter and never included in the conversation history the adapter sees.\nUse this for host-driven UI feedback (e.g. \"Your session expired\", upload progress)\ninstead of splicing getMessages/setMessages directly.\n\nSafe to call at any time, including while a response is streaming - it never\nfinalizes or otherwise touches the in-progress response.",
+              "inheritedFrom": {
+                "name": "AiChatbotBase",
+                "module": "src/lib/ai-chatbot/ai-chatbot-base.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "removeClientMessage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Removes a client-only message previously added via addClientMessage.\nNo-ops if no message with that id exists. Safe to call at any time, including\nwhile a response is streaming. Removal is never automatic - call this when your\nhost logic determines the message is no longer relevant.",
+              "inheritedFrom": {
+                "name": "AiChatbotBase",
+                "module": "src/lib/ai-chatbot/ai-chatbot-base.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "abort",
@@ -4300,6 +4397,15 @@
               "description": "The id of the currently selected conversation thread. Set this to highlight a thread in the conversations panel (e.g. when restoring a conversation loaded from the backend). Updated internally when a thread is selected or a new chat starts.",
               "fieldName": "selectedThreadId"
             },
+            {
+              "name": "threads-loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, shows a loading indicator in the conversations panel's recent chats list while threads are loading (default: false)",
+              "fieldName": "threadsLoading"
+            },
             {
               "name": "file-upload",
               "type": {
@@ -5226,6 +5332,26 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "markResponseThinking",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "clearResponseThinking",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "addTextToResponse",
@@ -5471,6 +5597,44 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "addClientMessage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "ClientMessageInput"
+                  }
+                }
+              ],
+              "description": "Inserts or upserts a client-only message, never touching `_activeResponse`.\nUnlike addMessage, this never finalizes an in-progress response -\nsafe to call while a real reply is streaming."
+            },
+            {
+              "kind": "method",
+              "name": "removeClientMessage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Removes a client message by id. No-ops if not found. Safe to call at any time."
+            },
             {
               "kind": "method",
               "name": "updateMessageStatus",
@@ -5626,6 +5790,10 @@
               ]
             }
           ]
+        },
+        {
+          "kind": "variable",
+          "name": "id"
         }
       ],
       "exports": [
@@ -6358,6 +6526,53 @@
                 "module": "src/lib/ai-chatbot/ai-chatbot-base.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "addClientMessage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "ClientMessageInput"
+                  },
+                  "description": "Content and optional kind ('text' | 'info' | 'warning' | 'error' | 'success'),\nheader, and actions. Pass the same `id` on a later call to upsert (replace) a\npreviously added message."
+                }
+              ],
+              "description": "Inserts or upserts a client-only status message into the thread - never sent to\nthe agent adapter and never included in the conversation history the adapter sees.\nUse this for host-driven UI feedback (e.g. \"Your session expired\", upload progress)\ninstead of splicing getMessages/setMessages directly.\n\nSafe to call at any time, including while a response is streaming - it never\nfinalizes or otherwise touches the in-progress response.",
+              "inheritedFrom": {
+                "name": "AiChatbotBase",
+                "module": "src/lib/ai-chatbot/ai-chatbot-base.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "removeClientMessage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Removes a client-only message previously added via addClientMessage.\nNo-ops if no message with that id exists. Safe to call at any time, including\nwhile a response is streaming. Removal is never automatic - call this when your\nhost logic determines the message is no longer relevant.",
+              "inheritedFrom": {
+                "name": "AiChatbotBase",
+                "module": "src/lib/ai-chatbot/ai-chatbot-base.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "abort",
@@ -6741,6 +6956,123 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/ai-client-message/ai-client-message.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiClientMessageComponentTagName",
+          "type": {
+            "text": "keyof HTMLElementTagNameMap"
+          },
+          "default": "'forge-ai-client-message'"
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AiClientMessageComponent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "kind",
+              "type": {
+                "text": "ClientMessageKind"
+              },
+              "privacy": "public",
+              "default": "'text'",
+              "attribute": "kind",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "header",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "public",
+              "attribute": "header"
+            },
+            {
+              "kind": "field",
+              "name": "content",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "default": "''",
+              "attribute": "content"
+            },
+            {
+              "kind": "field",
+              "name": "actions",
+              "type": {
+                "text": "ClientMessageAction[]"
+              },
+              "privacy": "public",
+              "default": "[]"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "kind",
+              "type": {
+                "text": "ClientMessageKind"
+              },
+              "default": "'text'",
+              "fieldName": "kind"
+            },
+            {
+              "name": "header",
+              "type": {
+                "text": "string | undefined"
+              },
+              "fieldName": "header"
+            },
+            {
+              "name": "content",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "content"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "forge-ai-client-message",
+          "customElement": true,
+          "summary": "Renders a client-only status message (never sent to the agent adapter) as\neither plain system-message text or a Forge inline-message banner, depending on `kind`."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiClientMessageComponentTagName",
+          "declaration": {
+            "name": "AiClientMessageComponentTagName",
+            "module": "src/lib/ai-client-message/ai-client-message.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiClientMessageComponent",
+          "declaration": {
+            "name": "AiClientMessageComponent",
+            "module": "src/lib/ai-client-message/ai-client-message.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "declaration": {
+            "name": "AiClientMessageComponent",
+            "module": "src/lib/ai-client-message/ai-client-message.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/lib/ai-confirmation-prompt/ai-confirmation-prompt.ts",
@@ -7242,6 +7574,17 @@
               "default": "false",
               "attribute": "show-conversation-delete"
             },
+            {
+              "kind": "field",
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "attribute": "loading",
+              "reflects": true
+            },
             {
               "kind": "method",
               "name": "resetToMainView",
@@ -7345,6 +7688,14 @@
               },
               "default": "false",
               "fieldName": "showConversationDelete"
+            },
+            {
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "loading"
             }
           ],
           "superclass": {
@@ -12997,6 +13348,53 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "addClientMessage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "ClientMessageInput"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "removeClientMessage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "finalizeActiveResponse",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Finalizes the in-progress response (if any) so a client message inserted right after it doesn't trail a live bubble."
+            },
             {
               "kind": "method",
               "name": "getThreadState",
@@ -14607,59 +15005,59 @@
     },
     "AdapterState": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 59
+      "lineNumber": 60
     },
     "FileUploadEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 65
+      "lineNumber": 66
     },
     "FileRemoveEvent": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 252
+      "lineNumber": 282
     },
     "ErrorEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 75
+      "lineNumber": 76
     },
     "CustomAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 79
+      "lineNumber": 80
     },
     "RawAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 85
+      "lineNumber": 86
     },
     "RunStartedAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 90
+      "lineNumber": 91
     },
     "StepStartedAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 96
+      "lineNumber": 97
     },
     "StepFinishedAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 101
+      "lineNumber": 102
     },
     "StateSnapshotAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 106
+      "lineNumber": 107
     },
     "StateDeltaAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 111
+      "lineNumber": 112
     },
     "ActivitySnapshotAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 116
+      "lineNumber": 117
     },
     "ActivityDeltaAgentEvent": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 123
+      "lineNumber": 124
     },
     "AgentAdapter": {
       "path": "src/lib/ai-chatbot/agent-adapter.ts",
-      "lineNumber": 129
+      "lineNumber": 130
     },
     "AgentRunnerConfig": {
       "path": "src/lib/ai-chatbot/agent-runner.ts",
@@ -14679,11 +15077,11 @@
     },
     "FeatureToggle": {
       "path": "src/lib/ai-chatbot/ai-chatbot-base.ts",
-      "lineNumber": 34
+      "lineNumber": 35
     },
     "AiChatbotBase": {
       "path": "src/lib/ai-chatbot/ai-chatbot-base.ts",
-      "lineNumber": 36
+      "lineNumber": 37
     },
     "AiChatbotToolCallComponent": {
       "path": "src/lib/ai-chatbot/ai-chatbot-tool-call.ts",
@@ -14703,7 +15101,7 @@
     },
     "ForgeAiChatbotFileSelectEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 256
+      "lineNumber": 286
     },
     "ForgeAiChatbotFileRemoveEventData": {
       "path": "src/lib/ai-chatbot/ai-chatbot.ts",
@@ -14719,7 +15117,7 @@
     },
     "AiChatbotComponent": {
       "path": "src/lib/ai-chatbot/ai-chatbot.ts",
-      "lineNumber": 175
+      "lineNumber": 176
     },
     "CreateToolRendererElementConfig": {
       "path": "src/lib/ai-chatbot/create-tool-renderer.ts",
@@ -14767,11 +15165,11 @@
     },
     "MessageStateControllerConfig": {
       "path": "src/lib/ai-chatbot/message-state-controller.ts",
-      "lineNumber": 22
+      "lineNumber": 23
     },
     "MessageStateController": {
       "path": "src/lib/ai-chatbot/message-state-controller.ts",
-      "lineNumber": 35
+      "lineNumber": 36
     },
     "HeadingLevel": {
       "path": "src/lib/ai-chatbot/types.ts",
@@ -14831,87 +15229,99 @@
     },
     "StreamEvent": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 160
+      "lineNumber": 161
     },
     "ChatMessage": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 169
+      "lineNumber": 170
+    },
+    "ClientMessageKind": {
+      "path": "src/lib/ai-chatbot/types.ts",
+      "lineNumber": 192
+    },
+    "ClientMessageAction": {
+      "path": "src/lib/ai-chatbot/types.ts",
+      "lineNumber": 194
+    },
+    "ClientMessageInput": {
+      "path": "src/lib/ai-chatbot/types.ts",
+      "lineNumber": 204
     },
     "ToolCall": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 183
+      "lineNumber": 212
     },
     "ResponseItem": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 197
+      "lineNumber": 226
     },
     "FeedbackType": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 201
+      "lineNumber": 230
     },
     "ResponseFeedback": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 203
+      "lineNumber": 232
     },
     "AssistantResponse": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 208
+      "lineNumber": 237
     },
     "FileAttachment": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 217
+      "lineNumber": 247
     },
     "UploadedFileMetadata": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 230
+      "lineNumber": 260
     },
     "FileUploadCallbacks": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 238
+      "lineNumber": 268
     },
     "FileUploadHandler": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 245
+      "lineNumber": 275
     },
     "FileRemoveCallbacks": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 247
+      "lineNumber": 277
     },
     "MessageItem": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 269
+      "lineNumber": 299
     },
     "ThreadState": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 274
+      "lineNumber": 304
     },
     "ForgeAiChatbotConversationSelectEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 281
+      "lineNumber": 311
     },
     "ForgeAiChatbotConversationSearchEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 286
+      "lineNumber": 316
     },
     "ForgeAiChatbotConversationLoadMoreEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 291
+      "lineNumber": 321
     },
     "ForgeAiChatbotConversationRenameEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 296
+      "lineNumber": 326
     },
     "ForgeAiChatbotConversationDeleteEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 304
+      "lineNumber": 334
     },
     "ContextItem": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 311
+      "lineNumber": 341
     },
     "ForgeAiChatbotContextRemoveEventData": {
       "path": "src/lib/ai-chatbot/types.ts",
-      "lineNumber": 320
+      "lineNumber": 350
     },
     "LauncherViewState": {
       "path": "src/lib/ai-chatbot-launcher/ai-chatbot-launcher.ts",
@@ -14929,6 +15339,10 @@
       "path": "src/lib/ai-chatbot-launcher/ai-chatbot-launcher.ts",
       "lineNumber": 101
     },
+    "AiClientMessageComponent": {
+      "path": "src/lib/ai-client-message/ai-client-message.ts",
+      "lineNumber": 34
+    },
     "AiConfirmationPromptComponent": {
       "path": "src/lib/ai-confirmation-prompt/ai-confirmation-prompt.ts",
       "lineNumber": 27
@@ -15111,23 +15525,23 @@
     },
     "ForgeAiMessageThreadCopyEventData": {
       "path": "src/lib/ai-message-thread/ai-message-thread.ts",
-      "lineNumber": 37
+      "lineNumber": 38
     },
     "ForgeAiMessageThreadResendEventData": {
       "path": "src/lib/ai-message-thread/ai-message-thread.ts",
-      "lineNumber": 41
+      "lineNumber": 42
     },
     "ForgeAiMessageThreadThumbsEventData": {
       "path": "src/lib/ai-message-thread/ai-message-thread.ts",
-      "lineNumber": 45
+      "lineNumber": 46
     },
     "ForgeAiMessageThreadEditEventData": {
       "path": "src/lib/ai-message-thread/ai-message-thread.ts",
-      "lineNumber": 50
+      "lineNumber": 51
     },
     "AiMessageThreadComponent": {
       "path": "src/lib/ai-message-thread/ai-message-thread.ts",
-      "lineNumber": 80
+      "lineNumber": 81
     },
     "AiModalSizeStrategy": {
       "path": "src/lib/ai-modal/ai-modal.ts",
@@ -15343,15 +15757,15 @@
     },
     "ChatbotCoreCallbacks": {
       "path": "src/lib/core/chatbot-core-controller.ts",
-      "lineNumber": 31
+      "lineNumber": 34
     },
     "ChatbotCoreControllerConfig": {
       "path": "src/lib/core/chatbot-core-controller.ts",
-      "lineNumber": 37
+      "lineNumber": 40
     },
     "ChatbotCoreController": {
       "path": "src/lib/core/chatbot-core-controller.ts",
-      "lineNumber": 41
+      "lineNumber": 44
     },
     "DragControllerOptions": {
       "path": "src/lib/core/drag-controller.ts",