@alfe.ai/remote 0.1.1 → 0.2.0

package/dist/index.cjs

@@ -581,12 +581,29 @@ var TurnController = class {
 	/**
 	* Resolve once the agent is (again) allowed to drive. Resolves immediately if
 	* the agent already holds the token; otherwise parks until `releaseHuman()`.
-	* Every automation op awaits this before touching the page.
+	* Every automation op awaits this before touching the page. Cancellation
+	* removes only this waiter and never changes the current human owner.
 	*/
-	acquireAgent() {
+	acquireAgent(signal) {
+		if (signal?.aborted) return Promise.reject(/* @__PURE__ */ new Error("Agent turn acquisition interrupted"));
 		if (this.owner === "agent") return Promise.resolve();
-		return new Promise((resolve) => {
-			this.waiters.push(resolve);
+		return new Promise((resolve, reject) => {
+			const cleanup = () => {
+				const index = this.waiters.indexOf(resume);
+				if (index !== -1) this.waiters.splice(index, 1);
+				signal?.removeEventListener("abort", onAbort);
+			};
+			const resume = () => {
+				cleanup();
+				resolve();
+			};
+			const onAbort = () => {
+				cleanup();
+				reject(/* @__PURE__ */ new Error("Agent turn acquisition interrupted"));
+			};
+			this.waiters.push(resume);
+			signal?.addEventListener("abort", onAbort, { once: true });
+			if (signal?.aborted) onAbort();
 		});
 	}
 	/**

package/dist/index.d.cts

@@ -244,9 +244,10 @@ declare class TurnController {
   /**
    * Resolve once the agent is (again) allowed to drive. Resolves immediately if
    * the agent already holds the token; otherwise parks until `releaseHuman()`.
-   * Every automation op awaits this before touching the page.
+   * Every automation op awaits this before touching the page. Cancellation
+   * removes only this waiter and never changes the current human owner.
    */
-  acquireAgent(): Promise<void>;
+  acquireAgent(signal?: AbortSignal): Promise<void>;
   /**
    * Grant control to a human. Succeeds unless a human already holds it (single
    * controller). "Human request always wins over the agent" — the agent parks

package/dist/index.d.ts

@@ -244,9 +244,10 @@ declare class TurnController {
   /**
    * Resolve once the agent is (again) allowed to drive. Resolves immediately if
    * the agent already holds the token; otherwise parks until `releaseHuman()`.
-   * Every automation op awaits this before touching the page.
+   * Every automation op awaits this before touching the page. Cancellation
+   * removes only this waiter and never changes the current human owner.
    */
-  acquireAgent(): Promise<void>;
+  acquireAgent(signal?: AbortSignal): Promise<void>;
   /**
    * Grant control to a human. Succeeds unless a human already holds it (single
    * controller). "Human request always wins over the agent" — the agent parks

package/dist/index.js

@@ -557,12 +557,29 @@ var TurnController = class {
 	/**
 	* Resolve once the agent is (again) allowed to drive. Resolves immediately if
 	* the agent already holds the token; otherwise parks until `releaseHuman()`.
-	* Every automation op awaits this before touching the page.
+	* Every automation op awaits this before touching the page. Cancellation
+	* removes only this waiter and never changes the current human owner.
 	*/
-	acquireAgent() {
+	acquireAgent(signal) {
+		if (signal?.aborted) return Promise.reject(/* @__PURE__ */ new Error("Agent turn acquisition interrupted"));
 		if (this.owner === "agent") return Promise.resolve();
-		return new Promise((resolve) => {
-			this.waiters.push(resolve);
+		return new Promise((resolve, reject) => {
+			const cleanup = () => {
+				const index = this.waiters.indexOf(resume);
+				if (index !== -1) this.waiters.splice(index, 1);
+				signal?.removeEventListener("abort", onAbort);
+			};
+			const resume = () => {
+				cleanup();
+				resolve();
+			};
+			const onAbort = () => {
+				cleanup();
+				reject(/* @__PURE__ */ new Error("Agent turn acquisition interrupted"));
+			};
+			this.waiters.push(resume);
+			signal?.addEventListener("abort", onAbort, { once: true });
+			if (signal?.aborted) onAbort();
 		});
 	}
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/remote",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Runtime-agnostic transport for the Alfe interactive remote-control relay — multiplexes browser screencast and terminal PTY surfaces over one outbound WebSocket",
   "type": "module",
   "main": "./dist/index.js",