@agentsim/sdk 0.21.0 → 0.22.0

package/README.md

@@ -1,6 +1,6 @@
 # @agentsim/sdk
 
-TypeScript/JavaScript SDK for AgentSIM — autonomous OTP relay for AI agents. Zero runtime dependencies. Works in Node.js 18+, Bun, Deno, and Edge runtimes.
+AgentSIM is the control plane for agents hitting the real world's auth walls. SMS OTP is the first challenge type. This TypeScript/JavaScript SDK has zero runtime dependencies and works in Node.js 18+, Bun, Deno, and Edge runtimes.
 
 ## Install
 
@@ -16,7 +16,7 @@ import { provision } from "@agentsim/sdk";
 
 // Using AsyncDisposable (TypeScript 5.2+, recommended)
 await using num = await provision({ agentId: "checkout-bot", country: "US" });
-await enterPhoneNumber(num.number);            // "+14155552671"
+await enterPhoneNumber(num.number);            // "+12025550142"
 const otp = await num.waitForOtp({ timeout: 60 });
 await enterOtp(otp.otpCode);                   // "847291"
 // number auto-released via [Symbol.asyncDispose]

package/dist/index.d.ts

@@ -4,6 +4,8 @@ import type { ProvisionOptions } from "./client.js";
 export { AgentSimClient } from "./client.js";
 export { NumberSession } from "./session.js";
 export type { ProvisionOptions, OtpResult, SmsMessage, WaitForOtpOptions, ReregistrationInfo } from "./client.js";
