@mind-harness/mh-browser 0.2.4 → 0.2.5

package/lib/typert.host.js

@@ -44,7 +44,7 @@ const $remote = createTypertRemoteInfo({
         create: _mind_harness_mh_browser_mhBrowser_revealHandover_result$schema,
         jsonSchema: {"type":"object","properties":{"status":{"type":"string","enum":["revealed","not-handing-over","no-tab"]}},"required":["status"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/mh-browser/src/service/service.ts","line":624,"column":9},
+      sourceLocation: {"file":"packages/mh-browser/src/service/service.ts","line":684,"column":9},
     },
   },
 }, z)

package/lib/typert.remote-client.js

@@ -44,7 +44,7 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         create: _mind_harness_mh_browser_mhBrowser_revealHandover_result$schema,
         jsonSchema: {"type":"object","properties":{"status":{"type":"string","enum":["revealed","not-handing-over","no-tab"]}},"required":["status"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/mh-browser/src/service/service.ts","line":624,"column":9},
+      sourceLocation: {"file":"packages/mh-browser/src/service/service.ts","line":684,"column":9},
     },
   },
 }, z)

package/lib/types/service/abortable.d.ts

@@ -0,0 +1,24 @@
+import { MhBrowserError } from '../types.ts';
+/** A wait ended because its signal aborted, including a deadline synthesized here. */
+export declare function stopped(): MhBrowserError;
+export declare function isInterrupted(error: unknown): boolean;
+/**
+ * `promise`, or a rejection when `signal` aborts. The original promise is
+ * always observed, so abandoning it leaves no unhandled rejection.
+ */
+export declare function untilAborted<T>(promise: Promise<T>, signal: AbortSignal | undefined): Promise<T>;
+/** `signal`, a deadline of `ms`, or whichever of the two aborts first. */
+export declare function capped(signal: AbortSignal | undefined, ms: number): AbortSignal;
+export interface Queued<T> {
+    /** Rejects as soon as `signal` aborts, including while `previous` is still running. */
+    run: Promise<T>;
+    /** Settles after `previous`, and after `op` when `op` started. Never rejects. */
+    tail: Promise<void>;
+}
+/**
+ * Run `op` once `previous` settles. Aborting `signal` while waiting rejects
+ * `run` and does not call `op`. `tail` still follows `previous`, and `op`
+ * when `op` has started, so a later caller cannot overlap the work.
+ */
+export declare function enqueue<T>(previous: Promise<unknown>, op: () => Promise<T>, signal?: AbortSignal): Queued<T>;
+//# sourceMappingURL=abortable.d.ts.map

package/lib/types/service/extension.d.ts

@@ -17,16 +17,17 @@ export declare class Extension {
     /** Address of a page shipped in the extension directory. */
     pageUrl(name: string): string;
     /** `chrome.tabs.create` in the named window. Returns the extension's tab id. */
-    createTab(windowId: number, url: string): Promise<number>;
-    tabIdsIn(windowId: number): Promise<number[]>;
-    activate(tabId: number): Promise<void>;
+    createTab(windowId: number, url: string, signal?: AbortSignal): Promise<number>;
+    tabIdsIn(windowId: number, signal?: AbortSignal): Promise<number[]>;
+    activate(tabId: number, signal?: AbortSignal): Promise<void>;
     group(tabId: number, target: {
         groupId: number;
     } | {
         windowId: number;
-    }): Promise<number>;
-    styleGroup(groupId: number, title: string, color: 'blue' | 'red'): Promise<void>;
-    ungroup(tabId: number): Promise<void>;
+    }, signal?: AbortSignal): Promise<number>;
+    styleGroup(groupId: number, title: string, color: 'blue' | 'red', signal?: AbortSignal): Promise<void>;
+    ungroup(tabId: number, signal?: AbortSignal): Promise<void>;
+    private answer;
     private worker;
 }
 /** The extension's service worker. Looks once more after the wait times out. */

package/lib/types/service/windows.d.ts

@@ -114,7 +114,7 @@ export declare class Windows {
     /** The tab touched most recently, for raising the window the person asked to see. */
     latest(owner: OwnerId): LiveTab | undefined;
     /** Make this tab the current one in its window. Does not raise the browser. */
-    activate(tab: LiveTab): Promise<void>;
+    activate(tab: LiveTab, signal?: AbortSignal): Promise<void>;
     /** Group title for the person. Empty until a title is known. */
     setTitle(owner: OwnerId, title: string): void;
     /** A handover in progress prefixes the group title and recolors it. */
@@ -126,15 +126,17 @@ export declare class Windows {
      * use the extension. Without a window, later pages use `window.open` from
      * an isolated world so they stay in that window.
      */
-    openBlank(owner: OwnerId): Promise<LiveTab>;
+    openBlank(owner: OwnerId, signal?: AbortSignal): Promise<LiveTab>;
     private createTab;
     private keep;
+    /** The page from a create, or close it when this wait is abandoned. */
+    private claimedPage;
     /**
      * Close one tab. `note` is listed in the next `<tabs>` block. A tab the
      * model was never shown (an Agent View discovered on a new tab) omits it.
      */
     closeTab(tab: LiveTab, note?: string): Promise<void>;
-    closeOwner(owner: OwnerId): Promise<void>;
+    closeOwner(owner: OwnerId, signal?: AbortSignal): Promise<void>;
     private closePage;
     /** A tab leaves the registry. The window closes with its last tab. */
     private forget;
@@ -176,5 +178,10 @@ export declare class Windows {
     private dropSession;
     private targetIdOf;
     private windowIdOf;
+    private pageSession;
+    private cdp;
+    /** Close a page that may no longer answer. A stall ends at `CLOSE_MS`. */
+    private shutdown;
+    private shutdownSession;
 }
 //# sourceMappingURL=windows.d.ts.map

package/lib/types/tools/given.d.ts

@@ -0,0 +1,5 @@
+/** A string the caller gave. Blank is the same as omitting it; the text itself is kept. */
+export declare function givenString(value: unknown): string | undefined;
+/** Seconds to wait. Zero is the same as omitting it; any other number is kept. */
+export declare function givenTime(value: unknown): number | undefined;
+//# sourceMappingURL=given.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mind-harness/mh-browser",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Opens pages in a real browser for the agent, keeps chosen Agent Views in context, and hands the browser to you when a person is needed.",
   "license": "SEE LICENSE IN LICENSE",
   "files": [