agent-device 0.8.2 → 0.8.4

package/dist/src/daemon/handlers/session-open.d.ts

@@ -0,0 +1,22 @@
+import { dispatchCommand, resolveTargetDevice } from '../../core/dispatch.ts';
+import { ensureDeviceReady } from '../device-ready.ts';
+import { stopIosRunnerSession } from '../../platforms/ios/runner-client.ts';
+import { applyRuntimeHintsToApp, clearRuntimeHintsFromApp } from '../runtime-hints.ts';
+import type { DeviceInfo } from '../../utils/device.ts';
+import type { DaemonRequest, DaemonResponse } from '../types.ts';
+import { SessionStore } from '../session-store.ts';
+import { settleIosSimulator } from './session-device-utils.ts';
+export declare function handleOpenCommand(params: {
+    req: DaemonRequest;
+    sessionName: string;
+    logPath: string;
+    sessionStore: SessionStore;
+    dispatch: typeof dispatchCommand;
+    ensureReady: typeof ensureDeviceReady;
+    resolveDevice: typeof resolveTargetDevice;
+    applyRuntimeHints?: typeof applyRuntimeHintsToApp;
+    clearRuntimeHints?: typeof clearRuntimeHintsFromApp;
+    stopIosRunner?: typeof stopIosRunnerSession;
+    settleSimulator?: typeof settleIosSimulator;
+    resolveAndroidPackageForOpen?: (device: DeviceInfo, openTarget: string | undefined) => Promise<string | undefined>;
+}): Promise<DaemonResponse>;

package/dist/src/daemon/handlers/session-perf.d.ts

@@ -0,0 +1,2 @@
+import type { SessionState } from '../types.ts';
+export declare function buildPerfResponseData(session: SessionState): Record<string, unknown>;

package/dist/src/daemon/handlers/session-runtime-command.d.ts

@@ -0,0 +1,9 @@
+import type { DaemonRequest, DaemonResponse } from '../types.ts';
+import { SessionStore } from '../session-store.ts';
+import { clearRuntimeHintsFromApp } from '../runtime-hints.ts';
+export declare function handleRuntimeCommand(params: {
+    req: DaemonRequest;
+    sessionName: string;
+    sessionStore: SessionStore;
+    clearRuntimeHints?: typeof clearRuntimeHintsFromApp;
+}): Promise<DaemonResponse>;

package/dist/src/daemon/handlers/session-runtime.d.ts

@@ -0,0 +1,41 @@
+import type { DeviceInfo } from '../../utils/device.ts';
+import type { CommandFlags } from '../../core/dispatch.ts';
+import type { DaemonRequest, DaemonResponse, SessionRuntimeHints, SessionState } from '../types.ts';
+import { SessionStore } from '../session-store.ts';
+import { type clearRuntimeHintsFromApp } from '../runtime-hints.ts';
+export declare function countConfiguredRuntimeHints(runtime: SessionRuntimeHints | undefined): number;
+export declare function buildRuntimeHints(flags: CommandFlags | undefined, platform?: 'ios' | 'android'): SessionRuntimeHints;
+export declare function mergeRuntimeHints(current: SessionRuntimeHints | undefined, next: SessionRuntimeHints): SessionRuntimeHints;
+export declare function setSessionRuntimeHintsForOpen(sessionStore: SessionStore, sessionName: string, runtime: SessionRuntimeHints | undefined): SessionRuntimeHints | undefined;
+declare function resolveOpenRuntimeHints(params: {
+    req: DaemonRequest;
+    sessionStore: SessionStore;
+    sessionName: string;
+    device: DeviceInfo;
+}): {
+    runtime: SessionRuntimeHints | undefined;
+    previousRuntime: SessionRuntimeHints | undefined;
+    replacedStoredRuntime: boolean;
+};
+export declare function tryResolveOpenRuntimeHints(params: Parameters<typeof resolveOpenRuntimeHints>[0]): {
+    ok: true;
+    data: ReturnType<typeof resolveOpenRuntimeHints>;
+} | {
+    ok: false;
+    response: DaemonResponse;
+};
+export declare function recordOpenRuntimeAction(params: {
+    req: DaemonRequest;
+    sessionStore: SessionStore;
+    session: SessionState;
+    sessionName: string;
+    runtime: SessionRuntimeHints | undefined;
+}): void;
+export declare function maybeClearRemovedRuntimeTransportHints(params: {
+    replacedStoredRuntime: boolean;
+    previousRuntime: SessionRuntimeHints | undefined;
+    runtime: SessionRuntimeHints | undefined;
+    session: SessionState | undefined;
+    clearRuntimeHints: typeof clearRuntimeHintsFromApp;
+}): Promise<void>;
+export {};

package/dist/src/daemon/handlers/session-startup-metrics.d.ts

