Send files in a reply

In a Connector conversation, include a file's Workspace-relative path in double brackets in the final reply. Create or verify the file first. For example:

Here is the report.
[[reports/summary.pdf]]
The chart shows the comparison.
[[reports/chart.png]]

Write the actual references outside code spans or code fences. The Connector uploads resolved files at their position in the reply, preserving the order of text and attachments. This does not create an Inbox entry.

• Paths refer to the replying Session's Workspace. For a file from a peer Workspace, copy it into this Workspace before referencing it.
• Use the path and extension directly: no file: prefix, absolute path, .., or |label suffix. Missing, unreadable or unsupported references stay as literal text; writing a reference alone is not proof of delivery.
• The current reply limit is five unique files, each at most 1 MiB. Files retain their bytes. Telegram sends PNG/JPEG/WebP as photos and other supported files as documents. sticker/*.png and sticker/*.webp use sticker delivery; follow the installed sticker Skill for the available pack and usage.

Attachment-capable Connectors send files; GUI chat renders previews and opens documents in the right panel. Images open a preview dialog when clicked. Terminals display the text without uploading it. To discuss the syntax without sending a file, put the reference in inline code or a code fence.

When to use Inbox

Inbox is OpenAlice's outward-facing notification and reporting surface for the human: alerts, findings, reports, or requests for attention that deserve their own delivery record. Use alice inbox push for that purpose; the alice Skill's collaboration reference describes its current commands.

A file requested in the current conversation can be sent directly in the reply. It does not need an Inbox entry merely because it is a file. Files and Git hold the work; Inbox communicates it to the human; peer conversations carry Agent-to-Agent handoffs. Avoid duplicating a reply into Inbox unless a separate notification or report handoff is intended.

Inbox reports

For a separate notification to the human, use alice inbox push --body 'See [[report/summary.pdf]]' or alice inbox push --body-file report/summary.md. The latter publishes the Markdown itself. References remain relative to the publishing Workspace root. A normal reply does not need an Inbox entry.