vanilla-agent 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vanilla-agent",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Themeable, plugable streaming agent widget for websites, in plain JS with support for voice input and reasoning / tool output.",
   "type": "module",
   "main": "dist/index.cjs",

package/src/session.ts

@@ -60,7 +60,7 @@ export class AgentWidgetSession {
     return this.streaming;
   }
 
-  public async sendMessage(rawInput: string) {
+  public async sendMessage(rawInput: string, options?: { viaVoice?: boolean }) {
     const input = rawInput.trim();
     if (!input) return;
 
@@ -71,7 +71,8 @@ export class AgentWidgetSession {
       role: "user",
       content: input,
       createdAt: new Date().toISOString(),
-      sequence: this.nextSequence()
+      sequence: this.nextSequence(),
+      viaVoice: options?.viaVoice || false
     };
 
     this.appendMessage(userMessage);

package/src/types.ts

@@ -193,6 +193,22 @@ export type AgentWidgetToolCall = {
 
 export type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool";
 
+/**
+ * Represents a message in the chat conversation.
+ * 
+ * @property id - Unique message identifier
+ * @property role - Message role: "user", "assistant", or "system"
+ * @property content - Message text content
+ * @property createdAt - ISO timestamp when message was created
+ * @property streaming - Whether message is still streaming (for assistant messages)
+ * @property variant - Message variant for assistant messages: "assistant", "reasoning", or "tool"
+ * @property sequence - Message ordering number
+ * @property reasoning - Reasoning data for assistant reasoning messages
+ * @property toolCall - Tool call data for assistant tool messages
+ * @property tools - Array of tool calls
+ * @property viaVoice - Set to `true` when a user message is sent via voice recognition.
+ *                      Useful for implementing voice-specific behaviors like auto-reactivation.
+ */
 export type AgentWidgetMessage = {
   id: string;
   role: AgentWidgetMessageRole;
@@ -204,6 +220,7 @@ export type AgentWidgetMessage = {
   reasoning?: AgentWidgetReasoning;
   toolCall?: AgentWidgetToolCall;
   tools?: AgentWidgetToolCall[];
+  viaVoice?: boolean;
 };
 
 export type AgentWidgetEvent =

package/src/ui.ts

@@ -469,7 +469,7 @@ export const createAgentExperience = (
           if (finalValue && speechRecognition && isRecording) {
             stopVoiceRecognition();
             textarea.value = "";
-            session.sendMessage(finalValue);
+            session.sendMessage(finalValue, { viaVoice: true });
           }
         }, pauseDuration);
       }
@@ -488,7 +488,7 @@ export const createAgentExperience = (
         const finalValue = textarea.value.trim();
         if (finalValue && finalValue !== initialText.trim()) {
           textarea.value = "";
-          session.sendMessage(finalValue);
+          session.sendMessage(finalValue, { viaVoice: true });
         }
         stopVoiceRecognition();
       }