Skip to content

[Docs] Correct recent task and integration guidance - #3008

Draft
roomote-community[bot] wants to merge 1 commit into
developfrom
fix/docs-accuracy-audit-1qamdl70sa1fv
Draft

roomote-community[bot] wants to merge 1 commit into
developfrom
fix/docs-accuracy-audit-1qamdl70sa1fv

Conversation

@roomote-community

Copy link
Copy Markdown
Contributor

​Opened on behalf of @mrubens. Follow up by mentioning @roomote, in the web UI, or in Discord.

What changed

  • document automatic and in-place recovery when a task's sandbox cannot start
  • explain standalone artifact links, version selection, access checks, and source navigation
  • document the Code Mode Integrations experiment and its authorization and fallback boundaries
  • require custom multi-service deployments to provide the job-auth keypair to BullMQ

Why this change was made

The daily public-documentation audit inspected all 29 first-parent commits merged into develop during the exact window from 2026-09-19T03:00:45.841Z through 2026-09-20T03:00:45.841Z. These four durable task, integration, and self-hosting behaviors were the confirmed gaps not already covered by shipped docs or the overlapping open documentation pull requests.

Impact

Users and operators now have current recovery, artifact-sharing, experimental integration, and deployment-key guidance. This is a documentation-only change. The repository-prescribed Mintlify validation and broken-link check, git diff --check, oxlint, residual lint, 27 fast typechecks, and Knip all passed; browser proof was not applicable to the semantic docs-only correction.

@roomote-community

roomote-community Bot commented Sep 20, 2026

Copy link
Copy Markdown
Contributor Author

1 issue outstanding. See task

  • apps/docs/tasks.mdx:94 — Startup-retry guidance promises automatic retries for every task, but session-delegated starts retry only when the parent agent judges the failure transient.

Reviewed adc409c

Comment thread apps/docs/tasks.mdx
environment. Review or change those values before starting it. This creates a
new task instead of retrying the failed task, and attachments are not copied, so
reattach any files the new task needs.
When a task's sandbox cannot start, Roomote automatically retries the start up

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This states that every failed sandbox start is automatically retried, but session-delegated tasks take a different path: finishRun skips its automatic retry when a Fast parent exists, and the parent agent is instructed to retry only failures that appear transient. Please qualify this behavior (or scope the guarantee to direct tasks) so users do not expect automatic retries for every task start.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant