prowl-tools 0.1.9 → 0.1.10

package/dist/lib.d.cts

@@ -115,6 +115,12 @@ type HistoryEntry = {
     durationMs: number;
     startedAt: string;
     runDir?: string;
+    /**
+     * Number of retry attempts beyond the first for this run (PROWL-033). Absent or
+     * `0` when the run did not retry — kept optional so older `history.json` files and
+     * runs of hunts without a `retry` block keep parsing unchanged.
+     */
+    retries?: number;
 };
 type HistoryFile = {
     entries: HistoryEntry[];
@@ -177,6 +183,13 @@ type WaitForNetworkIdleStep = {
         timeout?: number;
     };
 };
+type WaitForResponseStep = {
+    waitForResponse: {
+        url: string;
+        status?: number;
+        timeout?: number;
+    };
+};
 type SelectOptionStep = {
     selectOption: {
         selector: string;
@@ -299,7 +312,7 @@ type AssertScreenshotStep = {
 type AssertWithAiStep = {
     assertWithAI: string;
 };
-type Step = NavigateStep | ClickStep | FillStep | TypeStep | PressStep | WaitStep | SelectOptionStep | SelectStep | OnDialogStep | SetInputFilesStep | InlineAssertStep | RunHuntStep | WaitForSelectorStep | WaitForUrlStep | WaitForNetworkIdleStep | HoverStep | ScrollStep | ScrollToStep | ScreenshotStep | IfStep | RepeatStep | MockRouteStep | UnmockRouteStep | EvalScriptStep | RunScriptStep | AssertScreenshotStep | AssertWithAiStep | CopyTextStep | WaitForDownloadStep;
+type Step = NavigateStep | ClickStep | FillStep | TypeStep | PressStep | WaitStep | SelectOptionStep | SelectStep | OnDialogStep | SetInputFilesStep | InlineAssertStep | RunHuntStep | WaitForSelectorStep | WaitForUrlStep | WaitForNetworkIdleStep | WaitForResponseStep | HoverStep | ScrollStep | ScrollToStep | ScreenshotStep | IfStep | RepeatStep | MockRouteStep | UnmockRouteStep | EvalScriptStep | RunScriptStep | AssertScreenshotStep | AssertWithAiStep | CopyTextStep | WaitForDownloadStep;
 type Assertion = {
     selectorExists: string;
 } | {
@@ -344,6 +357,25 @@ type TraceCorrelation = {
     traceId: string;
     header: string;
 };
+/**
+ * One attempt of a retried hunt (PROWL-033). Recorded per attempt so a passed-on-retry
+ * run keeps the reason each earlier attempt failed, helping tell a flaky test apart from
+ * a slow environment or a real regression.
+ */
+type RetryAttempt = {
+    /** 1-based attempt number (attempt 1 is the initial run). */
+    attempt: number;
+    status: "pass" | "fail";
+    durationMs: number;
+    /** The first failing step on this attempt; absent when the attempt passed. */
+    failedStep?: {
+        /** 0-based index into the hunt's steps. */
+        index: number;
+        type: string;
+    };
+    /** Failure reason for this attempt; absent when it passed. */
+    error?: string;
+};
 type RunResult = {
     status: "pass" | "fail";
     exitCode: 0 | 1;
@@ -355,6 +387,17 @@ type RunResult = {
     assertions: AssertionResult[];
     artifacts: RunArtifacts;
     traceCorrelations?: TraceCorrelation[];
+    /**
+     * Per-attempt diagnostics (PROWL-033), present only when the hunt used `retry` and
+     * more than one attempt ran. Absent when no retry occurred so existing consumers and
+     * older run artifacts keep parsing. The last entry always matches the final result.
+     */
+    retryHistory?: RetryAttempt[];
+    /**
+     * Human-readable one-line retry outcome (PROWL-033), e.g. "Passed on attempt 2 of 3
+     * — first failure: navigate (timeout)". Present only alongside `retryHistory`.
+     */
+    retrySummary?: string;
 };
 type CiHuntResult = {
     hunt: string;
@@ -477,6 +520,10 @@ interface SessionDriver {
     waitForNetworkIdle(options?: {
         timeout?: number;
     }): Promise<void>;
+    /** Resolve once a network response satisfies `predicate`, or reject on timeout. */
+    waitForResponse(predicate: (response: DriverResponse) => boolean, options?: {
+        timeout?: number;
+    }): Promise<void>;
     evaluate<R = unknown, A = unknown>(pageFunction: string | ((arg: A) => R | Promise<R>), arg?: A): Promise<R>;
     screenshot(options: {
         path: string;

package/dist/lib.d.ts

@@ -115,6 +115,12 @@ type HistoryEntry = {
     durationMs: number;
     startedAt: string;
     runDir?: string;
+    /**
+     * Number of retry attempts beyond the first for this run (PROWL-033). Absent or
+     * `0` when the run did not retry — kept optional so older `history.json` files and
+     * runs of hunts without a `retry` block keep parsing unchanged.
+     */
+    retries?: number;
 };
 type HistoryFile = {
     entries: HistoryEntry[];
@@ -177,6 +183,13 @@ type WaitForNetworkIdleStep = {
         timeout?: number;
     };
 };
+type WaitForResponseStep = {
+    waitForResponse: {
+        url: string;
+        status?: number;
+        timeout?: number;
+    };
+};
 type SelectOptionStep = {
     selectOption: {
         selector: string;
@@ -299,7 +312,7 @@ type AssertScreenshotStep = {
 type AssertWithAiStep = {
     assertWithAI: string;
 };
-type Step = NavigateStep | ClickStep | FillStep | TypeStep | PressStep | WaitStep | SelectOptionStep | SelectStep | OnDialogStep | SetInputFilesStep | InlineAssertStep | RunHuntStep | WaitForSelectorStep | WaitForUrlStep | WaitForNetworkIdleStep | HoverStep | ScrollStep | ScrollToStep | ScreenshotStep | IfStep | RepeatStep | MockRouteStep | UnmockRouteStep | EvalScriptStep | RunScriptStep | AssertScreenshotStep | AssertWithAiStep | CopyTextStep | WaitForDownloadStep;
+type Step = NavigateStep | ClickStep | FillStep | TypeStep | PressStep | WaitStep | SelectOptionStep | SelectStep | OnDialogStep | SetInputFilesStep | InlineAssertStep | RunHuntStep | WaitForSelectorStep | WaitForUrlStep | WaitForNetworkIdleStep | WaitForResponseStep | HoverStep | ScrollStep | ScrollToStep | ScreenshotStep | IfStep | RepeatStep | MockRouteStep | UnmockRouteStep | EvalScriptStep | RunScriptStep | AssertScreenshotStep | AssertWithAiStep | CopyTextStep | WaitForDownloadStep;
 type Assertion = {
     selectorExists: string;
 } | {
@@ -344,6 +357,25 @@ type TraceCorrelation = {
     traceId: string;
     header: string;
 };
+/**
+ * One attempt of a retried hunt (PROWL-033). Recorded per attempt so a passed-on-retry
+ * run keeps the reason each earlier attempt failed, helping tell a flaky test apart from
+ * a slow environment or a real regression.
+ */
+type RetryAttempt = {
+    /** 1-based attempt number (attempt 1 is the initial run). */
+    attempt: number;
+    status: "pass" | "fail";
+    durationMs: number;
+    /** The first failing step on this attempt; absent when the attempt passed. */
+    failedStep?: {
+        /** 0-based index into the hunt's steps. */
+        index: number;
+        type: string;
+    };
+    /** Failure reason for this attempt; absent when it passed. */
+    error?: string;
+};
 type RunResult = {
     status: "pass" | "fail";
     exitCode: 0 | 1;
@@ -355,6 +387,17 @@ type RunResult = {
     assertions: AssertionResult[];
     artifacts: RunArtifacts;
     traceCorrelations?: TraceCorrelation[];
+    /**
+     * Per-attempt diagnostics (PROWL-033), present only when the hunt used `retry` and
+     * more than one attempt ran. Absent when no retry occurred so existing consumers and
+     * older run artifacts keep parsing. The last entry always matches the final result.
+     */
+    retryHistory?: RetryAttempt[];
+    /**
+     * Human-readable one-line retry outcome (PROWL-033), e.g. "Passed on attempt 2 of 3
+     * — first failure: navigate (timeout)". Present only alongside `retryHistory`.
+     */
+    retrySummary?: string;
 };
 type CiHuntResult = {
     hunt: string;
@@ -477,6 +520,10 @@ interface SessionDriver {
     waitForNetworkIdle(options?: {
         timeout?: number;
     }): Promise<void>;
+    /** Resolve once a network response satisfies `predicate`, or reject on timeout. */
+    waitForResponse(predicate: (response: DriverResponse) => boolean, options?: {
+        timeout?: number;
+    }): Promise<void>;
     evaluate<R = unknown, A = unknown>(pageFunction: string | ((arg: A) => R | Promise<R>), arg?: A): Promise<R>;
     screenshot(options: {
         path: string;

package/dist/lib.js

@@ -149,7 +149,7 @@ import {
   wdaTestRunArgs,
   webOnlyReason,
   zipinfoArchiveLister
-} from "./chunk-2RNOK64Y.js";
+} from "./chunk-SRWAF2RI.js";
 import {
   configSchema,
   huntSchema,
@@ -160,7 +160,7 @@ import {
   loadHuntMeta,
   loadHuntTags,
   stepSchema
-} from "./chunk-JFJQNJSJ.js";
+} from "./chunk-TTZ2IL3P.js";
 export {
   ANDROID_INTERACTIVE_CLASSES,
   ANDROID_KEYCODES,

package/dist/{loader-JTHA4BYG.js → loader-CAE4FPBK.js}

@@ -10,7 +10,7 @@ import {
   loadHuntTags,
   resolveViewport,
   warnLegacyConfigDir
-} from "./chunk-JFJQNJSJ.js";
+} from "./chunk-TTZ2IL3P.js";
 export {
   CONFIG_DIR,
   LEGACY_CONFIG_DIR,
@@ -24,4 +24,4 @@ export {
   resolveViewport,
   warnLegacyConfigDir
 };
-//# sourceMappingURL=loader-JTHA4BYG.js.map
+//# sourceMappingURL=loader-CAE4FPBK.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prowl-tools",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "E2E testing for native macOS apps and web apps from declarative YAML hunts.",
   "type": "module",
   "license": "Apache-2.0",
@@ -59,7 +59,8 @@
     "build": "tsup",
     "lint": "eslint .",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "audit:licenses": "node scripts/audit-licenses.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
@@ -83,6 +84,7 @@
     "@typescript-eslint/eslint-plugin": "^7.18.0",
     "@typescript-eslint/parser": "^7.18.0",
     "eslint": "^8.57.1",
+    "license-checker-rseidelsohn": "^4.4.2",
     "tsup": "^8.3.5",
     "typescript": "^5.7.3",
     "vitest": "^2.1.8"