@talqing/mcp 0.11.0 → 0.12.1

package/SKILL.md

@@ -37,8 +37,10 @@ An agent is a single object, `config`, plus what you attach to it:
 - **`prompt`** — the system prompt. This is where the agent's behaviour lives.
 - **`greeting`** — the line spoken on connect, and on the way in from a
   handoff. Voice and video only. `greeting_interruptible: false` makes the
-  caller unable to cut it off (cascade only); a greeting speaking the recording
-  notice is always protected.
+  caller unable to cut it off (cascade only). To tell callers they are recorded,
+  set `recording.notice` to the sentence and put `{{recording.notice}}` in the
+  greeting where it should be spoken; it plays uninterruptibly, needs recording
+  on and a cascade pipeline, and `null` means no notice.
 
   Both are personalized per session: `{{userdata.field}}` is substituted from
   the session's userdata when the agent starts, so *"You are speaking with
@@ -55,22 +57,28 @@ An agent is a single object, `config`, plus what you attach to it:
   Two more roots are filled in from outside the session, and nothing inside one
   can write either. They differ in who fills them.
 
-  **`{{system_vars.…}}` — ours.** Six keys, and any other is rejected at save;
-  `GET /v1/catalog` returns them as `system_vars`.
-
-  - `{{system_vars.human_phone_number}}` — the other party, the caller inbound
-    and the person you called outbound
-  - `{{system_vars.agent_phone_number}}` — your number on this call
-  - `{{system_vars.direction}}` — `inbound` or `outbound`
+  **`{{system_vars.…}}` — ours.** Seven keys, and any other is rejected at save;
+  `GET /v1/catalog` returns them as `system_vars`, each with the `channels` it
+  has a value on.
+
+  - `{{system_vars.human_phone_number}}` — the person's number: who called or
+    wrote to you, or whom you called or wrote to
+  - `{{system_vars.agent_phone_number}}` — your number in this session
+  - `{{system_vars.direction}}` — `inbound` when they started the call or chat,
+    `outbound` when you did
+  - `{{system_vars.channel}}` — where the session is happening: `phone_call`,
+    `whatsapp_call`, `whatsapp_message`, `web_call`, `chat`, `telegram` or `stream`
   - `{{system_vars.now}}` — `2026-08-19T19:26:59+05:30`, the machine format;
     send it to an API, never read it aloud
   - `{{system_vars.date}}` — `Wednesday, 19 August 2026`
   - `{{system_vars.time}}` — `7:26 PM`
 
-  The first three come from the call, so they are empty on web calls and on text
-  conversations — do not make one the only source of a fact the agent needs. One
+  The first three come from a phone number — phone calls, WhatsApp calls,
+  WhatsApp chats and media streams — so they are empty on web calls, API chats
+  and Telegram; do not make one the only source of a fact the agent needs. One
   agent can greet a caller and someone it called differently by branching on
