agent-scenario-loop 0.1.0

package/dist/runner/local-env.d.ts

@@ -0,0 +1,64 @@
+type LocalEnvLoadOptions = {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    fileName?: string;
+    override?: boolean;
+};
+type LoadedLocalEnvFile = {
+    filePath: string;
+    keys: string[];
+};
+declare const LOCAL_ENV_FILE_NAME = ".asl.local.env";
+/**
+ * Finds the nearest ASL local env file from a working directory upward.
+ *
+ * @param {string} cwd
+ * @param {string} fileName
+ * @returns {string | null}
+ */
+declare function findNearestLocalEnvFile(cwd?: string, fileName?: string): string | null;
+/**
+ * Parses one simple KEY=value line from an ASL local env file.
+ *
+ * @param {string} line
+ * @returns {{key: string, value: string} | null}
+ */
+declare function parseLocalEnvLine(line: string): {
+    key: string;
+    value: string;
+} | null;
+/**
+ * Loads `.asl.local.env` into the provided environment without overriding explicit values.
+ *
+ * @param {LocalEnvLoadOptions} options
+ * @returns {LoadedLocalEnvFile | null}
+ */
+declare function loadAslLocalEnv({ cwd, env, fileName, override, }?: LocalEnvLoadOptions): LoadedLocalEnvFile | null;
+/**
+ * Reads the first non-empty environment value for a list of supported names.
+ *
+ * @param {string[]} names
+ * @param {NodeJS.ProcessEnv} env
+ * @returns {string | undefined}
+ */
+declare function readEnvValue(names: string[], env?: NodeJS.ProcessEnv): string | undefined;
+/**
+ * Reads a CLI value first, then falls back to environment names.
+ *
+ * @param {unknown} value
+ * @param {string[]} envNames
+ * @param {NodeJS.ProcessEnv} env
+ * @returns {string | undefined}
+ */
+declare function readStringArgOrEnv(value: unknown, envNames: string[], env?: NodeJS.ProcessEnv): string | undefined;
+/**
+ * Returns true when a CLI flag or environment value enables an option.
+ *
+ * @param {unknown} value
+ * @param {string[]} envNames
+ * @param {NodeJS.ProcessEnv} env
+ * @returns {boolean}
+ */
+declare function readBooleanArgOrEnv(value: unknown, envNames: string[], env?: NodeJS.ProcessEnv): boolean;
+export { LOCAL_ENV_FILE_NAME, findNearestLocalEnvFile, loadAslLocalEnv, parseLocalEnvLine, readBooleanArgOrEnv, readEnvValue, readStringArgOrEnv, };
+export type { LoadedLocalEnvFile, LocalEnvLoadOptions, };

