tamash-playwright 0.9.0-beta.2 → 0.9.0-beta.3

package/README.md

@@ -147,6 +147,19 @@ The fix: use a personal-account PAT instead of the ambient token, so the request
 
 Outside GitHub Actions entirely, the same PAT approach applies — set `GITHUB_TOKEN` (or `COPILOT_GITHUB_TOKEN`) to a personal access token with the "Copilot Requests" scope.
 
+**Gotcha if you're not using `@playwright/test` as your runner** (Cucumber, Jest, Mocha, a plain script, …): `copilot-subscription` keeps a shared client open across calls for performance. Playwright's own test runner force-exits its process regardless, so this is invisible there — but a runner that doesn't force-exit will hang indefinitely after all your tests/scenarios have actually finished (confirmed with Cucumber: the process just never returns, even though every scenario passed). Call `closeCopilotSubscriptionClient()` from your runner's own teardown/`AfterAll` hook to fix it:
+
+```ts
+import { AfterAll } from '@cucumber/cucumber';
+import { closeCopilotSubscriptionClient } from 'tamash-playwright';
+
+AfterAll(async () => {
+  await closeCopilotSubscriptionClient();
+});
+```
+
+A no-op if `copilot-subscription` was never used, so it's safe to add unconditionally.
+
 **One thing worth knowing**: only Claude and Copilot support this "subscription, no API key, works in CI too" combination — a ChatGPT or Google AI subscription can back local runs the same way (via those vendors' own CLIs), but neither vendor currently offers a way to use that subscription unattended in CI, so CI there still needs a plain API key (the existing `openai`/`gemini` providers above).
 
 ### Important: set `actionTimeout` in your `playwright.config.ts`

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export type { BindingFixtures } from './bindings';
 export { bindPageActions, bindFrameActions, bindLocatorActions, bindTargetActions, bindContext } from './bindings/locator.binding';
 export { healActionFailure, getHealingReports, getDurableLocator } from './healer';
 export type { SelfHealingReport } from './healer';
+export { closeCopilotSubscriptionClient } from './healer/providers/copilot-subscription';
 export type { HealProvider, SelectorSuggestion, SuggestSelectorInput, TokenUsage, ProviderResult, VisionPoint, SuggestElementFromImageInput, VisionProviderResult, ActionTactic, SuggestActionTacticInput, ActionTacticResult } from './healer/providers/types';
 declare module '@playwright/test' {
     interface Locator {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEnI,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOhQ,OAAO,QAAQ,kBAAkB,CAAC;IAChC,UAAU,OAAO;QACf;;;;;;WAMG;QACH,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAC/C;CACF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEnI,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AASlD,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAEzF,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOhQ,OAAO,QAAQ,kBAAkB,CAAC;IAChC,UAAU,OAAO;QACf;;;;;;WAMG;QACH,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAC/C;CACF"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDurableLocator = exports.getHealingReports = exports.healActionFailure = exports.bindContext = exports.bindTargetActions = exports.bindLocatorActions = exports.bindFrameActions = exports.bindPageActions = exports.expect = exports.test = void 0;
+exports.closeCopilotSubscriptionClient = exports.getDurableLocator = exports.getHealingReports = exports.healActionFailure = exports.bindContext = exports.bindTargetActions = exports.bindLocatorActions = exports.bindFrameActions = exports.bindPageActions = exports.expect = exports.test = void 0;
 var bindings_1 = require("./bindings");
 Object.defineProperty(exports, "test", { enumerable: true, get: function () { return bindings_1.test; } });
 Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return bindings_1.expect; } });
@@ -14,4 +14,13 @@ var healer_1 = require("./healer");
 Object.defineProperty(exports, "healActionFailure", { enumerable: true, get: function () { return healer_1.healActionFailure; } });
 Object.defineProperty(exports, "getHealingReports", { enumerable: true, get: function () { return healer_1.getHealingReports; } });
 Object.defineProperty(exports, "getDurableLocator", { enumerable: true, get: function () { return healer_1.getDurableLocator; } });
+// copilot-subscription keeps a shared CopilotClient (and its underlying `copilot` CLI subprocess)
+// open across calls for performance — harmless inside Playwright's own test runner, which
+// force-exits its process regardless of lingering handles, but a runner that does NOT force-exit
+// (confirmed: Cucumber's CLI does not) will hang indefinitely after all scenarios finish, since the
+// open connection keeps Node's event loop non-empty. Exported here so a non-Playwright consumer can
+// call it from their own teardown hook (e.g. Cucumber's `AfterAll`) — see this package's own
+// usage.md for the exact pattern. A no-op if copilot-subscription was never used.
+var copilot_subscription_1 = require("./healer/providers/copilot-subscription");
+Object.defineProperty(exports, "closeCopilotSubscriptionClient", { enumerable: true, get: function () { return copilot_subscription_1.closeCopilotSubscriptionClient; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAA0C;AAAjC,gGAAA,IAAI,OAAA;AAAE,kGAAA,MAAM,OAAA;AAErB,8DAAmI;AAA1H,kHAAA,eAAe,OAAA;AAAE,mHAAA,gBAAgB,OAAA;AAAE,qHAAA,kBAAkB,OAAA;AAAE,oHAAA,iBAAiB,OAAA;AAAE,8GAAA,WAAW,OAAA;AAE9F,mCAAmF;AAA1E,2GAAA,iBAAiB,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,2GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAA0C;AAAjC,gGAAA,IAAI,OAAA;AAAE,kGAAA,MAAM,OAAA;AAErB,8DAAmI;AAA1H,kHAAA,eAAe,OAAA;AAAE,mHAAA,gBAAgB,OAAA;AAAE,qHAAA,kBAAkB,OAAA;AAAE,oHAAA,iBAAiB,OAAA;AAAE,8GAAA,WAAW,OAAA;AAE9F,mCAAmF;AAA1E,2GAAA,iBAAiB,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAGhE,kGAAkG;AAClG,0FAA0F;AAC1F,iGAAiG;AACjG,oGAAoG;AACpG,oGAAoG;AACpG,6FAA6F;AAC7F,kFAAkF;AAClF,gFAAyF;AAAhF,sIAAA,8BAA8B,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tamash-playwright",
-  "version": "0.9.0-beta.2",
+  "version": "0.9.0-beta.3",
   "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",