Skip to content

[Docs] Document task notifications and widget delivery #2615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
roomote-community wants to merge 1 commit into
base: develop
Choose a base branch
from
+19 −7
Draft

[Docs] Document task notifications and widget delivery #2615

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
4 changes: 2 additions & 2 deletions apps/docs/fast-sessions.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -187,8 +187,8 @@ result arrives.

Fast sessions can also render presentational widgets such as status cards,
tables, and plans directly in the transcript. Widget HTML is sanitized and
sandboxed in the web view. Chat surfaces receive a concise text preview and a
link to open the rendered widget when both are available.
sandboxed in the web view. Chat surfaces receive a link to open the rendered
widget and include a concise text preview when one is available.

Agent replies and delegated reports can also include up to two pie, bar, area,
or line charts. Roomote renders each chart responsively in the web transcript
Expand Down
22 changes: 17 additions & 5 deletions apps/docs/tasks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,18 @@ execution count, workspace or pull-request context, aggregate cost, and unread
state. Use the **Tasks** scope when you only want Sessions containing execution
work. Board and list choices remain in the URL so views are shareable.

If the task list fails to load, select **Retry** in the error state to fetch it
again without leaving the page.

## Web task notifications

When a task started from the web dashboard completes, fails, or is canceled
while its initiator is away from the Session, Roomote sends that person a direct
notification with a link back to the task. It uses linked Slack, Teams,
Telegram, and Discord accounts that the deployment can reach; verified Email is
the fallback when no chat notification is delivered. Roomote skips the
notification while the initiator is present in the Session.

## Recover from a failed start

When a task cannot start, select **Try in a new task** to open an editable task
Expand All @@ -64,11 +76,11 @@ The task view gives you the working context for a run:
- previews for running apps
- task metadata and links back to the surface that started the task

If a task started from Slack, Teams, Telegram, Discord, Linear, or source
control, use the task view when the chat or provider thread does not show enough
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.
If a task started from Slack, Teams, Telegram, Discord, Email, Linear, or source
control, use the task view when the provider thread does not show enough detail
to review the work. Presentational widgets remain available in the task
transcript. Supported communication surfaces receive a link to open the widget
and include the agent's text preview when one is available.

For a Markdown plan artifact, **Build this** starts a Session and delegates the
plan to a task inside it. Roomote preserves the selected environment, branch,
Expand Down
Loading