@avasapp/agent-bridge 0.4.2 → 0.6.0

package/dist/client/index.d.ts

@@ -44,9 +44,29 @@ type FlowApi = {
     step: (label: string, tool: string, ...args: unknown[]) => Promise<unknown>;
     /** What each declared scenario's apply returned, by name. */
     scenarios: Record<string, unknown>;
+    expect: FlowExpect;
+};
+/** Checks that throw a readable message; each runs as a timed step. */
+type FlowExpect = {
+    /** Text, label or testID is on screen (waits up to `timeoutMs`, default 5000). */
+    text: (target: string, options?: {
+        timeoutMs?: number;
+    }) => Promise<void>;
+    /** The target is not on screen (waits for it to leave). */
+    gone: (target: string, options?: {
+        timeoutMs?: number;
+    }) => Promise<void>;
+    /** `router.current` has this pathname (waits up to `timeoutMs`, default 2000). */
+    route: (pathname: string, options?: {
+        timeoutMs?: number;
+    }) => Promise<void>;
+    /** A tool's result contains `match`: objects by the keys given, arrays and values exactly. */
+    result: (tool: string, args: unknown[], match: unknown) => Promise<void>;
 };
 /** A flow file: `export default async ({ step, call }) => {}`, plus what it needs. */
 type FlowModule = {
+    /** Shown in the run summary and matched by `--grep`; default: the file name. */
+    name?: string;
     default: (api: FlowApi) => Promise<void>;
     /** Applied before the flow and undone after it, even when it fails. */
     scenario?: FlowScenario;
@@ -60,6 +80,13 @@ type FlowResult = {
     restoreErrors: string[];
     /** "app reloaded; N pending restores lost" warnings seen during the flow. */
     notices: string[];
+    /** The app stopped answering (a timeout or closed connection), so no restore was tried. */
+    unreachable: boolean;
+};
+/** What was on screen when a flow failed. */
+type FailureState = {
+    screen?: string[];
+    route?: unknown;
 };
 type RunFlowOptions = {
     /** Where step lines go. Default: console.log. */
@@ -69,14 +96,50 @@ type RunFlowOptions = {
         name: string;
         options?: unknown;
     }>;
+    /** Leave the app as the flow left it: no closing bridge.restore (for debugging). */
+    keep?: boolean;
+    /** Called with what was on screen when the flow failed. */
+    onFailure?: (state: FailureState) => void;
+    /** Called once the flow and its restore are done, also when it failed. */
+    onFinish?: (result: FlowResult) => void;
 };
 /**
- * Runs a flow module you imported: applies its scenarios, runs it, and when
- * there were any, undoes everything with bridge.restore afterwards, even
+ * Runs a flow module you imported: applies its scenarios, runs it, and
+ * undoes everything with bridge.restore afterwards (unless `keep`), even
  * when it fails. Throws what the flow threw; otherwise returns how it went.
  * It runs only the code you hand it, in this process.
  */
 declare function runFlow(bridge: AgentBridge, flow: FlowModule, options?: RunFlowOptions): Promise<FlowResult>;
+type FlowEntry = {
+    file: string;
+    name: string;
+    module: FlowModule;
+};
+type FlowRun = {
+    file: string;
+    name: string;
+    status: 'passed' | 'failed' | 'skipped';
+    ms: number;
+    steps: number;
+    errors: number;
+    /** Why it failed: what the flow threw, restore failures, or app errors under `strict`. */
+    error?: string;
+    state?: FailureState;
+    restoreErrors: string[];
+    notices: string[];
+};
+type RunFlowsOptions = RunFlowOptions & {
+    /** Stop at the first failure; the rest are reported as skipped. */
+    bail?: boolean;
+    /** Count an error the app logged as a failure. */
+    strict?: boolean;
+    /** One flow, text output: no name header, and the failure goes to `printError`. */
+    single?: boolean;
+    /** Where a failed flow's reason goes when `single`. Default: console.error. */
+    printError?: (line: string) => void;
+};
+/** Runs flows in order on one connection, each followed by a restore (see `keep`), and never throws for a failing flow. */
+declare function runFlows(bridge: AgentBridge, entries: FlowEntry[], options?: RunFlowsOptions): Promise<FlowRun[]>;
 
 /** What a running session writes next to its socket. Readable only by the user. */
 type SessionState = {
@@ -126,7 +189,7 @@ type ConnectOptions = {
     device?: string;
     /** "auto" tries Expo's socket first and falls back to CDP. */
     transport?: 'auto' | TransportName;
-    /** Per-call timeout. Default 10 s. */
+    /** Per-call timeout. Default 10 s; stretched when a call's own `timeoutMs` argument is longer. */
     timeoutMs?: number;
 };
 declare class AgentBridgeCallError extends Error {
@@ -170,4 +233,4 @@ type ListedDevice = {
 /** Apps with the bridge on Expo's socket, plus every React Native page Metro knows. */
 declare function listDevices(options?: Pick<ConnectOptions, 'metro'>): Promise<ListedDevice[]>;
 
-export { type AgentBridge, AgentBridgeCallError, type ConnectOptions, type DeviceInfo, type FlowApi, type FlowModule, type FlowResult, type FlowScenario, type ListedDevice, type LogEntry, type RunFlowOptions, type SessionConnectOptions, type SessionState, type Timed, type ToolInfo, type TransportName, connect, connectSession, listDevices, listSessions, runFlow };
+export { type AgentBridge, AgentBridgeCallError, type ConnectOptions, type DeviceInfo, type FlowApi, type FlowExpect, type FlowModule, type FlowResult, type FlowRun, type FlowScenario, type ListedDevice, type LogEntry, type RunFlowOptions, type SessionConnectOptions, type SessionState, type Timed, type ToolInfo, type TransportName, connect, connectSession, listDevices, listSessions, runFlow, runFlows };

package/dist/client/index.js

@@ -4,13 +4,15 @@ import {
   connectSession,
   listDevices,
   listSessions,
-  runFlow
-} from "../chunk-TA2OLPPT.js";
+  runFlow,
+  runFlows
+} from "../chunk-Y6QFU5ON.js";
 export {
   AgentBridgeCallError,
   connect,
   connectSession,
   listDevices,
   listSessions,
-  runFlow
+  runFlow,
+  runFlows
 };

package/dist/expo/index.d.cts

@@ -1,4 +1,4 @@
-import { a as Transport } from '../types-BmpykP1P.cjs';
+import { a as Transport } from '../types-qlwdcGjt.cjs';
 
 /**
  * Plain JSON over Expo's dev-tools plugin socket: no string evaluation, emoji