tamash-playwright 0.7.0 → 0.8.0

package/dist/healer/providers/index.js

@@ -5,10 +5,15 @@ const ollama_1 = require("./ollama");
 const openai_1 = require("./openai");
 const anthropic_1 = require("./anthropic");
 const gemini_1 = require("./gemini");
+const claude_subscription_1 = require("./claude-subscription");
+const copilot_subscription_1 = require("./copilot-subscription");
 let cachedProvider;
 // HEALER_PROVIDER picks which AI provider backs self-healing; each provider gracefully
 // returns null (disabling healing for that action) if its own API key/model env vars
-// aren't set, so switching providers is just an env change, no code change.
+// aren't set, so switching providers is just an env change, no code change. The two
+// subscription-based providers (claude-subscription, copilot-subscription) have no API key to
+// check synchronously — they always construct successfully and instead return null per-call
+// if the underlying SDK isn't installed or the CLI isn't authenticated.
 function getHealProvider() {
     if (cachedProvider !== undefined) {
         return cachedProvider;
@@ -26,6 +31,12 @@ function getHealProvider() {
         case 'gemini':
             cachedProvider = (0, gemini_1.createGeminiProvider)();
             break;
+        case 'claude-subscription':
+            cachedProvider = (0, claude_subscription_1.createClaudeSubscriptionProvider)();
+            break;
+        case 'copilot-subscription':
+            cachedProvider = (0, copilot_subscription_1.createCopilotSubscriptionProvider)();
+            break;
         default:
             cachedProvider = null;
     }

package/dist/healer/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/healer/providers/index.ts"],"names":[],"mappings":";;;AAAA,qCAAgD;AAChD,qCAAgD;AAChD,2CAAsD;AACtD,qCAAgD;AAKhD,IAAI,cAA+C,CAAC;AAEpD,uFAAuF;AACvF,qFAAqF;AACrF,4EAA4E;AAC5E;IACE,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,QAAQ,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QACpC,KAAK,QAAQ;YACX,cAAc,GAAG,IAAA,6BAAoB,GAAE,CAAC;YACxC,MAAM;QACR,KAAK,QAAQ;YACX,cAAc,GAAG,IAAA,6BAAoB,GAAE,CAAC;YACxC,MAAM;QACR,KAAK,WAAW;YACd,cAAc,GAAG,IAAA,mCAAuB,GAAE,CAAC;YAC3C,MAAM;QACR,KAAK,QAAQ;YACX,cAAc,GAAG,IAAA,6BAAoB,GAAE,CAAC;YACxC,MAAM;QACR;YACE,cAAc,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/healer/providers/index.ts"],"names":[],"mappings":";;;AAAA,qCAAgD;AAChD,qCAAgD;AAChD,2CAAsD;AACtD,qCAAgD;AAChD,+DAAyE;AACzE,iEAA2E;AAK3E,IAAI,cAA+C,CAAC;AAEpD,uFAAuF;AACvF,qFAAqF;AACrF,oFAAoF;AACpF,8FAA8F;AAC9F,4FAA4F;AAC5F,wEAAwE;AACxE;IACE,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,QAAQ,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QACpC,KAAK,QAAQ;YACX,cAAc,GAAG,IAAA,6BAAoB,GAAE,CAAC;YACxC,MAAM;QACR,KAAK,QAAQ;YACX,cAAc,GAAG,IAAA,6BAAoB,GAAE,CAAC;YACxC,MAAM;QACR,KAAK,WAAW;YACd,cAAc,GAAG,IAAA,mCAAuB,GAAE,CAAC;YAC3C,MAAM;QACR,KAAK,QAAQ;YACX,cAAc,GAAG,IAAA,6BAAoB,GAAE,CAAC;YACxC,MAAM;QACR,KAAK,qBAAqB;YACxB,cAAc,GAAG,IAAA,sDAAgC,GAAE,CAAC;YACpD,MAAM;QACR,KAAK,sBAAsB;YACzB,cAAc,GAAG,IAAA,wDAAiC,GAAE,CAAC;YACrD,MAAM;QACR;YACE,cAAc,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tamash-playwright",
-  "version": "0.7.0",
-  "description": "Plug and Play Self-healing for Playwright and automatically recovers broken selectors using an AI model (Ollama, OpenAI, Anthropic, or Gemini).",
+  "version": "0.8.0",
+  "description": "Plug and Play Self-healing for Playwright and automatically recovers broken selectors using an AI model (Ollama, OpenAI, Anthropic, Gemini, or a Claude/GitHub Copilot subscription).",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -27,18 +27,32 @@
     "ollama",
     "openai",
     "anthropic",
-    "gemini"
+    "gemini",
+    "claude-code",
+    "github-copilot"
   ],
   "author": "QtpSudhakar / VibeTestQ",
   "license": "SEE LICENSE IN LICENSE",
   "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": ">=0.3.0",
+    "@github/copilot-sdk": ">=1.0.0",
     "@playwright/test": ">=1.40.0"
   },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/claude-agent-sdk": {
+      "optional": true
+    },
+    "@github/copilot-sdk": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.115.0",
     "dotenv": "^16.0.1"
   },
   "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.241",
+    "@github/copilot-sdk": "^1.0.11",
     "@playwright/test": "^1.62.1",
     "@types/node": "^26.1.2",
     "typescript": "^7.0.2"

package/usage.md

