Navigate, restore history and autoplay prepared views
Version 0.20.0. Page, scroll, find, highlight and focus without republishing source data.
1. Execute explicit user requests to scroll, page or navigate immediately; never refuse based on pageCount/matchingItems or inferred visibility. Those counts are logical pagination. kanvas_view_navigation read returns fresh per-viewer viewport measurements; null means unknown, not no overflow.
2. Presentation/procedure gestures take precedence over session history; table horizontal scrolling, map dragging, JSON tree keys and editable inputs keep their native behavior. At an internal boundary, history browsing is local only and never propagates through display sync.
3. A notes presentation can set data.presenterPreview:true for private browsing. Go live explicitly pushes its previewed slide to linked screens; Follow live resumes the published position. Audience navigation chrome is hidden by default; showControls:true reveals it per published display. Notes retain their own controls.
4. For server-driven carousel/kiosk playback, open Displays → Autoplay / kiosk or use kanvas_presentation autoplay. Start with current expectedRevision, requestId, intervalSeconds from 2 to 86400 (including fractional values), and loop true/false. It plays the current prepared presentation, or snapshots the supplied frames from authorized displays/history in the same session. Only supplied frames are played. Inspect kanvas_presentation autoplay.read, then pause/resume/stop with sessionId, displayId, action and a fresh requestId. Optional expectedVersion or runId rejects stale commands. State survives restart; newer content, holds and lost editor access stop it. Stop preserves the last frame; queued/running is distinct from confirmed browser paint.
5. Arrow keys and horizontal swipes page within the current view first, then step through retained session frames in publication order. Reverse entry starts at the last inner page. Home and End choose first/last frame; Escape opens a compact positional overview list. PageUp/PageDown retain native scrolling. Private browsing does not restore shared history, change the other viewers, or acknowledge unseen new content. Use Back to live to resume the published display.
6. Read kanvas_display current and kanvas_view_navigation read for the selected display revision and capabilities. Send kanvas_view_navigation operation control with requestId, expectedRevision and navigation. Page numbers start at 1.
7. Navigation actions: page (direction next/previous or page), scroll (normalized x/y or deltaX/deltaY), search (query), match (next/previous), highlight (text), focus (text or normalized region and zoom), reset. Match navigation applies to the currently rendered text. Tables and lists search their entire supplied collection and reset to page 1.
8. Independent is the default: viewers browse separately. An editor/agent can cue the selected display; specify viewerId to cue just one active independent viewer. Shared allows approved viewers to drive the display’s navigation. Presenter follows one owner-designated viewer from kanvas_viewers list. Changing syncMode/presenterViewerId requires the owner and configRevision; it never adds publishing or guest-access authority.
9. Use kanvas_pins save with a label and optional retained revision; kanvas_pins list lists them. kanvas_pins recall needs pinId, requestId and current expectedRevision and restores the pinned content as a normal new history entry. Holds remain enforced. kanvas_pins remove removes only the bookmark.
10. Between views: kanvas_display_revisions go. Between ordinary presentation slides: kanvas_presentation navigate (goto index is zero-based). Saved decks use kanvas_presentation cue. These are distinct from within-view navigation.
11. Read kanvas_view_navigation read for per-viewer acknowledgements. Offline or unconfirmed screens are not assumed to have applied a cue. Cross-origin website contents cannot be searched, scrolled, highlighted or read by KANVAS.
Example
{
"tool": "kanvas_view_navigation",
"arguments": {
"operation": "control",
"sessionId": "session-id",
"displayId": "display-id",
"requestId": "next-page-1",
"expectedRevision": 3,
"navigation": {
"action": "page",
"direction": "next"
}
}
}
Related tasks
- A tour built around your work — Agent instructions for a live, context-aware tour, never a fixed demo deck.
- Kanvas Help — Get a useful visual onto a screen, then work with it together.
- Publish your first view — One call sets up a fresh authorized workspace and returns real viewer links.
- Connect a private screen or open a public session — Invite a browser without confusing its address with permission.
- Compare products or offers — Line up vendors and ordered attributes with exact prices and complete URLs.
- Show external websites — Edge-to-edge public pages, optional mobile viewports and honest static fallbacks.
- Set numbers, units and dates — Use regional display preferences without changing exact source strings.
- Choose a template — Use the current catalog and exact field schema instead of guessing.
- Recover from a failed call — Find the real error, correct the input, and retry without duplicating work.
- Use Kanvas Help with an agent — Learn a user-chosen task with live context and real interaction.
- Read comfortably at your own pace — Independent text size, zoom and words-per-minute controls for document reading.
- Show task progress and exact logs — Accumulate real milestones, inspect dense logs and use proportional timelines.
- Invite someone to KANVAS — Create a welcome link without granting private access or sending a message.
- A live Home for your sessions — A real KANVAS display, deliberate session choices and ordinary OAuth.
- Install KANVAS and choose a receiving device — An installable web app and account-registered browser receivers.
- Read messages and technical work — Source-driven email, inbox, chat, cards, bookmarks and developer/operations views.
- Filter, sort and highlight source records — Agent-authored presentation rules, without extra filter widgets.
- Profiles, organizations and independent teams — Optional photos, clear appearance precedence and explicit group access.
- Your activity history and access audit — Query actual retained events and create charts within your current permissions.
- Live people, devices, browser windows and participant map — A live connection hierarchy, distinct from the chronological overview list.
- Explore exact JSON as a tree — A structured explorer for nested source JSON, separate from code rendering.
- Point together at the same content — Optional named semantic markers that follow text and data across screen sizes.
- Show full images, team logos and drawing backgrounds — Source-preserving media with optional per-image information.
- Report an issue at the right scope — Separate session observations, private account feedback and general service requests.