@rtrvr-ai/rover 4.1.0 → 4.2.1

package/dist/index.d.ts

@@ -6,7 +6,7 @@ import { createRoverOwnerInstallBundle, type RoverOwnerInstallBootConfig, type R
 import { createRoverAgentCard, createRoverAgentCardJson, createRoverAgentDiscoveryTags, createRoverSiteProfile, createRoverSiteProfileJson, createRoverServiceDescLinkHeader, createRoverWellKnownAgentCard, createRoverWellKnownSiteProfile, type RoverAgentCard, type RoverAgentDiscoveryRuntimeConfig } from './agentDiscovery.js';
 import { type RoverCloudCheckpointState } from './cloudCheckpoint.js';
 import type { PersistedRuntimeState, PersistedWorkerState } from './runtimeTypes.js';
-import { type RoverLaunchAttachResponse, type RoverServerExperienceConfig } from './serverRuntime.js';
+import { type RoverLaunchAttachResponse, type RoverServerExperienceConfig, type RoverBusinessType } from './serverRuntime.js';
 import { type FollowupChatEntry } from './followupChatHeuristics.js';
 export type RoverWebToolsConfig = {
     enableExternalWebContext?: boolean;
@@ -27,6 +27,12 @@ export type RoverDeepLinkConfig = {
     shortcutParam?: string;
     consume?: boolean;
 };
+type RoverAiAccessConfig = {
+    enabled?: boolean;
+    allowCloudBrowser?: boolean;
+    allowDelegatedHandoffs?: boolean;
+    debugStreaming?: boolean;
+};
 export type RoverInit = {
     siteId: string;
     apiBase?: string;
@@ -45,6 +51,7 @@ export type RoverInit = {
     pageConfig?: RoverPageCaptureConfig;
     allowedDomains?: string[];
     domainScopeMode?: 'host_only' | 'registrable_domain';
+    cloudSandboxEnabled?: boolean;
     tabPolicy?: {
         observerByDefault?: boolean;
         actionLeaseMs?: number;
@@ -258,6 +265,10 @@ export type RoverInstance = {
     on: (event: RoverEventName, handler: RoverEventHandler) => () => void;
 };
 type TelemetryEventName = RoverEventName | RoverVoiceTelemetryEventName;
+type RoverShortcutLimits = {
+    shortcutMaxStored: number;
+    shortcutMaxRendered: number;
+};
 declare function normalizePromptContextEntry(input: string | RoverPromptContextEntry): FollowupChatEntry | null;
 declare function buildPublicRunStartedPayload(msg: any): Record<string, unknown>;
 declare function buildPublicRunLifecyclePayload(msg: any, completionState: ReturnType<typeof normalizeRunCompletionState>): Record<string, unknown>;
@@ -272,6 +283,24 @@ declare function normalizeRunCompletionState(msg: any): {
 };
 declare function sanitizeWorkerState(input: any): PersistedWorkerState | undefined;
 declare function cloneRuntimeStateForCheckpoint(state: PersistedRuntimeState): PersistedRuntimeState;
+type RoverGreetingConfig = {
+    text?: string;
+    delay?: number;
+    duration?: number;
+    disabled?: boolean;
+};
+type RoverResolvedSiteConfig = {
+    shortcuts: RoverShortcut[];
+    businessType?: RoverBusinessType;
+    experience?: RoverServerExperienceConfig;
+    greeting?: RoverGreetingConfig;
+    voice?: RoverVoiceConfig;
+    aiAccess?: RoverAiAccessConfig;
+    limits?: RoverShortcutLimits;
+    pageConfig?: RoverPageCaptureConfig;
+    agentDiscovery?: RoverAgentDiscoveryRuntimeConfig;
+    version?: string;
+};
 export declare function identify(visitor: {
     name?: string;
     email?: string;
@@ -309,6 +338,7 @@ export declare const __roverInternalsForTests: {
     normalizePromptContextEntry: typeof normalizePromptContextEntry;
     buildPublicRunStartedPayload: typeof buildPublicRunStartedPayload;
     buildPublicRunLifecyclePayload: typeof buildPublicRunLifecyclePayload;
+    resolveEffectiveShortcutsForTests: (cfg: RoverInit | null, siteConfig?: Partial<RoverResolvedSiteConfig> | null) => RoverShortcut[];
 };
 export { createRoverAgentCard, createRoverAgentCardJson, createRoverAgentDiscoveryTags, createRoverBookmarklet, createRoverConsoleSnippet, createRoverOwnerInstallBundle, createRoverSiteProfile, createRoverSiteProfileJson, createRoverServiceDescLinkHeader, createRoverScriptTagSnippet, createRoverWellKnownAgentCard, createRoverWellKnownSiteProfile, readRoverScriptDataAttributes, };
 export type { RoverOwnerInstallBootConfig, RoverOwnerInstallBundle, RoverOwnerInstallBundleInput, RoverOwnerInstallRoverBookConfig, };

package/dist/ownerInstall.js

@@ -1,4 +1,4 @@
-import { DEFAULT_AGENT_CARD_PATH, DEFAULT_ROVER_SITE_PATH, createRoverAgentCard, createRoverAgentCardJson, createRoverSiteProfile, createRoverSiteProfileJson, createRoverServiceDescLinkHeader, } from './agentDiscovery.js';
+import { DEFAULT_AGENT_CARD_PATH, DEFAULT_LLMS_PATH, DEFAULT_ROVER_SITE_PATH, createRoverAgentCard, createRoverAgentCardJson, createRoverSiteProfile, createRoverSiteProfileJson, createRoverServiceDescLinkHeader, } from './agentDiscovery.js';
 const DEFAULT_EMBED_SCRIPT_URL = 'https://rover.rtrvr.ai/embed.js';
 const DEFAULT_ROVERBOOK_SCRIPT_URL = 'https://rover.rtrvr.ai/roverbook.js';
 function text(value) {
@@ -172,6 +172,8 @@ function buildDefaultLlmsTxt(card, options) {
         'Prefer Rover shortcuts, explicit site tools, and A2W runs over raw DOM automation when they match the requested outcome.',
         `Primary A2W run endpoint: ${text(card.extensions?.rover.runEndpoint || card.url)}`,
         `A2W workflow endpoint: ${text(card.extensions?.rover.workflowEndpoint)}`,
+        'Create runs with { "url": "<site>", "prompt": "<instruction>" } or { "url": "<site>", "shortcutId": "<id>" }; "goal" is accepted as a compatibility alias.',
+        'For browserless execution, send Prefer: execution=cloud, wait=10 and follow returned links.stream, links.ndjson, or links.poll until completed, failed, cancelled, expired, or input_required.',
         `Capability card: ${options.agentCardUrl}`,
     ];
     const skills = card.skills
@@ -260,20 +262,23 @@ function buildRoverBookAttachScript(config, options) {
 export function createRoverOwnerInstallBundle(input) {
     const bootConfig = materializeCloudSandboxBootConfig(input.bootConfig);
     const discoveryConfig = discoveryEnabled(input.discovery) ? input.discovery : null;
+    const publishLlmsTxt = llmsEnabled(input, discoveryConfig);
     const publishedAgentCardUrl = discoveryConfig ? text(discoveryConfig.agentCardUrl) || DEFAULT_AGENT_CARD_PATH : '';
     const publishedRoverSiteUrl = discoveryConfig ? text(discoveryConfig.roverSiteUrl) || DEFAULT_ROVER_SITE_PATH : '';
-    const publishLlmsTxt = llmsEnabled(input, discoveryConfig);
-    const publishedLlmsUrl = discoveryConfig ? text(discoveryConfig.llmsUrl) : '';
+    const publishedLlmsUrl = discoveryConfig ? text(discoveryConfig.llmsUrl) || (publishLlmsTxt ? DEFAULT_LLMS_PATH : '') : '';
+    const effectiveDiscoveryConfig = discoveryConfig && publishedLlmsUrl && !text(discoveryConfig.llmsUrl)
+        ? { ...discoveryConfig, llmsUrl: publishedLlmsUrl }
+        : discoveryConfig;
     const embedScriptUrl = text(input.embedScriptUrl) || DEFAULT_EMBED_SCRIPT_URL;
     const roverBookEnabled = input.roverBook?.enabled !== false && hasObjectEntries(input.roverBook?.config);
     const roverBookScriptUrl = roverBookEnabled
         ? (text(input.roverBook?.scriptUrl) || DEFAULT_ROVERBOOK_SCRIPT_URL)
         : '';
-    const agentCard = discoveryConfig ? createRoverAgentCard(discoveryConfig) : undefined;
-    const agentCardJson = discoveryConfig ? createRoverAgentCardJson(discoveryConfig) : undefined;
-    const roverSite = discoveryConfig ? createRoverSiteProfile(discoveryConfig) : undefined;
-    const roverSiteJson = discoveryConfig ? createRoverSiteProfileJson(discoveryConfig) : undefined;
-    const pageManifestJson = discoveryConfig
+    const agentCard = effectiveDiscoveryConfig ? createRoverAgentCard(effectiveDiscoveryConfig) : undefined;
+    const agentCardJson = effectiveDiscoveryConfig ? createRoverAgentCardJson(effectiveDiscoveryConfig) : undefined;
+    const roverSite = effectiveDiscoveryConfig ? createRoverSiteProfile(effectiveDiscoveryConfig) : undefined;
+    const roverSiteJson = effectiveDiscoveryConfig ? createRoverSiteProfileJson(effectiveDiscoveryConfig) : undefined;
+    const pageManifestJson = effectiveDiscoveryConfig
         ? JSON.stringify(agentCard?.extensions?.rover.currentPage || null, null, 2)
         : undefined;
     const marker = agentCard && publishedAgentCardUrl

package/dist/previewBootstrap.d.ts

@@ -7,8 +7,24 @@ export type RoverPreviewBootstrapVoiceConfig = {
     language?: string;
     autoStopMs?: number;
 };
+export type RoverPreviewBootstrapExperienceConfig = {
+    audio?: {
+        narration?: {
+            enabled?: boolean;
+            defaultMode?: 'guided' | 'always' | 'off';
+            rate?: number;
+            language?: string;
+            voicePreference?: 'auto' | 'system' | 'natural';
+        };
+    };
+    motion?: {
+        actionSpotlight?: boolean;
+        actionSpotlightColor?: string;
+    };
+};
 export type RoverPreviewBootstrapUiConfig = {
     voice?: RoverPreviewBootstrapVoiceConfig;
+    experience?: RoverPreviewBootstrapExperienceConfig;
 };
 export type RoverPreviewBootstrapConfig = {
     scriptUrl?: string;
@@ -21,10 +37,14 @@ export type RoverPreviewBootstrapConfig = {
     workerUrl?: string;
     allowedDomains?: string[];
     domainScopeMode?: 'host_only' | 'registrable_domain';
+    cloudSandboxEnabled?: boolean;
     sessionScope?: 'shared_site' | 'tab';
     openOnInit?: boolean;
     mode?: 'safe' | 'full';
     allowActions?: boolean;
+    pageConfig?: {
+        disableAutoScroll?: boolean;
+    };
     ui?: RoverPreviewBootstrapUiConfig;
     attachLaunch?: RoverPreviewAttachLaunch;
 };

package/dist/previewBootstrap.js

@@ -2,6 +2,8 @@ const DEFAULT_EMBED_SCRIPT_URL = 'https://rover.rtrvr.ai/embed.js';
 const DEFAULT_AGENT_BASE = 'https://agent.rtrvr.ai';
 const VOICE_AUTO_STOP_MIN_MS = 800;
 const VOICE_AUTO_STOP_MAX_MS = 5000;
+const NARRATION_RATE_MIN = 0.85;
+const NARRATION_RATE_MAX = 1.15;
 function toStringValue(value) {
     return String(value || '').trim();
 }
@@ -41,6 +43,13 @@ function parseIntegerAttr(value) {
     const parsed = Number(toStringValue(value));
     return Number.isFinite(parsed) ? Math.trunc(parsed) : undefined;
 }
+function normalizeHexColor(value) {
+    const raw = toStringValue(value);
+    if (!raw)
+        return undefined;
+    const match = raw.match(/^#?([0-9a-fA-F]{6})$/);
+    return match ? `#${match[1].toUpperCase()}` : undefined;
+}
 function normalizeVoiceConfig(value) {
     if (!value || typeof value !== 'object')
         return undefined;
@@ -56,6 +65,53 @@ function normalizeVoiceConfig(value) {
     }
     return Object.keys(voice).length ? voice : undefined;
 }
+function normalizeExperienceConfig(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const experience = {};
+    if (value.audio && typeof value.audio === 'object') {
+        const narrationInput = value.audio.narration && typeof value.audio.narration === 'object'
+            ? value.audio.narration
+            : undefined;
+        if (narrationInput) {
+            const narration = {};
+            if (typeof narrationInput.enabled === 'boolean')
+                narration.enabled = narrationInput.enabled;
+            if (narrationInput.defaultMode === 'guided' ||
+                narrationInput.defaultMode === 'always' ||
+                narrationInput.defaultMode === 'off') {
+                narration.defaultMode = narrationInput.defaultMode;
+            }
+            const rate = Number(narrationInput.rate);
+            if (Number.isFinite(rate)) {
+                narration.rate = Math.max(NARRATION_RATE_MIN, Math.min(NARRATION_RATE_MAX, rate));
+            }
+            const language = toStringValue(narrationInput.language).replace(/[^a-zA-Z0-9-]/g, '').slice(0, 24);
+            if (language)
+                narration.language = language;
+            if (narrationInput.voicePreference === 'auto' ||
+                narrationInput.voicePreference === 'system' ||
+                narrationInput.voicePreference === 'natural') {
+                narration.voicePreference = narrationInput.voicePreference;
+            }
+            if (Object.keys(narration).length)
+                experience.audio = { narration };
+        }
+    }
+    if (value.motion && typeof value.motion === 'object') {
+        const motion = {};
+        if (typeof value.motion.actionSpotlight === 'boolean') {
+            motion.actionSpotlight = value.motion.actionSpotlight;
+        }
+        const actionSpotlightColor = normalizeHexColor(value.motion.actionSpotlightColor);
+        if (actionSpotlightColor) {
+            motion.actionSpotlightColor = actionSpotlightColor;
+        }
+        if (Object.keys(motion).length)
+            experience.motion = motion;
+    }
+    return Object.keys(experience).length ? experience : undefined;
+}
 function normalizeUiConfig(value) {
     if (!value || typeof value !== 'object')
         return undefined;
@@ -63,6 +119,9 @@ function normalizeUiConfig(value) {
     const voice = normalizeVoiceConfig(value.voice);
     if (voice)
         ui.voice = voice;
+    const experience = normalizeExperienceConfig(value.experience);
+    if (experience)
+        ui.experience = experience;
     return Object.keys(ui).length ? ui : undefined;
 }
 function normalizeBootstrapConfig(config) {
@@ -98,6 +157,8 @@ function buildBootstrapPayload(config) {
         payload.allowedDomains = normalized.allowedDomains;
     if (normalized.domainScopeMode)
         payload.domainScopeMode = normalized.domainScopeMode;
+    if (typeof normalized.cloudSandboxEnabled === 'boolean')
+        payload.cloudSandboxEnabled = normalized.cloudSandboxEnabled;
     if (normalized.sessionScope)
         payload.sessionScope = normalized.sessionScope;
     if (typeof normalized.openOnInit === 'boolean')
@@ -106,8 +167,11 @@ function buildBootstrapPayload(config) {
         payload.mode = normalized.mode;
     if (typeof normalized.allowActions === 'boolean')
         payload.allowActions = normalized.allowActions;
-    if (normalized.ui?.voice)
-        payload.ui = { voice: normalized.ui.voice };
+    if (typeof normalized.pageConfig?.disableAutoScroll === 'boolean') {
+        payload.pageConfig = { disableAutoScroll: normalized.pageConfig.disableAutoScroll };
+    }
+    if (normalized.ui)
+        payload.ui = normalized.ui;
     return payload;
 }
 function buildQueueStub() {
@@ -180,6 +244,8 @@ export function createRoverScriptTagSnippet(config) {
         attrs.push(`data-allowed-domains="${escapeHtmlAttr(normalized.allowedDomains.join(','))}"`);
     if (normalized.domainScopeMode)
         attrs.push(`data-domain-scope-mode="${escapeHtmlAttr(normalized.domainScopeMode)}"`);
+    if (typeof normalized.cloudSandboxEnabled === 'boolean')
+        attrs.push(`data-cloud-sandbox-enabled="${escapeHtmlAttr(String(normalized.cloudSandboxEnabled))}"`);
     if (normalized.sessionScope)
         attrs.push(`data-session-scope="${escapeHtmlAttr(normalized.sessionScope)}"`);
     if (typeof normalized.openOnInit === 'boolean')
@@ -188,14 +254,34 @@ export function createRoverScriptTagSnippet(config) {
         attrs.push(`data-mode="${escapeHtmlAttr(normalized.mode)}"`);
     if (typeof normalized.allowActions === 'boolean')
         attrs.push(`data-allow-actions="${escapeHtmlAttr(String(normalized.allowActions))}"`);
+    if (typeof normalized.pageConfig?.disableAutoScroll === 'boolean') {
+        attrs.push(`data-disable-auto-scroll="${escapeHtmlAttr(String(normalized.pageConfig.disableAutoScroll))}"`);
+    }
     if (typeof normalized.ui?.voice?.enabled === 'boolean')
         attrs.push(`data-voice-enabled="${escapeHtmlAttr(String(normalized.ui.voice.enabled))}"`);
     if (normalized.ui?.voice?.language)
         attrs.push(`data-voice-language="${escapeHtmlAttr(normalized.ui.voice.language)}"`);
     if (typeof normalized.ui?.voice?.autoStopMs === 'number')
         attrs.push(`data-voice-auto-stop-ms="${escapeHtmlAttr(String(normalized.ui.voice.autoStopMs))}"`);
+    const narration = normalized.ui?.experience?.audio?.narration;
+    if (typeof narration?.enabled === 'boolean')
+        attrs.push(`data-narration-enabled="${escapeHtmlAttr(String(narration.enabled))}"`);
+    if (narration?.defaultMode)
+        attrs.push(`data-narration-default-mode="${escapeHtmlAttr(narration.defaultMode)}"`);
+    if (typeof narration?.rate === 'number')
+        attrs.push(`data-narration-rate="${escapeHtmlAttr(String(narration.rate))}"`);
+    if (narration?.language)
+        attrs.push(`data-narration-language="${escapeHtmlAttr(narration.language)}"`);
+    if (narration?.voicePreference)
+        attrs.push(`data-narration-voice-preference="${escapeHtmlAttr(narration.voicePreference)}"`);
+    if (typeof normalized.ui?.experience?.motion?.actionSpotlight === 'boolean') {
+        attrs.push(`data-action-spotlight="${escapeHtmlAttr(String(normalized.ui.experience.motion.actionSpotlight))}"`);
+    }
+    if (normalized.ui?.experience?.motion?.actionSpotlightColor) {
+        attrs.push(`data-action-spotlight-color="${escapeHtmlAttr(normalized.ui.experience.motion.actionSpotlightColor)}"`);
+    }
     const runEndpoint = `${toStringValue(normalized.apiBase) || DEFAULT_AGENT_BASE}/v1/a2w/runs`;
-    const markerJson = escapeScriptJson(JSON.stringify({ a2w: runEndpoint, run: runEndpoint, task: runEndpoint }));
+    const markerJson = escapeScriptJson(JSON.stringify({ a2w: runEndpoint, run: runEndpoint }));
     return [
         `<script type="application/agent+json" data-rover-agent-discovery="marker">${markerJson}</script>`,
         '<link rel="service-desc" href="/.well-known/agent-card.json" type="application/json" data-rover-agent-discovery="service-desc" />',
@@ -235,6 +321,9 @@ export function readRoverScriptDataAttributes(scriptEl) {
     if (domainScopeMode === 'host_only' || domainScopeMode === 'registrable_domain') {
         config.domainScopeMode = domainScopeMode;
     }
+    const cloudSandboxEnabled = parseBooleanAttr(scriptEl.getAttribute('data-cloud-sandbox-enabled'));
+    if (typeof cloudSandboxEnabled === 'boolean')
+        config.cloudSandboxEnabled = cloudSandboxEnabled;
     const sessionScope = toStringValue(scriptEl.getAttribute('data-session-scope'));
     if (sessionScope === 'shared_site' || sessionScope === 'tab') {
         config.sessionScope = sessionScope;
@@ -249,16 +338,50 @@ export function readRoverScriptDataAttributes(scriptEl) {
     const allowActions = parseBooleanAttr(scriptEl.getAttribute('data-allow-actions'));
     if (typeof allowActions === 'boolean')
         config.allowActions = allowActions;
+    const disableAutoScroll = parseBooleanAttr(scriptEl.getAttribute('data-disable-auto-scroll'));
+    if (typeof disableAutoScroll === 'boolean')
+        config.pageConfig = { disableAutoScroll };
     const voiceEnabled = parseBooleanAttr(scriptEl.getAttribute('data-voice-enabled'));
     const voiceLanguage = toStringValue(scriptEl.getAttribute('data-voice-language'));
     const voiceAutoStopMs = parseIntegerAttr(scriptEl.getAttribute('data-voice-auto-stop-ms'));
-    if (typeof voiceEnabled === 'boolean' || voiceLanguage || typeof voiceAutoStopMs === 'number') {
+    const narrationEnabled = parseBooleanAttr(scriptEl.getAttribute('data-narration-enabled'));
+    const narrationDefaultMode = toStringValue(scriptEl.getAttribute('data-narration-default-mode'));
+    const narrationRate = Number(toStringValue(scriptEl.getAttribute('data-narration-rate')));
+    const narrationLanguage = toStringValue(scriptEl.getAttribute('data-narration-language'));
+    const narrationVoicePreference = toStringValue(scriptEl.getAttribute('data-narration-voice-preference'));
+    const actionSpotlight = parseBooleanAttr(scriptEl.getAttribute('data-action-spotlight'));
+    const actionSpotlightColor = normalizeHexColor(scriptEl.getAttribute('data-action-spotlight-color'));
+    const voice = normalizeVoiceConfig({
+        ...(typeof voiceEnabled === 'boolean' ? { enabled: voiceEnabled } : {}),
+        ...(voiceLanguage ? { language: voiceLanguage } : {}),
+        ...(typeof voiceAutoStopMs === 'number' ? { autoStopMs: voiceAutoStopMs } : {}),
+    });
+    const experience = normalizeExperienceConfig({
+        ...(typeof narrationEnabled === 'boolean' || narrationDefaultMode || Number.isFinite(narrationRate) || narrationLanguage || narrationVoicePreference
+            ? {
+                audio: {
+                    narration: {
+                        ...(typeof narrationEnabled === 'boolean' ? { enabled: narrationEnabled } : {}),
+                        ...(narrationDefaultMode === 'guided' || narrationDefaultMode === 'always' || narrationDefaultMode === 'off'
+                            ? { defaultMode: narrationDefaultMode }
+                            : {}),
+                        ...(Number.isFinite(narrationRate) ? { rate: narrationRate } : {}),
+                        ...(narrationLanguage ? { language: narrationLanguage } : {}),
+                        ...(narrationVoicePreference === 'auto' || narrationVoicePreference === 'system' || narrationVoicePreference === 'natural'
+                            ? { voicePreference: narrationVoicePreference }
+                            : {}),
+                    },
+                },
+            }
+            : {}),
+        ...(typeof actionSpotlight === 'boolean' || actionSpotlightColor
+            ? { motion: { ...(typeof actionSpotlight === 'boolean' ? { actionSpotlight } : {}), ...(actionSpotlightColor ? { actionSpotlightColor } : {}) } }
+            : {}),
+    });
+    if (voice || experience) {
         config.ui = {
-            voice: {
-                ...(typeof voiceEnabled === 'boolean' ? { enabled: voiceEnabled } : {}),
-                ...(voiceLanguage ? { language: voiceLanguage } : {}),
-                ...(typeof voiceAutoStopMs === 'number' ? { autoStopMs: voiceAutoStopMs } : {}),
-            },
+            ...(voice ? { voice } : {}),
+            ...(experience ? { experience } : {}),
         };
     }
     return config;