Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions apps/docs/communications.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,9 @@ After connecting the provider, run a small task from chat and confirm that:
- replies in the thread continue the same task
- final summaries and links are posted back to chat

In Slack, task and automation messages can link to all active pull requests
associated with the task.

## Start suggested tasks

When a task or automation report identifies independent follow-up work, Roomote
Expand Down
24 changes: 17 additions & 7 deletions apps/docs/file-attachments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,11 @@ Roomote can read supported file attachments from the web app and from chat
threads where you start or continue a Roomote task.

Support varies by chat provider. The web app, Slack, and Telegram can read the
formats below. Discord supports images and a smaller text and code subset, but
not Office documents, PDFs, or presentations. Microsoft Teams currently
supports image attachments only. Slack can also describe one supported video
attachment per message.
text, document, and image formats below. Discord supports images and a smaller
text and code subset, but not Office documents, PDFs, or presentations. Slack,
Discord, Microsoft Teams, and Telegram can also transcribe supported audio
attachments. Microsoft Teams otherwise supports image attachments only, and
Slack can describe one supported video attachment per message.

Use attachments when the file itself is the fastest way to show the problem: a
bug report export, a config file, a markdown handoff, a spreadsheet, or a PDF
Expand All @@ -34,8 +35,8 @@ If the attachments are large, Roomote reads them in the order you attach them
and applies a shared text budget so the task stays responsive. Very large
earlier files can leave later files included by name only.

Text-extracted files are limited to 8 MB each. Image, video, and provider
transport limits vary by surface.
Text-extracted files are limited to 8 MB each. Audio files are limited to 20
MiB each. Image, video, and provider transport limits vary by surface.

## Accepted file types

Expand All @@ -48,14 +49,18 @@ transport limits vary by surface.
| Documents | `.pdf`, `.docx` |
| Presentations | `.pptx` |
| Images | `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg` |
| Audio (chat) | `.aac`, `.flac`, `.m4a`, `.mp3`, `.mp4`, `.oga`, `.ogg`, `.opus`, `.wav`, `.webm` |

## How Roomote uses them

Text, code, spreadsheet, document, and presentation files are read into the
task as attachment context. Images are passed through as image inputs so
Roomote can inspect them directly. `.svg` files are normally read as text
markup, but Discord treats an SVG reported with the `image/svg+xml` content type
as an image input.
as an image input. In Slack, Discord, Microsoft Teams, and Telegram, supported
audio is transcribed and the transcript is added to the task context. Where a
provider permits multiple audio attachments in one message, Roomote transcribes
only the first one.

That means you can ask things like:

Expand All @@ -80,5 +85,10 @@ That means you can ask things like:
log window, or section. Text-extracted files larger than 8 MB are rejected.
- **The attachment is a format not listed here.** Export it as one of the
accepted formats above.
- **The audio was not transcribed.** Audio must be no larger than 20 MiB, use a
supported format, and have an audio-capable inference model available.
Roomote adds a warning to the task context when the format, size, model,
download, or transcription prevents processing, so the text portion of the
request can still proceed.
- **The task still needs more context.** Add a short prompt that explains the
question, expected behavior, or failure you want Roomote to investigate.
4 changes: 4 additions & 0 deletions apps/docs/tasks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,10 @@ detail to review the work. Presentational widgets remain available in the task
transcript; when an agent provides a text fallback, Roomote also sends that
fallback to the originating Slack, Teams, Telegram, or Discord conversation.

When a task is associated with more than one pull request, the task header and
**Task Info** panel list each linked pull request separately. Select a pull
request to open it in its source-control provider.

### Native widget styling

Roomote widgets inherit the task view's selected light or dark theme. Agents can
Expand Down
Loading