@poncho-ai/browser 0.6.2 → 0.6.3

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/browser@0.6.2 build /home/runner/work/poncho-ai/poncho-ai/packages/browser
+> @poncho-ai/browser@0.6.3 build /home/runner/work/poncho-ai/poncho-ai/packages/browser
 > tsup src/index.ts --format esm --dts
 
 CLI Building entry: src/index.ts
@@ -7,8 +7,8 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js 41.37 KB
-ESM ⚡️ Build success in 75ms
+ESM dist/index.js 44.07 KB
+ESM ⚡️ Build success in 79ms
 DTS Build start
-DTS ⚡️ Build success in 4983ms
-DTS dist/index.d.ts 13.59 KB
+DTS ⚡️ Build success in 4573ms
+DTS dist/index.d.ts 13.72 KB

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @poncho-ai/browser
 
+## 0.6.3
+
+### Patch Changes
+
+- [`35f3f54`](https://github.com/cesr/poncho-ai/commit/35f3f54b17ff50253ab01dbcfe19c643dd6c7e00) Thanks [@cesr](https://github.com/cesr)! - Add `browser_clear_cookies` tool for deleting browser cookies
+
+  Agents with `browser: true` can now call `browser_clear_cookies` to delete cookies from the live browser and persisted storage. Accepts an optional `url` parameter to scope deletion to a specific site (e.g. "https://example.com"); omit to clear all cookies.
+
 ## 0.6.2
 
 ### Patch Changes

package/dist/index.d.ts

@@ -147,6 +147,9 @@ declare class BrowserSession {
     executeJs(conversationId: string, script: string): Promise<unknown>;
     closeTab(conversationId: string): Promise<void>;
     navigate(conversationId: string, action: string): Promise<void>;
+    clearCookies(conversationId: string, url?: string): Promise<{
+        cleared: number;
+    }>;
     startScreencast(conversationId: string, options?: ScreencastOptions): Promise<void>;
     stopScreencast(): Promise<void>;
     onFrame(conversationId: string, listener: FrameListener): () => void;
@@ -158,6 +161,7 @@ declare class BrowserSession {
     saveState(storagePath: string): Promise<void>;
     private persistStorageState;
     private restoreStorageState;
+    private clearPersistedCookies;
     close(): Promise<void>;
     private emitStatus;
 }

package/dist/index.js

@@ -739,6 +739,34 @@ var BrowserSession = class {
       this.unlock();
     }
   }
+  async clearCookies(conversationId, url) {
+    await this.lock();
+    try {
+      const mgr = await this.ensureManager();
+      await this.switchToConversation(mgr, conversationId);
+      const cdp = await mgr.getCDPSession();
+      let cleared = 0;
+      if (url) {
+        const { cookies } = await cdp.send("Network.getCookies", { urls: [url] });
+        cleared = cookies.length;
+        for (const cookie of cookies) {
+          await cdp.send("Network.deleteCookies", {
+            name: cookie.name,
+            domain: cookie.domain,
+            path: cookie.path
+          });
+        }
+      } else {
+        const { cookies } = await cdp.send("Network.getCookies");
+        cleared = cookies.length;
+        await cdp.send("Network.clearBrowserCookies");
+      }
+      await this.clearPersistedCookies(url);
+      return { cleared };
+    } finally {
+      this.unlock();
+    }
+  }
   // -----------------------------------------------------------------------
   // Screencast (one active at a time, tied to the viewed conversation)
   // -----------------------------------------------------------------------
@@ -933,6 +961,36 @@ var BrowserSession = class {
       console.warn("[poncho][browser] Failed to restore storage state:", err?.message ?? err);
     }
   }
