@orkestrel/browser 0.0.28 → 0.0.30

package/dist/src/server/index.d.cts

@@ -14,6 +14,7 @@ import type { BrowserRunStoreInterface } from '@orkestrel/browser';
 import type { BrowserStoreOptions } from '@orkestrel/browser';
 import type { BrowserStorePage } from '@orkestrel/browser';
 import type { BrowserStorePageOptions } from '@orkestrel/browser';
+import type { BrowserToolsetInterface } from '@orkestrel/browser';
 import type { BrowserViewport } from '@orkestrel/browser';
 import type { BrowserWriterInterface } from '@orkestrel/browser';
 import type { CDPTarget } from '@orkestrel/browser';
@@ -23,6 +24,7 @@ import type { ChildProcess } from 'node:child_process';
 import type { EmitterErrorHandler } from '@orkestrel/emitter';
 import type { EmitterHooks } from '@orkestrel/emitter';
 import type { EmitterInterface } from '@orkestrel/emitter';
+import type { PoolToken } from '@orkestrel/pool';
 import type { Readable } from 'node:stream';
 import type { Result } from '@orkestrel/contract';
 import type { StdioServerOptions } from '@orkestrel/mcp/server';
@@ -333,6 +335,13 @@ export declare interface BrowserDiscoveryResult {
     readonly browser: string | undefined;
 }
 
+/** Reads the announced CDP endpoint while continuing to drain the browser's standard error. */
+export declare class BrowserEndpoint {
+    #private;
+    constructor(stream: Readable, signal: AbortSignal);
+    get endpoint(): Promise<string>;
+}
+
 /** Names a supported browser engine (raw CDP targets Chromium-family browsers only). */
 export declare type BrowserEngine = 'chromium' | 'chrome' | 'edge';
 
@@ -656,6 +665,18 @@ export declare interface BrowserOptions {
     readonly browsers?: SystemBrowserOptions;
 }
 
