@poe-platform/safe-bash 0.1.635 → 0.1.636

package/dist/safe-bash/playwright/snapshot.js

@@ -0,0 +1,96 @@
+/** Public element handles only. Shared by regular and Cloudflare injected pages.
+ * This is a DOM interaction summary, not the full Playwright CLI accessibility tree.
+ * Guest text is never compiled or evaluated as a locator or browser program.
+ */
+export function createSnapshotEngine(limits, nextRef) {
+    for (const value of [limits?.maxSnapshotBytes, limits?.maxSnapshotRefs])
+        if (!Number.isSafeInteger(value) || value < 1)
+            throw new RangeError('Invalid snapshot limit');
+    const { maxSnapshotBytes, maxSnapshotRefs } = limits;
+    let sequence = 0;
+    let epoch = 0;
+    const retirements = new Set();
+    const refs = new Map();
+    const invalidate = async () => {
+        epoch++;
+        const handles = [...refs.values()];
+        refs.clear();
+        const tasks = [...new Set(handles)].map(handle => Promise.resolve().then(() => handle.dispose()));
+        for (const task of tasks) {
+            retirements.add(task);
+            void task.then(() => retirements.delete(task), () => { });
+        }
+        const results = await Promise.allSettled([...retirements]);
+        const errors = results.flatMap(result => result.status === 'rejected' ? [result.reason] : []);
+        if (errors.length)
+            throw new AggregateError(errors, 'Snapshot handle disposal failed');
+    };
+    const capture = async (page, signal) => {
+        signal?.throwIfAborted();
+        if (typeof page.frames !== 'function')
+            throw new Error('Snapshot engine unsupported: public frame element handles required');
+        const frames = page.frames();
+        if (frames.some(frame => typeof frame.locator('button, input, textarea, select, a[href], [role], [contenteditable="true"]').elementHandles !== 'function'))
+            throw new Error('Snapshot engine unsupported: public element handles required');
+        await invalidate();
+        const capturedEpoch = epoch;
+        const acquired = new Set();
+        const pending = new Map();
+        let text = '';
+        let bytes = 0;
+        try {
+            for (const frame of frames) {
+                signal?.throwIfAborted();
+                const handles = await frame.locator('button, input, textarea, select, a[href], [role], [contenteditable="true"]').elementHandles();
+                for (const handle of handles)
+                    acquired.add(handle);
+                if (acquired.size > maxSnapshotRefs)
+                    throw new Error('Snapshot ref limit exceeded');
+                for (const handle of handles) {
+                    signal?.throwIfAborted();
+                    const summary = await handle.evaluate(node => {
+                        const tag = node.tagName.toLowerCase();
+                        const roles = { button: 'button', input: 'textbox', textarea: 'textbox', select: 'combobox', a: 'link' };
+                        return { role: node.getAttribute('role') || roles[tag] || tag, name: node.getAttribute('aria-label') || node.getAttribute('placeholder') || node.textContent || '' };
+                    });
+                    const ref = nextRef?.() ?? `e${++sequence}`;
+                    const line = `- ${JSON.stringify(summary.role).slice(1, -1)} ${JSON.stringify(summary.name.trim())} [ref=${ref}]\n`;
+                    bytes += new TextEncoder().encode(line).byteLength;
+                    if (bytes > maxSnapshotBytes)
+                        throw new Error('Snapshot byte limit exceeded');
+                    pending.set(ref, handle);
+                    text += line;
+                }
+            }
+            signal?.throwIfAborted();
+            if (capturedEpoch !== epoch)
+                throw new Error('Snapshot stale during capture');
+            for (const [ref, handle] of pending)
+                refs.set(ref, handle);
+            return text;
+        }
+        catch (error) {
+            const results = await Promise.allSettled([...acquired].map(handle => Promise.resolve().then(() => handle.dispose())));
+            const errors = results.flatMap(result => result.status === 'rejected' ? [result.reason] : []);
+            if (errors.length)
+                throw new AggregateError([error, ...errors], 'Snapshot capture and cleanup failed');
+            throw error;
+        }
+    };
+    const resolve = async (ref) => {
+        const handle = refs.get(ref);
+        if (!handle)
+            throw new Error(`Unknown or stale snapshot ref: ${ref}; snapshot again`);
+        const capturedEpoch = epoch;
+        let connected = false;
+        try {
+            connected = await handle.evaluate(node => node.isConnected && (!node.ownerDocument || node.ownerDocument.defaultView?.document === node.ownerDocument));
+        }
+        catch { /* Detached frames and destroyed execution contexts are stale. */ }
+        if (!connected || capturedEpoch !== epoch)
+            throw new Error(`Snapshot ref stale: ${ref}; snapshot again`);
+        return handle;
+    };
+    return { capture, resolve, invalidate };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/safe-bash/playwright/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/playwright/snapshot.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poe-platform/safe-bash",
-  "version": "0.1.635",
+  "version": "0.1.636",
   "description": "Extensible virtual shell with pluggable filesystems and streaming commands",
   "type": "module",
   "license": "MIT",
@@ -335,6 +335,16 @@
     "./trap": {
       "types": "./dist/safe-bash/opt-in/entrypoints/trap.d.ts",
       "import": "./dist/safe-bash/opt-in/entrypoints/trap.js"
+    },
+    "./commands/playwright": {
+      "types": "./dist/safe-bash/commands/playwright/index.d.ts",
+      "browser": "./dist/safe-bash/commands/playwright/index.js",
+      "import": "./dist/safe-bash/commands/playwright/index.js"
+    },
+    "./playwright": {
+      "types": "./dist/safe-bash/commands/playwright/index.d.ts",
+      "browser": "./dist/safe-bash/commands/playwright/index.js",
+      "import": "./dist/safe-bash/commands/playwright/index.js"
     }
   },
   "repository": {
@@ -346,7 +356,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@poe-platform/safe-fs": "0.1.635",
+    "@poe-platform/safe-fs": "0.1.636",
     "pako": "3.0.1",
     "@noble/hashes": "2.4.0",
     "@types/node": "^25.2.2",