Merge branch 'main' into update-openapi-spec-2025-08-22T00-26-07-644Z

Author: goosewin

fern/apis/api/openapi.json

@@ -31,6 +31,13 @@
   border: 1px solid #C7D2FE;
 }
 
+/* Optional: Squad badge (reuse assistant palette for now) */
+.vapi-badge-squad {
+  background-color: #EEF2FF;
+  color: #4338CA;
+  border: 1px solid #C7D2FE;
+}
+
 /* Dark mode adjustments */
 :is(.dark) .vapi-badge-assistant {
   background-color: #134E4A;
@@ -44,6 +51,12 @@
   border: 1px solid #6366F1;
 }
 
+:is(.dark) .vapi-badge-squad {
+  background-color: #312E81;
+  color: #C7D2FE;
+  border: 1px solid #6366F1;
+}
+
 /* for a grid of videos */
 
 .video-grid {
@@ -220,4 +233,4 @@ html.dark button[data-highlighted] .fern-api-property-meta {
 
 .light .fern-theme-default.fern-container {
   background-color: #fff !important;
-}
+}

fern/assets/styles.css

@@ -15,7 +15,7 @@ Supported events include:
 - `customer.speech.interrupted`: When the customer's speech is interrupted
 - `customer.speech.timeout`: When the customer doesn't speak within a specified time
 
-You can combine actions and add filters to control when hooks trigger.
+You can combine actions and add filters to control when hooks trigger. Multiple `customer.speech.timeout` hooks can be attached to an assistant with staggered trigger delay to support different actions at different timing in the conversation.
 
 ## How hooks work
 
@@ -145,6 +145,10 @@ Perform multiple actions—say a message, call a function, and transfer the call
   }]
 }
 ```
+ 
+<Note>
+Use `"oneOf": ["pipeline-error"]` as a catch-all filter for any pipeline-related error reason.
+</Note>
 
 ## Example: Handle speech interruptions
 
@@ -205,9 +209,73 @@ The `customer.speech.timeout` hook supports special options:
 - `triggerResetMode`: Whether to reset the trigger count when user speaks (default: "never")
 </Note>
 
-<Note>
-Use `"oneOf": ["pipeline-error"]` as a catch-all filter for any pipeline-related error reason.
-</Note>
+## Example: End call if user hasn't spoken for 30s
+
+Assistant checks with the user at the 10 and 20s mark from when the user is silent, and ends the call after 30s of silence. 
+
+```json
+{
+  "hooks": [
+    {
+      "hooks": [
+        {
+          "on": "customer.speech.timeout",
+          "options": {
+            "timeoutSeconds": 10,
+            "triggerMaxCount": 3,
+            "triggerResetMode": "onUserSpeech"
+          },
+          "do": [
+            {
+              "type": "say",
+              "exact": "Are you still there? Please let me know how I can help you."
+            }
+          ]
+        },
+        {
+          "on": "customer.speech.timeout",
+          "options": {
+            "timeoutSeconds": 20,
+            "triggerMaxCount": 3,
+            "triggerResetMode": "onUserSpeech"
+          },
+          "do": [
+            {
+              "type": "say",
+              "prompt": "The user has not responded in 20s. Based on the above conversation in {{transcript}} ask the user if they need help or if not you will be ending the call"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "hooks": [
+        {
+          "on": "customer.speech.timeout",
+          "options": {
+            "timeoutSeconds": 30,
+            "triggerMaxCount": 3,
+            "triggerResetMode": "onUserSpeech"
+          },
+          "do": [
+            {
+              "type" : "say",
+              "exact" : "I'll be ending the call now, please feel free to call back at any time."
+            },
+            {
+              "type": "tool",
+              "tool": {
+                "type": "endCall"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
 
 ## Common use cases