vanilla-agent 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vanilla-agent",
-  "version": "1.1.0",
+  "version": "1.2.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/types.ts

@@ -216,4 +216,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 => {
@@ -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();