@ricsam/isolate 0.1.10 → 0.1.12

package/dist/types/host/nested-host-controller.d.ts

@@ -0,0 +1,15 @@
+import type { NestedHostBindings } from "../bridge/sandbox-isolate.ts";
+import { type BrowserSource } from "../internal/browser-source.ts";
+import type { AppServer, CreateAppServerOptions, CreateNamespacedRuntimeOptions, CreateRuntimeOptions, CreateTestRuntimeOptions, NamespacedRuntime, ScriptRuntime, TestRuntime } from "../types.ts";
+interface NestedHostFactory {
+    createRuntime(options: CreateRuntimeOptions): Promise<ScriptRuntime>;
+    createAppServer(options: CreateAppServerOptions): Promise<AppServer>;
+    createTestRuntime(options: CreateTestRuntimeOptions): Promise<TestRuntime>;
+    getNamespacedRuntime(key: string, options: CreateNamespacedRuntimeOptions): Promise<NamespacedRuntime>;
+    disposeNamespace(key: string, options?: {
+        reason?: string;
+    }): Promise<void>;
+    isConnected(): boolean;
+}
+export declare function createNestedHostBindings(factory: NestedHostFactory, defaultBrowserSource: BrowserSource | undefined): NestedHostBindings;
+export {};

package/dist/types/index.d.ts

@@ -2,4 +2,4 @@ export { createIsolateHost } from "./host/index.ts";
 export { createModuleResolver } from "./modules/index.ts";
 export { createFileBindings } from "./files/index.ts";
 export { getTypeProfile, typecheck, formatTypecheckErrors } from "./typecheck/index.ts";
-export type { AppServer, BrowserRuntime, BrowserRuntimeDiagnostics, ConsoleEntry, CreateAppServerOptions, CreateBrowserRuntimeOptions, CreateIsolateHostOptions, CreateRuntimeOptions, FileBindings, HostBindings, HostCallContext, IsolateHost, ModuleImporter, ModuleResolveResult, ModuleResolver, ModuleResolverFallback, ModuleResolverSourceLoader, ModuleSource, PlaywrightEvent, RequestResult, RunResults, ScriptRuntime, TestEvent, ToolBindings, ToolHandler, RuntimeDiagnostics, TypeCapability, TypeProfile, TypeProfileName, TypecheckRequest, WebSocketUpgradeData, } from "./types.ts";
+export type { AppServer, BrowserDiagnostics, ConsoleEntry, CreateAppServerOptions, CreateIsolateHostOptions, CreateNamespacedRuntimeOptions, CreateRuntimeOptions, CreateTestRuntimeOptions, FileBindings, HostBindings, HostBrowserBindings, HostBrowserFactoryBindings, HostBrowserHandlerBindings, HostCallContext, IsolateHost, ModuleImporter, ModuleResolveResult, ModuleResolver, NamespacedRuntime, ModuleResolverFallback, ModuleResolverSourceLoader, ModuleSource, PlaywrightEvent, RequestResult, RuntimeResourceDiagnostics, RunResults, ScriptRuntime, TestDiagnostics, TestEvent, TestRuntime, TestRuntimeDiagnostics, ToolBindings, ToolHandler, RuntimeDiagnostics, TypeCapability, TypeProfile, TypeProfileName, TypecheckRequest, WebSocketUpgradeData, } from "./types.ts";

package/dist/types/internal/browser-source.d.ts

@@ -0,0 +1,10 @@
+import type { HostBrowserBindings } from "../types.ts";
+export declare const ISOLATE_BROWSER_DESCRIPTOR_PROPERTY = "__isolateBrowserBinding";
+export declare const ISOLATE_BROWSER_DESCRIPTOR_VALUE = "default";
+export type BrowserSource = HostBrowserBindings;
+export declare function isBrowserBindingLike(value: unknown): value is HostBrowserBindings;
+export declare function isDefaultBrowserDescriptor(value: unknown): boolean;
+export declare function createBrowserSourceFromBindings(browser: HostBrowserBindings | undefined): BrowserSource | undefined;
+export declare function createBrowserSourceFromUnknown(browser: unknown): BrowserSource | undefined;
+export declare function requireBrowserSource(source: BrowserSource | undefined, operation: string): BrowserSource;
+export declare function cloneBrowserDescriptor(): Record<string, string>;

