@talqing/mcp 0.13.2 → 0.15.0

package/SKILL.md

@@ -376,18 +376,20 @@ states what each entry supports: which channels, its language codes and default
 language, whether it accepts a speed and within what range, and its default
 voice. Read it before choosing; do not assume a model exists.
 
-### Images
+### Images and files
 
-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. 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.
+People can send files on WhatsApp (Twilio senders) and in a web chat, and a photo
+on a web voice or video call. Every file is stored on the conversation; photos,
+PDFs and Word (`.docx`) files are also read by the agent, and anything else
+(voice notes, videos, spreadsheets) is named to it as something it cannot open.
+**There is no setting for this.** Whether the agent sees a photo or a scanned
+PDF page is decided by the model it runs: `vision` on its catalog entry. 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 — such an agent is told it
+cannot view the image. Text PDFs and Word files are read on any model. If a user
+wants image input, check `vision` before picking the model.
 
-A phone call carries no files, so this is web only.
+A phone call carries no files.
 
 ### Vision input (screen share)
 
@@ -613,6 +615,9 @@ A tool is one capability the agent's LLM can call mid-conversation. It has:
   to get it out of the conversation, and a bare `{"type": "string"}` is how a
   tool ends up called with the wrong value. Mark the ones the tool cannot run
   without as `required`, and use an `enum` wherever the set of values is closed.
+  A **File** parameter is `{"type": "string", "format": "attachment"}`: the agent
+  passes the id of a file the person sent, and the operation reads
+  `{{args.<name>.url}}` (a link that lives an hour) and `.filename`, `.mime_type`.
 - **`long_running_task`** — voice and video agents keep talking while it runs and
   share the result when it lands; a run finishing within a second answers inline
   instead. Text agents wait either way. There is no fixed line — steer it from
@@ -1286,9 +1291,22 @@ recordings and cost.
 
 ## Email outbound
 
-To email a *list* rather than one person, create an **email batch**: a CSV, an
-agent task that drafts each row, a connected Resend account, and a mapping that
-says which column carries the address, the subject and the body.
+To email a *list* rather than one person, create an **email batch**: a CSV, a
+connected Resend account, and one of two writers for the emails:
+
+- **A template** — `template: {to, subject, body}`, the same email for every
+  row. `to` names the address column; `{{column}}` in the subject or body takes
+  that row's cell (bare column names, no `vars.` prefix), HTML-escaped when
+  `body_format` is `html`. No task, no drafting, no cost: the batch is created
+  `drafted` and every row is ready to review at once. A row whose placeholder
+  cell is blank is `draft_failed` ("first_name is empty") until the cell is
+  filled with `patch_email_batch_recipient`. Before creating one, offer
+  `send_test_email` — it mails the filled template to the signed-in user only.
+- **An agent task** — `task_id` + `field_map`, when each email should be
+  written for its row (research, personalization). The rest of this section
+  is mostly about this kind.
+
+Pick the template when the wording is fixed and only names/fields change.
 
 **Four things to say before creating one.** A user who discovers any of them
 afterwards will not forgive us:
@@ -1298,7 +1316,7 @@ afterwards will not forgive us:
   opted in. This runs on *their* Resend account under *their* agreement.
 - **Creating a batch only drafts.** Nothing is sent until someone creates a
   send — and a send of every row mails drafts nobody reviewed.
-- **Every row runs the task's CURRENT PUBLISHED version**, re-read as drafting
+- **In a task batch, every row runs the task's CURRENT PUBLISHED version**, re-read as drafting
   goes, so publishing mid-batch changes every row drafted after that moment. Which version
   wrote which rows is on the batch as `drafted_versions`, and
   `redraft_email_batch_recipients` with `selection: "stale_version"` is how the
@@ -1620,11 +1638,10 @@ then is it analysed and its `session.completed` sent, so end the chats you start
 On Telegram and WhatsApp a person's messages join one chat until it ends; the
 next starts a new one.
 
-A message can carry `images`: up to four `{data_url, filename}` entries beside
-`message`, each a base64 `data:image/...` URL of a JPEG, PNG or WebP under 10 MB.
-The caption and the photo arrive as one turn and one item, so send them together
-rather than as two messages. The agent's model must have `vision` (see *Images*
-above) or the call is refused naming the model.
+A message can carry `files`: up to four `{data_url, filename}` entries beside
+`message`, each a base64 `data:` URL of any type up to 20 MB. The caption and the
+file arrive as one turn and one item, so send them together rather than as two
+messages. See *Images and files* above for what the agent reads.
 
 **Reading it back.** A *conversation* is the thread with a person, on any
 surface; a *call* is one voice or video session. A person is one **contact**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talqing/mcp",
-  "version": "0.13.2",
+  "version": "0.15.0",
   "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

@@ -1998,7 +1998,28 @@
       "role": "read"
     },
     {
-      "description": "Create an email batch: a list, an agent task that drafts each row, and a connected Resend account to send from.",
+      "description": "Fill a template from `vars` and email it to yourself (the signed-in user) only.",
+      "method": "POST",
+      "name": "send_test_email",
+      "parameters": {
+        "additionalProperties": false,
+        "description": "Arguments not inlined: call describe_function('send_test_email').",
+        "properties": {
+          "body": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "body"
+        ],
+        "type": "object"
+      },
+      "path": "/v1/email/test-sends",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Create an email batch: a list, what writes each email, and a connected Resend account to send from.",
       "method": "POST",
       "name": "create_email_batch",
       "parameters": {
@@ -3505,6 +3526,31 @@
       "read_only": true,
       "role": "read"
     },
+    {
+      "description": "One file a person sent in this conversation, with a fresh link (it lives 1 hour).",
+      "method": "GET",
+      "name": "get_conversation_attachment",
+      "parameters": {
+        "additionalProperties": false,
+        "description": "Arguments not inlined: call describe_function('get_conversation_attachment').",
+        "properties": {
+          "attachment_id": {
+            "type": "string"
+          },
+          "conversation_id": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "conversation_id",
+          "attachment_id"
+        ],
+        "type": "object"
+      },
+      "path": "/v1/conversations/{conversation_id}/attachments/{attachment_id}",
+      "read_only": true,
+      "role": "read"
+    },
     {
       "description": "The agent sessions behind a conversation, newest first.",
       "method": "GET",