@rtrvr-ai/rover 4.1.0 → 4.2.0

package/README.md

@@ -514,10 +514,17 @@ const RoverWidget = dynamic(() => import('./RoverWidget'), { ssr: false });
 | `ui.thoughtStyle` | `'concise_cards' \| 'minimal'` | `'concise_cards'` | Thought rendering style |
 | `ui.panel.resizable` | `boolean` | `true` | Enables desktop freeform resizing plus phone/tablet snap-height resizing with per-device memory |
 | `ui.showTaskControls` | `boolean` | `true` | Show new/end task controls |
-| `ui.shortcuts` | `RoverShortcut[]` | `[]` | Suggested journeys (max 100 stored, max 12 rendered by default; lower site-key policy caps are enforced). Shortcuts can also publish agent-facing metadata such as `tags`, `examples`, `inputSchema`, `outputSchema`, `sideEffect`, and `requiresConfirmation`. |
+| `ui.shortcuts` | `RoverShortcut[]` | `[]` | Suggested journeys (max 100 stored, max 12 rendered by default; lower site-key policy caps are enforced). Set `runKind: 'guide'` for onboarding/demo journeys that should narrate under the guided default. Shortcuts can also publish agent-facing metadata such as `tags`, `examples`, `inputSchema`, `outputSchema`, `sideEffect`, and `requiresConfirmation`. |
 | `cloudSandboxEnabled` | `boolean` | `false` | Owner-facing shorthand for cloud execution plus approved third-party browsing. When `true`, Rover materializes `tools.web.enableExternalWebContext=true` and `tools.web.scrapeMode='on_demand'`. |
 | `ui.greeting` | `{ text?, delay?, duration?, disabled? }` | — | Greeting bubble config (`{name}` token supported) |
 | `ui.voice` | `{ enabled?: boolean; language?: string; autoStopMs?: number }` | — | Browser dictation for supported Chromium browsers. Rover fills the draft live, waits for post-speech silence before stopping, and the user still sends manually. |
+| `ui.experience.audio.narration.enabled` | `boolean` | `true` | Owner gate for Web Speech step narration. Visitors get a site-scoped speaker toggle when supported. |
+| `ui.experience.audio.narration.defaultMode` | `'guided' \| 'always' \| 'off'` | `'guided'` | Speak guided/demo runs by default, every run, or stay off unless the visitor enables it. |
+| `ui.experience.audio.narration.rate` | `number` | `1` | Web Speech playback rate, clamped to `0.85`-`1.15`. |
+| `ui.experience.audio.narration.language` | `string` | `'en-US'` | Preferred narration language for voice matching. |
+| `ui.experience.audio.narration.voicePreference` | `'auto' \| 'system' \| 'natural'` | `'auto'` | Voice matching preference; `natural` prefers higher-quality browser voices when available. |
+| `ui.experience.motion.actionSpotlight` | `boolean` | `true` | Highlights the element Rover is clicking, typing into, selecting, or scrolling to. |
+| `ui.experience.motion.actionSpotlightColor` | `"#RRGGBB"` | `"#FF4C00"` | Ring and glow color for Action Spotlight. |
 
 ### Web Tools
 
@@ -530,7 +537,7 @@ const RoverWidget = dynamic(() => import('./RoverWidget'), { ssr: false });
 | `tools.web.denyDomains` | `string[]` | `[]` | External context denylist |
 | `tools.client` | `ClientToolDefinition[]` | `[]` | Runtime-registered client tools. Tool definitions can include `title`, `outputSchema`, and `annotations` (`whenToUse`, `whyUse`, `examples`, `sideEffect`, `requiresConfirmation`) to improve model tool selection and discovery-card quality. |
 | `agentDiscovery` | `{ enabled?, siteName?, description?, version?, siteUrl?, agentCardUrl?, roverSiteUrl?, llmsUrl?, hostSurfaceSelector?, preferExecution?, discoverySurface?, additionalSkills? }` | — | Optional overrides for Rover's generated discovery surfaces. `rover-site.json` is the authoritative rich profile, `agent-card.json` is the interop card, and `discoverySurface.beaconLabel` now feeds the visible seed/presence CTA text in production. Legacy `visibleCue` / `visibleCueLabel` remain compatibility inputs only. |
