carlyemail-toolkit 0.1.2 → 0.1.4

package/README.md

@@ -42,7 +42,7 @@ Plain ES modules with no build step; types ship with it. `ai` and
 
 ## What is in it
 
-The 25 tools the hosted [MCP server](https://docs.carlyemail.com/mcp) serves —
+The 26 tools the hosted [MCP server](https://docs.carlyemail.com/mcp) serves —
 inboxes, threads, messages, drafts, attachments, labels, and account
 verification — with the same names, descriptions and parameter schemas, called
 over the REST API. Pass names to take only some:

package/core.js

@@ -180,7 +180,7 @@ async function deleteInbox(client, a) {
 
 async function listThreads(client, a) {
   const scope = await resolveScope(client, a.inbox_id);
-  const q = query(a, ...PAGE, ...WINDOW, "labels", "ascending", "senders", "recipients", "subject");
+  const q = query(a, ...PAGE, ...WINDOW, "labels", "ascending", "senders", "recipients", "subject", "assignee");
   if (scope.inbox) return client.threads.list(scope.inbox, q);
   return guided(await client.threads.listOrg(q), scope);
 }
@@ -200,7 +200,7 @@ async function getThread(client, a) {
 
 async function updateThread(client, a) {
   const scope = await resolveScope(client, a.inbox_id);
-  const body = pick(a, "add_labels", "remove_labels");
+  const body = pick(a, "add_labels", "remove_labels", "assignee_id");
   if (scope.inbox) return client.threads.update(scope.inbox, a.thread_id, body);
   return client.threads.updateOrg(a.thread_id, body);
 }
@@ -299,6 +299,11 @@ async function deleteDraft(client, a) {
   return { deleted: true, draft_id: a.draft_id };
 }
 
+async function addNote(client, a) {
+  const inbox = await oneInbox(client, a.inbox_id);
+  return client.threads.addNote(inbox, a.thread_id, { text: a.text });
+}
+
 async function authMe(client) {
   const out = { ...(await client.auth.whoami()) };
   // The first call a connected client makes, and so the earliest place a
@@ -315,6 +320,7 @@ async function verifyAccount(client, a) {
 }
 
 export const FUNCTIONS = {
+  add_note: addNote,
   auth_me: authMe,
   create_draft: createDraft,
   create_inbox: createInbox,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carlyemail-toolkit",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CarlyEmail's email tools for the Vercel AI SDK, LangChain, and any other agent framework.",
   "keywords": [
     "carlyemail",
@@ -54,7 +54,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "carlyemail": "^0.6.0"
+    "carlyemail": "^0.6.6"
   },
   "peerDependencies": {
     "@langchain/core": ">=0.3",

package/tools.js

@@ -1,8 +1,39 @@
 // Written by tools/gen_toolkit_tools.py in the API repository. Do not edit.
 export default {
-  "source": "app/mcp/tools.py, written by tools/gen_toolkit_tools.py",
+  "source": "app/mcp/tools/, written by tools/gen_toolkit_tools.py",
   "first_inbox": "Ask the person what they want their email address to be \u2014 the part before the @ \u2014 then call create_inbox with it as `username`.",
   "tools": [
+    {
+      "name": "add_note",
+      "title": "Note on a conversation",
+      "description": "Leave a note on a conversation for the team. It is never sent to anyone outside the organization.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "thread_id": {
+            "type": "string",
+            "description": "Identifier of the conversation, as returned by list_threads."
+          },
+          "inbox_id": {
+            "type": "string",
+            "description": "Address of the inbox to act on, like agent@carlyemail.com. Optional when this key is scoped to one inbox or the organization has only one; required otherwise."
+          },
+          "text": {
+            "type": "string",
+            "description": "The note."
+          }
+        },
+        "required": [
+          "thread_id",
+          "text"
+        ],
+        "additionalProperties": false
+      },
+      "read_only": false,
+      "destructive": false,
+      "idempotent": false,
+      "open_world": false
+    },
     {
       "name": "auth_me",
       "title": "Check my access",
@@ -370,8 +401,8 @@ export default {
     },
     {
       "name": "get_attachment",
-      "title": "Download an attachment",
-      "description": "Get a download URL for an attachment.",
+      "title": "Read an attachment",
+      "description": "Read an attachment. Returns a download URL and extracted text for PDF and DOCX files. Use extracted_text to read the document; check text_status, text_truncated and text_warning for limits. Scanned images are not transcribed (no OCR).",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -448,7 +479,7 @@ export default {
     {
       "name": "get_thread",
       "title": "Read a conversation",
-      "description": "Get one thread with every message in it.",
+      "description": "Get one thread with every message in it, the team's notes on it, and any reply someone has started.",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -645,6 +676,10 @@ export default {
             "type": "string",
             "description": "Only messages whose subject contains this text."
           },
+          "assignee": {
+            "type": "string",
+            "description": "Only conversations assigned to this member_id or api_key_id, to \"me\", or \"none\" for unassigned."
+          },
           "before": {
             "type": "string",
             "description": "Only items older than this ISO 8601 timestamp."
@@ -1200,7 +1235,7 @@ export default {
     {
       "name": "update_thread",
       "title": "Label a conversation",
-      "description": "Add or remove labels on a thread.",
+      "description": "Add or remove labels on a thread, or hand it to a teammate or an agent.",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -1225,6 +1260,10 @@ export default {
               "type": "string"
             },
             "description": "Labels to remove. Ones not present are ignored."
+          },
+          "assignee_id": {
+            "type": "string",
+            "description": "Who handles it: a member_id (from list_members), an api_key_id, or \"me\". Pass \"\" to unassign; leave it out to keep it."
           }
         },
         "required": [