@@ -0,0 +1,11 @@
+export declare const STARTUP_SAMPLE_METHOD = "open-command-roundtrip";
+export declare const STARTUP_SAMPLE_DESCRIPTION = "Elapsed wall-clock time around dispatching the open command for the active session app target.";
+export declare const PERF_STARTUP_SAMPLE_LIMIT = 20;
+export declare const PERF_UNAVAILABLE_REASON = "Not implemented for this platform in this release.";
+export type StartupPerfSample = {
+    durationMs: number;
+    measuredAt: string;
+    method: typeof STARTUP_SAMPLE_METHOD;
+    appTarget?: string;
+    appBundleId?: string;
+};

package/dist/src/daemon/handlers/session.d.ts

@@ -7,39 +7,14 @@ import { stopIosRunnerSession } from '../../platforms/ios/runner-client.ts';
 import { shutdownSimulator } from '../../platforms/ios/simulator.ts';
 import { startAppLog, stopAppLog } from '../app-log.ts';
 import { applyRuntimeHintsToApp, clearRuntimeHintsFromApp } from '../runtime-hints.ts';
-type ReinstallOps = {
-    ios: (device: DeviceInfo, app: string, appPath: string) => Promise<{
-        bundleId: string;
-    }>;
-    android: (device: DeviceInfo, app: string, appPath: string) => Promise<{
-        package: string;
-    }>;
-};
-type AppDeployOps = {
-    ios: (device: DeviceInfo, app: string, appPath: string) => Promise<{
-        bundleId?: string;
-        appName?: string;
-        launchTarget?: string;
-    }>;
-    android: (device: DeviceInfo, app: string, appPath: string) => Promise<{
-        package?: string;
-        appName?: string;
-        launchTarget?: string;
-    }>;
-};
-type InstallOps = AppDeployOps;
+import { settleIosSimulator } from './session-device-utils.ts';
+import { type ShutdownAndroidEmulatorFn } from './session-close.ts';
+import { type InstallOps, type ReinstallOps } from './session-deploy.ts';
 type EnsureAndroidEmulatorBoot = (params: {
     avdName: string;
     serial?: string;
     headless?: boolean;
 }) => Promise<DeviceInfo>;
