agent-scenario-loop 0.1.0

package/dist/runner/ios-simctl.d.ts

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+type CliArgs = {
+    bundle?: string | boolean;
+    'collect-profile-storage'?: string | boolean;
+    device?: string | boolean;
+    'diagnostic-reports-dir'?: string | boolean;
+    launch?: string | boolean;
+    'log-last'?: string | boolean;
+    'profile-command-storage-key'?: string | boolean;
+    'profile-event-storage-key'?: string | boolean;
+    out?: string | boolean;
+    'profile-session-entries-storage-key'?: string | boolean;
+    'profile-session-storage'?: string | boolean;
+    'profile-session-storage-key'?: string | boolean;
+    'profile-signal-storage-key'?: string | boolean;
+    'run-id'?: string | boolean;
+    screenshot?: string | boolean;
+    'screenshot-display'?: string | boolean;
+    'screenshot-mask'?: string | boolean;
+    'screenshot-type'?: string | boolean;
+    'terminate-before-launch'?: string | boolean;
+    'wait-ms'?: string | boolean;
+    xcrun?: string | boolean;
+    [key: string]: string | boolean | undefined;
+};
+type CommandResult = {
+    command: string;
+    args: string[];
+    exitCode: number;
+    stderr: string;
+    stdout: string;
+};
+type CommandExecutor = (command: string, args: string[]) => Promise<CommandResult>;
+type IosSimulator = {
+    name: string;
+    state: string;
+    udid: string;
+};
+type IosSimctlDeepLink = {
+    label?: string;
+    url: string;
+    waitMs?: number;
+};
+type IosProfileSessionStorageCommand = {
+    command: string;
+    id?: string;
+    label?: string;
+    timestamp?: number;
+};
+type IosProfileSessionStorageSeed = {
+    commands?: IosProfileSessionStorageCommand[];
+    scenario: string;
+    runId: string;
+    startedAt?: number;
+};
+type ProfileStorageKeys = {
+    command: string;
+    event: string;
+    session: string;
+    sessionEntries: string;
+    signal: string;
+};
+type IosSimctlCaptureOptions = {
+    bundleId?: string | null;
+    collectProfileStorage?: boolean;
+    conflictingBundleIds?: string[];
+    deepLinks?: IosSimctlDeepLink[];
+    delay?: (ms: number) => Promise<void>;
+    device?: string | null;
+    diagnosticReportsDir?: string | null;
+    executor?: CommandExecutor;
+    launch?: boolean;
+    logLast?: string;
+    outputDir?: string;
+    profileSessionStorage?: IosProfileSessionStorageSeed | null;
+    profileStorageKeys?: Partial<ProfileStorageKeys>;
+    runId?: string;
+    screenshot?: boolean;
+    screenshotDisplay?: string;
+    screenshotMask?: string;
+    screenshotType?: string;
+    terminateBeforeLaunch?: boolean;
+    waitMs?: number;
+    xcrunPath?: string;
+};
+type IosSimctlCaptureResult = {
+    agentSummary: string;
+    health: Record<string, unknown>;
+    captures: {
+        screenshot: string | null;
+    };
+    metadata: Record<string, unknown>;
+    raw: Record<string, string>;
+    runDir: string;
+    simulator: IosSimulator | null;
+    verdict: Record<string, unknown>;
+};
+/**
+ * Prints CLI usage to stderr.
+ *
+ * @returns {void}
+ */
+declare function usage(output?: {
+    write: (message: string) => unknown;
+}): void;
+/**
+ * Parses `--key value` arguments for the iOS simctl capture CLI.
+ *
+ * @param {string[]} argv
+ * @returns {CliArgs}
+ */
+declare function parseArgs(argv: string[]): CliArgs;
+/**
+ * Parses a positive integer CLI value, falling back when absent or invalid.
+ *
+ * @param {string | boolean | undefined} value
+ * @param {number} fallback
+ * @returns {number}
+ */
+declare function parsePositiveInteger(value: string | boolean | undefined, fallback: number): number;
+/**
+ * Normalizes configured sibling bundle ids, excluding the selected target bundle.
+ *
+ * @param {{bundleId: string | null, conflictingBundleIds: string[]}} options
+ * @returns {string[]}
+ */
+declare function normalizeConflictingBundleIds({ bundleId, conflictingBundleIds, }: {
+    bundleId: string | null;
+    conflictingBundleIds: string[];
+}): string[];
+/**
+ * Resolves React Native AsyncStorage's iOS storage directory for an app data container.
+ *
+ * @param {{dataContainer: string, bundleId: string}} options
+ * @returns {string}
+ */
+declare function resolveAsyncStorageDirectory({ bundleId, dataContainer, }: {
+    bundleId: string;
+    dataContainer: string;
+}): string;
+/**
+ * Returns the native iOS AsyncStorage spill-file name for a key.
+ *
+ * @param {string} key
+ * @returns {string}
+ */
+declare function asyncStorageFileNameForKey(key: string): string;
+/**
+ * Reads one native iOS AsyncStorage value from an inline manifest or spill file.
+ *
+ * @param {{key: string, storageDir: string}} options
+ * @returns {string | null}
+ */
+declare function readAsyncStorageValueSync({ key, storageDir, }: {
+    key: string;
+    storageDir: string;
+}): string | null;
+/**
+ * Seeds the app profile-session AsyncStorage key before launching the iOS app.
+ *
+ * @param {{bundleId: string, commands?: IosProfileSessionStorageCommand[], dataContainer: string, runId: string, scenario: string, startedAt?: number}} options
+ * @returns {Promise<{manifestPath: string, storageDir: string, session: Record<string, unknown>}>}
+ */
+declare function seedProfileSessionStorage({ bundleId, commands, dataContainer, profileStorageKeys, runId, scenario, startedAt, }: {
+    bundleId: string;
+    commands?: IosProfileSessionStorageCommand[];
+    dataContainer: string;
+    profileStorageKeys?: ProfileStorageKeys;
+    runId: string;
+    scenario: string;
+    startedAt?: number;
+}): Promise<{
+    commands: Record<string, unknown>[];
+    manifestPath: string;
+    storageDir: string;
+    session: Record<string, unknown>;
+}>;
+/**
+ * Reads JSON stored by the app profile-session AsyncStorage bridge.
+ *
+ * @param {{bundleId: string, dataContainer: string, key: string, fallback: unknown}} options
+ * @returns {unknown}
+ */
+declare function readProfileStorageJson({ bundleId, dataContainer, fallback, key, }: {
+    bundleId: string;
+    dataContainer: string;
+    fallback: unknown;
+    key: string;
+}): unknown;
+/**
+ * Formats stored profile events as the canonical profile-event log payload.
+ *
+ * @param {Record<string, unknown>[]} events
+ * @returns {string}
+ */
+declare function formatStoredProfileEventLog(events: Record<string, unknown>[]): string;
+/**
+ * Runs a command and captures stdout, stderr, and exit code without throwing.
+ *
+ * @param {string} command
+ * @param {string[]} args
+ * @returns {Promise<CommandResult>}
+ */
+declare function execFileCommand(command: string, args: string[]): Promise<CommandResult>;
+/**
+ * Parses `xcrun simctl list devices` output into simulator rows.
+ *
+ * @param {string} output
+ * @returns {IosSimulator[]}
+ */
+declare function parseSimctlDevices(output: string): IosSimulator[];
+/**
+ * Selects a simulator by explicit UDID or the first booted simulator.
+ *
+ * @param {IosSimulator[]} simulators
+ * @param {string | null | undefined} device
+ * @returns {IosSimulator | null}
+ */
+declare function selectSimulator(simulators: IosSimulator[], device?: string | null): IosSimulator | null;
+/**
+ * Builds a health artifact from iOS simulator capture checks.
+ *
+ * @param {{runId: string, checks: Record<string, unknown>[]}} options
+ * @returns {Record<string, unknown>}
+ */
+declare function buildIosSimctlHealth({ runId, checks }: {
+    runId: string;
+    checks: Record<string, unknown>[];
+}): Record<string, unknown>;
+/**
+ * Builds a verdict artifact for iOS simulator capture readiness.
+ *
+ * @param {{runId: string, health: Record<string, unknown>}} options
+ * @returns {Record<string, unknown>}
+ */
+declare function buildIosSimctlVerdict({ runId, health }: {
+    runId: string;
+    health: Record<string, unknown>;
+}): Record<string, unknown>;
+/**
+ * Runs iOS simulator readiness checks and writes raw simctl evidence.
+ *
+ * @param {IosSimctlCaptureOptions} options
+ * @returns {Promise<IosSimctlCaptureResult>}
+ */
+declare function runIosSimctlCapture({ bundleId, collectProfileStorage, conflictingBundleIds, deepLinks, delay: wait, device, diagnosticReportsDir, executor, launch, logLast, outputDir, profileSessionStorage, profileStorageKeys: profileStorageKeyOverrides, runId, screenshot, screenshotDisplay, screenshotMask, screenshotType, terminateBeforeLaunch, waitMs, xcrunPath, }?: IosSimctlCaptureOptions): Promise<IosSimctlCaptureResult>;
+/**
+ * Runs the ios-simctl capture CLI.
+ *
+ * @returns {Promise<void>}
+ */
+declare function main(): Promise<void>;
+export { buildIosSimctlHealth, buildIosSimctlVerdict, asyncStorageFileNameForKey, execFileCommand, formatStoredProfileEventLog, main, parseArgs, parsePositiveInteger, parseSimctlDevices, normalizeConflictingBundleIds, readAsyncStorageValueSync, readProfileStorageJson, resolveAsyncStorageDirectory, runIosSimctlCapture, seedProfileSessionStorage, selectSimulator, usage, };
+export type { CliArgs, CommandExecutor, CommandResult, IosSimctlCaptureOptions, IosSimctlCaptureResult, IosSimctlDeepLink, IosProfileSessionStorageSeed, IosSimulator, };