Update Python Server SDK tech docs

.claude/rules/mdx-reference-pages.md

@@ -8,9 +8,9 @@ paths:
 Applies wherever an interface is documented: SWML methods, SDK reference, Call Flow Builder nodes, cXML verbs, param-bearing snippets.
 
 - One page per symbol, terse and lookup-oriented (~50–80 lines): intro sentence → optional `Note`/`Warning` → params → returns/variables → examples.
-- Section names are bolded verbatim: `## **Parameters**` (functions/methods), `## **Properties**` (data objects), `## **Returns**`, `## **Variables**` (SWML methods that set any), `## **Examples**`.
+- Section names are plain headings, verbatim: `## Parameters` (functions/methods), `## Properties` (data objects), `## Returns`, `## Variables` (SWML methods that set any), `## Examples`. Don't bold them — Fern renders headings identically either way, and most existing pages still carry the old `## **Parameters**` form; leave those as they are unless you're already rewriting the page.
 - One `<ParamField>` per element, in source order. `path` = bare name for function args, dot-notation for object keys (`answer.max_duration`); nest children in `<Indent>` (blank lines inside). Types in the language's own terms (`str` for Python, `string` for SWML/JSON).
-- XML elements (cXML verbs): the heading is `## Attributes` — unbolded, the one exception — with the bare attribute name as `path`. Callbacks/events: `## **Parameters**` with the handler as the param, its payload fields documented inline beneath it.
+- XML elements (cXML verbs): the heading is `## Attributes`, with the bare attribute name as `path`. Callbacks/events: `## Parameters` with the handler as the param, its payload fields documented inline beneath it.
 - `required={true}` only on required params — never `required={false}`. `default` only when the source defines one. `toc={true}` on reference params.
 - SWML method pages: every example in both YAML and JSON inside `<CodeBlocks>`.
 - Server SDK reference: mirror the SDK's own naming and types per language — verify against source, and sync any edit across every language variant of the page.

fern/docs.yml

@@ -502,6 +502,14 @@ redirects:
   - source: /docs/server-sdks/reference/typescript/agents/swml-service/on-request
     destination: /docs/server-sdks/reference/typescript/agents/swml-service/set-on-request-callback
 
+  # The Python SDK removed its Twilio-compatibility REST namespace
+  # (`client.compat`, signalwire-python 3d08c96); the pages that documented it
+  # are gone. Send old URLs to the Python REST overview.
+  - source: /docs/server-sdks/reference/python/rest/compat
+    destination: /docs/server-sdks/reference/python/rest
+  - source: /docs/server-sdks/reference/python/rest/compat/:slug*
+    destination: /docs/server-sdks/reference/python/rest
+
   # The prompt writing techniques guide duplicated the prompt engineering
   # overview; the additive parts were merged into it and the page removed.
   - source: /docs/platform/ai/prompt-engineering/best-practices

fern/products/server-sdks/pages/guides/build-ai-agents/builtin-skills.mdx

@@ -418,8 +418,8 @@ Search SignalWire DataSphere documents.
 | Parameter | Type | Description | Default |
 |-----------|------|-------------|---------|
 | `space_name` | string | DataSphere space name | Required |
-| `project_id` | string | Project ID (falls back to `SIGNALWIRE_PROJECT_ID`) | Required |
-| `token` | string | API token (falls back to `SIGNALWIRE_TOKEN`) | Required |
+| `project_id` | string | Project ID | Required |
+| `token` | string | API token | Required |
 | `document_id` | string | Document ID to search within | Required |
 | `tool_name` | string | Custom function name | "search_knowledge" |
 | `count` | integer | Results to return (1-10) | 1 |

fern/products/server-sdks/pages/guides/build-ai-agents/results-actions.mdx

@@ -116,7 +116,7 @@ FunctionResult CheckOrder(Dictionary<string, object> args, Dictionary<string, ob
 
 | Component | Description |
 |-----------|-------------|
-| `response` | Text the AI will speak to the caller |
+| `response` | A prompt injected into the model's context. Write it as an instruction ("Tell the caller..."); the model decides what to say |
 | `action` | List of actions to execute (transfers, SMS, context changes, etc.) |
 | `post_process` | If `True`, AI speaks once more before actions execute (useful for confirmations) |
 
@@ -129,7 +129,7 @@ def transfer_to_support(self, args, raw_data):
     department = args.get("department", "support")
 
     return (
-        FunctionResult("I'll transfer you now")
+        FunctionResult("Tell the caller you're transferring them now.")
         .connect("+15551234567", final=True)
     )
 ```
@@ -893,15 +893,15 @@ Some actions end the call or AI session. Once a terminal action executes, subseq
 ```python
 # Good - data saved before transfer
 return (
-    FunctionResult("Transferring you now")
+    FunctionResult("Tell the caller you're transferring them now.")
     .update_global_data({"transferred": True})  # Executes
     .send_sms(to_number=phone, body="...")      # Executes
     .connect("+15551234567", final=True)        # Terminal
 )
 
 # Risky - SMS might not send
 return (
-    FunctionResult("Transferring you now")
+    FunctionResult("Tell the caller you're transferring them now.")
     .connect("+15551234567", final=True)        # Terminal - call leaves
     .send_sms(to_number=phone, body="...")      # May not execute
 )
@@ -926,7 +926,7 @@ When `post_process=True`, the AI speaks the response and can respond to follow-u
 ```python
 return (
     FunctionResult(
-        "I'll transfer you. Anything else first?",
+        "Tell the caller you'll transfer them, and ask if there's anything else first.",
         post_process=True  # AI waits for response
     )
     .connect("+15551234567", final=True)  # Executes after AI finishes