Update TypeScript Server SDK tech docs

fern/docs.yml

@@ -496,12 +496,26 @@ redirects:
   - source: /docs/browser-sdk/click-to-call/:slug*
     destination: /docs/browser-sdk/v3/click-to-call/:slug*
 
+  # The TypeScript SDK removed the Twilio-compatible LAML REST namespace
+  # (client.compat); point its old reference pages at the REST client overview.
+  - source: /docs/server-sdks/reference/typescript/rest/compat
+    destination: /docs/server-sdks/reference/typescript/rest
+  - source: /docs/server-sdks/reference/typescript/rest/compat/:slug*
+    destination: /docs/server-sdks/reference/typescript/rest
+
   # The SWMLService `onRequest` override hook is now protected (renamed
   # `buildSwmlForRequest`) and no longer documented; point its old page URL at
   # the public equivalent, `setOnRequestCallback`.
   - source: /docs/server-sdks/reference/typescript/agents/swml-service/on-request
     destination: /docs/server-sdks/reference/typescript/agents/swml-service/set-on-request-callback
 
+  # SwmlBuilder getDocument()/renderDocument() were removed from the SDK in
+  # favor of the Python-parity names build()/render().
+  - source: /docs/server-sdks/reference/typescript/agents/swml-builder/get-document
+    destination: /docs/server-sdks/reference/typescript/agents/swml-builder/build
+  - source: /docs/server-sdks/reference/typescript/agents/swml-builder/render-document
+    destination: /docs/server-sdks/reference/typescript/agents/swml-builder/render
+
   # 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.

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

@@ -284,15 +284,15 @@ Tell jokes to lighten the mood or entertain callers. Uses a curated joke databas
 
 **Functions:**
 
-- `tell_joke` - Get a random joke
+- `get_joke` - Get a random joke. Takes a required `type` argument, `jokes` or `dadjokes`
 
 **Requirements:** None
 
 **Parameters:**
 
 | Parameter | Type | Description | Default |
 |-----------|------|-------------|---------|
-| `tool_name` | string | Custom function name | "tell_joke" |
+| `tool_name` | string | Custom function name | "get_joke" |
 
 ```python
 from signalwire import AgentBase
@@ -323,22 +323,13 @@ Play audio files in the background during calls. Audio plays while conversation
 
 **Parameters:**
 
-This skill supports two configuration styles:
-
-- **Catalog mode** — preload named files via `files`, caller selects by `key`:
+Preload named files via `files`; the caller selects one by `key`:
 
 | Parameter | Type | Description | Default |
 |-----------|------|-------------|---------|
 | `tool_name` | string | Custom play function name | "play_background_file" |
 | `files` | array | List of `{ key, description, url, wait? }` entries | Required |
 
-- **Free-form mode** — caller supplies a URL at call time (gated by `allowed_domains`):
-
-| Parameter | Type | Description | Default |
-|-----------|------|-------------|---------|
-| `default_file_url` | string | URL played when no argument is provided | Required |
-| `allowed_domains` | array | Whitelisted domains for caller-supplied URLs | Required |
-
 **Supported formats:** MP3, WAV, OGG
 
 ```python
@@ -570,9 +561,6 @@ Validate addresses and compute driving routes using Google Maps. Supports geocod
 | `api_key` | string | Google Maps API key (falls back to `GOOGLE_MAPS_API_KEY`) | Required |
 | `lookup_tool_name` | string | Address lookup function name | "lookup_address" |
 | `route_tool_name` | string | Route computation function name | "compute_route" |
-| `geocode_tool_name` | string | Reverse-geocoding function name | "geocode_address" |
-| `route_by_coords_tool_name` | string | Coord-based route function name | "compute_route_by_coords" |
-| `default_mode` | string | `"driving"`, `"walking"`, `"bicycling"`, or `"transit"` | "driving" |
 
 ```python
 from signalwire import AgentBase

fern/products/server-sdks/pages/guides/deploy/docker-kubernetes.mdx

@@ -36,7 +36,7 @@ CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "3000", "--workers", "
 </Tab>
 <Tab title="TypeScript">
 ```dockerfile
-FROM node:20-slim
+FROM node:22-slim
 
 WORKDIR /app
 

fern/products/server-sdks/pages/guides/deploy/serverless.mdx

@@ -414,7 +414,7 @@ gcloud functions deploy signalwire-agent \
 ## TypeScript (Node.js)
 gcloud functions deploy signalwire-agent \
   --gen2 \
-  --runtime nodejs20 \
+  --runtime nodejs22 \
   --trigger-http \
   --allow-unauthenticated \
   --entry-point main \

