@rtrvr-ai/rover 4.0.0 → 4.1.0

package/dist/index.d.ts

@@ -45,7 +45,6 @@ export type RoverInit = {
     pageConfig?: RoverPageCaptureConfig;
     allowedDomains?: string[];
     domainScopeMode?: 'host_only' | 'registrable_domain';
-    externalNavigationPolicy?: 'open_new_tab_notice' | 'block' | 'allow';
     tabPolicy?: {
         observerByDefault?: boolean;
         actionLeaseMs?: number;
@@ -55,9 +54,6 @@ export type RoverInit = {
         actHeuristicThreshold?: number;
         plannerOnActError?: boolean;
     };
-    navigation?: {
-        crossHostPolicy?: 'open_new_tab' | 'same_tab';
-    };
     timing?: {
         /** Delay (ms) before same-tab navigation executes, allowing state persistence. Default: 80 */
         navigationDelayMs?: number;
@@ -165,6 +161,7 @@ export type RoverInit = {
         };
         mascot?: {
             disabled?: boolean;
+            imageUrl?: string;
             mp4Url?: string;
             webmUrl?: string;
             soundEnabled?: boolean;
@@ -210,7 +207,7 @@ export type ClientToolDefinition = {
     annotations?: Record<string, any>;
     llmCallable?: boolean;
 };
-export type RoverEventName = 'ready' | 'updated' | 'status' | 'run_started' | 'run_state_transition' | 'run_completed' | 'tool_start' | 'tool_result' | 'error' | 'auth_required' | 'navigation_guardrail' | 'mode_change' | 'task_started' | 'task_ended' | 'task_suggested_reset' | 'context_restored' | 'checkpoint_state' | 'checkpoint_error' | 'tab_event_conflict_retry' | 'tab_event_conflict_exhausted' | 'checkpoint_token_missing' | 'open' | 'close';
+export type RoverEventName = 'ready' | 'updated' | 'status' | 'visit_started' | 'visit_ended' | 'run_started' | 'run_state_transition' | 'run_completed' | 'tool_start' | 'tool_result' | 'error' | 'auth_required' | 'navigation_guardrail' | 'mode_change' | 'task_suggested_reset' | 'context_restored' | 'checkpoint_state' | 'checkpoint_error' | 'tab_event_conflict_retry' | 'tab_event_conflict_exhausted' | 'checkpoint_token_missing' | 'open' | 'close';
 export type RoverEventHandler = (payload?: any) => void;
 export type RoverPromptContextEntry = {
     role?: 'model';
@@ -266,7 +263,7 @@ declare function buildPublicRunStartedPayload(msg: any): Record<string, unknown>
 declare function buildPublicRunLifecyclePayload(msg: any, completionState: ReturnType<typeof normalizeRunCompletionState>): Record<string, unknown>;
 export declare function getAgentCard(): RoverAgentCard | null;
 declare function normalizeRunCompletionState(msg: any): {
-    taskComplete: boolean;
+    runComplete: boolean;
     needsUserInput: boolean;
     terminalState: 'waiting_input' | 'in_progress' | 'completed' | 'failed';
     contextResetRecommended: boolean;

package/dist/ownerInstall.d.ts

@@ -13,7 +13,7 @@ export type RoverOwnerInstallBootConfig = {
     workerUrl?: string;
     allowedDomains?: string[];
     domainScopeMode?: 'host_only' | 'registrable_domain';
-    externalNavigationPolicy?: 'open_new_tab_notice' | 'block' | 'allow';
+    cloudSandboxEnabled?: boolean;
     sessionScope?: 'shared_site' | 'tab';
     openOnInit?: boolean;
     mode?: 'safe' | 'full';
@@ -25,9 +25,6 @@ export type RoverOwnerInstallBootConfig = {
         consume?: boolean;
     };
     pageConfig?: RoverPageCaptureConfig | null;
-    navigation?: {
-        crossHostPolicy?: 'open_new_tab' | 'same_tab';
-    };
     tabPolicy?: {
         observerByDefault?: boolean;
         actionLeaseMs?: number;
@@ -70,6 +67,7 @@ export type RoverOwnerInstallBootConfig = {
         };
         mascot?: {
             disabled?: boolean;
+            imageUrl?: string;
             mp4Url?: string;
             webmUrl?: string;
             soundEnabled?: boolean;

package/dist/ownerInstall.js

@@ -135,8 +135,10 @@ function llmsEnabled(input, config) {
     return input.emitLlmsTxt === true || !!text(config.llmsUrl);
 }
 function buildOwnerMarker(card, publishedAgentCardUrl) {
+    const runEndpoint = card.extensions?.rover.runEndpoint;
     return {
-        task: card.extensions?.rover.taskEndpoint,
+        a2w: runEndpoint,
+        run: runEndpoint,
         card: publishedAgentCardUrl,
         roverSite: card.extensions?.rover.roverSiteUrl,
         site: card.extensions?.rover.siteUrl,
@@ -167,9 +169,9 @@ function buildDefaultLlmsTxt(card, options) {
         '',
         card.description,
         '',
-        'Prefer Rover shortcuts, explicit site tools, and public task flows over raw DOM automation when they match the requested outcome.',
-        `Primary task endpoint: ${text(card.extensions?.rover.taskEndpoint || card.url)}`,
-        `Workflow endpoint: ${text(card.extensions?.rover.workflowEndpoint)}`,
+        '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)}`,
         `Capability card: ${options.agentCardUrl}`,
     ];
     const skills = card.skills
@@ -177,7 +179,7 @@ function buildDefaultLlmsTxt(card, options) {
         id: text(skill.id),
         name: text(skill.name),
         description: text(skill.description),
-        interface: text(skill.preferredInterface || skill.rover?.source || 'task'),
+        interface: text(skill.preferredInterface || skill.rover?.source || 'run'),
     }))
         .filter(skill => skill.id && skill.name);
     if (skills.length > 0) {
@@ -203,11 +205,28 @@ function buildQueueStubLines() {
         '(function(){ var r = window.rover = window.rover || function(){ (r.q = r.q || []).push(arguments); }; r.l = +new Date(); })();',
     ];
 }
+function materializeCloudSandboxBootConfig(bootConfig) {
+    if (bootConfig.cloudSandboxEnabled !== true) {
+        return bootConfig;
+    }
+    return {
+        ...bootConfig,
+        tools: {
+            ...(bootConfig.tools || {}),
+            web: {
+                ...(bootConfig.tools?.web || {}),
+                enableExternalWebContext: true,
+                scrapeMode: 'on_demand',
+            },
+        },
+    };
+}
 function buildBootScript(bootConfig) {
+    const normalizedBootConfig = materializeCloudSandboxBootConfig(bootConfig);
     const lines = [
         '<script>',
         ...buildQueueStubLines().map(line => `  ${line}`),
-        `  rover('boot', ${indentJson(bootConfig)});`,
+        `  rover('boot', ${indentJson(normalizedBootConfig)});`,
         '</script>',
     ];
     return lines.join('\n');
@@ -239,7 +258,7 @@ function buildRoverBookAttachScript(config, options) {
     ].join('\n');
 }
 export function createRoverOwnerInstallBundle(input) {
-    const bootConfig = input.bootConfig;
+    const bootConfig = materializeCloudSandboxBootConfig(input.bootConfig);
     const discoveryConfig = discoveryEnabled(input.discovery) ? input.discovery : null;
     const publishedAgentCardUrl = discoveryConfig ? text(discoveryConfig.agentCardUrl) || DEFAULT_AGENT_CARD_PATH : '';
     const publishedRoverSiteUrl = discoveryConfig ? text(discoveryConfig.roverSiteUrl) || DEFAULT_ROVER_SITE_PATH : '';

package/dist/previewBootstrap.d.ts

@@ -21,7 +21,6 @@ export type RoverPreviewBootstrapConfig = {
     workerUrl?: string;
     allowedDomains?: string[];
     domainScopeMode?: 'host_only' | 'registrable_domain';
-    externalNavigationPolicy?: 'open_new_tab_notice' | 'block' | 'allow';
     sessionScope?: 'shared_site' | 'tab';
     openOnInit?: boolean;
     mode?: 'safe' | 'full';

package/dist/previewBootstrap.js

@@ -98,8 +98,6 @@ function buildBootstrapPayload(config) {
         payload.allowedDomains = normalized.allowedDomains;
     if (normalized.domainScopeMode)
         payload.domainScopeMode = normalized.domainScopeMode;
-    if (normalized.externalNavigationPolicy)
-        payload.externalNavigationPolicy = normalized.externalNavigationPolicy;
     if (normalized.sessionScope)
         payload.sessionScope = normalized.sessionScope;
     if (typeof normalized.openOnInit === 'boolean')
@@ -182,8 +180,6 @@ 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 (normalized.externalNavigationPolicy)
-        attrs.push(`data-external-navigation-policy="${escapeHtmlAttr(normalized.externalNavigationPolicy)}"`);
     if (normalized.sessionScope)
         attrs.push(`data-session-scope="${escapeHtmlAttr(normalized.sessionScope)}"`);
     if (typeof normalized.openOnInit === 'boolean')
@@ -198,8 +194,8 @@ export function createRoverScriptTagSnippet(config) {
         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 taskEndpoint = `${toStringValue(normalized.apiBase) || DEFAULT_AGENT_BASE}/v1/tasks`;
-    const markerJson = escapeScriptJson(JSON.stringify({ task: taskEndpoint }));
+    const runEndpoint = `${toStringValue(normalized.apiBase) || DEFAULT_AGENT_BASE}/v1/a2w/runs`;
+    const markerJson = escapeScriptJson(JSON.stringify({ a2w: runEndpoint, run: runEndpoint, task: 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" />',
@@ -239,10 +235,6 @@ export function readRoverScriptDataAttributes(scriptEl) {
     if (domainScopeMode === 'host_only' || domainScopeMode === 'registrable_domain') {
         config.domainScopeMode = domainScopeMode;
     }
-    const externalNavigationPolicy = toStringValue(scriptEl.getAttribute('data-external-navigation-policy'));
-    if (externalNavigationPolicy === 'open_new_tab_notice' || externalNavigationPolicy === 'block' || externalNavigationPolicy === 'allow') {
-        config.externalNavigationPolicy = externalNavigationPolicy;
-    }
     const sessionScope = toStringValue(scriptEl.getAttribute('data-session-scope'));
     if (sessionScope === 'shared_site' || sessionScope === 'tab') {
         config.sessionScope = sessionScope;