+export { classifyStall } from "./playwright.js";
+export type { ChallengeChannel, LocatorLike, PageLike, StallOutcome, StallSessionEvidence } from "./playwright.js";
 export { AgentSimError, AuthenticationError, ForbiddenError, PoolExhaustedError, SessionNotFoundError, OtpTimeoutError, RateLimitError, ValidationError, ApiError, } from "./errors.js";
 /**
  * Provision a temporary phone number for the given agent. Starts a billable session.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,aAAa,CAAC;AAE3E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,eAAe,EACf,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,EACzB,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,GACvC,OAAO,CAAC,aAAa,CAAC,CAkBxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,aAAa,CAAC;AAE3E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACnH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,eAAe,EACf,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,EACzB,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,GACvC,OAAO,CAAC,aAAa,CAAC,CAkBxB"}

package/dist/index.js

@@ -2,6 +2,7 @@ import { AgentSimClient } from "./client.js";
 import { NumberSession } from "./session.js";
 export { AgentSimClient } from "./client.js";
 export { NumberSession } from "./session.js";
+export { classifyStall } from "./playwright.js";
 export { AgentSimError, AuthenticationError, ForbiddenError, PoolExhaustedError, SessionNotFoundError, OtpTimeoutError, RateLimitError, ValidationError, ApiError, } from "./errors.js";
 /**
  * Provision a temporary phone number for the given agent. Starts a billable session.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,eAAe,EACf,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAyB,EACzB,cAAwC;IAExC,IAAI,MAAsB,CAAC;IAE3B,IAAI,cAAc,YAAY,cAAc,EAAE,CAAC;QAC7C,MAAM,GAAG,cAAc,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,cAAc,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAwB,MAAM,EAAE,WAAW,EAAE;QAC5E,QAAQ,EAAE,OAAO,CAAC,OAAO;QACzB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,WAAW,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACvC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC,CAAC;IAEH,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,eAAe,EACf,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAyB,EACzB,cAAwC;IAExC,IAAI,MAAsB,CAAC;IAE3B,IAAI,cAAc,YAAY,cAAc,EAAE,CAAC;QAC7C,MAAM,GAAG,cAAc,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,cAAc,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAwB,MAAM,EAAE,WAAW,EAAE;QAC5E,QAAQ,EAAE,OAAO,CAAC,OAAO;QACzB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,WAAW,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACvC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC,CAAC;IAEH,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/playwright.d.ts

@@ -0,0 +1,17 @@
+export type ChallengeChannel = "sms_otp" | "email_otp" | "magic_link" | "webauthn_required";
+export type StallOutcome = "otp_received" | "sms_no_otp" | "no_sms" | "phone_rejected" | "anti_bot_gate" | "email_received" | "magic_link_received" | "webauthn_required" | "no_email";
+export interface LocatorLike {
+    first(): LocatorLike;
+    isVisible(): Promise<boolean>;
+    innerText(): Promise<string>;
+}
+export interface PageLike {
+    locator(selector: string): LocatorLike;
+}
+export interface StallSessionEvidence {
+    channel: ChallengeChannel;
+    challengeValue?: string | null;
+    messageCount: number;
+}
+export declare function classifyStall(page: PageLike, session: StallSessionEvidence): Promise<StallOutcome>;
+//# sourceMappingURL=playwright.d.ts.map

package/dist/playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../src/playwright.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,mBAAmB,CAAC;AAE5F,MAAM,MAAM,YAAY,GACpB,cAAc,GACd,YAAY,GACZ,QAAQ,GACR,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,qBAAqB,GACrB,mBAAmB,GACnB,UAAU,CAAC;AAEf,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,WAAW,CAAC;IACrB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;CACtB;AAgCD,wBAAsB,aAAa,CACjC,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,CA4CvB"}

package/dist/playwright.js

@@ -0,0 +1,62 @@
+const ANTI_BOT_SELECTOR = [
+    'iframe[src*="recaptcha" i]',
+    'iframe[src*="hcaptcha" i]',
+    'iframe[src*="arkoselabs" i]',
+    "[data-sitekey]",
+    '[class*="captcha" i]',
+].join(", ");
+const WEBAUTHN_SELECTOR = [
+    'iframe[src*="webauthn" i]',
+    '[autocomplete="webauthn"]',
+    '[data-testid*="passkey" i]',
+    '[data-testid*="webauthn" i]',
+    '[id*="passkey" i]',
+    '[id*="webauthn" i]',
+    '[class*="passkey" i]',
+    '[class*="webauthn" i]',
+    'button[data-action*="passkey" i]',
+    'button[data-action*="webauthn" i]',
+].join(", ");
+const EMAIL_FIELD_SELECTOR = 'input[type="email"], input[autocomplete="email"]';
+const OTP_FIELD_SELECTOR = [
+    'input[autocomplete="one-time-code"]',
+    'input[name*="otp" i]',
+    'input[id*="otp" i]',
+    'input[name*="code" i]',
+    'input[id*="code" i]',
+].join(", ");
+export async function classifyStall(page, session) {
+    if (session.challengeValue?.trim()) {
+        return {
+            sms_otp: "otp_received",
+            email_otp: "email_received",
+            magic_link: "magic_link_received",
+            webauthn_required: "webauthn_required",
+        }[session.channel];
+    }
+    const pageText = await page.locator("body").innerText();
+    if (await page.locator(ANTI_BOT_SELECTOR).first().isVisible()
+        || /captcha|verify (?:you are|that you are) human|(?:not a|are you (?:a )?) robot|security challenge/i.test(pageText)) {
+        return "anti_bot_gate";
+    }
+    if (await page.locator(WEBAUTHN_SELECTOR).first().isVisible()
+        || /\b(?:passkey|security key|webauthn|touch id|windows hello|face id|biometric|fingerprint auth(?:entication)?|use your (?:passkey|security key)|authenticate with (?:passkey|security key|biometric))\b/i.test(pageText)
+        || /navigator\.credentials\.get/i.test(pageText)
+        || /PublicKeyCredential/i.test(pageText)) {
+        return "webauthn_required";
+    }
+    if (/\b(?:phone|mobile)(?: number)?\b[\s\S]{0,80}\b(?:cannot|can't|invalid|unsupported|rejected|not (?:accepted|supported|allowed)|try another)\b/i.test(pageText)
+        || /\b(?:invalid|unsupported|rejected)\b[\s\S]{0,40}\b(?:phone|mobile)(?: number)?\b/i.test(pageText)) {
+        return "phone_rejected";
+    }
+    if (await page.locator(EMAIL_FIELD_SELECTOR).first().isVisible()
+        || (session.channel !== "sms_otp"
+            && await page.locator(OTP_FIELD_SELECTOR).first().isVisible())) {
+        return "no_email";
+    }
+    if (session.channel === "sms_otp" && session.messageCount > 0) {
+        return "sms_no_otp";
+    }
+    return session.channel === "sms_otp" ? "no_sms" : "no_email";
+}
+//# sourceMappingURL=playwright.js.map

package/dist/playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.js","sourceRoot":"","sources":["../src/playwright.ts"],"names":[],"mappings":"AA6BA,MAAM,iBAAiB,GAAG;IACxB,4BAA4B;IAC5B,2BAA2B;IAC3B,6BAA6B;IAC7B,gBAAgB;IAChB,sBAAsB;CACvB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,iBAAiB,GAAG;IACxB,2BAA2B;IAC3B,2BAA2B;IAC3B,4BAA4B;IAC5B,6BAA6B;IAC7B,mBAAmB;IACnB,oBAAoB;IACpB,sBAAsB;IACtB,uBAAuB;IACvB,kCAAkC;IAClC,mCAAmC;CACpC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,oBAAoB,GAAG,kDAAkD,CAAC;AAChF,MAAM,kBAAkB,GAAG;IACzB,qCAAqC;IACrC,sBAAsB;IACtB,oBAAoB;IACpB,uBAAuB;IACvB,qBAAqB;CACtB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAc,EACd,OAA6B;IAE7B,IAAI,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;QACnC,OAAQ;YACN,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,gBAAgB;YAC3B,UAAU,EAAE,qBAAqB;YACjC,iBAAiB,EAAE,mBAAmB;SAC7B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;IACxD,IACE,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE;WACtD,mGAAmG,CAAC,IAAI,CAAC,QAAQ,CAAC,EACrH,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IACE,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE;WACtD,wMAAwM,CAAC,IAAI,CAAC,QAAQ,CAAC;WACvN,8BAA8B,CAAC,IAAI,CAAC,QAAQ,CAAC;WAC7C,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,EACxC,CAAC;QACD,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,IACE,+IAA+I,CAAC,IAAI,CAAC,QAAQ,CAAC;WAC3J,mFAAmF,CAAC,IAAI,CAAC,QAAQ,CAAC,EACrG,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IACE,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE;WACzD,CACD,OAAO,CAAC,OAAO,KAAK,SAAS;eAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,CAC9D,EACD,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;AAC/D,CAAC"}

package/dist/playwright.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=playwright.test.d.ts.map

package/dist/playwright.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.test.d.ts","sourceRoot":"","sources":["../src/playwright.test.ts"],"names":[],"mappings":""}

package/dist/playwright.test.js

@@ -0,0 +1,121 @@
+import { describe, expect, it } from "vitest";
+import { classifyStall } from "./index.js";
+function fakePage(text = "", visible = []) {
+    return {
+        locator(selector) {
+            const locator = {
+                first: () => locator,
+                isVisible: async () => visible.some((marker) => selector.includes(marker)),
+                innerText: async () => selector === "body" ? text : "",
+            };
+            return locator;
+        },
+    };
+}
+describe("classifyStall", () => {
+    it("reports a resolved SMS challenge as OTP received", async () => {
+        const page = {
+            locator() {
+                throw new Error("resolved challenges should not inspect the page");
+            },
+        };
+        await expect(classifyStall(page, {
+            channel: "sms_otp",
+            challengeValue: "847291",
+            messageCount: 1,
+        })).resolves.toBe("otp_received");
+    });
+    it.each([
+        ["email_otp", "email_received"],
+        ["magic_link", "magic_link_received"],
+    ])("reports a resolved %s challenge", async (channel, outcome) => {
+        const page = {
+            locator() {
+                throw new Error("resolved challenges should not inspect the page");
+            },
+        };
+        await expect(classifyStall(page, {
+            channel,
+            challengeValue: "https://example.test/verify",
+            messageCount: 1,
+        })).resolves.toBe(outcome);
+    });
+    it.each([
+        ["anti-bot copy", fakePage("Verify you are human to continue")],
+        ["robot-check copy", fakePage("Please prove you are not a robot")],
+        ["a visible CAPTCHA iframe", fakePage("", ["recaptcha"])],
+    ])("reports an anti-bot gate from %s", async (_source, page) => {
+        await expect(classifyStall(page, {
+            channel: "sms_otp",
+            messageCount: 0,
+        })).resolves.toBe("anti_bot_gate");
+    });
+    it.each([
+        ["passkey copy", fakePage("Use a passkey to continue")],
+        ["security key copy", fakePage("Insert your security key to authenticate")],
+        ["Touch ID copy", fakePage("Authenticate with Touch ID")],
+        ["Windows Hello copy", fakePage("Sign in with Windows Hello")],
+        ["Face ID copy", fakePage("Use Face ID to continue")],
+        ["biometric copy", fakePage("Authenticate with biometric verification")],
+        ["fingerprint auth copy", fakePage("Use fingerprint authentication to proceed")],
+        ["navigator.credentials.get code", fakePage("navigator.credentials.get({ publicKey")],
+        ["PublicKeyCredential code", fakePage("new PublicKeyCredential()")],
+        ["a visible WebAuthn iframe", fakePage("", ["webauthn"])],
+        ["a visible passkey button", fakePage("", ["passkey"])],
+    ])("reports WebAuthn from %s", async (_source, page) => {
+        await expect(classifyStall(page, {
+            channel: "email_otp",
+            messageCount: 0,
+        })).resolves.toBe("webauthn_required");
+    });
+    it.each([
+        "This phone number cannot be used for verification.",
+        "Phone number\ncannot be used here.",
+    ])("reports an explicit phone rejection", async (text) => {
+        await expect(classifyStall(fakePage(text), {
+            channel: "sms_otp",
+            messageCount: 0,
+        })).resolves.toBe("phone_rejected");
+    });
+    it("reports SMS received without a parsed OTP", async () => {
+        const page = fakePage("Enter the code we sent", ["one-time-code"]);
+        await expect(classifyStall(page, {
+            channel: "sms_otp",
+            messageCount: 1,
+        })).resolves.toBe("sms_no_otp");
+    });
+    it("reports no SMS when no message arrived", async () => {
+        await expect(classifyStall(fakePage("Enter the code we sent", ["one-time-code"]), {
+            channel: "sms_otp",
+            messageCount: 0,
+        })).resolves.toBe("no_sms");
+    });
+    it("reports no email while an email challenge field is visible", async () => {
+        const page = fakePage("Check your email", ['input[type="email"']);
+        await expect(classifyStall(page, {
+            channel: "email_otp",
+            messageCount: 0,
+        })).resolves.toBe("no_email");
+    });
+    it("recognizes an email-first stall even on the default SMS channel", async () => {
+        const page = fakePage("Enter your email to continue", ['input[type="email"']);
+        await expect(classifyStall(page, {
+            channel: "sms_otp",
+            messageCount: 0,
+        })).resolves.toBe("no_email");
+    });
+    it("reports no email while an OTP field is visible", async () => {
+        const page = fakePage("Enter the code from your email", ["one-time-code"]);
+        await expect(classifyStall(page, {
+            channel: "email_otp",
+            messageCount: 0,
+        })).resolves.toBe("no_email");
+    });
+    it.each(["email_otp", "magic_link"])("uses no_email as the honest %s fallback", async (channel) => {
+        await expect(classifyStall(fakePage(), {
+            channel,
+            messageCount: 0,
+        })).resolves.toBe("no_email");
+    });
+});
+//# sourceMappingURL=playwright.test.js.map

package/dist/playwright.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentsim/sdk",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "AgentSIM TypeScript SDK — autonomous OTP relay for AI agents",
   "type": "module",
   "main": "./dist/index.js",