From 52efedbc42146bee8c7fdfb3e6a7abe53eea1e44 Mon Sep 17 00:00:00 2001 From: Roomote Date: Fri, 28 Aug 2026 03:07:16 +0000 Subject: [PATCH] docs: sync user-facing behavior documentation --- apps/docs/automations.mdx | 8 ++++---- apps/docs/integrations/notion.mdx | 8 +++++--- apps/docs/memory.mdx | 4 ++++ apps/docs/tasks.mdx | 3 +++ 4 files changed, 16 insertions(+), 7 deletions(-) diff --git a/apps/docs/automations.mdx b/apps/docs/automations.mdx index 233661c11..094461b3a 100644 --- a/apps/docs/automations.mdx +++ b/apps/docs/automations.mdx @@ -155,10 +155,10 @@ conclusions and actions in its first message; supporting detail can continue in thread replies. Explicit instructions in the automation prompt about format, length, tone, audience, or detail placement always take precedence. -In Slack, automation reports appear as structured cards. Markdown tables render -as tables when they fit, and the card can include links to the task, related pull -requests, and automation settings. Completed runs also show their trigger or -schedule, model, estimated inference cost, and elapsed time. +In Slack, automation reports use Slack Markdown with a compact report header and +action controls. Reports can include links to the task, related pull requests, +and automation settings. Completed runs also show their trigger or schedule, +model, estimated inference cost, and elapsed time. Direct-message destinations require the automation owner to link an account for the selected communications provider and make the bot reachable there. diff --git a/apps/docs/integrations/notion.mdx b/apps/docs/integrations/notion.mdx index 1c7824081..9a1bcacc3 100644 --- a/apps/docs/integrations/notion.mdx +++ b/apps/docs/integrations/notion.mdx @@ -40,9 +40,11 @@ When Memory is enabled, Roomote also backfills the pages shared with this integration and keeps their Markdown snapshots current. Notion pages are stored under the `notion/` namespace. New and edited pages are picked up on regular Memory collector ticks, and a daily full sweep discovers older pages -that were newly shared without being edited. The same sweep replaces pages -that are no longer shared with unavailable tombstones, so their former -content is no longer retained in Memory search results. +that were newly shared without being edited. After each full sweep, Roomote also +walks accessible child pages and data sources so content omitted from Notion's +search index can still enter Memory. The same sweep replaces pages that are no +longer shared with unavailable tombstones, so their former content is no longer +retained in Memory search results. When the integration's capabilities allow listing users, Memory also refreshes the workspace user directory once a day to link page authors, diff --git a/apps/docs/memory.mdx b/apps/docs/memory.mdx index 806f71c9b..868a09596 100644 --- a/apps/docs/memory.mdx +++ b/apps/docs/memory.mdx @@ -194,6 +194,10 @@ Slack, GitHub, task-history, meeting, or pull-request sources. They check those live sources when Memory coverage is insufficient, freshness could change the answer, or you explicitly ask for live verification. +When recalled context materially shapes an agent's approach, the response +briefly names the specific useful insight without exposing Memory's internal +provenance or storage metadata. + Writes go through Roomote instead. When an agent finishes substantial work it records a short memory of what it did, and the platform places that text under a slug it controls, after scrubbing credential-shaped strings. An agent can diff --git a/apps/docs/tasks.mdx b/apps/docs/tasks.mdx index ce1107bea..893b6a73c 100644 --- a/apps/docs/tasks.mdx +++ b/apps/docs/tasks.mdx @@ -60,6 +60,9 @@ 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 +Structured tool details use a readable YAML view. For supported tools, Roomote +also shows selected inputs after redacting secrets and sanitizing sandbox paths. + 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