agent-scenario-loop 0.1.0

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

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+declare const createArtifactLayout: any;
+type CliArgValue = string | boolean | Array<string | boolean>;
+type CliArgs = {
+    'adb-artifacts'?: string | boolean;
+    'simctl-artifacts'?: string | boolean;
+    capture?: CliArgValue;
+    config?: string | boolean;
+    scenario?: string | boolean;
+    events?: string | boolean;
+    out?: string | boolean;
+    provider?: CliArgValue;
+    'run-id'?: string | boolean;
+    signal?: CliArgValue;
+    [key: string]: CliArgValue | undefined;
+};
+type ProfileRunResult = {
+    runDir: string;
+    health: Record<string, unknown>;
+    verdict: Record<string, unknown>;
+};
+type ProfilePlatform = 'android' | 'ios';
+type ProfileMobileOptions = {
+    comparisonLane?: string;
+    defaultDriver: string;
+    interactionDriver?: string;
+    platform: ProfilePlatform;
+};
+type CaptureEvidenceKind = 'screenshot' | 'uiTree' | 'video';
+type ProviderEvidenceKind = 'accessibility' | 'logs' | 'profiler';
+type SignalEvidenceKind = 'js' | 'memory' | 'network';
+type EvidenceChannel = 'capture' | 'provider' | 'signal';
+type EvidenceKind = CaptureEvidenceKind | ProviderEvidenceKind | SignalEvidenceKind;
+type EvidenceAttachment = {
+    channel: EvidenceChannel;
+    destinationPath: string;
+    kind: EvidenceKind;
+    manifestPath: string;
+    sha256: string;
+    sourcePath: string;
+    sourceFileName: string;
+    sizeBytes: number;
+};
+type EvidenceAttachmentInput = {
+    channel: EvidenceChannel;
+    destinationPath: string;
+    kind: EvidenceKind;
+    manifestPath: string;
+    sourcePath: string;
+};
+type AttachedEvidence = {
+    attachments: EvidenceAttachment[];
+    captures: {
+        screenshots: string[];
+        uiTree: string | null;
+        video: string | null;
+    };
+    copies: EvidenceAttachment[];
+    signals: Record<SignalEvidenceKind, string[]>;
+};
+type ProviderCommandOutput = {
+    channel: EvidenceChannel;
+    kind: EvidenceKind;
+    path: string;
+};
+type ProviderCommand = {
+    args?: string[];
+    command: string;
+    cwd?: string;
+    env?: Record<string, string>;
+    id: string;
+    outputs: ProviderCommandOutput[];
+    phase: 'prepare' | 'startWindow' | 'capture' | 'stopWindow' | 'finalize';
+};
+type ProviderCommandFailure = {
+    commandId: string;
+    code?: string;
+    exitCode: number | null;
+    message?: string;
+    name?: string;
+    nextAction?: string;
+    nextActionCode?: string;
+    phase: ProviderCommand['phase'];
+    providerId: string;
+    rawPath?: string;
+};
+/**
+ * Prints CLI usage to stderr.
+ *
+ * @returns {void}
+ */
+declare function usage({ binaryName, output, platform, }: {
+    binaryName: string;
+    output?: {
+        write: (message: string) => unknown;
+    };
+    platform: ProfilePlatform;
+}): void;
+/**
+ * Parses `--key value` arguments for a mobile profile runner.
+ *
+ * @param {string[]} argv
+ * @returns {CliArgs}
+ */
+declare function parseArgs(argv: string[]): CliArgs;
+/**
+ * Returns a scalar CLI flag value, ignoring repeated values for scalar-only flags.
+ *
+ * @param {string | boolean | Array<string | boolean> | undefined} value
+ * @returns {string | boolean | undefined}
+ */
+declare function readScalarArg(value: CliArgValue | undefined): string | boolean | undefined;
+/**
+ * Converts internal attachment copy plans into manifest-safe metadata.
+ *
+ * @param {EvidenceAttachment[]} attachments
+ * @returns {Record<string, unknown>[]}
+ */
+declare function buildEvidenceAttachmentManifest(attachments: EvidenceAttachment[]): Record<string, unknown>[];
+/**
+ * Validates provider artifact files and resolves their stable run destinations.
+ *
+ * @param {{args: CliArgs, layout: ReturnType<typeof createArtifactLayout>, providerInputs?: EvidenceAttachmentInput[]}} options
+ * @returns {Promise<AttachedEvidence>}
+ */
+declare function resolveAttachedEvidence({ args, layout, providerInputs, }: {
+    args: CliArgs;
+    layout: ReturnType<typeof createArtifactLayout>;
+    providerInputs?: EvidenceAttachmentInput[];
+}): Promise<AttachedEvidence>;
+/**
+ * Builds scenario health from profile metrics.
+ *
+ * @param {{scenario: Record<string, unknown>, runId: string, metrics: Record<string, unknown>}} options
+ * @returns {Record<string, unknown>}
+ */
+declare function buildProfileHealth({ scenario, runId, metrics, }: {
+    scenario: Record<string, any>;
+    runId: string;
+    metrics: Record<string, any>;
+}): Record<string, unknown>;
+/**
+ * Builds failed scenario health from evidence-provider command failures.
+ *
+ * @param {{failures: ProviderCommandFailure[], runId: string, scenario: Record<string, unknown>}} options
+ * @returns {Record<string, unknown>}
+ */
+declare function buildProviderCommandFailureHealth({ failures, runId, scenario, }: {
+    failures: ProviderCommandFailure[];
+    runId: string;
+    scenario: Record<string, any>;
+}): Record<string, unknown>;
+/**
+ * Converts profile budget evaluation checks into verdict budget checks.
+ *
+ * @param {Record<string, unknown> | null | undefined} budgetEvaluation
+ * @returns {Record<string, unknown>[]}
+ */
+declare function buildVerdictBudgetChecks(budgetEvaluation: Record<string, any> | null | undefined): Record<string, unknown>[];
+/**
+ * Builds product verdict from profile metrics and budget evaluation.
+ *
+ * @param {{scenario: Record<string, unknown>, runId: string, health: Record<string, unknown>, metrics: Record<string, unknown>}} options
+ * @returns {Record<string, unknown>}
+ */
+declare function buildProfileVerdict({ scenario, runId, health, metrics, }: {
+    scenario: Record<string, any>;
+    runId: string;
+    health: Record<string, any>;
+    metrics: Record<string, any>;
+}): Record<string, unknown>;
+/**
+ * Resolves the configured artifact root for a platform profile run.
+ *
+ * @param {{args: CliArgs, config: Record<string, unknown>, configPath: string, platform: ProfilePlatform}} options
+ * @returns {string}
+ */
+declare function resolveArtifactRoot({ args, config, configPath, platform, }: {
+    args: CliArgs;
+    config: Record<string, any>;
+    configPath: string;
+    platform: ProfilePlatform;
+}): string;
+/**
+ * Resolves the app identifier used in profile manifests.
+ *
+ * @param {{config: Record<string, unknown>, platform: ProfilePlatform}} options
+ * @returns {string}
+ */
+declare function resolveAppId({ config, platform }: {
+    config: Record<string, any>;
+    platform: ProfilePlatform;
+}): string;
+/**
+ * Resolves the interaction driver recorded in profile artifacts.
+ *
+ * @param {{config: Record<string, unknown>, options: ProfileMobileOptions, scenario: Record<string, unknown>}} options
+ * @returns {string}
+ */
+declare function resolveInteractionDriver({ config, options, scenario, }: {
+    config: Record<string, any>;
+    options: ProfileMobileOptions;
+    scenario: Record<string, any>;
+}): string;
+/**
+ * Resolves the stable comparison lane used for historical baseline selection.
+ *
+ * @param {{args: CliArgs, options: ProfileMobileOptions, scenario: Record<string, unknown>}} options
+ * @returns {string | undefined}
+ */
+declare function resolveComparisonLane({ args, options, scenario, }: {
+    args: CliArgs;
+    options: ProfileMobileOptions;
+    scenario: Record<string, any>;
+}): string | undefined;
+/**
+ * Resolves the profile event log source from explicit logs or prior adb artifacts.
+ *
+ * @param {{args: CliArgs, platform: ProfilePlatform}} options
+ * @returns {string | null}
+ */
+declare function resolveEventLogPath({ args, platform }: {
+    args: CliArgs;
+    platform: ProfilePlatform;
+}): string | null;
+/**
+ * Creates a stable fingerprint for the scenario contract used by one run.
+ *
+ * @param {Record<string, unknown>} scenario
+ * @returns {string}
+ */
+declare function hashScenarioContract(scenario: Record<string, unknown>): string;
+/**
+ * Runs the mobile log-ingest profile artifact pipeline.
+ *
+ * @param {CliArgs} args
+ * @param {ProfileMobileOptions} options
+ * @returns {Promise<ProfileRunResult>}
+ */
+declare function runProfileMobile(args: CliArgs, options: ProfileMobileOptions): Promise<ProfileRunResult>;
+/**
+ * Runs a platform-specific profile CLI.
+ *
+ * @param {{argv: string[], binaryName: string, platform: ProfilePlatform, defaultDriver: string}} options
+ * @returns {Promise<void>}
+ */
+declare function runProfileCli({ argv, binaryName, defaultDriver, platform, }: {
+    argv: string[];
+    binaryName: string;
+    defaultDriver: string;
+    platform: ProfilePlatform;
+}): Promise<void>;
+export { buildProfileHealth, buildProviderCommandFailureHealth, buildProfileVerdict, buildVerdictBudgetChecks, parseArgs, buildEvidenceAttachmentManifest, readScalarArg, resolveAppId, resolveArtifactRoot, resolveAttachedEvidence, resolveComparisonLane, resolveEventLogPath, resolveInteractionDriver, runProfileCli, runProfileMobile, hashScenarioContract, usage, };
+export type { CliArgs, ProfileMobileOptions, ProfilePlatform, ProfileRunResult, };