@rtrvr-ai/rover 2.2.0 → 3.0.0

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import type { RoverPageCaptureConfig } from '@rover/shared/lib/types/index.js';
-import { type RoverShortcut, type RoverVoiceConfig } from '@rover/ui';
+import { type RoverAskUserQuestion, type RoverShortcut, type RoverVoiceConfig } from '@rover/ui';
 import { type RoverCloudCheckpointState } from './cloudCheckpoint.js';
 import type { PersistedRuntimeState, PersistedWorkerState } from './runtimeTypes.js';
+import { type FollowupChatEntry } from './followupChatHeuristics.js';
 export type RoverWebToolsConfig = {
     enableExternalWebContext?: boolean;
     allowDomains?: string[];
@@ -198,8 +199,26 @@ export type ClientToolDefinition = {
     schema?: any;
     llmCallable?: boolean;
 };
-export type RoverEventName = 'ready' | 'updated' | 'status' | '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' | '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 RoverEventHandler = (payload?: any) => void;
+export type RoverPromptContextEntry = {
+    role?: 'model';
+    message: string;
+    source?: string;
+};
+export type RoverPromptContextInput = {
+    userText: string;
+    isFreshTask: boolean;
+    pageUrl: string;
+    taskId?: string;
+    taskBoundaryId?: string;
+    visitorId?: string;
+    visitor?: {
+        name?: string;
+        email?: string;
+    };
+};
+export type RoverPromptContextProvider = (input: RoverPromptContextInput) => string | RoverPromptContextEntry | Array<string | RoverPromptContextEntry> | null | undefined | Promise<string | RoverPromptContextEntry | Array<string | RoverPromptContextEntry> | null | undefined>;
 type RoverVoiceTelemetryEventName = 'voice_started' | 'voice_stopped' | 'voice_transcript_ready' | 'voice_error' | 'voice_permission_denied' | 'voice_provider_selected';
 export type RoverInstance = {
     boot: (cfg: RoverInit) => RoverInstance;
@@ -219,6 +238,8 @@ export type RoverInstance = {
         reason?: string;
     }) => void;
     getState: () => any;
+    requestSigned: (input: string | URL, init?: RequestInit) => Promise<Response>;
+    registerPromptContextProvider: (provider: RoverPromptContextProvider) => () => void;
     registerTool: (nameOrDef: string | ClientToolDefinition, handler: (args: any) => any | Promise<any>) => void;
     identify: (visitor: {
         name?: string;
@@ -227,6 +248,17 @@ export type RoverInstance = {
     on: (event: RoverEventName, handler: RoverEventHandler) => () => void;
 };
 type TelemetryEventName = RoverEventName | RoverVoiceTelemetryEventName;
+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>;
+declare function normalizeRunCompletionState(msg: any): {
+    taskComplete: boolean;
+    needsUserInput: boolean;
+    terminalState: 'waiting_input' | 'in_progress' | 'completed' | 'failed';
+    contextResetRecommended: boolean;
+    continuationReason?: 'loop_continue' | 'same_tab_navigation_handoff' | 'awaiting_user';
+    questions?: RoverAskUserQuestion[];
+};
 declare function sanitizeWorkerState(input: any): PersistedWorkerState | undefined;
 declare function cloneRuntimeStateForCheckpoint(state: PersistedRuntimeState): PersistedRuntimeState;
 export declare function identify(visitor: {
@@ -242,6 +274,8 @@ export declare function close(): void;
 export declare function show(): void;
 export declare function hide(): void;
 export declare function send(text: string): void;
+export declare function requestSigned(input: string | URL, init?: RequestInit): Promise<Response>;
+export declare function registerPromptContextProvider(provider: RoverPromptContextProvider): () => void;
 export declare function newTask(options?: {
     reason?: string;
     clearUi?: boolean;
@@ -259,6 +293,9 @@ export declare const __roverInternalsForTests: {
         maxCoalesceDelayMs: number;
     };
     getTelemetryFastLaneEvents: () => TelemetryEventName[];
+    normalizePromptContextEntry: typeof normalizePromptContextEntry;
+    buildPublicRunStartedPayload: typeof buildPublicRunStartedPayload;
+    buildPublicRunLifecyclePayload: typeof buildPublicRunLifecyclePayload;
 };
 export declare function installGlobal(): void;
 export {};