package/dist/types/internal/client/types.d.ts

@@ -47,6 +47,10 @@ export interface DaemonConnection {
     createRuntime(options?: RuntimeOptions): Promise<RemoteRuntime>;
     /** Create a namespace for runtime pooling/reuse */
     createNamespace(id: string): Namespace;
+    /** Permanently delete the runtime currently associated with a namespace key */
+    disposeNamespace(id: string, options?: {
+        reason?: string;
+    }): Promise<void>;
     /** Close the connection */
     close(): Promise<void>;
     /** Check if connected */
@@ -193,6 +197,11 @@ export interface RemoteTestEnvironmentHandle {
 export interface RemotePlaywrightHandle {
     /** Get collected browser console logs and network data */
     getCollectedData(): CollectedData;
+    /** Get tracked browser context/page ids */
+    getTrackedResources(): {
+        contexts: string[];
+        pages: string[];
+    };
     /** Clear collected data */
     clearCollectedData(): void;
 }

package/dist/types/internal/daemon/types.d.ts

@@ -61,8 +61,6 @@ export interface IsolateInstance {
     returnedPromises?: Map<number, Promise<unknown>>;
     /** Async iterators returned by custom function calls (iterable from isolate) */
     returnedIterators?: Map<number, AsyncIterator<unknown>>;
-    /** Next ID for daemon-local callback registration (starts at high number to avoid conflicts) */
-    nextLocalCallbackId?: number;
     /** Namespace ID for pooling/reuse (if set, runtime is cached on dispose) */
     namespaceId?: string;
     /** Whether this runtime is soft-deleted (disposed but cached for reuse) */

package/dist/types/internal/playwright/client.d.ts

@@ -2,6 +2,6 @@
  * Client-safe exports for ./index.ts
  * This module can be imported without loading isolated-vm
  */
-export type { NetworkRequestInfo, NetworkResponseInfo, BrowserConsoleLogEntry, PageErrorInfo, RequestFailureInfo, DefaultPlaywrightHandler, DefaultPlaywrightHandlerMetadata, DefaultPlaywrightHandlerOptions, PlaywrightSetupOptions, PlaywrightHandle, PlaywrightCallback, } from "./types.ts";
+export type { NetworkRequestInfo, NetworkResponseInfo, BrowserConsoleLogEntry, PageErrorInfo, RequestFailureInfo, DefaultPlaywrightHandler, DefaultPlaywrightHandlerMetadata, DefaultPlaywrightHandlerOptions, PlaywrightCollector, PlaywrightHandlerMetadata, PlaywrightSetupOptions, PlaywrightHandle, PlaywrightCallback, } from "./types.ts";
 export type { PlaywrightOperation, PlaywrightResult, PlaywrightEvent, PlaywrightFileData } from "../protocol/index.ts";
-export { createPlaywrightHandler, defaultPlaywrightHandler, getDefaultPlaywrightHandlerMetadata, } from "./handler.ts";
+export { createPlaywrightHandler, createPlaywrightFactoryHandler, defaultPlaywrightHandler, getDefaultPlaywrightHandlerMetadata, getPlaywrightHandlerMetadata, } from "./handler.ts";

package/dist/types/internal/playwright/handler.d.ts

@@ -3,13 +3,22 @@
  * Used by both index.ts (with isolated-vm) and client.ts (without isolated-vm)
  */
 import type { Page, Locator as PlaywrightLocator, BrowserContext, Response } from "playwright";
-import { type DefaultPlaywrightHandlerMetadata, type DefaultPlaywrightHandlerOptions, type PlaywrightCallback, type PlaywrightSetupOptions } from "./types.ts";
+import type { CollectedData, PlaywrightEvent } from "../protocol/index.ts";
+import { type DefaultPlaywrightHandlerMetadata, type DefaultPlaywrightHandlerOptions, type PlaywrightCallback, type PlaywrightHandlerMetadata, type PlaywrightSetupOptions } from "./types.ts";
 type ReadFileCallback = NonNullable<PlaywrightSetupOptions['readFile']>;
 type WriteFileCallback = NonNullable<PlaywrightSetupOptions['writeFile']>;
 export interface FileIOCallbacks {
     readFile?: ReadFileCallback;
     writeFile?: WriteFileCallback;
 }
+interface CollectorContextRecord {
+    context: BrowserContext;
+    pageIds: Set<string>;
+}
+interface CollectorPageRecord {
+    page: Page;
+    contextId: string;
+}
 export declare function getLocator(page: Page, selectorType: string, selectorValue: string, optionsJson: string | null): PlaywrightLocator;
 export declare function executeLocatorAction(locator: PlaywrightLocator, action: string, actionArg: unknown, timeout: number, fileIO?: FileIOCallbacks): Promise<unknown>;
 export declare function executeExpectAssertion(locator: PlaywrightLocator, matcher: string, expected: unknown, negated: boolean, timeout: number): Promise<void>;
@@ -18,25 +27,39 @@ export declare function executePageExpectAssertion(page: Page, matcher: string,
  * Registry for tracking multiple pages and contexts.
  */
 export interface PlaywrightRegistry {
-    pages: Map<string, Page>;
-    contexts: Map<string, BrowserContext>;
+    pages: Map<string, CollectorPageRecord>;
+    contexts: Map<string, CollectorContextRecord>;
+    pageIdsByObject: WeakMap<Page, string>;
+    contextIdsByObject: WeakMap<BrowserContext, string>;
     nextPageId: number;
     nextContextId: number;
+    nextRequestId: number;
     pendingResponses: Map<string, Promise<Response>>;
     pendingRequests: Map<string, Promise<import("playwright").Request>>;
     nextListenerId: number;
+    requestIds: WeakMap<object, string>;
+    pageListenerCleanups: Map<string, () => void>;
+    contextListenerCleanups: Map<string, () => void>;
+    eventSubscribers: Set<(event: PlaywrightEvent) => void>;
+    collectedData: CollectedData;
 }
 /**
  * Create a playwright handler from a Page object.
  * This handler is called by the daemon (via callback) when sandbox needs page operations.
  * Used for remote runtime where the browser runs on the client.
  */
-export declare function createPlaywrightHandler(page: Page, options?: DefaultPlaywrightHandlerOptions): PlaywrightCallback;
+export declare function createPlaywrightHandler(page: Page | undefined, options?: DefaultPlaywrightHandlerOptions): PlaywrightCallback;
 /**
  * Public helper for handler-first runtime options.
  * Adds metadata used by adapters for local event capture and collected data.
  */
 export declare function defaultPlaywrightHandler(page: Page, options?: DefaultPlaywrightHandlerOptions): PlaywrightCallback;
+/**
+ * Handler-first factory for contexts/pages without a default page.
+ * Used by browser bindings that expose only a stable browser object.
+ */
+export declare function createPlaywrightFactoryHandler(options?: DefaultPlaywrightHandlerOptions): PlaywrightCallback;
+export declare function getPlaywrightHandlerMetadata(handler: PlaywrightCallback): PlaywrightHandlerMetadata | undefined;
 /**
  * Extract metadata from handlers created by defaultPlaywrightHandler().
  */

package/dist/types/internal/playwright/index.d.ts

@@ -1,9 +1,9 @@
 import ivm from "@ricsam/isolated-vm";
 import { DEFAULT_PLAYWRIGHT_HANDLER_META } from "./types.ts";
-export { createPlaywrightHandler, defaultPlaywrightHandler, getDefaultPlaywrightHandlerMetadata, } from "./handler.ts";
+export { createPlaywrightHandler, defaultPlaywrightHandler, getDefaultPlaywrightHandlerMetadata, getPlaywrightHandlerMetadata, } from "./handler.ts";
 export type { PlaywrightOperation, PlaywrightResult, PlaywrightEvent, PlaywrightFileData } from "../protocol/index.ts";
 export { DEFAULT_PLAYWRIGHT_HANDLER_META };
-export type { NetworkRequestInfo, NetworkResponseInfo, BrowserConsoleLogEntry, PageErrorInfo, RequestFailureInfo, PlaywrightCallback, PlaywrightSetupOptions, PlaywrightHandle, } from "./types.ts";
+export type { NetworkRequestInfo, NetworkResponseInfo, BrowserConsoleLogEntry, PageErrorInfo, RequestFailureInfo, PlaywrightCallback, PlaywrightHandlerMetadata, PlaywrightSetupOptions, PlaywrightHandle, } from "./types.ts";
 import type { PlaywrightSetupOptions, PlaywrightHandle } from "./types.ts";
 /**
  * Set up playwright in an isolate context.

package/dist/types/internal/playwright/types.d.ts

@@ -2,8 +2,10 @@
  * Client-safe types for ./index.ts
  * This module can be imported without loading isolated-vm
  */
-export type { PlaywrightOperation, PlaywrightResult, PlaywrightEvent, PlaywrightFileData, } from "../protocol/index.ts";
+export type { PlaywrightOperation, PlaywrightResult, PlaywrightEvent, PlaywrightFileData, CollectedData, ConsoleEntry, } from "../protocol/index.ts";
 export interface NetworkRequestInfo {
+    contextId: string;
+    pageId: string;
     requestId: string;
     url: string;
     method: string;
@@ -13,6 +15,8 @@ export interface NetworkRequestInfo {
     timestamp: number;
 }
 export interface NetworkResponseInfo {
+    contextId: string;
+    pageId: string;
     requestId: string;
     url: string;
     status: number;
@@ -25,6 +29,8 @@ export interface NetworkResponseInfo {
  * Browser console log entry - logs from the page context (not sandbox).
  */
 export interface BrowserConsoleLogEntry {
+    contextId: string;
+    pageId: string;
     level: string;
     stdout: string;
     location?: {
@@ -35,12 +41,16 @@ export interface BrowserConsoleLogEntry {
     timestamp: number;
 }
 export interface PageErrorInfo {
+    contextId: string;
+    pageId: string;
     name: string;
     message: string;
     stack?: string;
     timestamp: number;
 }
 export interface RequestFailureInfo {
+    contextId: string;
+    pageId: string;
     requestId: string;
     url: string;
     method: string;
@@ -83,12 +93,28 @@ export interface DefaultPlaywrightHandlerMetadata {
     page: import("playwright").Page;
     options?: DefaultPlaywrightHandlerOptions;
 }
+export interface PlaywrightCollector {
+    getCollectedData(): import("../protocol/index.ts").CollectedData;
+    getTrackedResources(): {
+        contexts: string[];
+        pages: string[];
+    };
+    clearCollectedData(): void;
+    onEvent(callback: (event: import("../protocol/index.ts").PlaywrightEvent) => void): () => void;
+}
+export interface PlaywrightHandlerMetadata {
+    collector: PlaywrightCollector;
+}
 /**
  * Handler created by defaultPlaywrightHandler().
  */
 export type DefaultPlaywrightHandler = PlaywrightCallback & {
     [DEFAULT_PLAYWRIGHT_HANDLER_META]?: DefaultPlaywrightHandlerMetadata;
 };
+export declare const PLAYWRIGHT_HANDLER_META: unique symbol;
+export type InstrumentedPlaywrightHandler = PlaywrightCallback & {
+    [PLAYWRIGHT_HANDLER_META]?: PlaywrightHandlerMetadata;
+};
 /**
  * Options for setting up playwright in an isolate.
  */
@@ -97,6 +123,8 @@ export interface PlaywrightSetupOptions {
     page?: import("playwright").Page;
     /** Handler callback (for remote use - daemon invokes this) */
     handler?: PlaywrightCallback;
+    /** Whether the isolate should expose default page/context globals. */
+    hasDefaultPage?: boolean;
     /** Default timeout for operations */
     timeout?: number;
     /** If true, browser console logs are printed to stdout */
@@ -141,5 +169,9 @@ export interface PlaywrightHandle {
     getNetworkResponses(): NetworkResponseInfo[];
     /** Get network request failures (DNS, abort, connection reset, etc.) */
     getRequestFailures(): RequestFailureInfo[];
+    getTrackedResources(): {
+        contexts: string[];
+        pages: string[];
+    };
     clearCollected(): void;
 }

package/dist/types/internal/protocol/codec.d.ts

@@ -55,6 +55,7 @@ export interface IsolateRef {
 export interface CallbackRef {
     __type: "CallbackRef";
     callbackId: number;
+    callbackKind?: "asyncGenerator";
 }
 /**
  * Represents a reference to a stream.
@@ -180,12 +181,20 @@ export interface URLRef {
     __type: "URLRef";
     href: string;
 }
+/**
+ * Represents a serialized AbortSignal snapshot.
+ */
+export interface AbortSignalRef {
+    __type: "AbortSignalRef";
+    aborted: boolean;
+}
 /**
  * Represents a reference to a pending Promise.
  */
 export interface PromiseRef {
     __type: "PromiseRef";
     promiseId: number;
+    __resolveCallbackId?: number;
 }
 /**
  * Represents a reference to an async iterator.
@@ -197,7 +206,7 @@ export interface AsyncIteratorRef {
     __returnCallbackId?: number;
     __throwCallbackId?: number;
 }
-export type ExtensionType = IsolateRef | CallbackRef | StreamRef | ErrorRef | BlobRef | DateRef | RegExpRef | UndefinedRef | BigIntRef | RequestRef | ResponseRef | HeadersRef | FileRef | FormDataRef | URLRef | PromiseRef | AsyncIteratorRef;
+export type ExtensionType = IsolateRef | CallbackRef | StreamRef | ErrorRef | BlobRef | DateRef | RegExpRef | UndefinedRef | BigIntRef | RequestRef | ResponseRef | HeadersRef | FileRef | FormDataRef | URLRef | AbortSignalRef | PromiseRef | AsyncIteratorRef;
 /**
  * Encode a message to MessagePack bytes.
  */
@@ -215,7 +224,7 @@ export declare function encodeValue(value: unknown): Uint8Array;
  */
 export declare function decodeValue(data: Uint8Array): unknown;
 export declare function createIsolateRef(isolateId: string): IsolateRef;
-export declare function createCallbackRef(callbackId: number): CallbackRef;
+export declare function createCallbackRef(callbackId: number, callbackKind?: "asyncGenerator"): CallbackRef;
 export declare function createStreamRef(streamId: number, direction: "upload" | "download"): StreamRef;
 export declare function createErrorRef(name: string, message: string, stack?: string, code?: number): ErrorRef;
 export declare function createBlobRef(blobId: number, size: number, type: string): BlobRef;
@@ -238,5 +247,6 @@ export declare function createHeadersRef(pairs: [string, string][]): HeadersRef;
 export declare function createFileRef(name: string, type: string, lastModified: number, data: number[]): FileRef;
 export declare function createFormDataRef(entries: [string, string | FileRef][]): FormDataRef;
 export declare function createURLRef(href: string): URLRef;
+export declare function createAbortSignalRef(aborted: boolean): AbortSignalRef;
 export declare function createPromiseRef(promiseId: number): PromiseRef;
 export declare function createAsyncIteratorRef(iteratorId: number): AsyncIteratorRef;

package/dist/types/internal/protocol/marshalValue.d.ts

@@ -4,6 +4,7 @@
  * Provides type-preserving serialization for JavaScript types that would
  * otherwise lose fidelity when JSON stringified.
  */
+import { type PromiseRef, type AsyncIteratorRef } from "./codec.ts";
 /**
  * Error thrown when a value cannot be marshalled.
  */
@@ -30,9 +31,9 @@ export interface UnmarshalContext {
     /** Get a callback function by ID */
     getCallback?: (id: number) => ((...args: unknown[]) => unknown) | undefined;
     /** Create a proxy Promise for a PromiseRef */
-    createPromiseProxy?: (promiseId: number) => Promise<unknown>;
+    createPromiseProxy?: (promiseId: number, ref?: PromiseRef) => Promise<unknown>;
     /** Create a proxy AsyncIterator for an AsyncIteratorRef */
-    createIteratorProxy?: (iteratorId: number) => AsyncIterator<unknown>;
+    createIteratorProxy?: (iteratorId: number, ref?: AsyncIteratorRef) => AsyncIterator<unknown>;
     /** Get a Blob by ID */
     getBlob?: (blobId: number) => Blob | undefined;
 }

package/dist/types/internal/protocol/types.d.ts

@@ -10,6 +10,7 @@
 export declare const MessageType: {
     readonly CREATE_RUNTIME: 1;
     readonly DISPOSE_RUNTIME: 2;
+    readonly DISPOSE_NAMESPACE: 6;
     readonly EVAL: 3;
     readonly DISPATCH_REQUEST: 4;
     readonly DISPATCH_REQUEST_ABORT: 5;
@@ -105,7 +106,7 @@ export interface CustomFunctionRegistrations {
  * The client executes this operation on the real Page object.
  */
 export interface PlaywrightOperation {
-    type: "goto" | "reload" | "url" | "title" | "content" | "waitForSelector" | "waitForTimeout" | "waitForLoadState" | "evaluate" | "locatorAction" | "expectLocator" | "expectPage" | "request" | "goBack" | "goForward" | "waitForURL" | "waitForURLPredicate" | "waitForRequestStart" | "waitForRequestFinish" | "waitForRequestPredicateFinish" | "waitForResponseStart" | "waitForResponseFinish" | "waitForResponsePredicateFinish" | "clearCookies" | "screenshot" | "setViewportSize" | "viewportSize" | "emulateMedia" | "setExtraHTTPHeaders" | "bringToFront" | "close" | "isClosed" | "pdf" | "pause" | "frames" | "mainFrame" | "keyboardType" | "keyboardPress" | "keyboardDown" | "keyboardUp" | "keyboardInsertText" | "mouseMove" | "mouseClick" | "mouseDown" | "mouseUp" | "mouseWheel" | "addCookies" | "cookies" | "newContext" | "newPage" | "closeContext";
+    type: "goto" | "reload" | "url" | "title" | "content" | "waitForSelector" | "waitForTimeout" | "waitForLoadState" | "evaluate" | "locatorAction" | "expectLocator" | "expectPage" | "request" | "goBack" | "goForward" | "waitForURL" | "waitForURLPredicate" | "waitForRequestStart" | "waitForRequestFinish" | "waitForRequestPredicateFinish" | "waitForResponseStart" | "waitForResponseFinish" | "waitForResponsePredicateFinish" | "clearCookies" | "screenshot" | "setViewportSize" | "viewportSize" | "emulateMedia" | "setExtraHTTPHeaders" | "bringToFront" | "close" | "isClosed" | "pdf" | "pause" | "frames" | "mainFrame" | "keyboardType" | "keyboardPress" | "keyboardDown" | "keyboardUp" | "keyboardInsertText" | "mouseMove" | "mouseClick" | "mouseDown" | "mouseUp" | "mouseWheel" | "addCookies" | "cookies" | "contexts" | "pages" | "newContext" | "newPage" | "closeContext";
     args: unknown[];
     /** Target page ID (undefined = default page "page_0") */
     pageId?: string;
@@ -161,6 +162,8 @@ export interface TestEnvironmentOptionsProtocol {
 export interface PlaywrightOptionsProtocol {
     /** Default timeout for Playwright operations in ms */
     timeout?: number;
+    /** Whether the isolate should expose default page/context globals. */
+    hasDefaultPage?: boolean;
 }
 export interface CreateRuntimeRequest extends BaseMessage {
     type: typeof MessageType.CREATE_RUNTIME;
@@ -186,6 +189,12 @@ export interface DisposeRuntimeRequest extends BaseMessage {
     /** Optional caller-supplied reason for disposal, used for diagnostics/logging. */
     reason?: string;
 }
+export interface DisposeNamespaceRequest extends BaseMessage {
+    type: typeof MessageType.DISPOSE_NAMESPACE;
+    namespaceId: string;
+    /** Optional caller-supplied reason for disposal, used for diagnostics/logging. */
+    reason?: string;
+}
 export interface EvalRequest extends BaseMessage {
     type: typeof MessageType.EVAL;
     isolateId: string;
@@ -509,6 +518,8 @@ export interface WsClientErrorPayload {
  */
 export type PlaywrightEvent = {
     type: "browserConsoleLog";
+    contextId: string;
+    pageId: string;
     level: string;
     stdout: string;
     location?: {
@@ -519,12 +530,16 @@ export type PlaywrightEvent = {
     timestamp: number;
 } | {
     type: "pageError";
+    contextId: string;
+    pageId: string;
     name: string;
     message: string;
     stack?: string;
     timestamp: number;
 } | {
     type: "networkRequest";
+    contextId: string;
+    pageId: string;
     requestId: string;
     url: string;
     method: string;
@@ -534,6 +549,8 @@ export type PlaywrightEvent = {
     timestamp: number;
 } | {
     type: "networkResponse";
+    contextId: string;
+    pageId: string;
     requestId: string;
     url: string;
     status: number;
@@ -543,6 +560,8 @@ export type PlaywrightEvent = {
     timestamp: number;
 } | {
     type: "requestFailure";
+    contextId: string;
+    pageId: string;
     requestId: string;
     url: string;
     method: string;
@@ -556,7 +575,7 @@ export interface PingMessage {
 export interface PongMessage {
     type: typeof MessageType.PONG;
 }
-export type ClientMessage = CreateRuntimeRequest | DisposeRuntimeRequest | EvalRequest | DispatchRequestRequest | DispatchRequestAbort | WsOpenRequest | WsMessageRequest | WsCloseRequest | FetchGetUpgradeRequestRequest | FetchHasServeHandlerRequest | FetchHasActiveConnectionsRequest | FetchWsErrorRequest | TimersClearAllRequest | ConsoleResetRequest | ConsoleGetTimersRequest | ConsoleGetCountersRequest | ConsoleGetGroupDepthRequest | RunTestsRequest | ResetTestEnvRequest | HasTestsRequest | GetTestCountRequest | GetCollectedDataRequest | ClearCollectedDataRequest | CallbackResponseMsg | CallbackStreamStart | CallbackStreamChunk | CallbackStreamEnd | CallbackStreamCancel | StreamPush | StreamPull | StreamClose | StreamError | ClientEventMessage | PingMessage;
+export type ClientMessage = CreateRuntimeRequest | DisposeRuntimeRequest | DisposeNamespaceRequest | EvalRequest | DispatchRequestRequest | DispatchRequestAbort | WsOpenRequest | WsMessageRequest | WsCloseRequest | FetchGetUpgradeRequestRequest | FetchHasServeHandlerRequest | FetchHasActiveConnectionsRequest | FetchWsErrorRequest | TimersClearAllRequest | ConsoleResetRequest | ConsoleGetTimersRequest | ConsoleGetCountersRequest | ConsoleGetGroupDepthRequest | RunTestsRequest | ResetTestEnvRequest | HasTestsRequest | GetTestCountRequest | GetCollectedDataRequest | ClearCollectedDataRequest | CallbackResponseMsg | CallbackStreamStart | CallbackStreamChunk | CallbackStreamEnd | CallbackStreamCancel | StreamPush | StreamPull | StreamClose | StreamError | ClientEventMessage | PingMessage;
 export type DaemonMessage = ResponseOk | ResponseError | ResponseStreamStart | ResponseStreamChunk | ResponseStreamEnd | CallbackInvoke | CallbackAbort | StreamPush | StreamPull | StreamClose | StreamError | IsolateEventMessage | PongMessage;
 export type Message = ClientMessage | DaemonMessage;
 /**
@@ -801,6 +820,8 @@ export interface PlaywrightFileData {
 export interface PlaywrightOptions {
     /** Handler callback for Playwright operations (required when playwright is enabled) */
     handler: (op: PlaywrightOperation) => Promise<PlaywrightResult>;
+    /** Whether the isolate should expose default page/context globals. */
+    hasDefaultPage?: boolean;
     /** Default timeout for operations in ms */
     timeout?: number;
     /** If true, browser console logs are routed through console handler (or printed to stdout if no handler) */
@@ -927,6 +948,8 @@ export interface PlaywrightTestResult {
 export interface CollectedData {
     /** Browser console logs (from the page, not sandbox) */
     browserConsoleLogs: {
+        contextId: string;
+        pageId: string;
         level: string;
         stdout: string;
         location?: {
@@ -937,12 +960,16 @@ export interface CollectedData {
         timestamp: number;
     }[];
     pageErrors: {
+        contextId: string;
+        pageId: string;
         name: string;
         message: string;
         stack?: string;
         timestamp: number;
     }[];
     networkRequests: {
+        contextId: string;
+        pageId: string;
         requestId: string;
         url: string;
         method: string;
@@ -952,6 +979,8 @@ export interface CollectedData {
         timestamp: number;
     }[];
     networkResponses: {
+        contextId: string;
+        pageId: string;
         requestId: string;
         url: string;
         status: number;
@@ -961,6 +990,8 @@ export interface CollectedData {
         timestamp: number;
     }[];
     requestFailures: {
+        contextId: string;
+        pageId: string;
         requestId: string;
         url: string;
         method: string;

package/dist/types/internal/runtime/index.d.ts

@@ -115,6 +115,11 @@ export interface RuntimeTestEnvironmentHandle {
 export interface RuntimePlaywrightHandle {
     /** Get collected browser data (console logs, network requests/responses) */
     getCollectedData(): CollectedData;
+    /** Get tracked browser context/page ids */
+    getTrackedResources(): {
+        contexts: string[];
+        pages: string[];
+    };
     /** Clear collected browser data */
     clearCollectedData(): void;
 }

package/dist/types/internal/typecheck/index.d.ts

@@ -3,5 +3,5 @@
  *
  * Type definitions and type-checking utilities for isolated-vm V8 sandbox code.
  */
-export { CORE_TYPES, CONSOLE_TYPES, CRYPTO_TYPES, ENCODING_TYPES, FETCH_TYPES, FS_TYPES, PATH_TYPES, TEST_ENV_TYPES, TIMERS_TYPES, PLAYWRIGHT_TYPES, TYPE_DEFINITIONS, type TypeDefinitionKey, } from "./isolate-types.ts";
+export { CORE_TYPES, CONSOLE_TYPES, CRYPTO_TYPES, ENCODING_TYPES, FETCH_TYPES, FS_TYPES, PATH_TYPES, TEST_ENV_TYPES, TIMERS_TYPES, PLAYWRIGHT_TYPES, SANDBOX_ISOLATE_TYPES, TYPE_DEFINITIONS, type TypeDefinitionKey, } from "./isolate-types.ts";
 export { typecheckIsolateCode, formatTypecheckErrors, type TypecheckResult, type TypecheckError, type TypecheckOptions, type LibraryTypes, type LibraryTypeFile, } from "./typecheck.ts";