@aixnn/aixautots 0.5.3 → 0.5.4

package/dist/coords-LPR_MPyp.d.ts

@@ -0,0 +1,22 @@
+interface Box {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+interface DeviceSize {
+    width: number;
+    height: number;
+}
+interface DevicePoint {
+    x: number;
+    y: number;
+}
+/** Map a pointer's client coords inside a `<video>` (rendered with object-fit:
+ *  contain) to device pixels. Returns null if the point is in a letterbox bar. */
+declare function toDevicePoint(pointer: {
+    clientX: number;
+    clientY: number;
+}, box: Box, device: DeviceSize): DevicePoint | null;
+
+export { type Box as B, type DeviceSize as D, type DevicePoint as a, toDevicePoint as t };

package/dist/core/index.d.ts

@@ -0,0 +1,135 @@
+import { R as ResolvedConfig, W as WebSocketFactory } from '../config-fsx4jlLK.js';
+export { f as AdminApi, c as AixClient, A as AixConfig, g as ApiTokensApi, h as AuthApi, i as AuthProvider, B as BillingApi, C as CachedUserCredentialOpts, j as ClustersApi, k as Credential, D as DcStream, l as DeviceReq, m as DeviceResp, n as DeviceSession, o as DevicesApi, p as EnvAction, e as EnvEventKind, q as EnvFinished, E as EnvOs, r as EnvResultDto, d as EnvRoute, s as EnvRun, t as EnvSetupInput, u as EnvStepMeta, v as EnvStepView, w as EnvSummary, x as EnvTeardownInput, y as ExecutionFrame, z as ExecutionStreamEvent, G as ExecutionStreamEventsResult, H as FileEntry, I as FleetApi, F as FridaEventFrame, J as IRTCDataChannel, K as IRTCPeerConnection, L as IWebSocket, M as ImagesApi, N as IncomingFrame, P as LlmApi, Q as LocalNodeController, T as LocalNodeOptions, U as LocatorsApi, V as NodeHost, X as NodeHostStatus, Y as NodesApi, O as OutgoingFrame, Z as ProgressFn, _ as ProjectsApi, $ as PullResult, a0 as PushInput, a1 as RTCFactory, a2 as RequestOpts, a3 as RestClient, a4 as RetFrame, a as RunEventKind, a5 as Scope, S as ScriptletEventFrame, a6 as ScriptsApi, a7 as ShortcutsApi, b as StatusFrame, a8 as StreamTarget, a9 as TasksApi, aa as TransferOpts, ab as TransferProgress, ac as TransferResult, ad as UsersApi, ae as WebhooksApi, af as authHeader, ag as buildAuthProvider, ah as createCachedUserCredential, ai as createClient, aj as detectEnvOs, ak as envBlocker, al as executionStreamEventsAfter, am as executionWsTicketUrl, an as executionWsUrl, ao as isEnvEventFrame, ap as isExecutionFrame, aq as isFleetRunTerminal, ar as isFridaEventFrame, as as isRetFrame, at as isScriptletEventFrame, au as isStatusFrame, av as joinUrl, aw as parseIncoming, ax as pullFile, ay as pushFile, az as resolveConfig, aA as restClient, aB as runEnvToFinish, aC as summarizeEnv } from '../config-fsx4jlLK.js';
+export { A as AdbResult, D as DeviceChannel, b as DeviceTunnel, c as ScriptDebugger, d as ScriptDebuggerOptions, a as ScriptEngine, S as ScriptEvent, e as ScriptRunInput, W as WdaResult } from '../script-debugger-Cu_coj-h.js';
+export { A as AutomationQueue, B as BatchConfig, F as FlowEvent, a as FlowRun, b as FlowSubmit, Q as QueueMode, s as submitBatch } from '../automation-queue-CKsueO9z.js';
+import { h as ScriptParam } from '../types-C2WXVcam.js';
+export { i as AdbScanResult, d as AgentTaskBlocker, j as AgentTaskCurrentAttempt, k as AgentTaskEvent, l as AgentTaskEventsResult, e as AgentTaskEvidence, m as AgentTaskReadResult, n as AgentTaskReadTarget, o as AgentTaskSubmitInput, p as AgentTaskSubmitResult, c as AgentTaskTarget, A as AgentTaskTargetStatus, q as ApiTokenRow, r as AppCandidate, s as AppEntry, t as AppTemplate, u as AppTemplateItemAndroid, v as AppTemplateItemIos, w as AuthResult, B as BalanceLedgerRow, x as BalanceResp, y as BillingPlan, C as CatalogBrand, z as CatalogModel, E as Cluster, F as ClusterMode, G as CreateClusterInput, H as CreateLocatorInput, I as CreateProjectInput, J as CreateProjectResult, K as CreateTokenInput, L as CreateWebhookInput, M as CreatedToken, g as Decimal, O as DeveloperRef, Q as DeviceLocation, R as DeviceOp, T as DeviceProfileView, U as DeviceRate, D as DeviceRow, V as DeviceUsageSession, b as DiscoveredDevice, W as DiscoveredStatus, X as ElementNode, Y as FleetMode, Z as FleetRunDetail, _ as FleetRunDeviceRow, $ as FleetRunSubmit, a0 as ImageArtifact, a1 as ImageInput, a2 as ImageOption, a3 as InstallAntiDetectResult, a4 as IosAccountState, a5 as IosDeviceRow, a6 as IosLibraryApp, a7 as IosLoginResult, a8 as IosScanResult, a9 as KnownDeviceOpName, aa as LlmTestResult, ab as Locator, ac as MdnsEntry, ad as NewAppTemplate, ae as NewShortcut, af as NodeEffectiveCaps, ag as NodeOwnerPolicy, N as NodeRow, ah as NodeScope, ai as OwnNodeDailyCharge, aj as PlanInput, ak as PlatformOem, al as PlatformOemInput, am as PowerAction, an as PowerRunResult, ao as ProfileOverrides, ap as Project, aq as ProjectSubscription, ar as ProjectUserResult, a as ProvisionResult, P as ProvisionSpec, as as ProvisionUserInput, at as ProvisionUserResult, au as ProxyApplyReceipt, av as ProxyApplyStatus, aw as ProxyPatchResult, ax as ProxyProbe, ay as ProxyProbeErrorCode, az as ProxySummary, aA as ProxyUrl, aB as RateInput, aC as RebateLedgerRow, aD as RecycledDeviceRow, aE as RegisterNodeInput, aF as RegisterNodeResult, aG as ScreenshotResult, S as Script, f as ScriptSummary, aH as SendCodeResult, aI as SetDataRootResult, aJ as SetDisguiseResult, aK as SetProfileResult, aL as Shortcut, aM as ShortcutParam, aN as ShortcutRunResult, aO as SubscribeInput, aP as TaskEvent, aQ as TaskEventsResult, aR as TaskListFilter, aS as TaskListResult, aT as TaskStatus, aU as TaskSubmitResult, aV as TaskSummary, aW as TaskTarget, aX as TopupInput, aY as TopupResult, aZ as UpdateNodeInput, a_ as User, a$ as VerifyCodeResult, b0 as WebhookConfig } from '../types-C2WXVcam.js';
+import { C as ControlMessage } from '../mirror-session-DM-trg1F.js';
+export { I as InputMessage, M as MirrorSession, S as SCRCPY_PROFILES, a as ScrcpyProfile, b as ScrcpyProfileName, q as qualityMessage } from '../mirror-session-DM-trg1F.js';
+import { B as Box, D as DeviceSize } from '../coords-LPR_MPyp.js';
+export { a as DevicePoint, t as toDevicePoint } from '../coords-LPR_MPyp.js';
+export { D as DeviceTransport, N as NormalizedDevice, n as normalizeDevices } from '../device-normalize-BaThgnH7.js';
+
+type AixErrorCode = 'auth' | 'timeout' | 'offline' | 'locked' | 'protocol' | 'unknown';
+declare class AixError extends Error {
+    readonly code: AixErrorCode;
+    /** HTTP status when the error came from a REST response (else undefined). */
+    readonly status?: number;
+    /** Backend's human-facing message parsed from the response body (`message`/
+     *  `error` field), if any — prefer this over `message` when showing a prompt
+     *  (e.g. 402 → "账号余额不足，请充值"). */
+    readonly detail?: string;
+    constructor(message: string, code?: AixErrorCode, opts?: {
+        status?: number;
+        detail?: string;
+    });
+}
+declare class AixAuthError extends AixError {
+    constructor(m: string);
+}
+declare class AixTimeout extends AixError {
+    constructor(m: string);
+}
+declare class AixDeviceOffline extends AixError {
+    constructor(m: string);
+}
+declare class AixLocked extends AixError {
+    constructor(m: string);
+}
+declare class AixProtocolError extends AixError {
+    constructor(m: string);
+}
+/** Map a backend `ret.error` string to the most specific typed error. */
+declare function errorFromRet(error: string): AixError;
+
+interface WsAccess {
+    token: string;
+    expires_in: number;
+    direct_ws: string | null;
+    relay_ws: string;
+}
+/** POST /api/devices/:id/ws-access → short-lived device token + dual WS links. */
+declare function mintDeviceAccess(cfg: ResolvedConfig, deviceId: string): Promise<WsAccess>;
+/** Choose the WS url to use, appending the token query param. */
+declare function wsUrlFromAccess(a: WsAccess, prefer?: 'direct' | 'relay'): string;
+
+interface ReconnectingSocketOpts {
+    urlProvider: () => Promise<string>;
+    wsFactory: WebSocketFactory;
+    onMessage: (text: string) => void;
+    onOpen?: () => void;
+    onClose?: () => void;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+}
+/** A WebSocket that reconnects with exponential backoff + jitter. Each
+ *  (re)connect calls `urlProvider()` so a fresh token can be embedded. */
+declare class ReconnectingSocket {
+    private readonly o;
+    private ws;
+    private closed;
+    private attempt;
+    private reconnectTimer;
+    private readonly base;
+    private readonly max;
+    constructor(o: ReconnectingSocketOpts);
+    start(): Promise<void>;
+    private connect;
+    private scheduleReconnect;
+    send(text: string): void;
+    isConnected(): boolean;
+    close(): void;
+}
+
+/** schema 存放在 variables 里的保留键。以 `__` 前缀避免与真实参数键冲突。 */
+declare const SCHEMA_KEY = "__schema__";
+/**
+ * 从 `Script.variables` 解出结构化 schema。
+ * - 有合法 `__schema__` 数组 → 采用之(去重保唯一 isTarget:仅第一个生效)。
+ * - 否则降级:把所有非 `__` 前缀键当 `type:'text'` 字段,default=String(值)。
+ */
+declare function variablesToSchema(variables: Record<string, unknown> | undefined): ScriptParam[];
+/**
+ * 把结构化 schema 写回 `variables`:产出 `{ __schema__, <key>: <default> }`。
+ * 保留传入 variables 里的其它 `__` 保留键(除 `__schema__` 本身)。
+ */
+declare function schemaToVariables(schema: ScriptParam[], base?: Record<string, unknown>): Record<string, unknown>;
+/** schema 中被标记为目标字段(isTarget)的参数;无则 undefined。 */
+declare function targetParam(schema: ScriptParam[]): ScriptParam | undefined;
+/** schema 默认值映射(key → 字符串),供表单初始化。 */
+declare function schemaDefaults(schema: ScriptParam[]): Record<string, string>;
+
+declare function getIceServers(cfg: ResolvedConfig): Promise<unknown[]>;
+declare function mintViewerToken(cfg: ResolvedConfig, session: string): Promise<string>;
+
+interface PointerSample {
+    clientX: number;
+    clientY: number;
+    /** Timestamp in ms (e.g. `performance.now()` / `event.timeStamp`). */
+    t: number;
+}
+interface ClassifyDragOpts {
+    /** Max pixel movement still treated as a tap (not a swipe). */
+    tapMovePx?: number;
+}
+/** Classify a pointer gesture (down → up) into a `tap` or `swipe`.
+ *  Coords are normalized to [0,1] via the video `box` + device size (the node
+ *  scales back to px). Returns null if the relevant point is in the letterbox. */
+declare function classifyDrag(start: PointerSample, end: PointerSample, box: Box, device: DeviceSize, opts?: ClassifyDragOpts): ControlMessage | null;
+interface KeyEventLike {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    altKey?: boolean;
+}
+/** Map a keydown into a `key` (special keys) or `text` (printable char) control
+ *  message. Returns null for unmapped / modifier-combo keys (let the browser
+ *  keep them). */
+declare function mapKey(e: KeyEventLike): ControlMessage | null;
+
+type Locale = "en" | "zh";
+declare function setLocale(l: Locale): void;
+declare function getLocale(): Locale;
+declare function t(code: AixErrorCode): string;
+
+export { AixAuthError, AixDeviceOffline, AixError, type AixErrorCode, AixLocked, AixProtocolError, AixTimeout, Box, type ClassifyDragOpts, ControlMessage, DeviceSize, type KeyEventLike, type Locale, type PointerSample, ReconnectingSocket, ResolvedConfig, SCHEMA_KEY, ScriptParam, WebSocketFactory, type WsAccess, classifyDrag, errorFromRet, getIceServers, getLocale, mapKey, mintDeviceAccess, mintViewerToken, schemaDefaults, schemaToVariables, setLocale, t, targetParam, variablesToSchema, wsUrlFromAccess };

package/dist/device-normalize-BaThgnH7.d.ts

@@ -0,0 +1,43 @@
+import { D as DeviceRow } from './types-C2WXVcam.js';
+
+/** One backend device row as a transport of a (possibly de-duplicated) physical
+ *  device. The same phone reachable over both USB and WiFi yields two rows with
+ *  different `external_id`s — they share a `transport` label and a stable
+ *  `serialno` (set by the node from `ro.serialno`). */
+interface DeviceTransport {
+    /** The adb-serial-derived id this transport is addressed by (`POST /api/devices/:id/*`). */
+    external_id: string;
+    /** `'usb' | 'wifi' | 'virtual' | null` — from `meta.transport`. */
+    transport: string | null;
+    online: boolean;
+    node_id: string | null;
+    node_name: string | null;
+    last_seen_at: string | null;
+}
+/** A physical device after merging its transport rows. Extends the chosen
+ *  primary `DeviceRow`, but:
+ *  - `device_id` is the id to address device ops at (the active transport's
+ *    `external_id`) — NOT the DB primary key `id`. The whole `/api/devices/:id/*`
+ *    family resolves by `external_id`, so addressing by `id` 403s "not in scope".
+ *  - `online` is true if ANY transport is online.
+ *  - `transports` lists every underlying row (so the UI can show "USB + WiFi"). */
+interface NormalizedDevice extends DeviceRow {
+    /** The `external_id` to pass to every `/api/devices/:id/*` call. */
+    device_id: string;
+    transports: DeviceTransport[];
+}
+/** Merge the caller's device rows so the same physical device appears once.
+ *
+ *  Dedup key: `meta.serialno` when present; otherwise the row's own `external_id`.
+ *
+ *  Cross-reference: a provisioned virtual device row (e.g. `external_id = rd-XXXX`)
+ *  typically has no `meta.serialno`, but the ADB-TCP row the node auto-discovers
+ *  for the same container (e.g. `external_id = 127.0.0.1:PORT`) carries
+ *  `meta.serialno = rd-XXXX`.  We collect all serialno values first, then treat any
+ *  row whose `external_id` appears in that set as belonging to the same group —
+ *  so both rows end up under `sn:rd-XXXX` and are merged into one display entry.
+ *
+ *  Output order follows first appearance of each device in `rows`. */
+declare function normalizeDevices(rows: DeviceRow[]): NormalizedDevice[];
+
+export { type DeviceTransport as D, type NormalizedDevice as N, normalizeDevices as n };

package/dist/i18n/index.d.ts

@@ -0,0 +1,30 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+/**
+ * aixautots UI 内置词典（扁平 key→文案）。默认提供 en / zh 两份。各页面下沉时把自己
+ * 的文案 key 加到这里（命名建议：`<area>.<thing>`，如 `devices.title`、`common.refresh`）。
+ * 接入方可通过 `AixI18nProvider` 的 `overrides` 增改任意 key。
+ */
+type AixLang = 'en' | 'zh';
+type AixDict = Record<string, string>;
+
+type AixT = (key: string, vars?: Record<string, string | number>) => string;
+interface I18nValue {
+    lang: AixLang;
+    t: AixT;
+}
+interface AixI18nProviderProps {
+    /** 语言，默认 en。 */
+    lang?: AixLang;
+    /** 增改词条：按语言合并进内置词典（同 key 覆盖）。 */
+    overrides?: Partial<Record<AixLang, AixDict>>;
+    children: ReactNode;
+}
+declare function AixI18nProvider({ lang, overrides, children }: AixI18nProviderProps): react.FunctionComponentElement<react.ProviderProps<I18nValue | null>>;
+/** 取翻译函数。未包 Provider 时回退到 en 内置词典（找不到 key 则原样返回 key）。 */
+declare function useAixT(): AixT;
+/** 取当前语言（未包 Provider 时为 en）。 */
+declare function useAixLang(): AixLang;
+
+export { type AixDict, AixI18nProvider, type AixI18nProviderProps, type AixLang, type AixT, useAixLang, useAixT };

package/dist/mirror-session-DM-trg1F.d.ts

@@ -0,0 +1,108 @@
+import { A as AixConfig, R as ResolvedConfig } from './config-fsx4jlLK.js';
+
+/** Mirrors the node's `ControlMsg` (webrtc/control.rs): `t`-tagged, coords
+ *  normalized [0,1] (node scales to px). Sent over the `control` DataChannel. */
+type ControlMessage = {
+    t: 'tap';
+    x: number;
+    y: number;
+} | {
+    t: 'swipe';
+    from_x: number;
+    from_y: number;
+    to_x: number;
+    to_y: number;
+    duration_ms?: number;
+} | {
+    t: 'touch_down';
+    x: number;
+    y: number;
+} | {
+    t: 'touch_move';
+    x: number;
+    y: number;
+} | {
+    t: 'touch_up';
+    x: number;
+    y: number;
+} | {
+    t: 'key';
+    code: string;
+} | {
+    t: 'text';
+    value: string;
+} | {
+    t: 'home';
+} | {
+    t: 'back';
+} | {
+    t: 'rotate';
+    orientation: 'portrait' | 'landscape';
+} | {
+    t: 'quality';
+    max_size: number;
+    bitrate: number;
+    fps: number;
+};
+type InputMessage = ControlMessage;
+/** Named encode profiles (latency/quality tradeoff). The client owns the
+ *  names; the node only sees the explicit knobs (`qualityMessage`). */
+type ScrcpyProfileName = 'balanced' | 'low_latency' | 'high_quality';
+interface ScrcpyProfile {
+    /** Long-edge cap in px; 0 = native resolution. */
+    max_size: number;
+    /** Target video bitrate in bits/s. */
+    bitrate: number;
+    /** Frame-rate cap. */
+    fps: number;
+}
+declare const SCRCPY_PROFILES: Record<ScrcpyProfileName, ScrcpyProfile>;
+/** Build the `quality` control message for a named profile. */
+declare function qualityMessage(profile: ScrcpyProfileName): ControlMessage;
+/** WebRTC viewer for one signaling `session`. Viewer is the **answerer**: it
+ *  waits for an `offer` from the node (which is the offerer and owns the video
+ *  track + `control` DataChannel), creates an answer, and receives the
+ *  `control` DataChannel via `ondatachannel`. */
+declare class MirrorSession {
+    private readonly cfg;
+    readonly session: string;
+    private readonly socket;
+    private readonly iceServers;
+    private readonly token;
+    private pc;
+    private input;
+    private _stream;
+    private peerId;
+    private remotePeer;
+    private remoteDescriptionReady;
+    private pendingIce;
+    private readonly stateListeners;
+    private readonly streamListeners;
+    private constructor();
+    /** Start a viewer session. On WebSocket reconnect the socket re-joins
+     *  automatically; the node then sends a fresh offer, which is paired with a
+     *  fresh RTCPeerConnection (see the `offer` handler) — no consumer action
+     *  needed to restore the video track. */
+    static join(cfg: AixConfig | ResolvedConfig, session: string): Promise<MirrorSession>;
+    get stream(): MediaStream | null;
+    onConnectionStateChange(cb: (s: string) => void): () => void;
+    onStream(cb: (s: MediaStream) => void): () => void;
+    sendInput(msg: InputMessage): void;
+    /** Ask the node to switch this device's encode profile (restarts its capture
+     *  pipeline; the video blanks briefly while it re-syncs on a keyframe). */
+    setQuality(profile: ScrcpyProfileName): void;
+    /** Current round-trip time (seconds) from the active ICE candidate pair, or
+     *  null when stats are unavailable (no pc yet / mock without getStats). Used
+     *  by the auto quality heuristic. */
+    currentRtt(): Promise<number | null>;
+    private sendSignal;
+    private ensurePc;
+    private attachInput;
+    /** Drop the current peer connection (keeps the last frame on screen until
+     *  the replacement track arrives). */
+    private resetPeer;
+    private onSignal;
+    leave(): void;
+}
+
+export { type ControlMessage as C, type InputMessage as I, MirrorSession as M, SCRCPY_PROFILES as S, type ScrcpyProfile as a, type ScrcpyProfileName as b, qualityMessage as q };

package/dist/nav/index.d.ts

@@ -0,0 +1,19 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+interface AixNav {
+    /** 跳转到目标路径（应用内路由）。replace=true 时替换历史记录。 */
+    navigate: (to: string, opts?: {
+        replace?: boolean;
+    }) => void;
+}
+interface AixNavProviderProps {
+    nav: AixNav;
+    children: ReactNode;
+}
+declare function AixNavProvider({ nav, children }: AixNavProviderProps): react.FunctionComponentElement<react.ProviderProps<AixNav | null>>;
+/** 取注入的导航器。未包 `AixNavProvider` 时返回一个 no-op（仅 console.warn），
+ *  让组件在缺 Provider 时不崩溃。 */
+declare function useAixNav(): AixNav;
+
+export { type AixNav, AixNavProvider, type AixNavProviderProps, useAixNav };