Skip to content
Python

fix(attachments): expose PDF bytes in session scratch

Ayush Tiwari96abd89d63c4
diff --git a/coworker/attachment_workspace.py b/coworker/attachment_workspace.py
new file mode 100644
index 00000000..4587a5bc
--- /dev/null
+++ b/coworker/attachment_workspace.py
@@ -0,0 +1,80 @@
+"""Expose user-supplied PDF bytes to tools in the conversation's scratch folder."""
+
+from __future__ import annotations
+
+import base64
+import binascii
+import hashlib
+import json
+import os
+import tempfile
+from pathlib import Path
+from typing import Any
+
+
+_PDF_PREFIX = "data:application/pdf;base64,"
+
+
+def materialize_pdf_attachments(content: Any, scratch: str) -> Any:
+ """Add tool-readable paths alongside PDF parts without changing the original bytes."""
+ if not isinstance(content, list):
+ return content
+
+ result = []
+ created: list[Path] = []
+ try:
+ for part in content:
+ result.append(part)
+ _append_pdf_path(part, scratch, result, created)
+ except Exception:
+ for path in created:
+ path.unlink(missing_ok=True)
+ raise
+ return result
+
+
+def _append_pdf_path(part: Any, scratch: str, result: list, created: list[Path]) -> None:
+ if not isinstance(part, dict) or part.get("type") != "file":
+ return
+ file = part.get("file")
+ if not isinstance(file, dict):
+ return
+ data_url = file.get("file_data")
+ if not isinstance(data_url, str) or not data_url.startswith(_PDF_PREFIX):
+ return
+ try:
+ raw = base64.b64decode(data_url[len(_PDF_PREFIX) :], validate=True)
+ except (binascii.Error, ValueError):
+ return
+ if not raw.startswith(b"%PDF-"):
+ return
+
+ root = Path(scratch).resolve()
+ folder = root / "attachments"
+ folder.mkdir(mode=0o700, parents=True, exist_ok=True)
+ if folder.resolve() != folder or not folder.resolve().is_relative_to(root):
+ raise ValueError("attachment folder leaves the session scratch directory")
+ path = None
+ try:
+ with tempfile.NamedTemporaryFile(
+ mode="wb", prefix="pdf-", suffix=".pdf", dir=folder, delete=False
+ ) as output:
+ path = Path(output.name)
+ os.chmod(path, 0o600)
+ output.write(raw)
+ except Exception:
+ if path is not None:
+ path.unlink(missing_ok=True)
+ raise
+ created.append(path)
+
+ name = str(file.get("filename") or "attachment.pdf")
+ digest = hashlib.sha256(raw).hexdigest()
+ result.append({
+ "type": "text",
+ "text": (
+ f"[Attached PDF {json.dumps(name)}: original bytes are available "
+ f"to local tools at {path}; SHA-256 {digest}. Use this path for "
+ "byte-oriented file or MCP workflows.]"
+ ),
+ })