carlyemail-toolkit 0.1.4 → 0.1.6

package/core.js

@@ -113,7 +113,7 @@ export async function oneInbox(client, inboxId) {
     `This organization has ${scope.candidates.length} inboxes, so inbox_id is required.`,
     {
       code: "inbox_id_required",
-      fix: `Ask the person which one to use — ${shown}${more} — and pass it as inbox_id. Do not pick for them.`,
+      fix: `Pass the one that fits this mail as inbox_id: ${shown}${more}.`,
     },
   );
 }
@@ -173,7 +173,7 @@ async function updateInbox(client, a) {
 async function deleteInbox(client, a) {
   const inbox = await oneInbox(client, a.inbox_id);
   // Only sent when true, so a refusal (`inbox_in_use`) reaches the model and
-  // it has to ask the person before trying again with `force`.
+  // it decides whether to try again with `force`.
   await client.inboxes.delete(inbox, a.force === true ? { force: true } : {});
   return { deleted: true, inbox_id: inbox };
 }
@@ -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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carlyemail-toolkit",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "CarlyEmail's email tools for the Vercel AI SDK, LangChain, and any other agent framework.",
   "keywords": [
     "carlyemail",

package/tools.js

@@ -1,7 +1,7 @@
 // Written by tools/gen_toolkit_tools.py in the API repository. Do not edit.
 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`.",
+  "first_inbox": "Create an inbox with create_inbox and carry on. Use the address the person asked for as `username` if they named one; otherwise choose it yourself.",
   "tools": [
     {
       "name": "add_note",
@@ -173,7 +173,7 @@ export default {
     {
       "name": "create_inbox",
       "title": "Create an inbox",
-      "description": "Create a new inbox. Ask the person what they want the address to be before calling this; only omit `username` if they genuinely have no preference.",
+      "description": "Create a new inbox. Use the address the person asked for as `username`, or choose one yourself; omit it for a generated address.",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -235,7 +235,7 @@ export default {
     {
       "name": "delete_inbox",
       "title": "Delete an inbox and its mail",
-      "description": "Delete an inbox. Its messages go with it. An inbox that sent mail or whose key was used in the last 30 days is refused with `inbox_in_use`; ask the person before calling again with `force`.",
+      "description": "Delete an inbox. Its messages go with it. An inbox that sent mail or whose key was used in the last 30 days is refused with `inbox_in_use`; call again with `force` if you mean to delete it anyway.",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -402,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": {