carlyemail-toolkit 0.1.3 → 0.1.5

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

@@ -245,7 +245,9 @@ async function updateMessage(client, a) {
 
 async function getAttachment(client, a) {
   const inbox = await oneInbox(client, a.inbox_id);
-  return client.messages.getAttachment(inbox, a.message_id, a.attachment_id);
+  // A draft's id where a message's is asked for, as the hosted tool takes it.
+  const owner = String(a.message_id).startsWith("draft_") ? client.drafts : client.messages;
+  return owner.getAttachment(inbox, a.message_id, a.attachment_id);
 }
 
 async function createDraft(client, a) {
@@ -299,6 +301,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 +322,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.3",
+  "version": "0.1.5",
   "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

@@ -3,6 +3,37 @@ export default {
   "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",
@@ -371,7 +402,7 @@ export default {
     {
       "name": "get_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).",
+      "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). To read a file on a draft, pass its draft_id as message_id.",
       "input_schema": {
         "type": "object",
         "properties": {