-  `{{system_vars.direction}}`. The last three come from the agent's
+  `{{system_vars.direction}}`, and one agent on several channels can adapt by
+  branching on `{{system_vars.channel}}`. The last three come from the agent's
   **`timezone`** and work on every channel; using one without setting `timezone`
   is a save error. In a prompt or greeting the clock is frozen at the moment the
   agent started (re-resolving would throw away the model's prompt cache); inside
@@ -107,8 +115,9 @@ An agent is a single object, `config`, plus what you attach to it:
   Four things to get right:
 
   - **They are visible to the model.** Anything in `vars` may be read aloud or
-    repeated back. A credential belongs in a workspace secret, read as
-    `{{secrets.NAME}}` from a tool, where the model never sees it.
+    repeated back. A credential belongs in `secrets` on the same request when it
+    is per session, or in a workspace secret when it is shared — either is read
+    as `{{secrets.NAME}}` from a tool, where the model never sees it.
   - **`required: true` refuses the session** that supplies no value for a
     variable with no `default` — the call token, the dial, the batch and the chat,
     before anything is compiled and before any provider is called.
@@ -649,17 +658,21 @@ states what to add; do not try to turn the derived silence off.
 this tool run's own state, `{{userdata.field}}` the session's state,
 `{{system_vars.field}}` what the platform knows about this session,
 `{{vars.field}}` what the tenant supplied for it, and `{{secrets.NAME}}` a
-workspace secret. A string that is exactly one template token keeps the resolved
-value's type. Every one of these works in a URL, in the query, in the body **and
-in headers**. A token whose root is not one of those six is an error at save,
-not text.
-
-`system_vars` is read-only, and its six keys are the same ones the agent's prompt
-reads: `human_phone_number`, `agent_phone_number`, `direction`, `now`, `date`,
-`time`. So a tool can POST the caller's number to a CRM, stamp a record with
-`{{system_vars.now}}`, or branch an `if` on the direction without the agent
-having to ask. The phone-call keys are empty on web calls, on text conversations
-and in a dashboard test run; the clock keys resolve wherever the agent has a
+secret — the session's own if it brought one of that name, else the workspace's.
+A string that is exactly one template token keeps the resolved value's type.
+Every one of these works in a URL, in the query, in the body **and in headers**.
+A token whose root is not one of those six is an error at save, not text.
+**A secret may only be sent by an `http` operation or read by a `code`
+operation**: `{{secrets.…}}` in any other operation (`say`, `set_variable`,
+`if`, `frontend_rpc`, `generate_reply`, a handoff…) is refused at save, because
+it would be spoken, shown or stored.
+
+`system_vars` is read-only, and its seven keys are the same ones the agent's prompt
+reads: `human_phone_number`, `agent_phone_number`, `direction`, `channel`, `now`,
+`date`, `time`. So a tool can POST the person's number to a CRM, stamp a record
+with `{{system_vars.now}}`, or branch an `if` on the direction or the channel
+without the agent having to ask. The phone keys are empty on web calls, API chats,
+Telegram and in a dashboard test run; the clock keys resolve wherever the agent has a
 `timezone`, and read the time the **tool ran** rather than the time the call
 started.
 
@@ -916,7 +929,7 @@ message, draft an opening line, take a shipping address mid-call.
   reads `{{vars.name}}` for the values the run was given, and
   `{{system_vars.now}}` / `.date` / `.time` when `timezone` is set. It does
   **not** read `{{system_vars.human_phone_number}}` / `.agent_phone_number` /
-  `.direction` — there is no call.
+  `.direction` / `.channel` — there is no session.
 - **`llm`** — one model, with the same `fallback`, `reasoning_effort`,
   `priority` and `builtin_tools` an agent's LLM has. A provider tool runs inside
   a step rather than as one, so it costs no steps and real seconds. It is the
@@ -1054,14 +1067,16 @@ rest — it never refuses for load. `run_task_batch` queues up to 1000 runs of o
 call, all or nothing: one invalid item refuses the batch, naming `runs[i]`. Give
 each run `metadata` (≤16 string labels, e.g. `{candidate_id: "c_42"}`) and an
 `idempotency_key`: resending a key returns the existing run (`deduplicated`)
-instead of starting another, and the same key with a different request is a
-`409`. Read results with `list_task_runs` (filter by `task_id`, `status`,
-`metadata=key:value`, a creation window) and `get_task_run`, or subscribe a
-webhook to `task_run.completed`, sent once per run as it finishes.
+instead of starting another — even after the task was republished — and the same
+key with a different request is a `409`. Read results with `list_task_runs`
+(filter by `task_id`, `status`, `metadata=key:value`, a creation window) and
+`get_task_run`, or subscribe a webhook to `task_run.completed`, sent once per run
+as it finishes.
 
 **Retries.** A background run is tried again — at most 3 tries — when its
 worker stopped under it, or when the model provider failed transiently before
-any tool ran, so a side-effecting tool never runs twice. Everything else settles
+any tool ran. A worker stop retries from the start, so a side-effecting tool
+can repeat. Everything else settles
 on the first try. `tries` says how many there were; cost adds up across them.
 
 `cancel_task_run` stops a queued run at once and a running background one
@@ -1440,8 +1455,8 @@ a ramp.
   messaged. Cold outreach breaks WhatsApp's policy and risks their number.
 - **US numbers never receive marketing templates**, and Meta caps the marketing
   templates any one person receives.
-- **You cannot send it.** `send_whatsapp_batch` and `resume_whatsapp_batch` are
-  a person's to press, on the batch page. Create the batch, point them at it.
+- **`send_whatsapp_batch` messages every row and cannot be undone.** Send, or
+  resume a paused batch, only on an explicit yes for this batch.
 - **`add_whatsapp_batch_recipients` on a sending or completed batch messages
   the new rows at once**, with nobody pressing anything. Get an explicit yes.
 
@@ -1450,11 +1465,48 @@ Replies are answered by the agent on the sender's
 `{{userdata.<column>}}` and the whole template, buttons included, as its own
 first message — so write that agent's prompt against the CSV's column names.
 
+A tapped quick-reply button reaches the agent as its text; the item's `content`
+keeps the button's `payload` (never shown to the agent) and `replied_to`, the
+`provider_message_id` of the template message it answers. Photos reach an
+agent whose model has `vision: true`; any
+other agent is told to ask for a description, so pick a vision model for a
+number people send photos to. Voice notes, video and documents are not read.
+
+**One message to one person** is `create_conversation_item`, not a batch. `to`
+is a `conversation_id`, or `number` (your WhatsApp sender, E.164) plus `peer`
+(their number) to reach someone with no conversation yet. Four `type`s:
+
+- `template` — an approved template with every variable filled
+  (`template.variables`); may go any time.
+- `agent_text` — free text sent as the agent's own message.
+- `note` — background for the agent, never delivered (any contact, PSTN ones too).
+- `instruct` — the agent writes and sends the next message itself, in the
+  conversation's language, without ever saying it was instructed. Refused with
+  `voice_session_live` while they are on a call with the agent.
+
+WhatsApp allows free text only within **24 hours of their last message or
+call** (`ref.whatsapp_window_expires_at`). Outside it `agent_text` and
+`instruct` are refused with `whatsapp_window_closed`, unless
+`on_window_closed: {opener: {id, variables}}` names a template to send first:
+the text is then `held` until they reply, and `expired` after 7 days. Prefer an
+opener over a bare template when what you want to say is free-form.
+`userdata` on a post joins the contact's and is what the agent answering their
+reply starts from. Send an `idempotency_key` when retrying is possible. A
+provider refusal still stores the item, `delivery_status: failed` (nothing resends it). While
+they have an open chat, post anything but a note into that chat's conversation:
+another one is refused with `chat_open_elsewhere`.
+
 ## Secrets, keys and webhooks
 
 **Secrets** are workspace values referenced as `{{secrets.NAME}}` from tool
 operations and integration config. They are write-only: once stored, only the
-runtime resolves them.
+runtime resolves them. A session can also bring its own, as `secrets` on the
+request that starts it; for that session they join the workspace's under the
+same `{{secrets.NAME}}`, the session's value winning. A tool that reads a name
+that is not a workspace secret saves with a warning, and starting a session
+without supplying it is refused — an inbound call or chat, which has no
+request, gets one only from the inbound webhook below. Integration and carrier
+credentials and MCP server headers must be workspace secrets.
 
 **BYOK.** Talqing runs agents on the workspace's own provider API keys and has
 none of its own. `list_provider_keys` says which providers are configured, and
@@ -1465,7 +1517,21 @@ there, tell them the key has to be added before the agent can publish.
 
 **Webhooks** are workspace-wide and fire for every agent. `event_types` lists
 what can be subscribed to, and `webhook_deliveries` is where to look when one
-seems silent.
+seems silent. `session.refused` fires for every inbound call or channel chat
+turned away before an agent ran.
+
+**The inbound webhook** is how an inbound PSTN call, WhatsApp call or new
+WhatsApp/Telegram chat gets what an outbound request would carry. An agent with
+`inbound_webhook: true` has Talqing POST `session.request` (channel, numbers,
+`contact_key`, the opening message) to the workspace's one URL
+(`set_inbound_webhook`) before the session starts; the answer may set `vars`,
+`secrets`, `agent_override`, `metadata` and `userdata`, each meaning what it
+means on `create_outbound_call`. No valid answer within 3 s **refuses the
+session** (`inbound_webhook_failed`, reason in `error`), so publishing such an
+agent needs the webhook set, and `test_inbound_webhook` checks a reply before
+real callers depend on it. A chat asks once, when it opens. `metadata` — the
+caller's own labels — appears on the call or chat and filters `list_calls` and
+`list_chats` (`metadata=key:value`).
 
 ## Running an agent, and reading what happened
 
@@ -1488,9 +1554,14 @@ every agent the session runs and is gone when the session ends. Use `userdata`
 for facts about the person and `vars` for configuration of the session; unlike
 `userdata`, `vars` is never written onto the caller's contact record and no tool
 can change it mid-session. An empty string is a deliberate blank, not a request
-for the default. The model can see the values, so credentials stay in workspace
-secrets. On a batch it is one bag for the whole campaign, copied onto every call
-it places — per-person data is what a recipient's `userdata` is for.
+for the default. The model can see the values, so credentials go in secrets. On
+a batch it is one bag for the whole campaign, copied onto every call it places —
+per-person data is what a recipient's `userdata` is for.
+
+All three (not batches) also take `secrets`, `{NAME: value}`: credentials for
+that one session, read by its tools as `{{secrets.NAME}}` and never shown to the
+model or returned. A web call's `resume_call` keeps them, and its own `secrets`
+adds or replaces.
 
 **Per-call configuration.** All three — and `create_call_batch` — also take four
 fields that change what runs on that one call:
@@ -1537,7 +1608,13 @@ rather than as two messages. The agent's model must have `vision` (see *Images*
 above) or the call is refused naming the model.
 
 **Reading it back.** A *conversation* is the thread with a person, on any
