@aixnn/aixautots 0.5.3 → 0.5.4

package/dist/types-C2WXVcam.d.ts

@@ -0,0 +1,1005 @@
+interface DeveloperRef {
+    id: string;
+    email: string;
+}
+interface AuthResult {
+    token: string;
+    developer: DeveloperRef;
+}
+interface VerifyCodeResult {
+    token: string;
+    developer: DeveloperRef;
+    password_set: boolean;
+}
+interface SendCodeResult {
+    sent: boolean;
+    dev_code?: string;
+}
+interface ProjectUserResult {
+    token: string;
+    user_id: string;
+    project_id: string;
+}
+interface Project {
+    id: string;
+    name: string;
+    description?: string;
+    platform: string;
+    project_key: string;
+    created_at: string;
+    updated_at: string;
+}
+interface CreateProjectInput {
+    name: string;
+    description?: string;
+    platform: string;
+}
+interface CreateProjectResult {
+    project: Project;
+    secret: string;
+}
+interface User {
+    id: string;
+    email: string;
+    created_at: string;
+}
+/** `project_id` is optional; when set it must match the authenticated project. */
+interface ProvisionUserInput {
+    email: string;
+    project_id?: string;
+}
+interface ProvisionUserResult {
+    user: User;
+    project_id: string;
+    token: string;
+    /** True when this call created a brand-new user (vs. reused an existing one). */
+    created: boolean;
+}
+interface DeviceRow {
+    id: string;
+    external_id: string;
+    project_id: string;
+    owner_user_id: string;
+    visibility: string;
+    kind: string;
+    name: string;
+    meta: Record<string, unknown> | null;
+    last_seen_at: string | null;
+    online?: boolean;
+    created_at: string;
+    updated_at: string;
+    tags?: string[];
+    /** User-set free-text remark; '' = unset. */
+    note?: string;
+    node_id?: string | null;
+    node_name?: string | null;
+    platform?: string | null;
+}
+/** A soft-deleted device in the recycle bin (`GET /api/devices/recycle`). */
+interface RecycledDeviceRow {
+    id: string;
+    external_id: string;
+    name: string | null;
+    kind: string | null;
+    meta: Record<string, unknown> | null;
+    tags: string[];
+    note: string;
+    /** When it was moved to the recycle bin. */
+    deleted_at: string;
+    /** Container teardown deferred until the owning node reconnects. */
+    pending_destroy: boolean;
+    platform: string | null;
+}
+type PowerAction = 'start' | 'stop' | 'reboot' | 'reset' | 'destroy' | 'snapshot' | 'restore' | 'control' | 'reconfigure';
+interface ScreenshotResult {
+    png_base64: string;
+}
+/** Result of `POST /api/devices/:id/proxy/probe`. The endpoint deliberately
+ * exposes diagnostics only; it never echoes proxy credentials. The primary
+ * contract uses `exit_ip`/`message`; deprecated aliases are accepted while
+ * older gateways roll forward. */
+type ProxyProbeErrorCode = 'not_configured' | 'unsupported_runtime' | 'timeout' | 'dns' | 'connect' | 'invalid_response' | 'configuration_error' | 'probe_failed' | (string & {});
+interface ProxyProbe {
+    configured?: boolean;
+    enforcement?: 'transparent_tcp' | 'transparent' | 'unsupported';
+    reachable: boolean;
+    exit_ip?: string | null;
+    checked_at?: string;
+    error_code?: ProxyProbeErrorCode;
+    message?: string | null;
+    latency_ms?: number | null;
+    /** @deprecated Use `exit_ip`. */
+    egress_ip?: string | null;
+    /** @deprecated Use `message`. */
+    error?: string | null;
+}
+/** Secret-free proxy state exposed in public device metadata. */
+type ProxyApplyStatus = 'pending' | 'applied' | 'failed' | 'unsupported' | 'unsupported_legacy';
+interface ProxySummary {
+    configured: boolean;
+    desired_revision?: number | null;
+    observed_revision?: number | null;
+    observed_status?: ProxyApplyStatus | null;
+}
+interface ProxyApplyReceipt {
+    revision: number;
+    status: ProxyApplyStatus;
+    /** Safe backend explanation for failed/unsupported capability outcomes. */
+    message?: string | null;
+}
+/** The existing device PATCH returns the updated, credential-scrubbed device row. */
+interface ProxyPatchResult extends DeviceRow {
+    proxy_apply?: ProxyApplyReceipt | null;
+}
+/** A device op for the REST proxy (`POST /api/devices/:id/op`). Known ops are
+ *  listed for autocomplete; the open `{ op: string; ... }` fallback keeps any
+ *  node-supported op valid WITHOUT a new SDK method (the single generic entry
+ *  point — typed helpers like `screenshot()` are thin wrappers over it). */
+type KnownDeviceOpName = 'screenshot' | 'screen_size' | 'capture_ui_tree' | 'tap' | 'swipe' | 'input_text' | 'press_key' | 'find_element' | 'find_elements' | 'install' | 'app_list' | 'inject_location' | 'inject_location_auto';
+type DeviceOp = {
+    op: KnownDeviceOpName | (string & {});
+    [k: string]: unknown;
+};
+interface DeviceLocation {
+    mode: 'auto' | 'manual';
+    latitude: number;
+    longitude: number;
+    accuracy_meters?: number;
+    updated_at?: string;
+}
+/** An installed app entry — `device-op app_list` result (mirrors
+ *  `aixautosdk::core::device::types::AppEntry`). */
+interface AppEntry {
+    package: string;
+    label: string;
+}
+/** UI tree node — mirrors `aixautosdk::core::element::tree::UITreeNode`. */
+interface ElementNode {
+    label: string | null;
+    text: string | null;
+    resource_id: string | null;
+    class_name: string | null;
+    xpath: string;
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    enabled: boolean;
+    visible: boolean;
+    attributes: Record<string, string>;
+    children: ElementNode[];
+}
+/** Upstream proxy as a canonical HTTP CONNECT URL with optional credentials,
+ *  `http://[user:percent-encoded-password@]host:port`. Carried opaquely through
+ *  the provision spec; the backend encrypts credentials before storage. */
+type ProxyUrl = string;
+/** Ownership/claim status of a node-reported device, relative to the caller. */
+type DiscoveredStatus = 'mine' | 'claimable' | 'owned_other' | 'unregistered';
+/** A device a node currently reports (from `POST /api/nodes/:id/devices/discover`). */
+interface DiscoveredDevice {
+    external_id: string;
+    model?: string | null;
+    platform?: string | null;
+    transport?: string | null;
+    state?: string | null;
+    device_id?: string | null;
+    status: DiscoveredStatus;
+    meta?: Record<string, unknown>;
+    updated_at: string;
+}
+/** Opaque provision spec. `node_id` is a routing hint stripped server-side. */
+interface ProvisionSpec {
+    platform?: 'android' | 'ios' | 'vphone';
+    name?: string;
+    node_id?: string;
+    android_version?: string;
+    /** OS version chosen from the admin image catalog (e.g. "14", "17.4"). */
+    os_version?: string;
+    /** Concrete catalog image id from the wizard; the gateway resolves it to the
+     *  platform / container image / version (see `images.options`). */
+    image_id?: string;
+    /** Catalog 机型 (e.g. "Pixel 8", "SM-S911B") chosen in the create wizard. Locks
+     *  the fingerprint identity base to that device; omitted ⇒ backend picks a
+     *  random base for the chosen android version. See `devices.profileCatalog()`. */
+    model?: string;
+    hardware?: {
+        memory_mb?: number;
+    };
+    /** ISO-3166 country (e.g. "cn", "us") for a geo-consistent SIM/carrier/locale/
+     *  timezone, or "auto" to match the proxy's IP geolocation. Omitted ⇒ "auto". */
+    region?: string;
+    packages?: Array<{
+        software: string;
+        version?: string;
+    }>;
+    proxy?: ProxyUrl;
+    /** Stage Frida (the hidden florida frida-server + start script) into the
+     *  device so it can be started on demand for instrumentation. Default off —
+     *  Frida is an anti-detect surface, so it's opt-in per device. */
+    frida?: boolean;
+    /** Enable KernelSU root on the device (KSU-LKM, with its traces hidden at the
+     *  kernel layer by aixhide). Default off — no root is the smallest anti-detect
+     *  surface; opt in only when root-level capability (LSPosed dynamic hooks,
+     *  system-wide Frida, privileged automation) is needed. */
+    kernelsu?: boolean;
+    /** GPU rendering mode for the device: `'host'` uses the node's hardware GPU
+     *  (/dev/dri); `'guest'` uses software SwiftShader (works without a GPU);
+     *  `'auto'` (or omitted) lets the node decide (host iff /dev/dri present).
+     *  One image serves all modes — switching is a runtime boot arg, settable at
+     *  creation and changeable later (reset spec_override). */
+    gpu_mode?: 'auto' | 'host' | 'guest';
+    config?: Record<string, unknown>;
+    [k: string]: unknown;
+}
+interface ProvisionResult {
+    device_id: string;
+    tier: string;
+    node_class: string;
+}
+/** Curated, user-editable fingerprint fields. Identity base switched by `model`
+ *  (carries its android_version/build era); region by `locale` (+ `timezone`);
+ *  display by dpi/width/height. Unique IDs are never hand-set. */
+interface ProfileOverrides {
+    model?: string;
+    locale?: string;
+    timezone?: string;
+    dpi?: number;
+    width?: number;
+    height?: number;
+}
+/** `GET /api/devices/:id/profile` response. */
+interface DeviceProfileView {
+    /** Full device_profile JSON (null if none stored yet). */
+    profile: Record<string, unknown> | null;
+    /** Curated subset rendered as the editable form. */
+    editable: Record<string, unknown> | null;
+    kind: 'virtual' | 'real';
+    /** How a change takes effect: virtual reboots, real pushes via LSPosed. */
+    apply: 'reboot' | 'lsposed_push';
+    /** Real device only: apps the LSPosed spoof module disguises (force-stopped on re-push). */
+    scope_pkgs: string[];
+    /** Real device only: whether the LSPosed identity layer is installed (vs. needs first-time install). */
+    disguise_installed: boolean;
+    /** Real device only: whether the disguise is currently ON (default true). When false (停用伪装),
+     *  the on-device spoof config is emptied so scoped apps read the genuine identity; reversible. */
+    disguise_enabled: boolean;
+    /** Real device only: live install state for polling (null = never attempted). */
+    disguise_install_status?: 'installing' | 'installed' | 'failed' | null;
+    /** Real device only: error message when `disguise_install_status === 'failed'`. */
+    disguise_install_error?: string | null;
+    /** Real device only: whether the device is rooted (Magisk) — anti-detect install requires it. */
+    rooted: boolean;
+    choices: {
+        models: string[];
+        locales: string[];
+    };
+}
+/** `POST /api/devices/:id/profile` response. */
+interface SetProfileResult {
+    profile: Record<string, unknown> | null;
+    /** Real device: pushed live to the node's LSPosed layer. Virtual: always false (applies on reboot). */
+    applied: boolean;
+    requires_restart: boolean;
+    apply: 'reboot' | 'lsposed_push';
+    /** Real device only: the now-current disguise scope after this update. */
+    scope_pkgs: string[];
+    /** Real device only: present when the live LSPosed push failed (node offline / no LSPosed); the profile is still persisted. */
+    push_error?: string | null;
+}
+/** `POST /api/devices/:id/anti-detect` response — the install is async (202).
+ *  Poll `getProfile().disguise_install_status` for `installed`/`failed`. */
+interface InstallAntiDetectResult {
+    /** Always `installing` — the multi-reboot install runs in the background. */
+    status: 'installing';
+    /** The device_profile installed with (generated if the device had none). */
+    profile: Record<string, unknown>;
+}
+/** `POST /api/devices/:id/disguise` response — toggle the real-device disguise on/off. */
+interface SetDisguiseResult {
+    /** The now-current state (echo of the request). */
+    enabled: boolean;
+    /** Whether the live push to the node landed. The flag is persisted regardless. */
+    applied: boolean;
+    /** Present when the live push failed (node offline / no LSPosed); the flag still persisted. */
+    push_error?: string | null;
+}
+/** One catalog model offered under a brand; `android_version` lets the wizard
+ *  filter models down to the chosen image version. */
+interface CatalogModel {
+    /** Raw model / SKU passed to `ProvisionSpec.model` (e.g. "SM-S911B"). */
+    model: string;
+    /** Friendly display name (e.g. "Samsung Galaxy S23"). */
+    label: string;
+    android_version: string;
+}
+/** One brand group in the create-wizard catalog. */
+interface CatalogBrand {
+    /** Stable lowercase brand key (e.g. "google", "samsung"). */
+    brand: string;
+    manufacturer: string;
+    label: string;
+    models: CatalogModel[];
+}
+/** `GET /api/admin/oem` response — the platform-level OEM singleton every project
+ *  inherits until it overrides a field. Managed by `PUT /api/admin/oem`. */
+interface PlatformOem {
+    app_name: string | null;
+    package_name: string | null;
+    brand_name: string | null;
+    logo_url: string | null;
+    brand_icon_url: string | null;
+    primary_color: string | null;
+    wallpaper_url: string | null;
+    boot_anim_url: string | null;
+    support_url: string | null;
+    support_email: string | null;
+    preinstall_packages: boolean;
+}
+type PlatformOemInput = Partial<Omit<PlatformOem, 'preinstall_packages'> & {
+    preinstall_packages?: boolean;
+}>;
+interface RegisterNodeResult {
+    id: string;
+    token: string;
+}
+/** Receipt from the allowlisted node runtime data-root update. The node must be
+ * restarted separately before its systemd EnvironmentFile is reloaded. */
+interface SetDataRootResult {
+    data_root: string;
+    restart_required: true;
+}
+interface MdnsEntry {
+    name: string;
+    host: string;
+    port: number;
+}
+interface AdbScanResult {
+    paired: MdnsEntry[];
+    pairing: MdnsEntry[];
+}
+/** A connected iOS device and the usbmux lanes it is reachable on. */
+interface IosDeviceRow {
+    udid: string;
+    usb: boolean;
+    wireless: boolean;
+}
+/** Result of the node-scoped iOS `scan` control verb. */
+interface IosScanResult {
+    devices: IosDeviceRow[];
+}
+/** Access scope: 'personal' (owner only) | 'project' (project members) | 'platform' (anyone). */
+type NodeScope = 'personal' | 'project' | 'platform';
+/** A node row from `GET /api/nodes`. */
+interface NodeRow {
+    id: string;
+    name: string;
+    status: 'online' | 'offline';
+    last_seen_at: string | null;
+    created_at: string;
+    scope: NodeScope;
+    region: string | null;
+    device_count: number;
+    /** 平台(公共)节点的起始价格——最低规格档的小时费率;非平台节点为 null。
+     *  公共节点列表展示「¥x/小时 起」而非设备数。 */
+    starting_price?: Decimal | null;
+    /** starting_price 的币种(默认 CNY)。 */
+    price_currency?: string | null;
+    owner_user_id: string | null;
+    is_owner: boolean;
+    is_platform: boolean;
+    /** Node-reported capabilities (Hello): redroid/ios/vphone_capable, capacity,
+     *  and `system{os,arch,sdk_version}`. Null until the node has connected. */
+    reported_caps?: Record<string, unknown> | null;
+    /** Owner restrictions on top of reported_caps, e.g. `{real_devices:false}`. */
+    owner_policy?: NodeOwnerPolicy | null;
+    /** reported ∩ owner_policy — what the node may actually do. */
+    effective_caps?: NodeEffectiveCaps;
+}
+/** Owner-set capability restrictions (only disable, never enable). */
+interface NodeOwnerPolicy {
+    android?: boolean;
+    ios?: boolean;
+    real_devices?: boolean;
+}
+interface NodeEffectiveCaps {
+    android: boolean;
+    ios: boolean;
+    real_devices: boolean;
+}
+interface RegisterNodeInput {
+    name: string;
+    scope?: NodeScope;
+    region?: string | null;
+}
+interface UpdateNodeInput {
+    name?: string;
+    scope?: NodeScope;
+    region?: string | null;
+    owner_policy?: NodeOwnerPolicy;
+}
+/** The stable lifecycle of one device target. Only the final three states are terminal. */
+type AgentTaskTargetStatus = 'queued' | 'dispatching' | 'running' | 'verifying' | 'blocked' | 'succeeded' | 'failed' | 'cancel_requested' | 'cancelled' | 'expired';
+/** A durable artifact or structured observation produced by an agent attempt. */
+interface AgentTaskEvidence {
+    kind: string;
+    label?: string | null;
+    uri?: string | null;
+    content_type?: string | null;
+    data?: unknown;
+}
+/** A user/policy gate that must be resolved before a target can continue. */
+interface AgentTaskBlocker {
+    code: string;
+    message: string;
+    approval_id?: string | null;
+    data?: unknown;
+}
+/** Stable target identity plus the current immutable attempt, if it has started. */
+interface AgentTaskTarget {
+    target_id: string;
+    device_id: string;
+    status: AgentTaskTargetStatus;
+    attempt_id?: string | null;
+    error?: string | null;
+    blocker?: AgentTaskBlocker | null;
+    evidence?: AgentTaskEvidence[];
+}
+interface AgentTaskSubmitInput {
+    agent: 'claude' | 'codex';
+    prompt: string;
+    device_ids: string[];
+    max_concurrency: number;
+    /** Defaults server-side to `device_standard_v1`; observe/privileged policies are not available to CLI agent tasks. */
+    policy_id?: 'device_standard_v1';
+}
+interface AgentTaskSubmitResult {
+    task_id: string;
+    targets: AgentTaskTarget[];
+}
+/** Current immutable attempt included when a target has an active attempt. */
+interface AgentTaskCurrentAttempt {
+    attempt_id: string;
+    attempt_no: number;
+    status: string;
+    accepted_at: string | null;
+    started_at: string | null;
+    finished_at: string | null;
+    result: Record<string, unknown> | null;
+    error: string | null;
+}
+/** Target shape returned by the durable AgentTask read endpoint. */
+interface AgentTaskReadTarget {
+    target_id: string;
+    device_id: string;
+    status: string;
+    result: Record<string, unknown> | null;
+    error: string | null;
+    blocker: string | null;
+    evidence: Record<string, unknown> | null;
+    current_attempt: AgentTaskCurrentAttempt | null;
+}
+/** Full durable AgentTask snapshot used to restore state after reload. */
+interface AgentTaskReadResult {
+    task_id: string;
+    status: string;
+    agent: string;
+    prompt: string;
+    policy_id: string;
+    max_concurrency: number;
+    targets: AgentTaskReadTarget[];
+}
+/** Cursor-ordered v2 event retained by the generic execution stream ledger. */
+interface AgentTaskEvent {
+    cursor: number;
+    run_id: string;
+    target_id?: string;
+    attempt_id?: string;
+    device_id?: string;
+    node_seq?: number;
+    kind: string;
+    payload: Record<string, unknown>;
+    created_at: string;
+}
+interface AgentTaskEventsResult {
+    events: AgentTaskEvent[];
+    next_cursor?: number;
+    has_more?: boolean;
+}
+type ClusterMode = {
+    type: 'broadcast';
+} | {
+    type: 'mirror';
+    leader: string;
+};
+interface Cluster {
+    id: string;
+    name: string;
+    description: string | null;
+    device_ids: string[];
+    default_mode: ClusterMode | Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+}
+interface CreateClusterInput {
+    name: string;
+    description?: string | null;
+    device_ids: string[];
+    default_mode?: ClusterMode;
+}
+interface ScriptSummary {
+    id: string;
+    name: string;
+    description?: string;
+    platform?: string;
+    icon_url?: string;
+    cover_url?: string;
+    visibility?: 'user' | 'project' | 'system';
+    updated_at: string;
+}
+/** 结构化脚本参数定义。存进 `Script.variables.__schema__`(JSONB,后端透传,
+ *  无校验)。无 `__schema__` 的旧脚本由 `variablesToSchema` 降级为一组 text 字段。 */
+interface ScriptParam {
+    /** 参数键(脚本代码里读取的名字)。 */
+    key: string;
+    /** 展示标签;缺省用 key。 */
+    label?: string;
+    /** 控件类型。 */
+    type: 'text' | 'textarea' | 'number' | 'select' | 'boolean';
+    /** 默认值(字符串化存储)。 */
+    default?: string;
+    /** type==='select' 时的候选项。 */
+    options?: string[];
+    /** 创建任务时是否提供「随机取值」开关(仅文本类有意义)。 */
+    randomable?: boolean;
+    /** 标记为「目标字段」,全脚本唯一;创建任务时渲染为目标 textarea(每行一个目标)。 */
+    isTarget?: boolean;
+}
+interface Script {
+    id?: string;
+    name: string;
+    description?: string;
+    platform?: string;
+    language?: 'ts' | 'js';
+    code: string;
+    /** 动态参数;结构化形态为 `{ __schema__: ScriptParam[], <key>: <default>, ... }`。 */
+    variables?: Record<string, unknown>;
+    icon_url?: string;
+    cover_url?: string;
+    visibility?: 'user' | 'project' | 'system';
+    updated_at?: string;
+}
+/** Mirrors backend `CreateLocatorRequest` (backend/src/api/locators.rs) —
+ *  `platform` is REQUIRED server-side ("android" | "ios" | "macos" | "windows"). */
+interface CreateLocatorInput {
+    name: string;
+    strategy: string;
+    value: string;
+    platform: string;
+    element_label?: string;
+    project_id?: string;
+    visibility?: string;
+}
+interface Locator {
+    id: string;
+    name: string;
+    strategy: string;
+    value: string;
+    [key: string]: unknown;
+}
+interface FleetRunDeviceRow {
+    device_id: string;
+    status: string;
+    last_error?: string | null;
+    output?: string | null;
+}
+interface FleetRunDetail {
+    run_id: string;
+    status?: string | null;
+    devices?: FleetRunDeviceRow[];
+}
+/** serde externally-tagged `FleetMode` (backend/src/fleet/mode.rs):
+ *  unit variant as string, payload variants as single-key objects. */
+type FleetMode = 'Broadcast' | {
+    Mirror: {
+        leader: string;
+    };
+} | {
+    Sharded: {
+        strategy: unknown;
+    };
+};
+interface FleetRunSubmit {
+    script: Script;
+    mode?: FleetMode;
+    device_ids: string[];
+}
+/** Result of running a power-kind shortcut on ONE device. `result` is the raw
+ *  backend power JSON (e.g. `{ rebooted: true }`); `error` is set when the
+ *  per-device power call rejected. */
+interface PowerRunResult {
+    device_id: string;
+    ok: boolean;
+    result?: unknown;
+    error?: string;
+}
+/** Result of submitting + awaiting a script-kind shortcut as a Broadcast fleet
+ *  run. `detail` is the terminal (or last-polled) run state with per-device
+ *  status/output. `timedOut` = polling cap hit before all devices reached a
+ *  terminal status (the run keeps going server-side). */
+interface ShortcutRunResult {
+    run_id: string;
+    detail: FleetRunDetail;
+    timedOut: boolean;
+}
+interface TaskTarget {
+    device_id: string;
+    status: string;
+    result?: unknown;
+    error?: string | null;
+}
+interface TaskStatus {
+    task_id: string;
+    status: string;
+    targets: TaskTarget[];
+}
+/** Submit response for `POST /api/webhook/tasks` (also produced by `FlowRun`). */
+interface TaskSubmitResult {
+    task_id: string;
+    targets: {
+        device_id: string;
+        status: string;
+    }[];
+}
+interface TaskSummary {
+    task_id: string;
+    status: string;
+    source: string;
+    created_at: string;
+    updated_at: string;
+    total: number;
+    finished: number;
+    /** 提交时的参数(后端 `tasks.params` JSONB)。批次入队时含 `__batch__`/`__target__`,
+     *  供任务页按批次分组、展示目标子表(刷新/换端后仍可云同步重建)。 */
+    params?: Record<string, unknown>;
+}
+interface TaskEvent {
+    id: number;
+    task_id: string;
+    external_id: string | null;
+    kind: string;
+    step_index: number | null;
+    status: string | null;
+    data: unknown;
+    created_at: string;
+}
+interface TaskListFilter {
+    deviceId?: string;
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+interface TaskListResult {
+    tasks: TaskSummary[];
+    limit: number;
+    offset: number;
+}
+interface TaskEventsResult {
+    task_id: string;
+    events: TaskEvent[];
+    limit: number;
+    offset: number;
+}
+interface WebhookConfig {
+    id: string;
+    url: string;
+    events: string[];
+    enabled: boolean;
+}
+interface CreateWebhookInput {
+    id: string;
+    url: string;
+    secret: string;
+    events: string[];
+    enabled: boolean;
+}
+interface LlmTestResult {
+    ok: boolean;
+    base_url: string;
+    status: number | null;
+    latency_ms: number;
+    model: string | null;
+    models: string[];
+    error: string | null;
+}
+type Decimal = number | string;
+/** A provisionable version offered by the device-create wizard (slim; from the
+ *  active, admin-curated image catalog). No internal `image_tag` / urls. */
+interface ImageOption {
+    /** Concrete artifact id — pass as `ProvisionSpec.image_id` at provision. */
+    id: string;
+    platform: string;
+    version: string;
+    label: string;
+    rooted: boolean;
+    /** Container image tag (= node `nerdctl` repo:tag). Match against a node's
+     *  reported `installed_images` to show 已装/未装 and filter by node support. */
+    image_tag: string;
+}
+interface ImageArtifact {
+    id: string;
+    platform: string;
+    os_version: string;
+    rooted: boolean;
+    image_tag: string;
+    artifact_url: string | null;
+    sha256: string | null;
+    signature: string | null;
+    version: string;
+    size_bytes: number | null;
+    active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface ImageInput {
+    platform?: string;
+    os_version: string;
+    rooted?: boolean;
+    image_tag: string;
+    artifact_url?: string | null;
+    sha256?: string | null;
+    signature?: string | null;
+    version?: string;
+    size_bytes?: number | null;
+    active?: boolean;
+}
+interface DeviceRate {
+    id: string;
+    node_class: string;
+    tier: string;
+    rate_per_hour: Decimal;
+    currency: string;
+    active: boolean;
+    updated_at: string;
+}
+interface RateInput {
+    node_class: string;
+    tier: string;
+    rate_per_hour: number;
+    currency?: string;
+    active?: boolean;
+}
+interface BillingPlan {
+    id: string;
+    name: string;
+    kind: string;
+    tier: string;
+    period: string;
+    price: Decimal;
+    included_hours: Decimal | null;
+    overage_rate_per_hour: Decimal | null;
+    currency: string;
+    active: boolean;
+    updated_at: string;
+}
+interface PlanInput {
+    name: string;
+    kind: string;
+    tier: string;
+    period: string;
+    price: number;
+    included_hours?: number | null;
+    overage_rate_per_hour?: number | null;
+    currency?: string;
+    active?: boolean;
+}
+/** 计费用量会话记录(billing usage row)。注意:与 `core/device-session.ts`
+ *  的 `DeviceSession` 直连会话类**不是同一概念**,故此处用 `DeviceUsageSession`
+ *  命名以避免 barrel 重名冲突。 */
+interface DeviceUsageSession {
+    id: string;
+    project_id: string;
+    device_id: string;
+    node_class: string;
+    tier: string;
+    kind: string;
+    started_at: string;
+    ended_at: string | null;
+    billed_seconds: number | null;
+    gross_cost: Decimal | null;
+    currency: string;
+    status: string;
+}
+interface RebateLedgerRow {
+    id: string;
+    project_id: string;
+    session_id: string | null;
+    period: string;
+    gross: Decimal;
+    rebate_amount: Decimal;
+    currency: string;
+    status: string;
+    created_at: string;
+}
+/** 钱包流水一行(`account_balances` 记账,按 owner_user_id)。 */
+interface BalanceLedgerRow {
+    id: string;
+    owner_user_id: string;
+    kind: 'topup' | 'platform_session' | 'subscription' | 'own_node_daily' | 'adjust';
+    amount: Decimal;
+    ref: string;
+    balance_after: Decimal;
+    currency: string;
+    created_at: string;
+}
+/** `GET /api/billing/balance` — 当前钱包余额 + 最近流水。 */
+interface BalanceResp {
+    balance: Decimal;
+    currency: string;
+    recent: BalanceLedgerRow[];
+}
+/** 一条项目订阅(`GET /api/billing/subscriptions` 一行)。 */
+interface ProjectSubscription {
+    id: string;
+    project_id: string;
+    plan_id: string;
+    tier: string;
+    started_at: string;
+    expires_at: string;
+    /** 剩余小时(按时长套餐);包月/不计时为 null。 */
+    remaining_hours: Decimal | null;
+    bound_device_id: string | null;
+    status: string;
+    created_at: string;
+}
+/** 自有节点单日计费(`GET /api/billing/own-node-charges` 一行)。 */
+interface OwnNodeDailyCharge {
+    id: string;
+    owner_user_id: string;
+    day: string;
+    device_count: number;
+    billable: number;
+    blocks: number;
+    free_devices: number;
+    amount: Decimal;
+    currency: string;
+    created_at: string;
+    updated_at: string;
+}
+/** `POST /api/billing/subscriptions` 入参。`plan_id` 由调用方传入
+ *  (caller 套餐目录端点为 follow-up,spec §5.4)。 */
+interface SubscribeInput {
+    plan_id: string;
+    bound_device_id?: string;
+}
+/** `POST /api/admin/billing/balance/topup` 入参(admin 给指定用户钱包充值)。 */
+interface TopupInput {
+    owner_user_id: string;
+    amount: number;
+    note?: string;
+}
+/** 充值结果——返回新余额。 */
+interface TopupResult {
+    owner_user_id: string;
+    new_balance: Decimal;
+}
+/** 列表一行——无明文/hash,只含展示前缀与生命周期时间戳。 */
+interface ApiTokenRow {
+    id: string;
+    name: string;
+    /** 展示前缀(如 `aixpat_AbCdEf`),供列表识别。 */
+    token_prefix: string;
+    /** pin 到单项目时为该项目 id;null = 名下所有项目。 */
+    project_id: string | null;
+    last_used_at: string | null;
+    expires_at: string | null;
+    /** 非空 = 已撤销。 */
+    revoked_at: string | null;
+    created_at: string;
+}
+/** `POST /api/tokens` 入参。 */
+interface CreateTokenInput {
+    name: string;
+    project_id?: string;
+    expires_at?: string;
+}
+/** create / rotate 响应——`token` 明文仅此一次返回。 */
+interface CreatedToken {
+    id: string;
+    name: string;
+    /** 明文 PAT(`aixpat_…`),仅创建/轮换时返回一次。 */
+    token: string;
+    token_prefix: string;
+    project_id: string | null;
+    expires_at: string | null;
+}
+interface ShortcutParam {
+    key: string;
+    label: string;
+    type: 'text' | 'url' | 'number' | 'select' | 'boolean';
+    required?: boolean;
+    default?: unknown;
+    options?: string[];
+    placeholder?: string;
+}
+interface Shortcut {
+    id: string;
+    name: string;
+    icon?: string | null;
+    platform: 'android' | 'ios' | 'any';
+    visibility: 'system' | 'user';
+    owner_user_id?: string | null;
+    params: ShortcutParam[];
+    body: string;
+    language: string;
+    confirm: boolean;
+    sort_order: number;
+    /** `script` = device.* function script (run via fleet); `power` = lifecycle
+     *  action where `body` is a device power action (start/stop/reboot) called
+     *  on the backend, not a script. */
+    kind: 'script' | 'power';
+}
+/** Create/update payload (server forces visibility=user + owner=caller). */
+interface NewShortcut {
+    name: string;
+    icon?: string | null;
+    platform?: 'android' | 'ios' | 'any';
+    params?: ShortcutParam[];
+    body: string;
+    language?: string;
+    confirm?: boolean;
+    sort_order?: number;
+    kind?: 'script' | 'power';
+}
+/** An APKPure search hit (mirrors backend `apkpure::Candidate`). */
+interface AppCandidate {
+    package: string;
+    label: string | null;
+    icon_url: string | null;
+    banner_url: string | null;
+    version: string | null;
+    kind: 'apk' | 'xapk';
+}
+interface AppTemplateItemAndroid {
+    package: string;
+    version?: string;
+}
+interface AppTemplateItemIos {
+    bundle_id: string;
+    name?: string;
+}
+interface AppTemplate {
+    id: string;
+    name: string;
+    platform: 'android' | 'ios';
+    owner_user_id: string;
+    items: Array<AppTemplateItemAndroid | AppTemplateItemIos>;
+}
+interface NewAppTemplate {
+    name: string;
+    platform: 'android' | 'ios';
+    items: AppTemplate['items'];
+}
+interface IosLibraryApp {
+    bundle_id: string;
+    name: string;
+    version: string;
+    path?: string;
+}
+interface IosAccountState {
+    logged_in: boolean;
+    account?: {
+        name: string;
+        email: string;
+    };
+}
+interface IosLoginResult {
+    status: 'ok' | 'needs_2fa';
+    account?: {
+        name: string;
+        email: string;
+    };
+}
+
+export type { FleetRunSubmit as $, AgentTaskTargetStatus as A, BalanceLedgerRow as B, CatalogBrand as C, DeviceRow as D, Cluster as E, ClusterMode as F, CreateClusterInput as G, CreateLocatorInput as H, CreateProjectInput as I, CreateProjectResult as J, CreateTokenInput as K, CreateWebhookInput as L, CreatedToken as M, NodeRow as N, DeveloperRef as O, ProvisionSpec as P, DeviceLocation as Q, DeviceOp as R, Script as S, DeviceProfileView as T, DeviceRate as U, DeviceUsageSession as V, DiscoveredStatus as W, ElementNode as X, FleetMode as Y, FleetRunDetail as Z, FleetRunDeviceRow as _, ProvisionResult as a, VerifyCodeResult as a$, ImageArtifact as a0, ImageInput as a1, ImageOption as a2, InstallAntiDetectResult as a3, IosAccountState as a4, IosDeviceRow as a5, IosLibraryApp as a6, IosLoginResult as a7, IosScanResult as a8, KnownDeviceOpName as a9, ProxyUrl as aA, RateInput as aB, RebateLedgerRow as aC, RecycledDeviceRow as aD, RegisterNodeInput as aE, RegisterNodeResult as aF, ScreenshotResult as aG, SendCodeResult as aH, SetDataRootResult as aI, SetDisguiseResult as aJ, SetProfileResult as aK, Shortcut as aL, ShortcutParam as aM, ShortcutRunResult as aN, SubscribeInput as aO, TaskEvent as aP, TaskEventsResult as aQ, TaskListFilter as aR, TaskListResult as aS, TaskStatus as aT, TaskSubmitResult as aU, TaskSummary as aV, TaskTarget as aW, TopupInput as aX, TopupResult as aY, UpdateNodeInput as aZ, User as a_, LlmTestResult as aa, Locator as ab, MdnsEntry as ac, NewAppTemplate as ad, NewShortcut as ae, NodeEffectiveCaps as af, NodeOwnerPolicy as ag, NodeScope as ah, OwnNodeDailyCharge as ai, PlanInput as aj, PlatformOem as ak, PlatformOemInput as al, PowerAction as am, PowerRunResult as an, ProfileOverrides as ao, Project as ap, ProjectSubscription as aq, ProjectUserResult as ar, ProvisionUserInput as as, ProvisionUserResult as at, ProxyApplyReceipt as au, ProxyApplyStatus as av, ProxyPatchResult as aw, ProxyProbe as ax, ProxyProbeErrorCode as ay, ProxySummary as az, DiscoveredDevice as b, WebhookConfig as b0, AgentTaskTarget as c, AgentTaskBlocker as d, AgentTaskEvidence as e, ScriptSummary as f, Decimal as g, ScriptParam as h, AdbScanResult as i, AgentTaskCurrentAttempt as j, AgentTaskEvent as k, AgentTaskEventsResult as l, AgentTaskReadResult as m, AgentTaskReadTarget as n, AgentTaskSubmitInput as o, AgentTaskSubmitResult as p, ApiTokenRow as q, AppCandidate as r, AppEntry as s, AppTemplate as t, AppTemplateItemAndroid as u, AppTemplateItemIos as v, AuthResult as w, BalanceResp as x, BillingPlan as y, CatalogModel as z };