package/dist/runner/local-env.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOCAL_ENV_FILE_NAME = void 0;
+exports.findNearestLocalEnvFile = findNearestLocalEnvFile;
+exports.loadAslLocalEnv = loadAslLocalEnv;
+exports.parseLocalEnvLine = parseLocalEnvLine;
+exports.readBooleanArgOrEnv = readBooleanArgOrEnv;
+exports.readEnvValue = readEnvValue;
+exports.readStringArgOrEnv = readStringArgOrEnv;
+const fs = require('node:fs');
+const path = require('node:path');
+const LOCAL_ENV_FILE_NAME = '.asl.local.env';
+exports.LOCAL_ENV_FILE_NAME = LOCAL_ENV_FILE_NAME;
+const ENV_KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/u;
+/**
+ * Finds the nearest ASL local env file from a working directory upward.
+ *
+ * @param {string} cwd
+ * @param {string} fileName
+ * @returns {string | null}
+ */
+function findNearestLocalEnvFile(cwd = process.cwd(), fileName = LOCAL_ENV_FILE_NAME) {
+    let current = path.resolve(cwd);
+    while (true) {
+        const candidate = path.join(current, fileName);
+        try {
+            if (fs.statSync(candidate).isFile()) {
+                return candidate;
+            }
+        }
+        catch {
+            // Missing local env files are expected on CI and fresh installs.
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+/**
+ * Removes matching single or double quotes from an env file value.
+ *
+ * @param {string} value
+ * @returns {string}
+ */
+function unquoteEnvValue(value) {
+    const trimmed = value.trim();
+    if (trimmed.length >= 2) {
+        const first = trimmed[0];
+        const last = trimmed[trimmed.length - 1];
+        if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+            return trimmed.slice(1, -1);
+        }
+    }
+    return trimmed;
+}
+/**
+ * Parses one simple KEY=value line from an ASL local env file.
+ *
+ * @param {string} line
+ * @returns {{key: string, value: string} | null}
+ */
+function parseLocalEnvLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) {
+        return null;
+    }
+    const exportPrefix = 'export ';
+    const assignment = trimmed.startsWith(exportPrefix)
+        ? trimmed.slice(exportPrefix.length).trim()
+        : trimmed;
+    const equalsIndex = assignment.indexOf('=');
+    if (equalsIndex <= 0) {
+        return null;
+    }
+    const key = assignment.slice(0, equalsIndex).trim();
+    if (!ENV_KEY_PATTERN.test(key)) {
+        return null;
+    }
+    return {
+        key,
+        value: unquoteEnvValue(assignment.slice(equalsIndex + 1)),
+    };
+}
+/**
+ * Loads `.asl.local.env` into the provided environment without overriding explicit values.
+ *
+ * @param {LocalEnvLoadOptions} options
+ * @returns {LoadedLocalEnvFile | null}
+ */
+function loadAslLocalEnv({ cwd = process.cwd(), env = process.env, fileName = LOCAL_ENV_FILE_NAME, override = false, } = {}) {
+    const filePath = findNearestLocalEnvFile(cwd, fileName);
+    if (!filePath) {
+        return null;
+    }
+    const keys = [];
+    const content = fs.readFileSync(filePath, 'utf8');
+    for (const line of content.split(/\r?\n/u)) {
+        const parsed = parseLocalEnvLine(line);
+        if (!parsed) {
+            continue;
+        }
+        if (!override && Object.prototype.hasOwnProperty.call(env, parsed.key)) {
+            continue;
+        }
+        env[parsed.key] = parsed.value;
+        keys.push(parsed.key);
+    }
+    return { filePath, keys };
+}
+/**
+ * Reads the first non-empty environment value for a list of supported names.
+ *
+ * @param {string[]} names
+ * @param {NodeJS.ProcessEnv} env
+ * @returns {string | undefined}
+ */
+function readEnvValue(names, env = process.env) {
+    for (const name of names) {
+        const value = env[name];
+        if (typeof value === 'string' && value.length > 0) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/**
+ * Reads a CLI value first, then falls back to environment names.
+ *
+ * @param {unknown} value
+ * @param {string[]} envNames
+ * @param {NodeJS.ProcessEnv} env
+ * @returns {string | undefined}
+ */
+function readStringArgOrEnv(value, envNames, env = process.env) {
+    return typeof value === 'string' && value.length > 0
+        ? value
+        : readEnvValue(envNames, env);
+}
+/**
+ * Returns true when a CLI flag or environment value enables an option.
+ *
+ * @param {unknown} value
+ * @param {string[]} envNames
+ * @param {NodeJS.ProcessEnv} env
+ * @returns {boolean}
+ */
+function readBooleanArgOrEnv(value, envNames, env = process.env) {
+    if (value === true || value === 'true' || value === '1') {
+        return true;
+    }
+    const envValue = readEnvValue(envNames, env);
+    return envValue === '1' || envValue === 'true' || envValue === 'yes';
+}

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

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+declare const parseArgs: any, usage: any;
+type AndroidProfileOptions = {
+    agentDeviceExecutor?: import('./agent-device').CommandExecutor;
+    comparisonLane?: string;
+    delay?: (ms: number) => Promise<void>;
+    executor?: import('./android-adb').CommandExecutor;
+};
+type AndroidAdbProfileCommand = {
+    command: string;
+    label?: string;
+    waitMs?: number;
+};
+type AndroidAdbDriverStep = import('./android-adb').AndroidAdbDriverStep;
+/**
+ * Derives a logcat-backed profile capture window from scenario waits and cycles.
+ *
+ * @param {Record<string, unknown>} scenario
+ * @returns {number}
+ */
+declare function deriveProfileSessionCaptureWaitMs(scenario: Record<string, any>): number;
+/**
+ * Resolves the Android adb capture wait, keeping explicit CLI waits authoritative.
+ *
+ * @param {{args: import('./profile-mobile').CliArgs, scenario: Record<string, unknown>, profileSessionEnabled: boolean}} options
+ * @returns {number}
+ */
+declare function resolveProfileSessionCaptureWaitMs({ args, profileSessionEnabled, scenario, }: {
+    args: import('./profile-mobile').CliArgs;
+    profileSessionEnabled: boolean;
+    scenario: Record<string, any>;
+}): number;
+/**
+ * Expands normalized scenario evidence steps into Android adb driver actions.
+ *
+ * @param {Record<string, unknown>} scenario
+ * @returns {import('./android-adb').AndroidAdbDriverStep[]}
+ */
+declare function resolveAndroidAdbDriverSteps(scenario: Record<string, any>): AndroidAdbDriverStep[];
+/**
+ * Reads the first video capture produced by adb driver actions.
+ *
+ * @param {Record<string, unknown>} metadata
+ * @returns {string | null}
+ */
+declare function readAndroidAdbVideoCapturePath(metadata: Record<string, unknown>): string | null;
+/**
+ * Returns profile-time validation errors for adb driver steps.
+ *
+ * @param {import('./android-adb').AndroidAdbDriverStep[]} driverSteps
+ * @returns {string[]}
+ */
+declare function validateAndroidAdbDriverSteps(driverSteps: AndroidAdbDriverStep[]): string[];
+/**
+ * Expands scenario-declared Android commands for an adb capture profile session.
+ *
+ * @param {Record<string, unknown>} scenario
+ * @returns {AndroidAdbProfileCommand[]}
+ */
+declare function resolveAndroidAdbProfileCommands(scenario: Record<string, any>): AndroidAdbProfileCommand[];
+/**
+ * Summarizes failed adb capture checks for CLI errors.
+ *
+ * @param {Record<string, unknown>} health
+ * @returns {string}
+ */
+declare function summarizeFailedAndroidChecks(health: Record<string, unknown>): string;
+/**
+ * Runs the Android profile artifact pipeline.
+ *
+ * @param {import('./profile-mobile').CliArgs} args
+ * @param {AndroidProfileOptions} [options]
+ * @returns {Promise<import('./profile-mobile').ProfileRunResult>}
+ */
+declare function runProfileAndroid(args: import('./profile-mobile').CliArgs, options?: AndroidProfileOptions): Promise<import('./profile-mobile').ProfileRunResult>;
+/**
+ * Runs the profile-android CLI.
+ *
+ * @returns {Promise<void>}
+ */
+declare function main(): Promise<void>;
+export { deriveProfileSessionCaptureWaitMs, main, parseArgs, resolveAndroidAdbProfileCommands, resolveAndroidAdbDriverSteps, resolveProfileSessionCaptureWaitMs, readAndroidAdbVideoCapturePath, validateAndroidAdbDriverSteps, runProfileAndroid, summarizeFailedAndroidChecks, usage, };