How do I attach files to agent emails?

import { CommuneClient } from 'commune-ai';
import { readFileSync } from 'fs';

const commune = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY! });

// Step 1: Upload the file
const pdfBytes = readFileSync('./contract.pdf');
const upload = await commune.attachments.upload(
  Buffer.from(pdfBytes).toString('base64'),
  'contract.pdf',
  'application/pdf'
);

// Step 2: Send with the attachment
await commune.messages.send({
  to: 'client@lawfirm.com',
  subject: 'Signed engagement letter',
  inboxId: 'inb_legal_01',
  text: 'Please find the signed engagement letter attached.',
  html: '<p>Please find the signed engagement letter attached.</p>',
  attachments: [upload.attachment_id],
});

import base64
import commune

client = commune.CommuneClient(api_key=os.environ["COMMUNE_API_KEY"])

# Step 1: Upload the file
with open("contract.pdf", "rb") as f:
    content = base64.b64encode(f.read()).decode()

upload = client.attachments.upload(
    content=content,
    filename="contract.pdf",
    mime_type="application/pdf",
)

# Step 2: Send with the attachment
client.messages.send(
    to="client@lawfirm.com",
    subject="Signed engagement letter",
    inbox_id="inb_legal_01",
    text="Please find the signed engagement letter attached.",
    html="<p>Please find the signed engagement letter attached.</p>",
    attachments=[upload.attachment_id],
)

const proposalUpload = await commune.attachments.upload(
  proposalBase64, 'proposal.pdf', 'application/pdf'
);
const pricingUpload = await commune.attachments.upload(
  pricingBase64, 'pricing.xlsx', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
);

await commune.messages.send({
  to: 'prospect@company.com',
  subject: 'Proposal and pricing',
  inboxId: salesInboxId,
  text: 'Attached: our proposal and pricing breakdown.',
  attachments: [proposalUpload.attachment_id, pricingUpload.attachment_id],
});

proposal_upload = client.attachments.upload(
    content=proposal_base64,
    filename="proposal.pdf",
    mime_type="application/pdf",
)
pricing_upload = client.attachments.upload(
    content=pricing_base64,
    filename="pricing.xlsx",
    mime_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
)

client.messages.send(
    to="prospect@company.com",
    subject="Proposal and pricing",
    inbox_id=sales_inbox_id,
    text="Attached: our proposal and pricing breakdown.",
    attachments=[proposal_upload.attachment_id, pricing_upload.attachment_id],
)

// Generate a CSV in memory
const csvRows = [
  'Date,Description,Amount',
  '2026-03-01,Monthly subscription,$49.00',
  '2026-03-05,API overage (12k calls),$24.00',
  '2026-03-10,Support add-on,$15.00',
];
const csvContent = Buffer.from(csvRows.join('\n')).toString('base64');

const upload = await commune.attachments.upload(
  csvContent,
  'march-invoice.csv',
  'text/csv'
);

await commune.messages.send({
  to: 'billing@customer.com',
  subject: 'March 2026 invoice',
  inboxId: billingInboxId,
  text: 'Your March invoice is attached.',
  attachments: [upload.attachment_id],
});

import base64
import csv
import io

# Generate a CSV in memory
buf = io.StringIO()
writer = csv.writer(buf)
writer.writerow(["Date", "Description", "Amount"])
writer.writerow(["2026-03-01", "Monthly subscription", "$49.00"])
writer.writerow(["2026-03-05", "API overage (12k calls)", "$24.00"])
writer.writerow(["2026-03-10", "Support add-on", "$15.00"])

content = base64.b64encode(buf.getvalue().encode("utf-8")).decode()

upload = client.attachments.upload(
    content=content,
    filename="march-invoice.csv",
    mime_type="text/csv",
)

client.messages.send(
    to="billing@customer.com",
    subject="March 2026 invoice",
    inbox_id=billing_inbox_id,
    text="Your March invoice is attached.",
    attachments=[upload.attachment_id],
)

// In your webhook handler
async function handleInbound(payload: any) {
  for (const att of payload.attachments ?? []) {
    // Get metadata (already in payload, but you can also fetch it)
    const meta = await commune.attachments.get(att.attachment_id);
    console.log(`File: ${meta.filename} (${meta.size} bytes)`);

    // Get a signed download URL (expires in 1 hour)
    const urlInfo = await commune.attachments.get(att.attachment_id, {
      url: true,
      expiresIn: 3600,
    });

    // Download the file
    const response = await fetch(urlInfo.url);
    const fileBuffer = await response.arrayBuffer();

    // Process — e.g., extract text from PDF, parse CSV, store in S3
    await processAttachment(meta.filename, meta.mime_type, fileBuffer);
  }
}

import requests

# In your webhook handler
def handle_inbound(payload: dict):
    for att in payload.get("attachments", []):
        # Get metadata
        meta = client.attachments.get(att["attachment_id"])
        print(f"File: {meta.filename} ({meta.size} bytes)")

        # Get a signed download URL (expires in 1 hour)
        url_info = client.attachments.url(att["attachment_id"], expires_in=3600)

        # Download the file
        response = requests.get(url_info.url)
        file_bytes = response.content

        # Process — e.g., extract text from PDF, parse CSV, store in S3
        process_attachment(meta.filename, meta.mime_type, file_bytes)

const ALLOWED_TYPES = new Set([
  'application/pdf',
  'text/csv',
  'image/png',
  'image/jpeg',
]);
const MAX_SIZE = 5 * 1024 * 1024; // 5 MB

for (const att of payload.attachments ?? []) {
  if (!ALLOWED_TYPES.has(att.mime_type)) {
    console.log(`Skipping ${att.filename} — unsupported type ${att.mime_type}`);
    continue;
  }
  if (att.size > MAX_SIZE) {
    console.log(`Skipping ${att.filename} — too large (${att.size} bytes)`);
    continue;
  }
  // Safe to download and process
}

ALLOWED_TYPES = {"application/pdf", "text/csv", "image/png", "image/jpeg"}
MAX_SIZE = 5 * 1024 * 1024  # 5 MB

for att in payload.get("attachments", []):
    if att["mime_type"] not in ALLOWED_TYPES:
        print(f"Skipping {att['filename']} — unsupported type {att['mime_type']}")
        continue
    if att["size"] > MAX_SIZE:
        print(f"Skipping {att['filename']} — too large ({att['size']} bytes)")
        continue
    # Safe to download and process