-declare function settleIosSimulator(device: DeviceInfo, delayMs: number): Promise<void>;
-declare function shutdownAndroidEmulator(device: DeviceInfo): Promise<{
-    success: boolean;
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-}>;
 export declare function handleSessionCommands(params: {
     req: DaemonRequest;
     sessionName: string;
@@ -62,6 +37,6 @@ export declare function handleSessionCommands(params: {
     clearRuntimeHints?: typeof clearRuntimeHintsFromApp;
     settleSimulator?: typeof settleIosSimulator;
     shutdownSimulator?: typeof shutdownSimulator;
-    shutdownAndroidEmulator?: typeof shutdownAndroidEmulator;
+    shutdownAndroidEmulator?: ShutdownAndroidEmulatorFn;
 }): Promise<DaemonResponse | null>;
 export {};

package/dist/src/daemon/selectors-build.d.ts

@@ -0,0 +1,4 @@
+import type { SnapshotNode } from '../utils/snapshot.ts';
+export declare function buildSelectorChainForNode(node: SnapshotNode, _platform: 'ios' | 'android', options?: {
+    action?: 'click' | 'fill' | 'get';
+}): string[];

package/dist/src/daemon/selectors-match.d.ts

@@ -0,0 +1,5 @@
+import type { SnapshotNode } from '../utils/snapshot.ts';
+import type { Selector } from './selectors-parse.ts';
+export declare function matchesSelector(node: SnapshotNode, selector: Selector, platform: 'ios' | 'android'): boolean;
+export declare function isNodeVisible(node: SnapshotNode): boolean;
+export declare function isNodeEditable(node: SnapshotNode, platform: 'ios' | 'android'): boolean;

package/dist/src/daemon/selectors-parse.d.ts

@@ -0,0 +1,29 @@
+export type SelectorKey = 'id' | 'role' | 'text' | 'label' | 'value' | 'visible' | 'hidden' | 'editable' | 'selected' | 'enabled' | 'hittable';
+export type SelectorTerm = {
+    key: SelectorKey;
+    value: string | boolean;
+};
+export type Selector = {
+    raw: string;
+    terms: SelectorTerm[];
+};
+export type SelectorChain = {
+    raw: string;
+    selectors: Selector[];
+};
+export declare function parseSelectorChain(expression: string): SelectorChain;
+export declare function tryParseSelectorChain(expression: string): SelectorChain | null;
+export declare function isSelectorToken(token: string): boolean;
+export declare function splitSelectorFromArgs(args: string[], options?: {
+    preferTrailingValue?: boolean;
+}): {
+    selectorExpression: string;
+    rest: string[];
+} | null;
+export declare function splitIsSelectorArgs(positionals: string[]): {
+    predicate: string;
+    split: {
+        selectorExpression: string;
+        rest: string[];
+    } | null;
+};

package/dist/src/daemon/selectors-resolve.d.ts

@@ -0,0 +1,32 @@
+import type { SnapshotNode, SnapshotState } from '../utils/snapshot.ts';
+import type { Selector, SelectorChain } from './selectors-parse.ts';
+export type SelectorDiagnostics = {
+    selector: string;
+    matches: number;
+};
+type SelectorResolution = {
+    node: SnapshotNode;
+    selector: Selector;
+    selectorIndex: number;
+    matches: number;
+    diagnostics: SelectorDiagnostics[];
+};
+export declare function resolveSelectorChain(nodes: SnapshotState['nodes'], chain: SelectorChain, options: {
+    platform: 'ios' | 'android';
+    requireRect?: boolean;
+    requireUnique?: boolean;
+    disambiguateAmbiguous?: boolean;
+}): SelectorResolution | null;
+export declare function findSelectorChainMatch(nodes: SnapshotState['nodes'], chain: SelectorChain, options: {
+    platform: 'ios' | 'android';
+    requireRect?: boolean;
+}): {
+    selectorIndex: number;
+    selector: Selector;
+    matches: number;
+    diagnostics: SelectorDiagnostics[];
+} | null;
+export declare function formatSelectorFailure(chain: SelectorChain, diagnostics: SelectorDiagnostics[], options: {
+    unique?: boolean;
+}): string;
+export {};

package/dist/src/daemon/selectors.d.ts

@@ -1,65 +1,5 @@
-import type { SnapshotNode, SnapshotState } from '../utils/snapshot.ts';
-type SelectorKey = 'id' | 'role' | 'text' | 'label' | 'value' | 'visible' | 'hidden' | 'editable' | 'selected' | 'enabled' | 'hittable';
-type SelectorTerm = {
-    key: SelectorKey;
-    value: string | boolean;
-};
-type Selector = {
-    raw: string;
-    terms: SelectorTerm[];
-};
-export type SelectorChain = {
-    raw: string;
-    selectors: Selector[];
-};
-type SelectorDiagnostics = {
-    selector: string;
-    matches: number;
-};
-type SelectorResolution = {
-    node: SnapshotNode;
-    selector: Selector;
-    selectorIndex: number;
-    matches: number;
-    diagnostics: SelectorDiagnostics[];
-};
-export declare function parseSelectorChain(expression: string): SelectorChain;
-export declare function tryParseSelectorChain(expression: string): SelectorChain | null;
-export declare function resolveSelectorChain(nodes: SnapshotState['nodes'], chain: SelectorChain, options: {
-    platform: 'ios' | 'android';
-    requireRect?: boolean;
-    requireUnique?: boolean;
-    disambiguateAmbiguous?: boolean;
-}): SelectorResolution | null;
-export declare function findSelectorChainMatch(nodes: SnapshotState['nodes'], chain: SelectorChain, options: {
-    platform: 'ios' | 'android';
-    requireRect?: boolean;
-}): {
-    selectorIndex: number;
-    selector: Selector;
-    matches: number;
-    diagnostics: SelectorDiagnostics[];
-} | null;
-export declare function formatSelectorFailure(chain: SelectorChain, diagnostics: SelectorDiagnostics[], options: {
-    unique?: boolean;
-}): string;
-export declare function isSelectorToken(token: string): boolean;
-export declare function splitSelectorFromArgs(args: string[], options?: {
-    preferTrailingValue?: boolean;
-}): {
-    selectorExpression: string;
-    rest: string[];
-} | null;
-export declare function splitIsSelectorArgs(positionals: string[]): {
-    predicate: string;
-    split: {
-        selectorExpression: string;
-        rest: string[];
-    } | null;
-};
-export declare function isNodeVisible(node: SnapshotNode): boolean;
-export declare function isNodeEditable(node: SnapshotNode, platform: 'ios' | 'android'): boolean;
-export declare function buildSelectorChainForNode(node: SnapshotNode, _platform: 'ios' | 'android', options?: {
-    action?: 'click' | 'fill' | 'get';
-}): string[];
-export {};
+export type { SelectorChain } from './selectors-parse.ts';
+export { parseSelectorChain, tryParseSelectorChain, isSelectorToken, splitSelectorFromArgs, splitIsSelectorArgs, } from './selectors-parse.ts';
+export { isNodeVisible, isNodeEditable } from './selectors-match.ts';
+export { resolveSelectorChain, findSelectorChainMatch, formatSelectorFailure, } from './selectors-resolve.ts';
+export { buildSelectorChainForNode } from './selectors-build.ts';