+  async clearPersistedCookies(url) {
+    const persistence = this.config.storagePersistence;
+    if (!persistence) return;
+    try {
+      const json = await persistence.load();
+      if (!json) return;
+      const state = JSON.parse(json);
+      if (!state.cookies?.length) return;
+      if (url) {
+        let host;
+        try {
+          host = new URL(url).hostname.toLowerCase();
+        } catch {
+          return;
+        }
+        state.cookies = state.cookies.filter((c) => {
+          const raw = String(c.domain ?? "").toLowerCase();
+          const bare = raw.replace(/^\./, "");
+          if (host === bare) return false;
+          if (raw.startsWith(".") && host.endsWith("." + bare)) return false;
+          return true;
+        });
+      } else {
+        state.cookies = [];
+      }
+      await persistence.save(JSON.stringify(state));
+    } catch (err) {
+      console.warn("[poncho][browser] Failed to clear persisted cookies:", err?.message ?? err);
+    }
+  }
   async close() {
     try {
       await this.stopScreencast();
@@ -1167,6 +1225,25 @@ function createBrowserTools(getSession, getConversationId) {
         return { scrolled: direction, amount: amount ?? "viewport" };
       }
     },
+    {
+      name: "browser_clear_cookies",
+      description: `Delete browser cookies. By default clears all cookies. Pass a url to only delete cookies that would be sent to that URL (e.g. "https://example.com" removes cookies for example.com and its subdomains). Also removes them from persisted storage so they won't be restored on next launch.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          url: {
+            type: "string",
+            description: 'Optional URL to scope deletion to (e.g. "https://example.com"). Omit to clear all cookies.'
+          }
+        }
+      },
+      handler: async (input) => {
+        const session = getSession();
+        const url = input.url ? String(input.url) : void 0;
+        const { cleared } = await session.clearCookies(getConversationId(), url);
+        return { cleared, scope: url ?? "all" };
+      }
+    },
     {
       name: "browser_close",
       description: "Close the browser tab for this conversation. Call this when you're done with browser tasks to free resources.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/browser",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Browser automation for Poncho agents, powered by agent-browser",
   "repository": {
     "type": "git",

package/src/session.ts

@@ -676,6 +676,42 @@ export class BrowserSession {
     }
   }
 
+  async clearCookies(conversationId: string, url?: string): Promise<{ cleared: number }> {
+    await this.lock();
+    try {
+      const mgr = await this.ensureManager();
+      await this.switchToConversation(mgr, conversationId);
+      const cdp = await mgr.getCDPSession();
+
+      let cleared = 0;
+
+      if (url) {
+        const { cookies } = (await cdp.send("Network.getCookies", { urls: [url] })) as {
+          cookies: Array<{ name: string; domain: string; path: string }>;
+        };
+        cleared = cookies.length;
+        for (const cookie of cookies) {
+          await cdp.send("Network.deleteCookies", {
+            name: cookie.name,
+            domain: cookie.domain,
+            path: cookie.path,
+          });
+        }
+      } else {
+        const { cookies } = (await cdp.send("Network.getCookies")) as {
+          cookies: Array<unknown>;
+        };
+        cleared = cookies.length;
+        await cdp.send("Network.clearBrowserCookies");
+      }
+
+      await this.clearPersistedCookies(url);
+      return { cleared };
+    } finally {
+      this.unlock();
+    }
+  }
+
   // -----------------------------------------------------------------------
   // Screencast (one active at a time, tied to the viewed conversation)
   // -----------------------------------------------------------------------
@@ -881,6 +917,38 @@ export class BrowserSession {
     }
   }
 
+  private async clearPersistedCookies(url?: string): Promise<void> {
+    const persistence = this.config.storagePersistence;
+    if (!persistence) return;
+    try {
+      const json = await persistence.load();
+      if (!json) return;
+      const state = JSON.parse(json) as {
+        cookies?: Array<Record<string, unknown>>;
+        origins?: Array<{ origin: string; localStorage: Array<{ name: string; value: string }> }>;
+      };
+      if (!state.cookies?.length) return;
+
+      if (url) {
+        let host: string;
+        try { host = new URL(url).hostname.toLowerCase(); } catch { return; }
+        state.cookies = state.cookies.filter((c) => {
+          const raw = String(c.domain ?? "").toLowerCase();
+          const bare = raw.replace(/^\./, "");
+          if (host === bare) return false;
+          if (raw.startsWith(".") && host.endsWith("." + bare)) return false;
+          return true;
+        });
+      } else {
+        state.cookies = [];
+      }
+
+      await persistence.save(JSON.stringify(state));
+    } catch (err) {
+      console.warn("[poncho][browser] Failed to clear persisted cookies:", (err as Error)?.message ?? err);
+    }
+  }
+
   async close(): Promise<void> {
     try { await this.stopScreencast(); } catch { /* */ }
     await this.persistStorageState();

package/src/tools.ts

@@ -221,6 +221,30 @@ export function createBrowserTools(
         return { scrolled: direction, amount: amount ?? "viewport" };
       },
     },
+    {
+      name: "browser_clear_cookies",
+      description:
+        "Delete browser cookies. By default clears all cookies. " +
+        "Pass a url to only delete cookies that would be sent to that URL " +
+        "(e.g. \"https://example.com\" removes cookies for example.com and its subdomains). " +
+        "Also removes them from persisted storage so they won't be restored on next launch.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          url: {
+            type: "string",
+            description:
+              "Optional URL to scope deletion to (e.g. \"https://example.com\"). Omit to clear all cookies.",
+          },
+        },
+      },
+      handler: async (input: BrowserToolInput) => {
+        const session = getSession();
+        const url = input.url ? String(input.url) : undefined;
+        const { cleared } = await session.clearCookies(getConversationId(), url);
+        return { cleared, scope: url ?? "all" };
+      },
+    },
     {
       name: "browser_close",
       description: