a4a_open_file
Verify and decrypt a local blob or fetch an attachment from this mailbox's gateway, then write it to a safe output path without overwriting existing files. Returns the written path, size, and sender, or a refusal reason.
Instructions
Verify and decrypt a local blob, or save an attachment from this mailbox's gateway.
File-reference locations and metadata are never shown to the model. With `blob_path`
this opens an existing local blob supplied by the owner or trusted host outside MCP;
it matches a hidden incoming reference and makes no network request for the blob.
With `attachment` the blob comes only from this mailbox's own file gateway, fetched
as the recipient; references to any other location are never followed.
Args:
blob_path: Existing local blob path. Give this or `attachment`, not both.
attachment: The handle shown in an "[A4A attachment]" message. The blob is
taken only from a file gateway configured for this mailbox
(A4A_FILE_GATEWAY), as the recipient; nothing is opened or run.
out_path: Decrypted output path; existing files are never overwritten.
since_days: How many days of incoming history to search; default 30.
Returns:
Written path, size, and sender, or a refusal reason.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| out_path | No | ||
| blob_path | No | ||
| attachment | No | ||
| since_days | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |