@talqing/mcp 0.3.2 → 0.3.4

package/SKILL.md

@@ -209,6 +209,10 @@ An agent is a single object, `config`, plus what you attach to it:
   Leaving it out resolves `name` against the team defined on the call that runs
   the agent, which publishes with a warning rather than an error.
 
+  One model cannot be handed off from at all: `openai/gpt-live-1` refuses new
+  instructions once a call is connected, so an agent with both that realtime
+  model and a handoff destination is refused on save. Every other model is fine.
+
   **`context` is what the next agent starts from** — the same three words an
   agent's own `conversation.context` uses for what a new *call* starts from.
 
@@ -294,10 +298,11 @@ it.
 
 ## Writing config
 
-`update_agent` and `create_agent` take the **whole** config, not a patch.
-Anything you leave out reverts to its default — omitting `tools` detaches
-every tool. Always read the current config first, apply your change to it, and
-send the result back.
+`create_agent` takes a whole config. `update_agent` takes only the fields you
+change: omitted fields are kept, an explicit `null` clears a field, objects
+merge key by key, and lists replace whole — to add one tool, send the complete
+`tools` list with it appended. Naming a new `provider` on `stt`, `tts` or `llm`
+starts that object over, so send its `voice` and settings with it. Unknown fields are refused, not ignored.
 
 The config is validated on every write. Unknown models, a model that does not
 support the channel, a language the model does not offer, a speed outside the
@@ -322,10 +327,11 @@ voice. Read it before choosing; do not assume a model exists.
 People can attach a photo to a web chat, a web voice call or a web video call,
 and the agent sees it. **There is no setting for this** — whether an agent can
 read images is decided by the model it runs, and `vision` on that model's catalog
-entry is where it says so. Every LLM entry today reads images; the two
-`grok-voice-*` realtime entries do not, and an agent on one of them cannot be
-sent a photo at all. If a user wants image input, check `vision` before picking
-the model rather than changing anything on the agent.
+entry is where it says so. Most entries read images; `gemini-3.8-flash`,
+`gemini-3.7-flash`, `openai/gpt-live-1` and the two `grok-voice-*` realtime
+entries do not, and an agent on one of them cannot be sent a photo at all. If a
+user wants image input, check `vision` before picking the model rather than
+changing anything on the agent.
 
 A phone call carries no files, so this is web only.
 
@@ -505,7 +511,7 @@ do not promise the user one — change the models or the language instead:
   Saaras endpoint on their own schedule and ignore that window entirely, so on
   those two the setting is a floor.
 - **Batch speech-to-text** (`streaming: false` — xAI `xai-stt-batch`, ElevenLabs
-  `scribe_v2`, OpenAI `gpt-4o-transcribe`) → it has no endpointer at all, so
+  `scribe_v2`, OpenAI `gpt-transcribe`) → it has no endpointer at all, so
   LiveKit's audio end-of-turn model takes over when `config.language` is one of
   the fourteen it was trained on: Arabic, Chinese, Dutch, English, French,
   German, Hindi, Indonesian, Italian, Japanese, Korean, Portuguese, Spanish,
@@ -1167,6 +1173,12 @@ collides with an output field name (one of the two would be unreachable); a
 those rows at draft time with `missing_vars` — one row, not the batch, and with
 no tokens spent. Flag blank cells in a required column before creating.
 
+**A row that can never be sent is never drafted.** If a mapped column the task
+does NOT write is blank (or `to` is not an address), the row is `skipped` with
+`skip_reason: "unfillable"` the moment the batch is created, and costs nothing.
+`skips.unfillable` counts them. Filling the cell in with
+`patch_email_batch_recipient` brings the row back to drafting.
+
 ### Two jobs, and a human between them
 
 **Drafting** starts on `start_at` (or immediately), runs `draft_concurrency` rows
@@ -1177,22 +1189,29 @@ the last row lands. It has no business-hours window: nobody receives a draft. It
 to review"*, never "finished": it says nothing about what has been sent.
 
 **Sending** is separate, only ever happens when a person asks, and is its own
-row. `create_email_send` takes `recipient_ids` or `selection: "all_drafts"` and
-returns a **send** you can steer:
-
+row. `create_email_send` takes a `scope` and returns a **send** you can steer:
+
+- `scope: "selected"` with `recipient_ids` sends exactly those rows.
+- `scope: "all"` is a standing send: every row of the batch as it finishes
+  drafting, including rows not drafted yet — so **it mails drafts nobody has
+  read**. Say so, and get an explicit yes, before creating one. It waits while
+  drafting runs (`next_send_reason: "drafting"`) and ends once drafting has and
+  every draft has gone. It cannot be live beside any other send of the batch —
+  that is a 409 naming the live send.
 - `start_at` schedules it, `window` (on its own `timezone`) holds it to business
-  hours, `send_gap_seconds` is the minimum wait between two emails (1 second to
-  1 hour) and `send_daily_cap` bounds how many may leave per local day. Anything
-  omitted comes from the batch.
+  hours, `send_gap_seconds` is the minimum wait between two emails of the
+  **batch** (1 second to 1 hour) and `send_daily_cap` bounds how many the batch
+  may send per local day. Anything omitted comes from the batch.
+- A draft a live send covers reads `queued`, and is still a draft: it can be
+  edited, skipped or redrafted until the send takes it.
 - `pause_email_send` stops on the next email; `resume_email_send` carries on.
