@workglow/browser-control 0.2.36 → 0.3.0

package/dist/task.js

@@ -619,7 +619,7 @@ class BrowserSessionTask extends Task {
   static category = "Browser";
   static title = "Browser Session";
   static description = "Creates a new browser session and returns its session ID";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static hasDynamicEntitlements = true;
   static configSchema() {
     return browserSessionTaskConfigSchema;
@@ -685,10 +685,12 @@ class BrowserSessionTask extends Task {
     const ctx = deps.createContext(options);
     await ctx.connect(options);
     const sessionId = BrowserSessionRegistry.register(ctx);
-    executeContext.resourceScope?.register(`browser:${sessionId}`, async () => {
+    const resourceKey = `browser:${sessionId}`;
+    executeContext.resourceScope?.register(resourceKey, async () => {
       await ctx.disconnect();
       BrowserSessionRegistry.unregister(sessionId);
     });
+    executeContext.resourceScope?.touch(resourceKey);
     return { sessionId };
   }
 }
@@ -717,7 +719,7 @@ class BrowserCloseTask extends Task2 {
   static category = "Browser";
   static title = "Browser Close";
   static description = "Disconnects and closes an existing browser session";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return TaskConfigSchema2;
   }
@@ -727,7 +729,8 @@ class BrowserCloseTask extends Task2 {
   static outputSchema() {
     return outputSchema2;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     await ctx.disconnect();
     BrowserSessionRegistry.unregister(input.sessionId);
@@ -800,7 +803,7 @@ class BrowserNavigateTask extends Task3 {
   static category = "Browser";
   static title = "Browser Navigate";
   static description = "Navigates the browser to a URL and returns the page title and URL";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserNavigateTaskConfigSchema;
   }
@@ -817,7 +820,8 @@ class BrowserNavigateTask extends Task3 {
       ]
     };
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const parsed = new URL(input.url, "https://placeholder");
     if (parsed.protocol === "javascript:") {
       throw new Error("BrowserNavigateTask: javascript: URLs are not allowed");
@@ -867,7 +871,7 @@ class BrowserBackTask extends Task4 {
   static category = "Browser";
   static title = "Browser Back";
   static description = "Navigates back in the browser history and returns the current URL";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return TaskConfigSchema4;
   }
@@ -877,7 +881,8 @@ class BrowserBackTask extends Task4 {
   static outputSchema() {
     return outputSchema4;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     await ctx.goBack();
     const url = await ctx.currentUrl();
@@ -921,7 +926,7 @@ class BrowserForwardTask extends Task5 {
   static category = "Browser";
   static title = "Browser Forward";
   static description = "Navigates forward in the browser history and returns the current URL";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return TaskConfigSchema5;
   }
@@ -931,7 +936,8 @@ class BrowserForwardTask extends Task5 {
   static outputSchema() {
     return outputSchema5;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     await ctx.goForward();
     const url = await ctx.currentUrl();
@@ -970,7 +976,7 @@ class BrowserReloadTask extends Task6 {
   static category = "Browser";
   static title = "Browser Reload";
   static description = "Reloads the current page in the browser";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return TaskConfigSchema6;
   }
@@ -980,7 +986,8 @@ class BrowserReloadTask extends Task6 {
   static outputSchema() {
     return outputSchema6;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     await ctx.reload();
     return { sessionId: input.sessionId };
@@ -1024,7 +1031,7 @@ class BrowserSnapshotTask extends Task7 {
   static category = "Browser";
   static title = "Browser Snapshot";
   static description = "Returns the accessibility tree of the current browser page";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return TaskConfigSchema7;
   }
@@ -1034,7 +1041,8 @@ class BrowserSnapshotTask extends Task7 {
   static outputSchema() {
     return outputSchema7;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     const tree = await ctx.snapshot();
     return { sessionId: input.sessionId, tree };
@@ -1098,7 +1106,7 @@ class BrowserScreenshotTask extends Task8 {
   static category = "Browser";
   static title = "Browser Screenshot";
   static description = "Takes a screenshot of the current browser page";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserScreenshotTaskConfigSchema;
   }
@@ -1108,7 +1116,8 @@ class BrowserScreenshotTask extends Task8 {
   static outputSchema() {
     return outputSchema8;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     const format = this.config.format ?? "png";
     const fullPage = this.config.fullPage ?? false;
@@ -1179,7 +1188,7 @@ class BrowserClickTask extends Task9 {
   static category = "Browser";
   static title = "Browser Click";
   static description = "Clicks an element in the browser by ref or by ARIA role and name";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserClickTaskConfigSchema;
   }
@@ -1189,7 +1198,8 @@ class BrowserClickTask extends Task9 {
   static outputSchema() {
     return outputSchema9;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     const opts = this.config.modifiers ? { modifiers: this.config.modifiers } : undefined;
     if (input.ref) {
@@ -1262,7 +1272,7 @@ class BrowserFillTask extends Task10 {
   static category = "Browser";
   static title = "Browser Fill";
   static description = "Fills a text input in the browser by ref or by label";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserFillTaskConfigSchema;
   }
@@ -1272,7 +1282,8 @@ class BrowserFillTask extends Task10 {
   static outputSchema() {
     return outputSchema10;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     if (input.ref) {
       await ctx.fill(input.ref, input.value);
@@ -1331,7 +1342,7 @@ class BrowserSelectTask extends Task11 {
   static category = "Browser";
   static title = "Browser Select";
   static description = "Selects an option in a select element identified by ref";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return TaskConfigSchema11;
   }
@@ -1341,7 +1352,8 @@ class BrowserSelectTask extends Task11 {
   static outputSchema() {
     return outputSchema11;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     if (input.ref) {
       await ctx.selectOption(input.ref, input.value);
@@ -1398,7 +1410,7 @@ class BrowserHoverTask extends Task12 {
   static category = "Browser";
   static title = "Browser Hover";
   static description = "Hovers over an element in the browser identified by ref";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return TaskConfigSchema12;
   }
@@ -1408,7 +1420,8 @@ class BrowserHoverTask extends Task12 {
   static outputSchema() {
     return outputSchema12;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     if (input.ref) {
       await ctx.hover(input.ref);
@@ -1467,7 +1480,7 @@ class BrowserExtractTextTask extends Task13 {
   static category = "Browser";
   static title = "Browser Extract Text";
   static description = "Extracts text content from a specific element or the full page";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserExtractTextTaskConfigSchema;
   }
@@ -1477,7 +1490,8 @@ class BrowserExtractTextTask extends Task13 {
   static outputSchema() {
     return outputSchema13;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     let ref = this.config.ref;
     if (!ref) {
@@ -1545,7 +1559,7 @@ class BrowserExtractHtmlTask extends Task14 {
   static category = "Browser";
   static title = "Browser Extract HTML";
   static description = "Extracts HTML content from a specific element by ref or CSS selector";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserExtractHtmlTaskConfigSchema;
   }
@@ -1555,7 +1569,8 @@ class BrowserExtractHtmlTask extends Task14 {
   static outputSchema() {
     return outputSchema14;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     let ref = this.config.ref;
     if (!ref) {
@@ -1619,7 +1634,7 @@ class BrowserAttributeTask extends Task15 {
   static category = "Browser";
   static title = "Browser Attribute";
   static description = "Retrieves the value of an attribute from a browser element";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return TaskConfigSchema15;
   }
@@ -1629,7 +1644,8 @@ class BrowserAttributeTask extends Task15 {
   static outputSchema() {
     return outputSchema15;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     const value = await ctx.attribute(input.ref, input.attribute);
     return { sessionId: input.sessionId, value };
@@ -1678,7 +1694,7 @@ class BrowserQuerySelectorTask extends Task16 {
   static category = "Browser";
   static title = "Browser Query Selector";
   static description = "Queries all elements matching a CSS selector and returns their refs";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return TaskConfigSchema16;
   }
@@ -1688,7 +1704,8 @@ class BrowserQuerySelectorTask extends Task16 {
   static outputSchema() {
     return outputSchema16;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     const refs = await ctx.querySelectorAll(input.selector);
     return { sessionId: input.sessionId, refs };
@@ -1739,7 +1756,7 @@ class BrowserEvaluateTask extends Task17 {
   static category = "Browser";
   static title = "Browser Evaluate";
   static description = "Evaluates a JavaScript expression in the browser page context";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return TaskConfigSchema17;
   }
@@ -1759,7 +1776,8 @@ class BrowserEvaluateTask extends Task17 {
       ]
     };
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     const result = await ctx.evaluate(input.expression);
     return { sessionId: input.sessionId, result };
@@ -1818,7 +1836,7 @@ class BrowserPressKeyTask extends Task18 {
   static category = "Browser";
   static title = "Browser Press Key";
   static description = "Presses a keyboard key in the browser, optionally with modifiers";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserPressKeyTaskConfigSchema;
   }
@@ -1832,7 +1850,8 @@ class BrowserPressKeyTask extends Task18 {
     const modifiers = this.config.modifiers?.filter(Boolean) ?? [];
     return modifiers.length > 0 ? `${modifiers.join("+")}+${key}` : key;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     await ctx.pressKey(this.buildKeyChord(input.key));
     return { sessionId: input.sessionId };
@@ -1882,7 +1901,7 @@ class BrowserTypeTask extends Task19 {
   static category = "Browser";
   static title = "Browser Type";
   static description = "Types text into the currently focused element in the browser";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserTypeTaskConfigSchema;
   }
@@ -1892,7 +1911,8 @@ class BrowserTypeTask extends Task19 {
   static outputSchema() {
     return outputSchema19;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     await ctx.type(input.text);
     return { sessionId: input.sessionId };
@@ -1954,7 +1974,7 @@ class BrowserScrollTask extends Task20 {
   static category = "Browser";
   static title = "Browser Scroll";
   static description = "Scrolls the page or a specific element by the given pixel deltas";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserScrollTaskConfigSchema;
   }
@@ -1964,7 +1984,8 @@ class BrowserScrollTask extends Task20 {
   static outputSchema() {
     return outputSchema20;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     await ctx.scroll(this.config.x ?? 0, this.config.y ?? 0, this.config.ref);
     return { sessionId: input.sessionId };
@@ -2026,7 +2047,7 @@ class BrowserUploadTask extends Task21 {
   static category = "Browser";
   static title = "Browser Upload";
   static description = "Uploads one or more files to a file input element in the browser";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static entitlements() {
     return {
       entitlements: [
@@ -2043,7 +2064,8 @@ class BrowserUploadTask extends Task21 {
   static outputSchema() {
     return outputSchema21;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     await ctx.uploadFile(input.ref, input.filePaths);
     return { sessionId: input.sessionId };
@@ -2106,7 +2128,7 @@ class BrowserWaitTask extends Task22 {
   static category = "Browser";
   static title = "Browser Wait";
   static description = "Waits for a navigation, selector, or network idle state in the browser";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserWaitTaskConfigSchema;
   }
@@ -2116,7 +2138,8 @@ class BrowserWaitTask extends Task22 {
   static outputSchema() {
     return outputSchema22;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     const waitFor = this.config.waitFor ?? "idle";
     const timeout = this.config.timeout ?? 30000;
@@ -2188,7 +2211,7 @@ class BrowserNewTabTask extends Task23 {
   static category = "Browser";
   static title = "Browser New Tab";
   static description = "Opens a new browser tab and returns its tab ID";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserNewTabTaskConfigSchema;
   }
@@ -2198,7 +2221,8 @@ class BrowserNewTabTask extends Task23 {
   static outputSchema() {
     return outputSchema23;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     const tabInfo = await ctx.newTab(input.url);
     return { sessionId: input.sessionId, tabId: tabInfo.tabId };
@@ -2248,7 +2272,7 @@ class BrowserSwitchTabTask extends Task24 {
   static category = "Browser";
   static title = "Browser Switch Tab";
   static description = "Switches the active browser tab to the specified tab ID";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserSwitchTabTaskConfigSchema;
   }
@@ -2258,7 +2282,8 @@ class BrowserSwitchTabTask extends Task24 {
   static outputSchema() {
     return outputSchema24;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const ctx = BrowserSessionRegistry.get(input.sessionId);
     await ctx.switchTab(input.tabId);
     return { sessionId: input.sessionId };
@@ -2308,7 +2333,7 @@ class BrowserCloseTabTask extends Task25 {
   static category = "Browser";
   static title = "Browser Close Tab";
   static description = "Closes a browser tab by tab ID";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static configSchema() {
     return browserCloseTabTaskConfigSchema;
   }
@@ -2318,7 +2343,8 @@ class BrowserCloseTabTask extends Task25 {
   static outputSchema() {
     return outputSchema25;
   }
-  async execute(input, _executeContext) {
+  async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     if (!this.config.tabId) {
       throw new Error("BrowserCloseTabTask requires config.tabId");
     }
@@ -2389,7 +2415,7 @@ class BrowserLoginTask extends Task26 {
   static category = "Browser";
   static title = "Browser Login";
   static description = "Logs into a website using manual, credential, or AI-driven login strategies";
-  static cacheable = false;
+  static cachePolicy = { kind: "none" };
   static hasDynamicEntitlements = true;
   static configSchema() {
     return browserLoginTaskConfigSchema;
@@ -2422,6 +2448,7 @@ class BrowserLoginTask extends Task26 {
     return base;
   }
   async execute(input, executeContext) {
+    executeContext.resourceScope?.touch(`browser:${input.sessionId}`);
     const parsed = new URL(input.url, "https://placeholder");
     if (parsed.protocol === "javascript:") {
       throw new Error("BrowserLoginTask: javascript: URLs are not allowed");
@@ -2476,4 +2503,4 @@ export {
   BROWSER_CONTROL_TASK_DEPS
 };
 
-//# debugId=BB75C3F860F618D964756E2164756E21
+//# debugId=87E0BB2655418B2964756E2164756E21