@qoniai/qoni 0.5.2 → 0.6.0

package/dist/index.d.cts

@@ -445,6 +445,8 @@ declare const QoniEventTypes: {
     readonly Interaction: "interaction";
     /** A live screenshot frame (opt in with `capture: { screenshots: true }`); image on `event.image`. */
     readonly Screenshot: "screenshot";
+    /** The browser viewer moved to a new page or needs a fresh attachment. Use `event.data.liveUrl` for the live preview. */
+    readonly BrowserLiveUrlChanged: "browserLiveUrlChanged";
     /** Terminal — the run finished; outcome + output in `event.data` (cost is on the `RunResult`). */
     readonly Done: "done";
     /** Web Search results are ready; `event.data` is the count (the list is in `done.output`). */
@@ -487,6 +489,13 @@ interface RunScreenshotData {
     pageUrl?: string;
     step?: number;
 }
+/** `browserLiveUrlChanged` — the provider's live viewer URL can rotate as tabs change. */
+interface RunBrowserLiveUrlChangedData {
+    liveUrl: string;
+    supportsLivePump: boolean;
+    forceViewerReload: boolean;
+    providerSessionId?: string;
+}
 /** `done` — terminal outcome + final output. (Total cost is on the `RunResult`.) */
 interface RunDoneData {
     output?: unknown;
@@ -510,6 +519,10 @@ type RunEvent = (RunEventBase & {
     data: RunScreenshotData;
     image: RunImage;
     isTerminal: false;
+}) | (RunEventBase & {
+    type: "browserLiveUrlChanged";
+    data: RunBrowserLiveUrlChangedData;
+    isTerminal: false;
 }) | (RunEventBase & {
     type: "done";
     data: RunDoneData;
@@ -541,7 +554,7 @@ type RunEvent = (RunEventBase & {
 });
 /** Events any product run can emit. */
 type CoreRunEvent = Extract<RunEvent, {
-    type: "progress" | "message" | "interaction" | "screenshot" | "done";
+    type: "progress" | "message" | "interaction" | "screenshot" | "browserLiveUrlChanged" | "done";
 }>;
 /** Do Anything — core events only. */
 type DoAnythingEvent = CoreRunEvent;
@@ -1394,4 +1407,4 @@ declare const QoniScopeBundles: {
     readonly TRACK: readonly ["webagent.track:read", "webagent.track:manage"];
 };
 
-export { type Action, type ActionKind, ActionKinds, type Artifact, type BrowserProxyOptions, type BrowserbaseRegion, type CaptureOptions, type ClarificationPayload, type CompleteDelegateAgentInput, type CompleteDelegateTokenInput, type ConfirmationPayload, type CoreRunEvent, type DeepResearchAttachOptions, type DeepResearchEvent, type DeepResearchRunOptions, type DelegateAgentInput, type DelegateAgentResponse, type DelegateAgentTokenResponse, type DelegateTokenInput, type DelegateTokenInteractiveInput, type DelegateTokenResponse, type DelegateTokenResult, type DelegateTokenSilentInput, type DelegateTokenSilentResponse, type DelegationMode, type DelegationTokenResponse, type DoAnythingAttachOptions, type DoAnythingEvent, type DoAnythingRunOptions, type DoAnythingSnapshot, type GenAuthAccessTokenInput, type GenAuthAdminToken, type GenAuthAdminTokenOverrideInput, type GenAuthDelegationIntrospectionInput, type GenAuthUserCreateBatchInput, type GenAuthUserCreateInput, type GenAuthUserDeleteBatchInput, type GenAuthUserGetBatchInput, type GenAuthUserGetInput, type GenAuthUserListInput, type GenAuthUserUpdateInput, type Interaction, type InteractionEvidence, InteractionHandle, type InteractionPayloadByType, type InteractionSite, type InteractionStatus, InteractionStatuses, type InteractionType, InteractionTypes, type InteractiveDelegationResponse, type JsonObject, type MonitorEvent, type MonitorEventsOptions, MonitorHandle, type MonitorRunsOptions, Qoni, QoniAuthError, QoniDelegationRequiredError, QoniError, type QoniErrorCode, type QoniErrorOptions, type QoniEvent, type QoniEventType, QoniEventTypes, type QoniMeta, type QoniOptions, QoniPermissionDeniedError, type QoniProduct, type QoniProductName, QoniProductScopes, QoniRateLimitError, type QoniResponse, type QoniRuntimeConfig, type QoniSSEEvent, QoniScopeBundles, QoniScopes, QoniTimeoutError, QoniTokenExpiredError, QoniUpstreamError, QoniValidationError, type RawRequestInput, type RunDoneData, type RunEvent, type RunEventsOptions, RunHandle, type RunImage, type RunLimits, type RunMessageData, type RunReconnectInfo, type RunResult, type RunScreenshotData, type RunStatus, type RunWaitOptions, type RuntimeTokenInput, type SessionRef, type SiteLoginPayload, type SnapshotAction, type SnapshotImage, type TakeControlPayload, type TokenInput, type TrackAttachOptions, type TrackCreateOptions, type WaitKind, type WaitPayload, type WebSearchAttachOptions, type WebSearchEvent, type WebSearchRunOptions, buildAuthorization, buildSignature, buildStringToSign };
+export { type Action, type ActionKind, ActionKinds, type Artifact, type BrowserProxyOptions, type BrowserbaseRegion, type CaptureOptions, type ClarificationPayload, type CompleteDelegateAgentInput, type CompleteDelegateTokenInput, type ConfirmationPayload, type CoreRunEvent, type DeepResearchAttachOptions, type DeepResearchEvent, type DeepResearchRunOptions, type DelegateAgentInput, type DelegateAgentResponse, type DelegateAgentTokenResponse, type DelegateTokenInput, type DelegateTokenInteractiveInput, type DelegateTokenResponse, type DelegateTokenResult, type DelegateTokenSilentInput, type DelegateTokenSilentResponse, type DelegationMode, type DelegationTokenResponse, type DoAnythingAttachOptions, type DoAnythingEvent, type DoAnythingRunOptions, type DoAnythingSnapshot, type GenAuthAccessTokenInput, type GenAuthAdminToken, type GenAuthAdminTokenOverrideInput, type GenAuthDelegationIntrospectionInput, type GenAuthUserCreateBatchInput, type GenAuthUserCreateInput, type GenAuthUserDeleteBatchInput, type GenAuthUserGetBatchInput, type GenAuthUserGetInput, type GenAuthUserListInput, type GenAuthUserUpdateInput, type Interaction, type InteractionEvidence, InteractionHandle, type InteractionPayloadByType, type InteractionSite, type InteractionStatus, InteractionStatuses, type InteractionType, InteractionTypes, type InteractiveDelegationResponse, type JsonObject, type MonitorEvent, type MonitorEventsOptions, MonitorHandle, type MonitorRunsOptions, Qoni, QoniAuthError, QoniDelegationRequiredError, QoniError, type QoniErrorCode, type QoniErrorOptions, type QoniEvent, type QoniEventType, QoniEventTypes, type QoniMeta, type QoniOptions, QoniPermissionDeniedError, type QoniProduct, type QoniProductName, QoniProductScopes, QoniRateLimitError, type QoniResponse, type QoniRuntimeConfig, type QoniSSEEvent, QoniScopeBundles, QoniScopes, QoniTimeoutError, QoniTokenExpiredError, QoniUpstreamError, QoniValidationError, type RawRequestInput, type RunBrowserLiveUrlChangedData, type RunDoneData, type RunEvent, type RunEventsOptions, RunHandle, type RunImage, type RunLimits, type RunMessageData, type RunReconnectInfo, type RunResult, type RunScreenshotData, type RunStatus, type RunWaitOptions, type RuntimeTokenInput, type SessionRef, type SiteLoginPayload, type SnapshotAction, type SnapshotImage, type TakeControlPayload, type TokenInput, type TrackAttachOptions, type TrackCreateOptions, type WaitKind, type WaitPayload, type WebSearchAttachOptions, type WebSearchEvent, type WebSearchRunOptions, buildAuthorization, buildSignature, buildStringToSign };

package/dist/index.d.ts

@@ -445,6 +445,8 @@ declare const QoniEventTypes: {
     readonly Interaction: "interaction";
     /** A live screenshot frame (opt in with `capture: { screenshots: true }`); image on `event.image`. */
     readonly Screenshot: "screenshot";
+    /** The browser viewer moved to a new page or needs a fresh attachment. Use `event.data.liveUrl` for the live preview. */
+    readonly BrowserLiveUrlChanged: "browserLiveUrlChanged";
     /** Terminal — the run finished; outcome + output in `event.data` (cost is on the `RunResult`). */
     readonly Done: "done";
     /** Web Search results are ready; `event.data` is the count (the list is in `done.output`). */
@@ -487,6 +489,13 @@ interface RunScreenshotData {
     pageUrl?: string;
     step?: number;
 }
+/** `browserLiveUrlChanged` — the provider's live viewer URL can rotate as tabs change. */
+interface RunBrowserLiveUrlChangedData {
+    liveUrl: string;
+    supportsLivePump: boolean;
+    forceViewerReload: boolean;
+    providerSessionId?: string;
+}
 /** `done` — terminal outcome + final output. (Total cost is on the `RunResult`.) */
 interface RunDoneData {
     output?: unknown;
@@ -510,6 +519,10 @@ type RunEvent = (RunEventBase & {
     data: RunScreenshotData;
     image: RunImage;
     isTerminal: false;
+}) | (RunEventBase & {
+    type: "browserLiveUrlChanged";
+    data: RunBrowserLiveUrlChangedData;
+    isTerminal: false;
 }) | (RunEventBase & {
     type: "done";
     data: RunDoneData;
@@ -541,7 +554,7 @@ type RunEvent = (RunEventBase & {
 });
 /** Events any product run can emit. */
 type CoreRunEvent = Extract<RunEvent, {
-    type: "progress" | "message" | "interaction" | "screenshot" | "done";
+    type: "progress" | "message" | "interaction" | "screenshot" | "browserLiveUrlChanged" | "done";
 }>;
 /** Do Anything — core events only. */
 type DoAnythingEvent = CoreRunEvent;
@@ -1394,4 +1407,4 @@ declare const QoniScopeBundles: {
     readonly TRACK: readonly ["webagent.track:read", "webagent.track:manage"];
 };
 
-export { type Action, type ActionKind, ActionKinds, type Artifact, type BrowserProxyOptions, type BrowserbaseRegion, type CaptureOptions, type ClarificationPayload, type CompleteDelegateAgentInput, type CompleteDelegateTokenInput, type ConfirmationPayload, type CoreRunEvent, type DeepResearchAttachOptions, type DeepResearchEvent, type DeepResearchRunOptions, type DelegateAgentInput, type DelegateAgentResponse, type DelegateAgentTokenResponse, type DelegateTokenInput, type DelegateTokenInteractiveInput, type DelegateTokenResponse, type DelegateTokenResult, type DelegateTokenSilentInput, type DelegateTokenSilentResponse, type DelegationMode, type DelegationTokenResponse, type DoAnythingAttachOptions, type DoAnythingEvent, type DoAnythingRunOptions, type DoAnythingSnapshot, type GenAuthAccessTokenInput, type GenAuthAdminToken, type GenAuthAdminTokenOverrideInput, type GenAuthDelegationIntrospectionInput, type GenAuthUserCreateBatchInput, type GenAuthUserCreateInput, type GenAuthUserDeleteBatchInput, type GenAuthUserGetBatchInput, type GenAuthUserGetInput, type GenAuthUserListInput, type GenAuthUserUpdateInput, type Interaction, type InteractionEvidence, InteractionHandle, type InteractionPayloadByType, type InteractionSite, type InteractionStatus, InteractionStatuses, type InteractionType, InteractionTypes, type InteractiveDelegationResponse, type JsonObject, type MonitorEvent, type MonitorEventsOptions, MonitorHandle, type MonitorRunsOptions, Qoni, QoniAuthError, QoniDelegationRequiredError, QoniError, type QoniErrorCode, type QoniErrorOptions, type QoniEvent, type QoniEventType, QoniEventTypes, type QoniMeta, type QoniOptions, QoniPermissionDeniedError, type QoniProduct, type QoniProductName, QoniProductScopes, QoniRateLimitError, type QoniResponse, type QoniRuntimeConfig, type QoniSSEEvent, QoniScopeBundles, QoniScopes, QoniTimeoutError, QoniTokenExpiredError, QoniUpstreamError, QoniValidationError, type RawRequestInput, type RunDoneData, type RunEvent, type RunEventsOptions, RunHandle, type RunImage, type RunLimits, type RunMessageData, type RunReconnectInfo, type RunResult, type RunScreenshotData, type RunStatus, type RunWaitOptions, type RuntimeTokenInput, type SessionRef, type SiteLoginPayload, type SnapshotAction, type SnapshotImage, type TakeControlPayload, type TokenInput, type TrackAttachOptions, type TrackCreateOptions, type WaitKind, type WaitPayload, type WebSearchAttachOptions, type WebSearchEvent, type WebSearchRunOptions, buildAuthorization, buildSignature, buildStringToSign };
+export { type Action, type ActionKind, ActionKinds, type Artifact, type BrowserProxyOptions, type BrowserbaseRegion, type CaptureOptions, type ClarificationPayload, type CompleteDelegateAgentInput, type CompleteDelegateTokenInput, type ConfirmationPayload, type CoreRunEvent, type DeepResearchAttachOptions, type DeepResearchEvent, type DeepResearchRunOptions, type DelegateAgentInput, type DelegateAgentResponse, type DelegateAgentTokenResponse, type DelegateTokenInput, type DelegateTokenInteractiveInput, type DelegateTokenResponse, type DelegateTokenResult, type DelegateTokenSilentInput, type DelegateTokenSilentResponse, type DelegationMode, type DelegationTokenResponse, type DoAnythingAttachOptions, type DoAnythingEvent, type DoAnythingRunOptions, type DoAnythingSnapshot, type GenAuthAccessTokenInput, type GenAuthAdminToken, type GenAuthAdminTokenOverrideInput, type GenAuthDelegationIntrospectionInput, type GenAuthUserCreateBatchInput, type GenAuthUserCreateInput, type GenAuthUserDeleteBatchInput, type GenAuthUserGetBatchInput, type GenAuthUserGetInput, type GenAuthUserListInput, type GenAuthUserUpdateInput, type Interaction, type InteractionEvidence, InteractionHandle, type InteractionPayloadByType, type InteractionSite, type InteractionStatus, InteractionStatuses, type InteractionType, InteractionTypes, type InteractiveDelegationResponse, type JsonObject, type MonitorEvent, type MonitorEventsOptions, MonitorHandle, type MonitorRunsOptions, Qoni, QoniAuthError, QoniDelegationRequiredError, QoniError, type QoniErrorCode, type QoniErrorOptions, type QoniEvent, type QoniEventType, QoniEventTypes, type QoniMeta, type QoniOptions, QoniPermissionDeniedError, type QoniProduct, type QoniProductName, QoniProductScopes, QoniRateLimitError, type QoniResponse, type QoniRuntimeConfig, type QoniSSEEvent, QoniScopeBundles, QoniScopes, QoniTimeoutError, QoniTokenExpiredError, QoniUpstreamError, QoniValidationError, type RawRequestInput, type RunBrowserLiveUrlChangedData, type RunDoneData, type RunEvent, type RunEventsOptions, RunHandle, type RunImage, type RunLimits, type RunMessageData, type RunReconnectInfo, type RunResult, type RunScreenshotData, type RunStatus, type RunWaitOptions, type RuntimeTokenInput, type SessionRef, type SiteLoginPayload, type SnapshotAction, type SnapshotImage, type TakeControlPayload, type TokenInput, type TrackAttachOptions, type TrackCreateOptions, type WaitKind, type WaitPayload, type WebSearchAttachOptions, type WebSearchEvent, type WebSearchRunOptions, buildAuthorization, buildSignature, buildStringToSign };

package/dist/index.js

@@ -230,6 +230,8 @@ var QoniEventTypes = {
   Interaction: "interaction",
   /** A live screenshot frame (opt in with `capture: { screenshots: true }`); image on `event.image`. */
   Screenshot: "screenshot",
+  /** The browser viewer moved to a new page or needs a fresh attachment. Use `event.data.liveUrl` for the live preview. */
+  BrowserLiveUrlChanged: "browserLiveUrlChanged",
   /** Terminal — the run finished; outcome + output in `event.data` (cost is on the `RunResult`). */
   Done: "done",
   // --- Web Search ---
@@ -360,7 +362,6 @@ var WIRE_TO_SEMANTIC = {
   "run.recording_started": "progress",
   "run.recording_paused": "progress",
   "run.recording_finalized": "progress",
-  "run.browser_live_url_changed": "progress",
   // side-channel
   "run.feedback_submitted": "progress"
 };
@@ -422,6 +423,18 @@ function normalizeRunEvent(wire, options = {}) {
       return { ...base, type: "screenshot", data: sData, image, isTerminal: false };
     }
   }
+  if (wireType === "run.browser_live_url_changed") {
+    const liveUrl = asString(c.liveUrl);
+    if (!liveUrl) return null;
+    const data2 = {
+      liveUrl,
+      supportsLivePump: c.supportsLivePump === true,
+      forceViewerReload: c.forceViewerReload === true
+    };
+    const providerSessionId = asString(c.providerSessionId);
+    if (providerSessionId) data2.providerSessionId = providerSessionId;
+    return { ...base, type: "browserLiveUrlChanged", data: data2, isTerminal: false };
+  }
   if (wireType === INTERACTION) {
     const interaction = normalizeInteraction(payload);
     if (interaction) {