@modelprofile.com/browser-runtime 3.0.1 → 3.1.0

package/changelog.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2026-08-23 - 3.1.0
+
+### Features
+
+- add human frame stream refresh operation (frame-stream)
+  - Expose refreshFrameStream() on human leases with audited FIFO execution under the new frame-stream classification.
+  - Validate refreshed screencast boundaries and surface FRAME_STREAM_FAILED for refresh protocol failures.
+  - Keep refresh-owned acknowledgements within the configured outstanding frame window.
+  - Update SmartPuppeteer to ^2.5.0 for screencast refresh support.
+
 ## 2026-08-15 - 3.0.1
 
 ### Fixes

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@modelprofile.com/browser-runtime',
-    version: '3.0.1',
+    version: '3.1.0',
     description: 'Parent-owned, resource-centric Chromium runtime with revisioned attachment fencing, authenticated human and agent control, fail-closed egress, bounded artifacts, and Flex/MCP adapters.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxtQ0FBbUM7SUFDekMsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLDBMQUEwTDtDQUN4TSxDQUFBIn0=

package/dist_ts/classes.runtime.d.ts

@@ -1,6 +1,7 @@
 import * as plugins from './plugins.js';
 import { BrowserArtifactStore } from './classes.artifactstore.js';
 import { BrowserEgressProxy } from './classes.egressproxy.js';
+import { BrowserRuntimeError } from './errors.js';
 import { type IBrowserRuntimeTestingOptions } from './internal.testing.js';
 import type { IAttachTrustedFramedPeerOptions, IApplyBrowserAttachmentBindingRequest, IBrowserAttachmentBinding, TBrowserCapabilityDescriptor, TBrowserCapabilityAuthorizationRequest, TBrowserRuntimeLeaseAuthority, TBrowserRuntimeOperationClassification, IBrowserRuntimeFrameSubscription, IBrowserRuntimeOperationOptions, IBrowserRuntimeOptions, IBrowserResourceRegistration, IBrowserRuntimeState, ICreateBrowserResourceRequest, IRegisterBrowserResourceRequest, TIssueBrowserCapabilityRequest, TIssuedBrowserCapability, ILiveBrowserSessionLike, TBrowserActorRole, TBrowserAgentAction, TBrowserAgentActionResult, TBrowserRuntimeEvent } from './interfaces.js';
 import { TransitionMutex } from './utils.js';
@@ -52,6 +53,7 @@ interface IQueuedOperationRecord {
     onOperationStarted?: (operationId: string) => void;
     signal: AbortSignal;
     execute: (signal: AbortSignal, session: ILiveBrowserSessionLike) => Promise<unknown>;
+    finalize?: () => Promise<void>;
     resolve(value: unknown): void;
     reject(error: unknown): void;
     state: 'queued' | 'starting' | 'active' | 'settled';
@@ -59,10 +61,18 @@ interface IQueuedOperationRecord {
 }
 interface IOutstandingFrameRecord {
     acknowledgement: plugins.smartpuppeteer.ILiveBrowserFrameAcknowledgementRequest;
-    timer: ReturnType<typeof setTimeout>;
+    timer?: ReturnType<typeof setTimeout>;
     session: ILiveBrowserSessionLike;
     incarnationGeneration: number;
 }
+type TFrameAcknowledgementOutcome = {
+    status: 'fulfilled';
+    accepted: boolean;
+} | {
+    status: 'rejected';
+} | {
+    status: 'timedOut';
+};
 interface IFrameSubscriptionRecord {
     lease: ILeaseRecord;
     listener: (event: TBrowserRuntimeEvent) => void;
@@ -70,6 +80,22 @@ interface IFrameSubscriptionRecord {
     highestSequence: number;
     closed: boolean;
 }
+interface IFrameRefreshRecord {
+    lease: ILeaseRecord;
+    subscription: IFrameSubscriptionRecord;
+    session: ILiveBrowserSessionLike;
+    incarnationGeneration: number;
+    initialTabId: string;
+    initialGeneration: number;
+    initialViewportRevision: number;
+    startingHighestSequence: number;
+    pendingAcknowledgements: Set<Promise<TFrameAcknowledgementOutcome>>;
+    refreshStarted: boolean;
+    admissionClosed: boolean;
+    abandoned: boolean;
+    boundaryCandidate?: plugins.smartpuppeteer.ILiveBrowserFrameIdentity;
+    failure?: BrowserRuntimeError;
+}
 interface IResourceSlot {
     projectId: string;
     browserResourceId: string;
@@ -93,6 +119,7 @@ interface IResourceSlot {
     operationQueue: IQueuedOperationRecord[];
     operationSchedulerRunning: boolean;
     frameSubscription?: IFrameSubscriptionRecord;
+    frameRefresh?: IFrameRefreshRecord;
     idleTimer?: ReturnType<typeof setTimeout>;
     lifecycleTail: Promise<void>;
     lifecycleOperationCount: number;
@@ -176,6 +203,8 @@ export declare class BrowserRuntime {
     /** @internal */
     leaseSetViewport(lease: ILeaseRecord, viewport: plugins.smartpuppeteer.ILiveBrowserViewport, operationOptions?: IBrowserRuntimeOperationOptions): Promise<void>;
     /** @internal */
+    leaseRefreshFrameStream(lease: ILeaseRecord, operationOptions?: IBrowserRuntimeOperationOptions): Promise<void>;
+    /** @internal */
     leaseDispatchRawInput(lease: ILeaseRecord, action: 'dispatchMouse' | 'dispatchWheel' | 'dispatchKey' | 'insertText', input: plugins.smartpuppeteer.ILiveBrowserMouseInput | plugins.smartpuppeteer.ILiveBrowserWheelInput | plugins.smartpuppeteer.ILiveBrowserKeyInput | plugins.smartpuppeteer.ILiveBrowserInsertTextInput, operationOptions?: IBrowserRuntimeOperationOptions): Promise<void>;
     /** @internal */
     subscribeLeaseEvents(lease: ILeaseRecord, listener: (event: TBrowserRuntimeEvent) => void): Promise<IBrowserRuntimeFrameSubscription>;
@@ -210,6 +239,17 @@ export declare class BrowserRuntime {
     private executeAgentActionInternal;
     private resolveSemanticTarget;
     private resourceState;
+    private beginFrameRefresh;
+    private executeFrameRefresh;
+    private drainFrameRefreshOutstanding;
+    private validateFrameRefreshBoundary;
+    private reconcileFrameRefreshOutstanding;
+    private beginFrameAcknowledgement;
+    private failFrameRefresh;
+    private finalizeFrameRefresh;
+    private abandonFrameRefresh;
+    private armFrameAcknowledgementTimer;
+    private matchingFrameRefresh;
     private handleSessionEvent;
     private pushToSubscription;
     private closeFrameSubscription;
@@ -299,6 +339,7 @@ export declare class BrowserRuntimeLease {
     insertText(input: plugins.smartpuppeteer.ILiveBrowserInsertTextInput, operationOptions?: IBrowserRuntimeOperationOptions): Promise<void>;
     subscribeEvents(listener: (event: TBrowserRuntimeEvent) => void): Promise<IBrowserRuntimeFrameSubscription>;
     acknowledgeFrame(acknowledgement: plugins.smartpuppeteer.ILiveBrowserFrameAcknowledgementRequest): Promise<boolean>;
+    refreshFrameStream(operationOptions?: IBrowserRuntimeOperationOptions): Promise<void>;
     readArtifact(artifactId: string): Promise<Uint8Array>;
     deleteArtifact(artifactId: string): Promise<void>;
     cancelActiveOperation(): boolean;