fern/products/server-sdks/pages/guides/getting-started/installation.mdx

@@ -10,7 +10,7 @@ max-toc-depth: 3
 | Language | Runtime | Package Manager | OS |
 |----------|---------|-----------------|-----|
 | Python | 3.10+ | pip | Linux, macOS, Windows |
-| TypeScript | Node.js 18+ | npm | Linux, macOS, Windows |
+| TypeScript | Node.js 22+ | npm | Linux, macOS, Windows |
 {/*
 | Go | 1.21+ | go modules | Linux, macOS, Windows |
 | Ruby | 3.0+ | gem/bundler | Linux, macOS, Windows |
@@ -36,7 +36,7 @@ npm install @signalwire/sdk
 ```
 
 <Note>
-`@signalwire/sdk` is published as an ES module only (no CommonJS build). Your project must use ESM — add `"type": "module"` to your `package.json`, use `.mjs` file extensions, or use a bundler/transpiler that supports ESM. `import` syntax works; `require('@signalwire/sdk')` does not work in Node older than 22 without the `--experimental-require-module` flag.
+`@signalwire/sdk` is published as an ES module only (no CommonJS build). Your project must use ESM — add `"type": "module"` to your `package.json`, use `.mjs` file extensions, or use a bundler/transpiler that supports ESM. Import it with `import` syntax.
 </Note>
 </Tab>
 </Tabs>

fern/products/server-sdks/pages/guides/getting-started/overview.mdx

@@ -87,7 +87,7 @@ Before starting, ensure you have the following:
 | Language | Requirement | Package Manager |
 |----------|-------------|-----------------|
 | Python | 3.10+ | pip |
-| TypeScript | Node.js 18+ | npm |
+| TypeScript | Node.js 22+ | npm |
 {/*
 | Go | 1.21+ | go modules |
 | Ruby | 3.0+ | gem/bundler |

fern/products/server-sdks/pages/guides/manage-resources/overview.mdx

@@ -559,6 +559,15 @@ client = RestClient(request_options=RequestOptions(timeout=10.0, retries=3))
 numbers = client.phone_numbers.list(request_options=RequestOptions(timeout=60.0))
 ```
 
+In TypeScript, every list resource has a `paginate()` method that returns an
+async iterator over all pages:
+
+```typescript
+for await (const number of client.phoneNumbers.paginate()) {
+  console.log(number.name, number.number);
+}
+```
+
 ### Error Handling
 
 REST errors raise `SignalWireRestError`. A request that never reaches the server

fern/products/server-sdks/pages/reference/python/agents/bedrock-agent/index.mdx

@@ -6,8 +6,8 @@ max-toc-depth: 3
 ---
 
 [agentbase]: /docs/server-sdks/reference/python/agents/agent-base
-[amazon-bedrock]: /docs/swml/reference/amazon-bedrock
-[swml-bedrock-reference]: /docs/swml/reference/amazon-bedrock
+[amazon-bedrock]: /docs/swml/reference/calling/amazon-bedrock
+[swml-bedrock-reference]: /docs/swml/reference/calling/amazon-bedrock
 [setvoice]: /docs/server-sdks/reference/python/agents/bedrock-agent/set-voice
 [setinferenceparams]: /docs/server-sdks/reference/python/agents/bedrock-agent/set-inference-params
 
@@ -72,7 +72,7 @@ full specification.
   </Card>
 </CardGroup>
 
-## **Overridden Behavior**
+## **Overridden behavior**
 
 BedrockAgent overrides several AgentBase methods to adapt for the Bedrock
 voice-to-voice model:

fern/products/server-sdks/pages/reference/python/agents/cli/swaig-test.mdx

@@ -40,7 +40,7 @@ Choose one action per invocation:
   after the function name.
 </ParamField>
 
-## Common Options
+## Common options
 
 <ParamField path="-v, --verbose" type="flag" toc={true}>
   Enable verbose output with debug information, including raw result types and
@@ -62,7 +62,7 @@ Choose one action per invocation:
   Mutually exclusive with `--agent-class`.
 </ParamField>
 
-## Function Execution Options
+## Function execution options
 
 <ParamField path="--minimal" type="flag" toc={true}>
   Use minimal `post_data` containing only the function arguments. This is the default behavior.
@@ -77,7 +77,7 @@ Choose one action per invocation:
   JSON string with custom `post_data` overrides merged into the request payload.
 </ParamField>
 
-## SWML Generation Options
+## SWML generation options
 
 <ParamField path="--call-type" type="string" default="webrtc" toc={true}>
   Simulated call type. Valid values:
@@ -103,7 +103,7 @@ Choose one action per invocation:
   Override the destination/to extension in mock data.
 </ParamField>
 
-## Data Customization
+## Data customization
 
 <ParamField path="--user-vars" type="string" toc={true}>
   JSON string injected as `userVariables` in the mock request. Used to test
@@ -124,7 +124,7 @@ Choose one action per invocation:
   Can be specified multiple times.
 </ParamField>
 
-## Serverless Simulation
+## Serverless simulation
 
 <ParamField path="--simulate-serverless" type="string" toc={true}>
   Simulate a serverless platform environment. Valid values:
@@ -146,7 +146,7 @@ Choose one action per invocation:
   Load environment variables from a file (one `KEY=VALUE` per line).
 </ParamField>
 
-### Platform-Specific Options
+### Platform-specific options
 
 Run `swaig-test agent.py --help-platforms` for the full list. Key options per platform:
 
@@ -158,7 +158,7 @@ Run `swaig-test agent.py --help-platforms` for the full list. Key options per pl
 
 **Azure**: `--azure-env`, `--azure-function-url`
 
-## Extended Help
+## Extended help
 
 <ParamField path="--help-platforms" type="flag" toc={true}>
   Show detailed documentation for all serverless platform options.
@@ -176,7 +176,7 @@ Run `swaig-test agent.py --help-platforms` for the full list. Key options per pl
 
 ## Examples
 
-### List Tools and Generate SWML
+### List tools and generate SWML
 
 ```bash
 # List all registered SWAIG functions
@@ -192,7 +192,7 @@ swaig-test agent.py --dump-swml --raw | jq '.'
 swaig-test agent.py --dump-swml --raw | jq '.sections.main[1].ai.SWAIG.functions'
 ```
 
-### Execute Functions
+### Execute functions
 
 ```bash
 # Execute with CLI-style arguments
@@ -212,7 +212,7 @@ Arguments are automatically type-converted: numeric values become integers or
 floats, `true`/`false` become booleans, and everything else stays as a string.
 </Tip>
 
-### Multi-Agent Files
+### Multi-agent files
 
 ```bash
 # Discover agents in the file
@@ -225,7 +225,7 @@ swaig-test multi_agent.py --agent-class SalesAgent --list-tools
 swaig-test multi_agent.py --route /support --exec create_ticket --issue "Login problem"
 ```
 
-### Dynamic Agent Testing
+### Dynamic agent testing
 
 ```bash
 # Test with query parameters
@@ -238,7 +238,7 @@ swaig-test dynamic_agent.py --dump-swml \
   --user-vars '{"preferences":{"language":"es"}}'
 ```
 
-### Serverless Simulation
+### Serverless simulation
 
 ```bash
 # AWS Lambda
@@ -265,7 +265,7 @@ swaig-test agent.py --simulate-serverless lambda \
   --exec my_function
 ```
 
-## Exit Codes
+## Exit codes
 
 | Code | Meaning |
 |------|---------|

fern/products/server-sdks/pages/reference/typescript/agents/agent-base/add-function-include.mdx

@@ -5,8 +5,8 @@ description: Add a remote function include to the SWAIG configuration.
 max-toc-depth: 3
 ---
 
-[ai-swaig-includes]: /docs/swml/reference/ai/swaig/includes
-[swml-swaig-includes-reference]: /docs/swml/reference/ai/swaig/includes
+[ai-swaig-includes]: /docs/swml/reference/calling/ai/swaig/includes
+[swml-swaig-includes-reference]: /docs/swml/reference/calling/ai/swaig/includes
 [ref-agentbase]: /docs/server-sdks/reference/typescript/agents/agent-base
 
 Add a remote SWAIG function include so the agent can call tools hosted on an external

fern/products/server-sdks/pages/reference/typescript/agents/agent-base/add-language.mdx

@@ -5,8 +5,8 @@ description: Add a language configuration with voice settings for multilingual c
 max-toc-depth: 3
 ---
 
-[ai-languages]: /docs/swml/reference/ai/languages
-[swml-languages-reference]: /docs/swml/reference/ai/languages
+[ai-languages]: /docs/swml/reference/calling/ai/languages
+[swml-languages-reference]: /docs/swml/reference/calling/ai/languages
 [ref-agentbase]: /docs/server-sdks/reference/typescript/agents/agent-base
 
 Add a language configuration with voice settings. The agent uses these configurations

fern/products/server-sdks/pages/reference/typescript/agents/agent-base/add-skill-by-name.mdx

@@ -14,8 +14,10 @@ Look up a skill class by name in the global
 
 ## **Parameters**
 
-<ParamField path="skillName" type="string" required={true} toc={true}>
-  Registered skill name (read from the target class's `SKILL_NAME`).
+<ParamField path="skillName" type="SkillNameOrString" required={true} toc={true}>
+  Registered skill name (read from the target class's `SKILL_NAME`). The
+  `SkillName` union lists the 19 built-in names for editor autocompletion; any
+  other string resolves against skills you registered yourself.
 </ParamField>
 
 <ParamField path="params" type="SkillConfig" toc={true}>

fern/products/server-sdks/pages/reference/typescript/agents/agent-base/as-router.mdx

@@ -16,8 +16,10 @@ None.
 
 ## **Returns**
 
-`Hono` -- A Hono app with all agent endpoints (SWML delivery, SWAIG function
-handling, post-prompt, debug events, health checks, etc.).
+`HostAppRouter` -- The agent's Hono app, with all agent endpoints (SWML
+delivery, SWAIG function handling, post-prompt, debug events, health checks,
+etc.). `HostAppRouter` is a type alias for `Hono`, named for the host-app
+mounting contract it fulfills.
 
 ## **Example**
 

fern/products/server-sdks/pages/reference/typescript/agents/agent-base/define-tool.mdx

@@ -5,10 +5,12 @@ description: Programmatically define a SWAIG tool that the AI can invoke during
 max-toc-depth: 3
 ---
 
-[swaig-function]: /docs/swml/reference/ai/swaig/functions
-[swml-swaig-functions-reference]: /docs/swml/reference/ai/swaig/functions
+[swaig-function]: /docs/swml/reference/calling/ai/swaig/functions
+[swml-swaig-functions-reference]: /docs/swml/reference/calling/ai/swaig/functions
 [functionresult]: /docs/server-sdks/reference/typescript/agents/function-result
 [ref-agentbase]: /docs/server-sdks/reference/typescript/agents/agent-base
+[parameter-schema]: /docs/server-sdks/reference/typescript/agents/parameter-schema
+[on-error]: /docs/server-sdks/reference/typescript/agents/agent-base/on-error
 
 Programmatically define a SWAIG function (tool) that the AI can invoke during a
 conversation.
@@ -42,19 +44,25 @@ instead.
   when to call the tool.
 </ParamField>
 
-<ParamField path="opts.parameters" type={"Record<string, unknown>"} toc={true}>
-  JSON Schema describing the tool's parameters. The AI generates arguments
-  conforming to this schema.
+<ParamField path="opts.parameters" type="ToolParameters" toc={true}>
+  JSON Schema describing the tool's parameters. Write it either as a flat map of
+  property name to schema (`{ city: { type: 'string' } }`) or as a wrapped
+  object schema (`{ type: 'object', properties: { ... } }`). With the flat form
+  the handler's `args` is typed from the schema, so `args.city` is a `string`
+  and an `enum` narrows to its literal union. You can also build the schema
+  with [`paramSchema()`][parameter-schema].
 </ParamField>
 
 <ParamField path="opts.handler" type="SwaigHandler" required={true} toc={true}>
   Callback invoked when the AI calls this tool. Receives
-  `(args: Record<string, unknown>, rawData: Record<string, unknown>)` and should
-  return a [`FunctionResult`][functionresult].
+  `(args, rawData: SwaigRequest)` and returns a [`FunctionResult`][functionresult],
+  a plain object, or a string.
 </ParamField>
 
-<ParamField path="opts.secure" type="boolean" default="false" toc={true}>
-  Whether to require token validation on tool calls. Recommended for production.
+<ParamField path="opts.secure" type="boolean" default="true" toc={true}>
+  Whether to require token validation on tool calls. Tools are secure by
+  default: the rendered webhook URL carries a per-tool token. Pass `false` only
+  to expose the tool on the shared, unauthenticated webhook URL.
 </ParamField>
 
 <ParamField path="opts.fillers" type={"Record<string, string[]>"} toc={true}>
@@ -84,6 +92,19 @@ instead.
   Additional fields merged into the SWAIG function definition. Equivalent to
   Python's `**swaig_fields` kwargs (e.g., `meta_data`).
 </ParamField>
+
+<ParamField path="opts.onError" type="SwaigErrorHandler" toc={true}>
+  Per-tool error hook, called when the handler throws. Return a
+  [`FunctionResult`][functionresult] to control what the caller hears, or
+  nothing to fall back to `errorMessage`. Runs before the agent-level
+  [`onError()`][on-error] hook.
+</ParamField>
+
+<ParamField path="opts.errorMessage" type="string" toc={true}>
+  Message spoken to the caller when the handler throws and no error hook
+  supplies a response. Defaults to a generic apology asking the caller to try
+  again.
+</ParamField>
 </Indent>
 
 ## **Returns**