+/** Waits for a process remainder whose host exposes no exit event. */
+export declare class BrowserProcessDrain implements BrowserProcessDrainInterface {
+    #private;
+    constructor(inspect: () => boolean | undefined, timeout: number);
+    get result(): Promise<boolean | undefined>;
+}
+
+/** Exposes whether a process remainder disappeared before its deadline. */
+export declare interface BrowserProcessDrainInterface {
+    readonly result: Promise<boolean | undefined>;
+}
+
 /** Names the browser a browse profile serves, which a later start's sweep reads. */
 export declare interface BrowserProfileRecord {
     readonly pid: number;
@@ -681,6 +702,32 @@ export declare interface BrowserServerCatalog {
     readonly tools: readonly ToolDefinition[];
 }
 
+/** Owns a holder's context, toolset, and download directory. */
+export declare interface BrowserServerGeneration {
+    readonly context: BrowserContextInterface;
+    readonly toolset: BrowserToolsetInterface;
+    readonly directory: string;
+}
+
+/** Identifies an admitted holder and its cancellation lifetime. */
+export declare interface BrowserServerHolder {
+    readonly id: string;
+    readonly purpose: string;
+    readonly abort: AbortController;
+}
+
+/** Pairs a pool token with the generation it owns. */
+export declare interface BrowserServerLease {
+    readonly token: PoolToken<BrowserServerSlot>;
+    readonly generation: BrowserServerGeneration;
+}
+
+/** Pairs a pooled browser with its profile directory. */
+export declare interface BrowserServerSlot {
+    readonly browser: BrowserInterface;
+    readonly profile: string;
+}
+
 /** Names the server tools that manage independent browser holders. */
 export declare type BrowserServerToolName = 'acquire' | 'execute' | 'tools' | 'destroy';
 
@@ -1005,15 +1052,6 @@ export declare function parseBrowserViewport(value: string | undefined): Browser
 /** Probes PATH (`which`/`where`) for every resolvable command name, in the given order. */
 export declare function probePathNames(names: readonly string[], platform: string): readonly string[];
 
-/**
- * Probes whether a process has not been confirmed absent.
- * @param pid - Process identifier to probe with signal zero
- * @returns True if the host has not confirmed absence with ESRCH; false otherwise
- * @example
- * probeProcess(process.pid) // true
- */
-export declare function probeProcess(pid: number): boolean;
-
 /**
  * Reads the CDP endpoint a launched browser announces on its standard error.
  *

package/dist/src/server/index.d.ts

@@ -14,6 +14,7 @@ import type { BrowserRunStoreInterface } from '@orkestrel/browser';
 import type { BrowserStoreOptions } from '@orkestrel/browser';
 import type { BrowserStorePage } from '@orkestrel/browser';
 import type { BrowserStorePageOptions } from '@orkestrel/browser';
+import type { BrowserToolsetInterface } from '@orkestrel/browser';
 import type { BrowserViewport } from '@orkestrel/browser';
 import type { BrowserWriterInterface } from '@orkestrel/browser';
 import type { CDPTarget } from '@orkestrel/browser';
@@ -23,6 +24,7 @@ import type { ChildProcess } from 'node:child_process';
 import type { EmitterErrorHandler } from '@orkestrel/emitter';
 import type { EmitterHooks } from '@orkestrel/emitter';
 import type { EmitterInterface } from '@orkestrel/emitter';
+import type { PoolToken } from '@orkestrel/pool';
 import type { Readable } from 'node:stream';
 import type { Result } from '@orkestrel/contract';
 import type { StdioServerOptions } from '@orkestrel/mcp/server';
@@ -333,6 +335,13 @@ export declare interface BrowserDiscoveryResult {
     readonly browser: string | undefined;
 }
 
+/** Reads the announced CDP endpoint while continuing to drain the browser's standard error. */
+export declare class BrowserEndpoint {
+    #private;
+    constructor(stream: Readable, signal: AbortSignal);
+    get endpoint(): Promise<string>;
+}
+
 /** Names a supported browser engine (raw CDP targets Chromium-family browsers only). */
 export declare type BrowserEngine = 'chromium' | 'chrome' | 'edge';
 
@@ -656,6 +665,18 @@ export declare interface BrowserOptions {
     readonly browsers?: SystemBrowserOptions;
 }
 
+/** Waits for a process remainder whose host exposes no exit event. */
+export declare class BrowserProcessDrain implements BrowserProcessDrainInterface {
+    #private;
+    constructor(inspect: () => boolean | undefined, timeout: number);
+    get result(): Promise<boolean | undefined>;
+}
+
+/** Exposes whether a process remainder disappeared before its deadline. */
+export declare interface BrowserProcessDrainInterface {
+    readonly result: Promise<boolean | undefined>;
+}
+
 /** Names the browser a browse profile serves, which a later start's sweep reads. */
 export declare interface BrowserProfileRecord {
     readonly pid: number;
@@ -681,6 +702,32 @@ export declare interface BrowserServerCatalog {
     readonly tools: readonly ToolDefinition[];
 }
 
+/** Owns a holder's context, toolset, and download directory. */
+export declare interface BrowserServerGeneration {
+    readonly context: BrowserContextInterface;
+    readonly toolset: BrowserToolsetInterface;
+    readonly directory: string;
+}
+
+/** Identifies an admitted holder and its cancellation lifetime. */
+export declare interface BrowserServerHolder {
+    readonly id: string;
+    readonly purpose: string;
+    readonly abort: AbortController;
+}
+
+/** Pairs a pool token with the generation it owns. */
+export declare interface BrowserServerLease {
+    readonly token: PoolToken<BrowserServerSlot>;
+    readonly generation: BrowserServerGeneration;
+}
+
+/** Pairs a pooled browser with its profile directory. */
+export declare interface BrowserServerSlot {
+    readonly browser: BrowserInterface;
+    readonly profile: string;
+}
+
 /** Names the server tools that manage independent browser holders. */
 export declare type BrowserServerToolName = 'acquire' | 'execute' | 'tools' | 'destroy';
 
@@ -1005,15 +1052,6 @@ export declare function parseBrowserViewport(value: string | undefined): Browser
 /** Probes PATH (`which`/`where`) for every resolvable command name, in the given order. */
 export declare function probePathNames(names: readonly string[], platform: string): readonly string[];
 
-/**
- * Probes whether a process has not been confirmed absent.
- * @param pid - Process identifier to probe with signal zero
- * @returns True if the host has not confirmed absence with ESRCH; false otherwise
- * @example
- * probeProcess(process.pid) // true
- */
-export declare function probeProcess(pid: number): boolean;
-
 /**
  * Reads the CDP endpoint a launched browser announces on its standard error.
  *