-surface; a *call* is one voice or video session. `list_conversations` and
+surface; a *call* is one voice or video session. A person is one **contact**
+(`contact_key`) per business number: `phone:<your number>:<their number>` spans
+phone calls, WhatsApp messages and WhatsApp calls on that number, with one
+`userdata`. Which thread a session writes to is the answering agent's
+`conversation.context` (`transcript` joins their newest thread), except that a
+WhatsApp call always joins their open WhatsApp chat. Every item carries the
+`channel` it arrived on. `list_conversations` and
 `list_conversation_items` are the transcript; `list_conversation_sessions` lists
 its calls and chats, and `get_chat` gives one chat's cost and analysis.
 `list_calls` and `get_call` cover phone and web calls — `get_call` gives the transcript with every tool call and
@@ -1549,6 +1626,13 @@ What a run costs is the provider spend on the workspace's own keys plus
 Talqing's platform fee, which `get_catalog` gives: per minute on voice and
 video, and $0.0001 per answered message on text.
 
+Items posted through `create_conversation_item` carry `post_type` and the
+`author` you gave (shown to people, never to the agent or the contact). Notes and
+instructions have no `channel`. Outbound WhatsApp and Telegram messages move
+through `delivery_status` (`queued`, `sent`, `delivered`, `read`, or
+`undelivered`/`failed` with `delivery_error`), and each move fires the
+`conversation.item.status` webhook.
+
 When an agent misbehaves, read the actual run before theorizing. The transcript
 and the final `userdata` usually name the cause.
 

