vanilla-agent 1.1.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vanilla-agent",
-  "version": "1.1.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/runtime/init.ts

@@ -116,7 +116,7 @@ export const initAgentWidget = (
   let controller = createAgentExperience(mount, options.config);
   options.onReady?.();
 
-  return {
+  const handle: AgentWidgetInitHandle = {
     host,
     update(nextConfig: AgentWidgetConfig) {
       controller.update(nextConfig);
@@ -133,9 +133,32 @@ export const initAgentWidget = (
     clearChat() {
       controller.clearChat();
     },
+    setMessage(message: string) {
+      return controller.setMessage(message);
+    },
+    submitMessage(message?: string) {
+      return controller.submitMessage(message);
+    },
+    startVoiceRecognition() {
+      return controller.startVoiceRecognition();
+    },
+    stopVoiceRecognition() {
+      return controller.stopVoiceRecognition();
+    },
     destroy() {
       controller.destroy();
       host.remove();
+      // Clean up window reference if it was set
+      if (options.windowKey && typeof window !== 'undefined') {
+        delete (window as any)[options.windowKey];
+      }
     }
   };
+
+  // Store on window if windowKey is provided
+  if (options.windowKey && typeof window !== 'undefined') {
+    (window as any)[options.windowKey] = handle;
+  }
+
+  return handle;
 };

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 =
@@ -216,4 +233,5 @@ export type AgentWidgetInitOptions = {
   config?: AgentWidgetConfig;
   useShadowDom?: boolean;
   onReady?: () => void;
+  windowKey?: string; // If provided, stores the controller on window[windowKey] for global access
 };

package/src/ui.ts

@@ -23,6 +23,10 @@ type Controller = {
   close: () => void;
   toggle: () => void;
   clearChat: () => void;
+  setMessage: (message: string) => boolean;
+  submitMessage: (message?: string) => boolean;
+  startVoiceRecognition: () => boolean;
+  stopVoiceRecognition: () => boolean;
 };
 
 const buildPostprocessor = (cfg?: AgentWidgetConfig): MessageTransform => {
@@ -465,7 +469,7 @@ export const createAgentExperience = (
           if (finalValue && speechRecognition && isRecording) {
             stopVoiceRecognition();
             textarea.value = "";
-            session.sendMessage(finalValue);
+            session.sendMessage(finalValue, { viaVoice: true });
           }
         }, pauseDuration);
       }
@@ -484,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();
       }
@@ -1596,6 +1600,55 @@ export const createAgentExperience = (
       });
       window.dispatchEvent(clearEvent);
     },
+    setMessage(message: string): boolean {
+      if (!textarea) return false;
+      if (session.isStreaming()) return false;
+      
+      // Auto-open widget if closed and launcher is enabled
+      if (!open && launcherEnabled) {
+        setOpenState(true);
+      }
+      
+      textarea.value = message;
+      // Trigger input event for any listeners
+      textarea.dispatchEvent(new Event('input', { bubbles: true }));
+      return true;
+    },
+    submitMessage(message?: string): boolean {
+      if (session.isStreaming()) return false;
+      
+      const valueToSubmit = message?.trim() || textarea.value.trim();
+      if (!valueToSubmit) return false;
+      
+      // Auto-open widget if closed and launcher is enabled
+      if (!open && launcherEnabled) {
+        setOpenState(true);
+      }
+      
+      textarea.value = "";
+      session.sendMessage(valueToSubmit);
+      return true;
+    },
+    startVoiceRecognition(): boolean {
+      if (isRecording || session.isStreaming()) return false;
+      
+      const SpeechRecognitionClass = getSpeechRecognitionClass();
+      if (!SpeechRecognitionClass) return false;
+      
+      // Auto-open widget if closed and launcher is enabled
+      if (!open && launcherEnabled) {
+        setOpenState(true);
+      }
+      
+      startVoiceRecognition();
+      return true;
+    },
+    stopVoiceRecognition(): boolean {
+      if (!isRecording) return false;
+      
+      stopVoiceRecognition();
+      return true;
+    },
     destroy() {
       destroyCallbacks.forEach((cb) => cb());
       wrapper.remove();