-| `pageConfig` | `RoverPageCaptureConfig` | — | Optional per-site page-capture overrides such as `disableAutoScroll`, settle timing, and sparse-tree retry settings |
+| `pageConfig` | `RoverPageCaptureConfig` | `{ disableAutoScroll: true }` for generated installs | Optional per-site page-capture overrides such as `disableAutoScroll`, settle timing, and sparse-tree retry settings. Set `disableAutoScroll: false` only when automatic page-capture scrolling is desired. |
 
 ### AI-Callable URLs (Deep Links)
 

package/dist/agentDiscovery.d.ts

@@ -63,6 +63,7 @@ export type RoverPublicSkillDefinition = {
         shortcutId?: string;
         prompt?: string;
         routing?: 'auto' | 'act' | 'planner';
+        runKind?: 'guide' | 'task';
         toolName?: string;
         run?: {
             endpoint: string;

package/dist/agentDiscovery.js

@@ -414,7 +414,7 @@ function normalizeAnnotations(value) {
         requiresConfirmation: typeof annotations.requiresConfirmation === 'boolean'
             ? annotations.requiresConfirmation
             : undefined,
-        preferredInterface: annotations.preferredInterface === 'task'
+        preferredInterface: annotations.preferredInterface === 'run'
             || annotations.preferredInterface === 'shortcut'
             || annotations.preferredInterface === 'client_tool'
             || annotations.preferredInterface === 'webmcp'
@@ -472,6 +472,7 @@ function normalizePublishedShortcut(shortcut) {
         prompt,
         ...(description ? { description } : {}),
         ...(shortcut.routing ? { routing: shortcut.routing } : {}),
+        ...(shortcut.runKind === 'guide' || shortcut.runKind === 'task' ? { runKind: shortcut.runKind } : {}),
     };
 }
 function buildShortcutSkill(shortcut, config, runEndpoint) {
@@ -518,6 +519,7 @@ function buildShortcutSkill(shortcut, config, runEndpoint) {
             shortcutId: id,
             prompt,
             routing: shortcut.routing,
+            runKind: shortcut.runKind,
             deepLink: buildDeepLink(config.siteUrl, id),
             run: {
                 endpoint: runEndpoint,
@@ -1025,15 +1027,15 @@ export function createRoverAgentDiscoveryTags(config) {
     const escapedRoverSiteJson = escapeScriptJson(roverSiteJson);
     const escapedPageManifestJson = escapeScriptJson(pageManifestJson);
     const lines = [
-        `<script type="application/agent+json">${markerJson}</script>`,
-        `<link rel="service-desc" href="${escapeHtmlAttr(serviceDescHref)}" type="application/json" />`,
+        `<script type="application/agent+json" data-rover-agent-discovery="marker">${markerJson}</script>`,
+        `<link rel="service-desc" href="${escapeHtmlAttr(serviceDescHref)}" type="application/json" data-rover-agent-discovery="service-desc" />`,
     ];
     if (llmsUrl) {
-        lines.push(`<link rel="service-doc" href="${escapeHtmlAttr(llmsUrl)}" type="text/markdown" />`);
+        lines.push(`<link rel="service-doc" href="${escapeHtmlAttr(llmsUrl)}" type="text/markdown" data-rover-agent-discovery="service-doc" />`);
     }
-    lines.push(`<script type="application/rover-site+json">${escapedRoverSiteJson}</script>`);
-    lines.push(`<script type="application/rover-page+json">${escapedPageManifestJson}</script>`);
-    lines.push(`<script type="application/agent-card+json">${escapedCardJson}</script>`);
+    lines.push(`<script type="application/rover-site+json" data-rover-agent-discovery="rover-site">${escapedRoverSiteJson}</script>`);
+    lines.push(`<script type="application/rover-page+json" data-rover-agent-discovery="page">${escapedPageManifestJson}</script>`);
+    lines.push(`<script type="application/agent-card+json" data-rover-agent-discovery="agent-card">${escapedCardJson}</script>`);
     return lines.join('\n');
 }
 export { createRoverAgentDiscoverySnapshot };