package/dist/index.js

@@ -97,13 +97,19 @@ async function call(name, args) {
         return failure(`unknown function: ${name}`);
     let response;
     try {
-        response = await fetch(requestFor(fn, args));
+        // Not followed: the recordings redirect to the media itself, which is no
+        // use as a tool result. The model gets the short-lived link instead.
+        response = await fetch(requestFor(fn, args), { redirect: "manual" });
     }
     catch (error) {
         // A bad argument (missing path parameter) and an unreachable API both land
         // here; either way the model gets a readable error in the API's own shape.
         return failure(error instanceof Error ? error.message : String(error));
     }
+    const location = response.headers.get("location");
+    if (response.status >= 300 && response.status < 400 && location) {
+        return { content: [{ type: "text", text: JSON.stringify({ url: location }) }] };
+    }
     const text = await response.text();
     if (!response.ok) {
         // Errors already carry {detail: {message, errors}} — pass them through so

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talqing/mcp",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "MCP server for building Talqing AI voice, video and text agents from Claude Code, Codex, or any MCP client.",
   "license": "MIT",
   "homepage": "https://talqing.com",

package/tools.json

@@ -2,6 +2,20 @@
   "api_prefix": "/v1",
   "api_version": "1.0.0",
   "tools": [
+    {
+      "description": "Liveness probe: `200` once this process is serving. Unauthenticated.",
+      "method": "GET",
+      "name": "health",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('health').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/health",
+      "read_only": true,
+      "role": "public"
+    },
     {
       "description": "List the workspace's agents, newest edit first.",
       "method": "GET",
@@ -1192,6 +1206,20 @@
       "read_only": false,
       "role": "write"
     },
+    {
+      "description": "Delete a finished batch and its recipient list for good. Its calls stay.",
+      "method": "DELETE",
+      "name": "delete_call_batch",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('delete_call_batch').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/calls/batches/{batch_id}",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "The domains a connected email account may send from, right now.",
       "method": "GET",
@@ -1304,6 +1332,20 @@
       "read_only": false,
       "role": "write"
     },
+    {
+      "description": "Delete a batch, its rows and its sends for good. **The record of what was sent goes too.**",
+      "method": "DELETE",
+      "name": "delete_email_batch",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('delete_email_batch').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/email/batches/{batch_id}",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "One batch's rows, in the order they were uploaded.",
       "method": "GET",
@@ -1486,6 +1528,20 @@
       "read_only": true,
       "role": "read"
     },
+    {
+      "description": "List the WhatsApp senders on a Twilio account, before connecting one. Stores nothing.",
+      "method": "POST",
+      "name": "list_twilio_whatsapp_senders",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('list_twilio_whatsapp_senders').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/whatsapp/twilio-senders",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "Create a WhatsApp batch: one approved template, sent once per CSV row. Sends nothing yet.",
       "method": "POST",
@@ -1542,6 +1598,20 @@
       "read_only": false,
       "role": "write"
     },
+    {
+      "description": "Send every ready row. **This messages real people and cannot be undone.**",
+      "method": "POST",
+      "name": "send_whatsapp_batch",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('send_whatsapp_batch').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/whatsapp/batches/{batch_id}/send",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "Stop sending before the next message. Nothing is lost.",
       "method": "POST",
@@ -1556,6 +1626,20 @@
       "read_only": false,
       "role": "write"
     },
+    {
+      "description": "Carry on sending from where the batch stopped.",
+      "method": "POST",
+      "name": "resume_whatsapp_batch",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('resume_whatsapp_batch').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/whatsapp/batches/{batch_id}/resume",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "Stop for good. Messages already sent stay sent, and replies are still answered.",
       "method": "POST",
@@ -1570,6 +1654,20 @@
       "read_only": false,
       "role": "write"
     },
+    {
+      "description": "Delete a batch and its rows for good. A live batch must be canceled first.",
+      "method": "DELETE",
+      "name": "delete_whatsapp_batch",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('delete_whatsapp_batch').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/whatsapp/batches/{batch_id}",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "A batch's rows in upload order, each with its rendered message.",
       "method": "GET",
@@ -1780,6 +1878,34 @@
       "read_only": false,
       "role": "write"
     },
+    {
+      "description": "Mint a one-hour browser token for this chat. Mint another to refresh.",
+      "method": "POST",
+      "name": "create_chat_token",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('create_chat_token').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/chats/{chat_id}/token",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Erase an ended chat's content; the chat and its cost stay. Cannot be undone.",
+      "method": "DELETE",
+      "name": "delete_chat",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('delete_chat').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/chats/{chat_id}",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "List voice and video calls, newest first, with status, duration and cost.",
       "method": "GET",
@@ -1822,6 +1948,62 @@
       "read_only": true,
       "role": "read"
     },
+    {
+      "description": "Erase this call's content. The call itself stays, with its cost.",
+      "method": "DELETE",
+      "name": "delete_call",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('delete_call').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/calls/{session_id}",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Redirect to the call's audio: one stereo Ogg/Opus file.",
+      "method": "GET",
+      "name": "get_call_recording",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('get_call_recording').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/calls/{session_id}/recording",
+      "read_only": true,
+      "role": "read"
+    },
+    {
+      "description": "Redirect to the screen the person shared: one 1 fps H.264 file.",
+      "method": "GET",
+      "name": "get_call_screen_recording",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('get_call_screen_recording').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/calls/{session_id}/screen-recording",
+      "read_only": true,
+      "role": "read"
+    },
+    {
+      "description": "Delete the call's recorded media, keeping the call itself.",
+      "method": "DELETE",
+      "name": "delete_call_recording",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('delete_call_recording').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/calls/{session_id}/recording",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "Try an analysis definition against one past call and see what it finds.",
       "method": "POST",
@@ -1920,6 +2102,20 @@
       "read_only": true,
       "role": "read"
     },
+    {
+      "description": "What the platform did during this conversation's sessions, oldest first.",
+      "method": "GET",
+      "name": "list_conversation_trace",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('list_conversation_trace').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/conversations/{conversation_id}/trace",
+      "read_only": true,
+      "role": "read"
+    },
     {
       "description": "Edit a conversation's summary, userdata or metadata.",
       "method": "PATCH",
@@ -1934,6 +2130,76 @@
       "read_only": false,
       "role": "write"
     },
+    {
+      "description": "Erase a conversation: every session's content, its items, and the contact once it has no other conversations. Cannot be undone.",
+      "method": "DELETE",
+      "name": "delete_conversation",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('delete_conversation').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/conversations/{conversation_id}",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Post a template, agent text, note or instruction into a conversation, or start one with a person.",
+      "method": "POST",
+      "name": "create_conversation_item",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('create_conversation_item').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/conversations/items",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Say something to AgentCoPilot. The reply arrives on the stream, not here.",
+      "method": "POST",
+      "name": "agent_copilot_send_message",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('agent_copilot_send_message').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/copilot/agents/{agent_id}/messages",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Say something to ToolCoPilot. The reply arrives on the stream, not here.",
+      "method": "POST",
+      "name": "tool_copilot_send_message",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('tool_copilot_send_message').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/copilot/tools/{tool_id}/messages",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Say something to TaskCoPilot. The reply arrives on the stream, not here.",
+      "method": "POST",
+      "name": "task_copilot_send_message",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('task_copilot_send_message').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/copilot/tasks/{task_id}/messages",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "Workspace analytics: volume, endings, recordings, response time and spend. One snapshot of a date range, up to 7 days.",
       "method": "GET",
@@ -1948,6 +2214,90 @@
       "read_only": true,
       "role": "read"
     },
+    {
+      "description": "This workspace's credit balance, what it buys, and what a top-up costs.",
+      "method": "GET",
+      "name": "get_credits",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('get_credits').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/billing/credits",
+      "read_only": true,
+      "role": "read"
+    },
+    {
+      "description": "Every movement of this workspace's balance, newest first, with what caused each.",
+      "method": "GET",
+      "name": "list_credit_ledger",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('list_credit_ledger').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/billing/credits/ledger",
+      "read_only": true,
+      "role": "read"
+    },
+    {
+      "description": "Start a credit purchase and return the hosted checkout URL to open.",
+      "method": "POST",
+      "name": "create_credit_checkout",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('create_credit_checkout').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/billing/credits/checkout",
+      "read_only": false,
+      "role": "admin"
+    },
+    {
+      "description": "List personal access tokens: your own, or every one in the organization if you are an admin.",
+      "method": "GET",
+      "name": "list_tokens",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('list_tokens').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/tokens",
+      "read_only": true,
+      "role": "read"
+    },
+    {
+      "description": "Create a personal access token for driving this API without the dashboard.",
+      "method": "POST",
+      "name": "create_token",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('create_token').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/tokens",
+      "read_only": false,
+      "role": "read"
+    },
+    {
+      "description": "Revoke a token immediately and permanently.",
+      "method": "DELETE",
+      "name": "delete_token",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('delete_token').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/tokens/{token_id}",
+      "read_only": false,
+      "role": "read"
+    },
     {
       "description": "List the workspace's secrets by name, with a masked hint of each value.",
       "method": "GET",
@@ -2102,6 +2452,76 @@
       "read_only": true,
       "role": "read"
     },
+    {
+      "description": "Get the workspace's inbound session webhook.",
+      "method": "GET",
+      "name": "get_inbound_webhook",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('get_inbound_webhook').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/inbound-webhook",
+      "read_only": true,
+      "role": "read"
+    },
+    {
+      "description": "Set the URL asked for an inbound session's configuration.",
+      "method": "PUT",
+      "name": "set_inbound_webhook",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('set_inbound_webhook').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/inbound-webhook",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Remove the inbound session webhook.",
+      "method": "DELETE",
+      "name": "delete_inbound_webhook",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('delete_inbound_webhook').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/inbound-webhook",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Issue a new signing secret; the old one stops working at once.",
+      "method": "POST",
+      "name": "rotate_inbound_webhook_secret",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('rotate_inbound_webhook_secret').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/inbound-webhook/rotate-secret",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Send a sample request and check the reply against the response schema.",
+      "method": "POST",
+      "name": "test_inbound_webhook",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('test_inbound_webhook').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/inbound-webhook/test",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "The provider catalog: every LLM, STT, TTS, realtime and avatar model that agents may use.",
       "method": "GET",