-- `cancel_email_send` gives **every unsent row back as a draft**, ready for
-  another send. It is also the ONLY way to change what a scheduled send
-  contains: a send's rows are fixed when it is created, and there is no verb for
-  pulling rows out of one.
+- `cancel_email_send` ends it; its unsent rows are simply drafts again. A send's
+  scope never changes, so cancel and create another to change what it covers.
 - `get_email_send` carries `next_send_at` and `next_send_reason` (`start`,
-  `window`, `daily_cap`, `retry`, `gap`), which is how "waiting for Monday" is
-  told apart from "stuck". `patch_email_send` reaches a live send within five
-  minutes, so raising a spent cap or removing a window needs no cancel.
+  `window`, `daily_cap`, `retry`, `gap`, `drafting`), which is how "waiting for
+  Monday" is told apart from "stuck". `patch_email_send` reaches a live send
+  within five minutes, so raising a spent cap or removing a window needs no
+  cancel.
 
 **The safeguard here is a RATE, not a row count.** `send_daily_cap` (200 by
 default, per batch, `null` for uncapped) is what stands between a 5 000-row list
@@ -1224,7 +1243,9 @@ action that revives a batch that already finished drafting. Its `selection` is
 task wrote them), `not_sent`, or `all` — which names every row it refuses.
 **Each redrafted row runs the task again and is billed again**, so say the row
 count before running `all`. A person's edited cells survive unless
-`clear_overrides` is set.
+`clear_overrides` is set. A `queued` row is redrafted too, and its send takes
+the new draft. Read `draft_failures` before redrafting `failed`: a task that
+declined a row on purpose will most likely decline it again.
 
 **One address is mailed at most once per batch**, enforced when the row is
 claimed for sending: the second row settles `skipped` with
@@ -1233,9 +1254,12 @@ ours — Resend keeps one and auto-suppresses hard bounces and complaints.
 
 ### Watching it
 
-`get_email_batch` carries live counts, `failure_reason`, `sent_today` (against
-`send_daily_cap`), `drafted_versions`, `stale_redraftable` and the drafting cost
-so far.
+`get_email_batch` carries live counts, `skips` (why rows were skipped),
+`draft_failures` (why drafts failed, most common first), `failure_reason`,
+`sent_today` (against `send_daily_cap`), `drafted_versions`,
+`stale_redraftable` / `stale_sent` and the drafting cost so far. Measure
+progress against what can be reached: `unfillable` rows are never drafted, and
+skipped, failed or cancelled rows are never sent.
 
 **Stopping itself comes in two shapes, and they need different advice.** Ten
 consecutive failures **pause** a batch or a send: everything is where it was and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talqing/mcp",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "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",
@@ -17,7 +17,7 @@
   ],
   "type": "module",
   "bin": {
-    "talqing-mcp": "./dist/index.js"
+    "talqing-mcp": "dist/index.js"
   },
   "files": [
     "dist",

package/tools.json

@@ -45,7 +45,7 @@
       "role": "read"
     },
     {
-      "description": "Replace the agent's draft config with the one supplied.",
+      "description": "Update the agent's draft config. Send only the fields to change.",
       "method": "PATCH",
       "name": "update_agent",
       "parameters": {
@@ -311,7 +311,7 @@
       "role": "read"
     },
     {
-      "description": "Replace the task's draft config with the one supplied.",
+      "description": "Update the task's draft config. Send only the fields to change.",
       "method": "PATCH",
       "name": "update_task",
       "parameters": {
@@ -1319,7 +1319,7 @@
       "role": "write"
     },
     {
-      "description": "Put skipped rows back. `selection: \"all_eligible\"` means every skipped row.",
+      "description": "Put skipped rows back. `selection: \"all_eligible\"` means every row a person skipped; an `unfillable` row is restored by filling in its cell instead.",
       "method": "POST",
       "name": "restore_email_batch_recipients",
       "parameters": {
@@ -1347,7 +1347,7 @@
       "role": "write"
     },
     {
-      "description": "Send these rows. **This mails real people and cannot be undone.**",
+      "description": "Send rows. **This mails real people and cannot be undone.**",
       "method": "POST",
       "name": "create_email_send",
       "parameters": {
@@ -1403,7 +1403,7 @@
       "role": "write"
     },
     {
-      "description": "Stop sending. It takes hold on the next email, and nothing is lost \u2014 the rows stay queued for whenever you resume.",
+      "description": "Stop sending. It takes hold on the next email, and nothing is lost \u2014 the rows stay queued, and editable, until you resume.",
       "method": "POST",
       "name": "pause_email_send",
       "parameters": {
@@ -1431,7 +1431,7 @@
       "role": "write"
     },
     {
-      "description": "Stop this send, and give every row it has not sent back as a draft.",
+      "description": "Stop this send for good. Every row it has not sent stays a draft, exactly as it was, ready for another send \u2014 not a destructive action.",
       "method": "POST",
       "name": "cancel_email_send",
       "parameters": {
@@ -1823,7 +1823,7 @@
       "role": "read"
     },
     {
-      "description": "Search the language models a provider offers too many of to list.",
+      "description": "Search the models a provider offers too many of to list.",
       "method": "GET",
       "name": "search_models",
       "parameters": {
@@ -1836,6 +1836,20 @@
       "read_only": true,
       "role": "read"
     },
+    {
+      "description": "The hosts that can serve one OpenRouter language model; fastest first when the workspace has an OpenRouter key. Each `host` is a valid entry for `llm.hosts`.",
+      "method": "GET",
+      "name": "list_model_hosts",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('list_model_hosts').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/catalog/models/hosts",
+      "read_only": true,
+      "role": "read"
+    },
     {
       "description": "The Anam avatar gallery \u2014 the faces a video agent can wear.",
       "method": "GET",