@modelprofile.com/browser-runtime 5.1.0 → 5.2.0

package/changelog.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 2026-09-13 - 5.2.0
+
+### Maintenance
+
+- update release tooling and omit private hints from npm (tooling)
+
+### Features
+
+- add lease-owned WebRTC peers and demand-driven image capture (video)
+
+### Documentation
+
+- describe the final release dependency state (changelog)
+
 ## 2026-09-08 - 5.1.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@modelprofile.com/browser-runtime',
-    version: '5.1.0',
+    version: '5.2.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

@@ -3,7 +3,7 @@ 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, IBrowserRuntimeViewportResult, ICreateBrowserResourceRequest, IRegisterBrowserResourceRequest, TIssueBrowserCapabilityRequest, TIssuedBrowserCapability, ILiveBrowserSessionLike, TBrowserActorRole, TBrowserAgentAction, TBrowserAgentActionResult, TBrowserRuntimeEvent } from './interfaces.js';
+import type { IAttachTrustedFramedPeerOptions, IApplyBrowserAttachmentBindingRequest, IBrowserAttachmentBinding, TBrowserCapabilityDescriptor, TBrowserCapabilityAuthorizationRequest, TBrowserRuntimeLeaseAuthority, TBrowserRuntimeOperationClassification, IBrowserRuntimeFrameSubscription, IBrowserRuntimeOperationOptions, IBrowserRuntimeOptions, IBrowserResourceRegistration, IBrowserRuntimeState, IBrowserRuntimeViewportResult, IBrowserRuntimeEventSubscriptionOptions, TBrowserRuntimeVideoOffer, ICreateBrowserResourceRequest, IRegisterBrowserResourceRequest, TIssueBrowserCapabilityRequest, TIssuedBrowserCapability, ILiveBrowserSessionLike, TBrowserActorRole, TBrowserAgentAction, TBrowserAgentActionResult, TBrowserRuntimeEvent } from './interfaces.js';
 import { TransitionMutex } from './utils.js';
 import { BrowserRuntimeFramedServerPeer } from './classes.framed.js';
 type TCapabilityRecord = TBrowserCapabilityDescriptor & {
@@ -32,6 +32,9 @@ interface ILeaseRecord {
     released: boolean;
     releasePromise?: Promise<void>;
     preferredViewport?: plugins.smartpuppeteer.ILiveBrowserViewport;
+    videoPeerId: string;
+    videoPeerMayExist: boolean;
+    frameCaptureUsed: boolean;
     heldKeys: Map<string, plugins.smartpuppeteer.ILiveBrowserKeyInput>;
     heldButtons: Map<string, plugins.smartpuppeteer.ILiveBrowserMouseInput>;
 }
@@ -66,7 +69,7 @@ interface IQueuedOperationRecord {
     state: 'queued' | 'starting' | 'active' | 'settled';
     onQueuedAbort?: () => void;
     /** Resource-owned cleanup, admitted only for this exact released participant. */
-    participantCleanup?: boolean;
+    participantCleanup?: 'participant' | 'subscription' | false;
 }
 interface IOutstandingFrameRecord {
     acknowledgement: plugins.smartpuppeteer.ILiveBrowserFrameAcknowledgementRequest;
@@ -86,6 +89,10 @@ type TFrameAcknowledgementOutcome = {
 interface IFrameSubscriptionRecord {
     lease: ILeaseRecord;
     listener: (event: TBrowserRuntimeEvent) => void;
+    includeFrames: boolean;
+    session: ILiveBrowserSessionLike;
+    closePromise?: Promise<void>;
+    closeComplete?: boolean;
     outstanding: Map<string, IOutstandingFrameRecord>;
     highestSequence: number;
     closed: boolean;
@@ -130,6 +137,7 @@ interface IResourceSlot {
     operationQueue: IQueuedOperationRecord[];
     operationSchedulerRunning: boolean;
     frameSubscriptions: Map<string, IFrameSubscriptionRecord>;
+    frameCaptureEnabled?: boolean;
     highestFrameSequence: number;
     producerAcknowledgements: Set<Promise<TFrameAcknowledgementOutcome>>;
     frameRefresh?: IFrameRefreshRecord;
@@ -220,6 +228,14 @@ export declare class BrowserRuntime {
     leaseHumanAgentAction(lease: ILeaseRecord, actionArg: unknown, operationOptions?: IBrowserRuntimeOperationOptions): Promise<TBrowserAgentActionResult>;
     /** @internal */
     leaseSetViewport(lease: ILeaseRecord, viewport: plugins.smartpuppeteer.ILiveBrowserViewport, operationOptions?: IBrowserRuntimeOperationOptions): Promise<IBrowserRuntimeViewportResult>;
+    /** @internal */
+    leaseOpenVideoPeer(lease: ILeaseRecord, options?: IBrowserRuntimeOperationOptions): Promise<TBrowserRuntimeVideoOffer>;
+    /** @internal */
+    leaseAnswerVideoPeer(lease: ILeaseRecord, negotiationId: string, description: plugins.smartpuppeteer.ILiveVideoDescription, options?: IBrowserRuntimeOperationOptions): Promise<void>;
+    /** @internal */
+    leaseCloseVideoPeer(lease: ILeaseRecord, options?: IBrowserRuntimeOperationOptions): Promise<void>;
+    /** @internal */
+    leaseGetVideoStatistics(lease: ILeaseRecord, options?: IBrowserRuntimeOperationOptions): Promise<plugins.smartpuppeteer.ILiveVideoStatistics>;
     private validatePreferredViewport;
     private applySharedViewport;
     /** @internal */
@@ -235,7 +251,8 @@ export declare class BrowserRuntime {
     private releaseAllParticipantInput;
     private releaseParticipantInput;
     /** @internal */
-    subscribeLeaseEvents(lease: ILeaseRecord, listener: (event: TBrowserRuntimeEvent) => void): Promise<IBrowserRuntimeFrameSubscription>;
+    subscribeLeaseEvents(lease: ILeaseRecord, listener: (event: TBrowserRuntimeEvent) => void, options?: IBrowserRuntimeEventSubscriptionOptions): Promise<IBrowserRuntimeFrameSubscription>;
+    private reconcileFrameCapture;
     /** @internal */
     acknowledgeLeaseFrame(lease: ILeaseRecord, acknowledgementArg: plugins.smartpuppeteer.ILiveBrowserFrameAcknowledgementRequest): Promise<boolean>;
     /** @internal */
@@ -284,6 +301,7 @@ export declare class BrowserRuntime {
     private handleSessionEvent;
     private pushToSubscription;
     private closeFrameSubscription;
+    private detachFrameSubscription;
     private retireOutstandingFrame;
     private validateFrameAcknowledgement;
     private frameAcknowledgementKey;
@@ -372,7 +390,11 @@ export declare class BrowserRuntimeLease {
     dispatchWheel(input: plugins.smartpuppeteer.ILiveBrowserWheelInput, operationOptions?: IBrowserRuntimeOperationOptions): Promise<void>;
     dispatchKey(input: plugins.smartpuppeteer.ILiveBrowserKeyInput, operationOptions?: IBrowserRuntimeOperationOptions): Promise<void>;
     insertText(input: plugins.smartpuppeteer.ILiveBrowserInsertTextInput, operationOptions?: IBrowserRuntimeOperationOptions): Promise<void>;
-    subscribeEvents(listener: (event: TBrowserRuntimeEvent) => void): Promise<IBrowserRuntimeFrameSubscription>;
+    subscribeEvents(listener: (event: TBrowserRuntimeEvent) => void, options?: IBrowserRuntimeEventSubscriptionOptions): Promise<IBrowserRuntimeFrameSubscription>;
+    openVideoPeer(options?: IBrowserRuntimeOperationOptions): Promise<TBrowserRuntimeVideoOffer>;
+    answerVideoPeer(negotiationId: string, description: plugins.smartpuppeteer.ILiveVideoDescription, options?: IBrowserRuntimeOperationOptions): Promise<void>;
+    closeVideoPeer(options?: IBrowserRuntimeOperationOptions): Promise<void>;
+    getVideoStatistics(options?: IBrowserRuntimeOperationOptions): Promise<plugins.smartpuppeteer.ILiveVideoStatistics>;
     acknowledgeFrame(acknowledgement: plugins.smartpuppeteer.ILiveBrowserFrameAcknowledgementRequest): Promise<boolean>;
     refreshFrameStream(operationOptions?: IBrowserRuntimeOperationOptions): Promise<void>;
     readArtifact(artifactId: string): Promise<Uint8Array>;