fixes, more handoff

Author: arthurchi93

fern/docs.yml

@@ -321,8 +321,11 @@ navigation:
                 path: squads/examples/property-management.mdx
               - page: Multilingual support
                 path: squads/examples/multilingual-support.mdx
-              - page: Silent transfers
-                path: squads/silent-transfers.mdx
+              - page: Handoff tools
+                path: tools/handoff.mdx
+                icon: fa-light fa-hand-holding-hand
+              - page: Silent handoffs
+                path: squads/silent-handoffs.mdx
                 icon: fa-light fa-arrow-right-arrow-left
 
       - section: Best practices

fern/squads.mdx

@@ -94,7 +94,7 @@ To override the configuration of a saved assistant without modifying the underly
 }
 ```
 
-You may also define inline tools via assistant overrides through the `model` object (using `tools:append`), so that the assistant will only handoff if it is a part of this squad.
+You may also define inline tools via assistantOverrides through the `tools:append` array, so that the assistant will only handoff if it is a part of this squad.
 ```json
 {
     "squad": {
@@ -111,22 +111,18 @@ You may also define inline tools via assistant overrides through the `model` obj
             {
                 "assistantId": "saved-assistant-id",
                 "assistantOverrides": {
-                    "model": {
-                        "provider": "openai",
-                        "model": "gpt-4o",
-                        "tools:append": [
-                            {
-                                "type": "handoff",
-                                "destinations": [
-                                    {
-                                        "type": "assistant",
-                                        "assistantId": "assistant-123",
-                                        "description": "Call this tool when the customer wants to talk about pricing"
-                                    }
-                                ]
-                            }
-                        ]
-                    },
+                    "tools:append": [
+                        {
+                            "type": "handoff",
+                            "destinations": [
+                                {
+                                    "type": "assistant",
+                                    "assistantId": "assistant-123",
+                                    "description": "Call this tool when the customer wants to talk about pricing"
+                                }
+                            ]
+                        }
+                    ]
                 }
             },
         ]

fern/squads/examples/clinic-triage-scheduling.mdx

@@ -35,8 +35,6 @@ Compose multiple assistants into a Squad for safe, specialized healthcare flows:
 - From Triage → Scheduler for routine care
 - Warm-transfer with a short summary for human escalation
 
-See: [Silent transfers](/squads/silent-transfers).
-
 ## 3. Implement
 
 <Tabs>

fern/squads/examples/multilingual-support.mdx

@@ -12,7 +12,7 @@ Provide structured multilingual support using a Squad: present a short language
 **Squad Capabilities:**
 * Explicit language choice for clarity
 * Language‑specific prompts and voices
-* Seamless transfers while preserving context
+* Seamless handoffs while preserving context
 
 ## 1. Define members