agent-scenario-loop 0.1.2 → 0.1.4

package/dist/runner/android-adb-driver.d.ts

@@ -7,6 +7,7 @@ type AndroidAdbCommandResult = {
     rawFileName: string;
     stderr: string;
     stdout: string;
+    stdoutBuffer?: Uint8Array;
 };
 type AndroidAdbDriver = {
     assertVisible: (options: AndroidAdbAssertVisibleOptions) => Promise<AndroidAdbCommandResult>;
@@ -31,12 +32,15 @@ type AndroidAdbDriverOptions = {
     deviceSerial: string;
     executor: AndroidAdbCommandExecutor;
 };
-type AndroidAdbCommandExecutor = (command: string, args: string[]) => Promise<{
+type AndroidAdbCommandExecutor = (command: string, args: string[], options?: {
+    encoding?: 'buffer' | 'utf8';
+}) => Promise<{
     args: string[];
     command: string;
     exitCode: number;
     stderr: string;
     stdout: string;
+    stdoutBuffer?: Uint8Array;
 }>;
 type AndroidAdbDeepLinkOptions = {
     packageName?: string | null;
@@ -110,7 +114,8 @@ declare function quoteAndroidShellArg(value: string): string;
 declare function formatAndroidAdbRawOutput(result: {
     stdout: string;
     stderr: string;
-}): string;
+    stdoutBuffer?: Uint8Array;
+}): string | Uint8Array;
 /**
  * Joins command output from a multi-command adb driver action.
  *

package/dist/runner/android-adb-driver.js

@@ -57,6 +57,7 @@ function buildDriverResult({ action, rawFileName, result, }) {
         rawFileName,
         stderr: result.stderr,
         stdout: result.stdout,
+        ...(result.stdoutBuffer ? { stdoutBuffer: result.stdoutBuffer } : {}),
     };
 }
 /**
@@ -66,6 +67,9 @@ function buildDriverResult({ action, rawFileName, result, }) {
  * @returns {string}
  */
 function formatAndroidAdbRawOutput(result) {
+    if (result.stdoutBuffer && !result.stderr) {
+        return result.stdoutBuffer;
+    }
     return [result.stdout, result.stderr].filter(Boolean).join('\n');
 }
 /**
@@ -373,7 +377,9 @@ function createAndroidAdbDriver({ adbPath, deviceSerial, executor, }) {
             };
         },
         async screenshot({ rawFileName = 'adb-screenshot.png', } = {}) {
-            const result = await executor(adbPath, ['-s', deviceSerial, 'exec-out', 'screencap', '-p']);
+            const result = await executor(adbPath, ['-s', deviceSerial, 'exec-out', 'screencap', '-p'], {
+                encoding: 'buffer',
+            });
             return buildDriverResult({ action: 'screenshot', rawFileName, result });
         },
         async scroll({ durationMs = 300, endX, endY, rawFileName = 'adb-scroll.txt', startX, startY, }) {

package/dist/runner/android-adb.d.ts

@@ -3,6 +3,7 @@ type CliArgs = {
     adb?: string | boolean;
     'capture-logcat'?: string | boolean;
     'clear-logcat'?: string | boolean;
+    'command-timeout-ms'?: string | boolean;
     launch?: string | boolean;
     'android-dev-client-url'?: string | boolean;
     'android-dev-client-wait-ms'?: string | boolean;
@@ -28,8 +29,12 @@ type CommandResult = {
     exitCode: number;
     stderr: string;
     stdout: string;
+    stdoutBuffer?: Uint8Array;
 };
-type CommandExecutor = (command: string, args: string[]) => Promise<CommandResult>;
+type CommandExecutorOptions = {
+    encoding?: 'buffer' | 'utf8';
+};
+type CommandExecutor = (command: string, args: string[], options?: CommandExecutorOptions) => Promise<CommandResult>;
 type AndroidDevice = {
     serial: string;
     state: string;
@@ -40,7 +45,7 @@ type AndroidPreflightResult = {
     device: AndroidDevice | null;
     health: Record<string, unknown>;
     metadata: Record<string, unknown>;
-    raw: Record<string, string>;
+    raw: Record<string, string | Uint8Array>;
     runDir: string;
     verdict: Record<string, unknown>;
 };
@@ -81,7 +86,9 @@ type AndroidAdbDriverStep = {
 type AndroidPreflightOptions = {
     adbPath?: string;
     captureLogcat?: boolean;
+    captureWatchdogMs?: number;
     clearLogcat?: boolean;
+    commandTimeoutMs?: number;
     deepLinks?: AndroidDeepLinkCommand[];
     delay?: (ms: number) => Promise<void>;
     driverSteps?: AndroidAdbDriverStep[];
@@ -129,7 +136,16 @@ declare function parsePositiveInteger(value: string | boolean | undefined, fallb
  * @param {string[]} args
  * @returns {Promise<CommandResult>}
  */
-declare function execFileCommand(command: string, args: string[]): Promise<CommandResult>;
+declare function execFileCommand(command: string, args: string[], options?: CommandExecutorOptions): Promise<CommandResult>;
+/**
+ * Runs a command with a bounded timeout and captures stdout, stderr, and exit code without throwing.
+ *
+ * @param {string} command
+ * @param {string[]} args
+ * @param {number} timeoutMs
+ * @returns {Promise<CommandResult>}
+ */
+declare function execFileCommandWithTimeout(command: string, args: string[], timeoutMs?: number, options?: CommandExecutorOptions): Promise<CommandResult>;
 /**
  * Parses `adb devices -l` output into device rows.
  *
@@ -189,6 +205,25 @@ declare function buildAndroidVerdict({ runId, health }: {
     runId: string;
     health: Record<string, unknown>;
 }): Record<string, unknown>;
+type AndroidAdbCaptureWatchdogBudget = {
+    ceilingMs: number;
+    commandBudgetMs: number;
+    commandUnits: number;
+    declaredWaitMs: number;
+    floorMs: number;
+    perCommandOverheadMs: number;
+    source: 'derived' | 'override';
+    timeoutMs: number;
+};
+/**
+ * Derives a whole-capture adb watchdog from declared runner waits and command bounds.
+ *
+ * @param {AndroidPreflightOptions & {commandTimeoutMs: number}} options
+ * @returns {AndroidAdbCaptureWatchdogBudget}
+ */
+declare function deriveAndroidAdbCaptureWatchdogBudget({ captureLogcat, captureWatchdogMs, clearLogcat, commandTimeoutMs, deepLinks, driverSteps, launch, launchWaitMs, packageName, reactNativeDebugHost, startupDeepLinks, storageWrites, waitMs, }: AndroidPreflightOptions & {
+    commandTimeoutMs: number;
+}): AndroidAdbCaptureWatchdogBudget;
 /**
  * Builds the driver steps for this adb capture window.
  *
@@ -243,12 +278,12 @@ declare function runAndroidAdbDriverStep({ capturesDir, driver, driverStep, logc
  * @param {AndroidPreflightOptions} options
  * @returns {Promise<AndroidPreflightResult>}
  */
-declare function runAndroidAdbPreflight({ adbPath, captureLogcat, clearLogcat, deepLinks, delay: wait, driverSteps, executor, launch, launchWaitMs, logcatLines, outputDir, packageName, reactNativeDebugHost, runId, serial, startupDeepLinks, storageWrites, waitMs, }?: AndroidPreflightOptions): Promise<AndroidPreflightResult>;
+declare function runAndroidAdbPreflight({ adbPath, captureLogcat, captureWatchdogMs: captureWatchdogMsOverride, clearLogcat, commandTimeoutMs, deepLinks, delay: wait, driverSteps, executor, launch, launchWaitMs, logcatLines, outputDir, packageName, reactNativeDebugHost, runId, serial, startupDeepLinks, storageWrites, waitMs, }?: AndroidPreflightOptions): Promise<AndroidPreflightResult>;
 /**
  * Runs the android-adb preflight CLI.
  *
  * @returns {Promise<void>}
  */
 declare function main(): Promise<void>;
-export { ANDROID_DEVICE_EPOCH_MS_PLACEHOLDER, buildAndroidHealth, buildAndroidVerdict, buildReactNativeDebugHostPreferenceCommand, escapeAndroidPreferenceXml, execFileCommand, main, parseAdbDevices, parseArgs, parsePositiveInteger, parseReactNativeDebugHostPort, resolveAndroidAdbDriverSteps, applyAndroidSelectorResolution, buildAndroidSelectorHealthMetadata, needsAndroidSelectorResolution, runAndroidAdbDriverStep, runAndroidAdbPreflight, selectDevice, usage, };
+export { ANDROID_DEVICE_EPOCH_MS_PLACEHOLDER, buildAndroidHealth, buildAndroidVerdict, buildReactNativeDebugHostPreferenceCommand, deriveAndroidAdbCaptureWatchdogBudget, escapeAndroidPreferenceXml, execFileCommand, execFileCommandWithTimeout, main, parseAdbDevices, parseArgs, parsePositiveInteger, parseReactNativeDebugHostPort, resolveAndroidAdbDriverSteps, applyAndroidSelectorResolution, buildAndroidSelectorHealthMetadata, needsAndroidSelectorResolution, runAndroidAdbDriverStep, runAndroidAdbPreflight, selectDevice, usage, };
 export type { AndroidDevice, AndroidAdbDriverStep, AndroidAsyncStorageWrite, AndroidDeepLinkCommand, AndroidPreflightOptions, AndroidPreflightResult, CliArgs, CommandExecutor, CommandResult, };