vanilla-agent 1.1.0 → 1.3.0

package/dist/index.d.cts

@@ -256,6 +256,22 @@ type AgentWidgetToolCall = {
     durationMs?: number;
 };
 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.
+ */
 type AgentWidgetMessage = {
     id: string;
     role: AgentWidgetMessageRole;
@@ -267,6 +283,7 @@ type AgentWidgetMessage = {
     reasoning?: AgentWidgetReasoning;
     toolCall?: AgentWidgetToolCall;
     tools?: AgentWidgetToolCall[];
+    viaVoice?: boolean;
 };
 type AgentWidgetEvent = {
     type: "message";
@@ -283,6 +300,7 @@ type AgentWidgetInitOptions = {
     config?: AgentWidgetConfig;
     useShadowDom?: boolean;
     onReady?: () => void;
+    windowKey?: string;
 };
 
 type Controller = {
@@ -292,6 +310,10 @@ type Controller = {
     close: () => void;
     toggle: () => void;
     clearChat: () => void;
+    setMessage: (message: string) => boolean;
+    submitMessage: (message?: string) => boolean;
+    startVoiceRecognition: () => boolean;
+    stopVoiceRecognition: () => boolean;
 };
 declare const createAgentExperience: (mount: HTMLElement, initialConfig?: AgentWidgetConfig) => Controller;
 type AgentWidgetController = Controller;
@@ -322,7 +344,9 @@ declare class AgentWidgetSession {
     getMessages(): AgentWidgetMessage[];
     getStatus(): AgentWidgetSessionStatus;
     isStreaming(): boolean;
-    sendMessage(rawInput: string): Promise<void>;
+    sendMessage(rawInput: string, options?: {
+        viaVoice?: boolean;
+    }): Promise<void>;
     cancel(): void;
     clearMessages(): void;
     private handleEvent;

package/dist/index.d.ts

@@ -256,6 +256,22 @@ type AgentWidgetToolCall = {
     durationMs?: number;
 };
 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.
+ */
 type AgentWidgetMessage = {
     id: string;
     role: AgentWidgetMessageRole;
@@ -267,6 +283,7 @@ type AgentWidgetMessage = {
     reasoning?: AgentWidgetReasoning;
     toolCall?: AgentWidgetToolCall;
     tools?: AgentWidgetToolCall[];
+    viaVoice?: boolean;
 };
 type AgentWidgetEvent = {
     type: "message";
@@ -283,6 +300,7 @@ type AgentWidgetInitOptions = {
     config?: AgentWidgetConfig;
     useShadowDom?: boolean;
     onReady?: () => void;
+    windowKey?: string;
 };
 
 type Controller = {
@@ -292,6 +310,10 @@ type Controller = {
     close: () => void;
     toggle: () => void;
     clearChat: () => void;
+    setMessage: (message: string) => boolean;
+    submitMessage: (message?: string) => boolean;
+    startVoiceRecognition: () => boolean;
+    stopVoiceRecognition: () => boolean;
 };
 declare const createAgentExperience: (mount: HTMLElement, initialConfig?: AgentWidgetConfig) => Controller;
 type AgentWidgetController = Controller;
@@ -322,7 +344,9 @@ declare class AgentWidgetSession {
     getMessages(): AgentWidgetMessage[];
     getStatus(): AgentWidgetSessionStatus;
     isStreaming(): boolean;
-    sendMessage(rawInput: string): Promise<void>;
+    sendMessage(rawInput: string, options?: {
+        viaVoice?: boolean;
+    }): Promise<void>;
     cancel(): void;
     clearMessages(): void;
     private handleEvent;