@@ -17,7 +17,6 @@ For a quicker, high-level overview see [README.md](README.md); this file is the
 - [Finding elements by structure](#when-theres-no-name-to-match-finding-elements-by-structure)
 - [When a fix needs a second look](#when-a-fix-needs-a-second-look)
 - [Vision fallback](#when-text-alone-isnt-enough-vision-fallback)
-- [Action recovery](#action-recovery-optional)
 - [Not paying for the same heal twice](#not-paying-for-the-same-heal-twice)
 - [Making a heal permanent: `apply-heals`](#making-a-heal-permanent-apply-heals)
 - [Proving a fix works: `verify-heals.cjs`](#proving-a-fix-actually-works-verify-healscjs)
@@ -55,9 +54,6 @@ HEALER_ENABLED=true
 # Pick one: ollama | openai | anthropic | gemini
 HEALER_PROVIDER=ollama
 
-# Optional, off by default — see "Action recovery" below.
-# HEALER_ACTION_RECOVERY_ENABLED=true
-
 # --- Ollama Cloud (https://ollama.com) ---
 OLLAMA_MODEL=gpt-oss:120b
 OLLAMA_API_KEY=
@@ -108,10 +104,9 @@ npx tamash-playwright doctor
 |---|-------|---------------|
 | 1 | AI connectivity | Confirms `HEALER_ENABLED`/`HEALER_PROVIDER` are set, and actually calls the provider to verify the key and model work. |
 | 2 | `actionTimeout` | Reads `playwright.config.ts`; flags a missing or too-close-to-`timeout` value. |
-| 3 | Action recovery | Reports whether `HEALER_ACTION_RECOVERY_ENABLED` is on. |
-| 4 | Vision capability | Checks by name whether your configured model is expected to support the screenshot fallback. |
-| 5 | Missing `.describe()` | Scans `tests/` (or `--dir <path>`) for locators without a label, raw CSS/XPath first. |
-| 6 | Inline locators | Flags locators written directly in test files rather than a Page Object class. |
+| 3 | Vision capability | Checks by name whether your configured model is expected to support the screenshot fallback. |
+| 4 | Missing `.describe()` | Scans `tests/` (or `--dir <path>`) for locators without a label, raw CSS/XPath first. |
+| 5 | Inline locators | Flags locators written directly in test files rather than a Page Object class. |
 
 If it finds issues, the fastest fix is to open the project in an AI coding assistant and ask it to address what's flagged — add `.describe()` calls, or extract locators into Page Objects. A standing rule in that assistant's instructions file (`CLAUDE.md`, `.cursor/rules`, etc.) keeps it doing both automatically going forward.
 
@@ -208,12 +203,6 @@ If the retry doesn't resolve either, healing falls through to the vision fallbac
 
 Sometimes an element has nothing useful to match on by text — an icon-only button with no label, or several visually distinct elements that look identical in the accessibility tree. If your configured model supports image input (`gpt-4o`, `claude-haiku-4-5`, `gemini-3.6-flash`, …), `tamash-playwright` automatically falls back to a screenshot-based search after the normal text attempt fails — same provider, same key, no separate setup. Run `npx tamash-playwright doctor` to check whether your model is expected to support it.
 
-## Action recovery (optional)
-
-Occasionally a locator heals correctly — the AI found the right element — but the *action* on it still fails: covered by an overlay, needs scrolling into view first. Set `HEALER_ACTION_RECOVERY_ENABLED=true` to let the AI pick a tactic from a fixed, safe menu (scroll into view, bypass actionability checks, wait and retry, or dispatch the DOM event directly) before giving up.
-
-Off by default — it's a second, more speculative layer beyond selector healing. The AI only ever picks from that fixed menu; it never decides how to interact with the page on its own.
-
 ## Not paying for the same heal twice
 
 Once a locator heals successfully, `tamash-playwright` remembers the fix in `.tamash-playwright/heals.jsonl`. The next time that exact locator breaks the same way, it tries the previously-confirmed selector *first* — no ARIA snapshot, no AI call. Only if that no longer works does it fall through to a fresh snapshot-and-AI-call, exactly as before.
@@ -512,7 +501,6 @@ The same detail prints to the console as it happens:
 |----------|---------|---------|
 | `HEALER_ENABLED` | `true` | Master on/off switch. Any value other than `false`/`0` leaves healing on. |
 | `HEALER_PROVIDER` | unset | `ollama` \| `openai` \| `anthropic` \| `gemini`. Unset or missing key/model still allows cache hits, just no fresh AI calls. |
-| `HEALER_ACTION_RECOVERY_ENABLED` | `false` | Opt-in second-layer recovery for actionability failures on an already-correctly-healed locator. |
 | `OLLAMA_MODEL` / `OLLAMA_API_KEY` | — | Ollama Cloud provider config. |
 | `OPENAI_MODEL` / `OPENAI_API_KEY` | — | OpenAI provider config. |
 | `ANTHROPIC_MODEL` / `ANTHROPIC_API_KEY` | — | Anthropic (Claude) provider config. |
@@ -522,7 +510,7 @@ The same detail prints to the console as it happens:
 
 | Command | Flags | What it does |
 |---------|-------|---------------|
-| `npx tamash-playwright doctor` | `--dir <path>` | Pre-flight checks: AI connectivity, `actionTimeout`, action recovery, vision capability, missing `.describe()`, inline locators. |
+| `npx tamash-playwright doctor` | `--dir <path>` | Pre-flight checks: AI connectivity, `actionTimeout`, vision capability, missing `.describe()`, inline locators. |
 | `npx tamash-playwright apply-heals` | `--dry-run` | Preview fixes without writing anything (including `verify-heals.cjs` — see below). |
 | | `--logs-dir <path>` | Merge every `heals.jsonl` found under `<path>` (any nesting) instead of the local log — for sharded CI. |