@phnx-labs/agents-cli 1.22.116 → 1.22.118

package/dist/lib/browser/types.d.ts

@@ -1,647 +0,0 @@
-import type { ArcNativeTabRef } from './drivers/arc.js';
-export type { ArcNativeTabRef } from './drivers/arc.js';
-export type BrowserType = 'chrome' | 'comet' | 'chromium' | 'brave' | 'edge' | 'arc' | 'firefox' | 'custom';
-/**
- * The transport backend a live browser connection uses (PHNX-2399).
- *   - `cdp` — Chrome DevTools Protocol (the existing path for all Chromium-family browsers).
- *   - `arc-native` — Apple Events via `osascript` (the native Arc path, no CDP port required).
- *   - `bidi` — WebDriver BiDi over a WebSocket (Firefox, PHNX-4043; Firefox 129+
- *     ships no CDP at all).
- *
- * Load-bearing: every action method on `BrowserService` that calls `conn.cdp.send()`
- * must check `conn.backend` and route to the native driver instead when it is
- * `arc-native` or `bidi`. Unsupported verbs throw `ArcNativeCapabilityError` /
- * `FirefoxCapabilityError`.
- */
-export type BackendKind = 'cdp' | 'arc-native' | 'bidi';
-/**
- * Stable native identity carried by an Arc profile declaration (PHNX-2399).
- * One agents-cli profile is one Arc Space: the Space already carries its Arc
- * profile (cookies, logins), so agents never learn a second "space" concept.
- */
-export interface ArcNativeProfileIdentity {
-    /** Arc's profile directory basename the Space belongs to. Authoritative id. */
-    profileId: string;
-    /** Display-only Arc profile name from Local State. Never used for addressing. */
-    profileName: string;
-    /** Stable Space id used for every native operation. */
-    spaceId: string;
-    /** Display-only Space title. */
-    spaceTitle: string;
-}
-/** A crash-safe native create intent persisted before Arc is asked to mutate. */
-export interface ArcNativeCreateIntent {
-    tabId: string;
-    markerUrl: string;
-    targetUrl: string;
-    createdAt: number;
-    /** Active tab before creation, restored only if the owned tab stayed active. */
-    previousTabId?: string;
-    /** Written immediately after the driver returns, before final navigation. */
-    ref?: ArcNativeTabRef;
-}
-/** Durable Arc state owned by one browser task. */
-export interface ArcNativeTaskState {
-    profileId: string;
-    /** Original Arc window id. A tab moved elsewhere is never adopted. */
-    windowId: string;
-    spaceId: string;
-    /** Display-only snapshot for status output. */
-    spaceTitle: string;
-    tabs: Record<string, ArcNativeTabRef>;
-    createIntents?: Record<string, ArcNativeCreateIntent>;
-}
-/**
- * The user-facing name of a profile — what `agents browser profiles list`
- * prints and what `--profile <name>` takes. ALWAYS bare: it never carries an
- * `@<endpoint>` suffix or a `.<fork>` suffix. `BrowserProfile.name` is one.
- */
-export type ProfileName = string;
-/**
- * The key of an endpoint preset within a profile (`endpoint-0`, `local`, …) —
- * see {@link EndpointPreset} and `getEndpointPresets`.
- */
-export type EndpointName = string;
-/**
- * The RUNTIME key a live browser is registered under: `<profile>@<endpoint>`,
- * plus an optional `.<n>` fork suffix for Electron forks. It keys
- * `BrowserService.connections`, the profile's runtime dir, its `tasks.json`,
- * and its capture dirs — so one YAML profile can run at several endpoints
- * concurrently without colliding on disk.
- *
- * It is BRANDED on purpose. Before RUSH-2709 both this and a {@link ProfileName}
- * were bare `string`s and `start()` overwrote `BrowserProfile.name` with the
- * composite, so a connection key leaked into every user-facing listing and six
- * consumers each invented their own rule for turning one back into the other.
- * The brand makes `connections.get(someProfileName)` — the exact miss behind
- * `status --profile comet-local` returning EMPTY for a live
- * `comet-local@endpoint-0` — a compile error. Build one ONLY with
- * {@link connectionKey} (deriving) or {@link asConnectionKey} (adopting a name
- * that is already a runtime key, e.g. a directory read off disk).
- */
-export type ConnectionKey = string & {
-    readonly __connectionKey: unique symbol;
-};
-/** The single site that derives a {@link ConnectionKey} from its two parts. */
-export declare function connectionKey(profile: ProfileName, endpoint: EndpointName): ConnectionKey;
-/**
- * Adopt a string that IS already a runtime key — a runtime directory name, a
- * `tasks.json` `profile` field, a fork key. Never use it to launder a bare
- * profile name into a key; use {@link connectionKey} for that.
- */
-export declare function asConnectionKey(raw: string): ConnectionKey;
-/**
- * Split a {@link ConnectionKey} back into its parts. The inverse of
- * {@link connectionKey}, and the ONE rule every consumer uses to decide whether
- * a runtime key belongs to a profile.
- *
- * Tolerates the legacy shape still on disk: a pre-composite key that is just
- * the bare profile name (`comet-local`).
- *
- * A key with no `@` is read as a WHOLE profile name, never as `<name>.<fork>`,
- * because nothing constrains a profile's name (`createProfile` checks only for
- * a duplicate name and a port collision). Reading the trailing digits as a fork
- * would let `stop --profile chrome` claim the runtime dirs of a separate
- * profile named `chrome.2` and kill its browser. A fork is only ever created
- * from a composite base (`forkElectronProfile` appends to a `<p>@<e>` key), so
- * the `@`-bearing branch below is the one that must understand forks.
- */
-export declare function parseConnectionKey(key: string): {
-    profile: ProfileName;
-    endpoint?: EndpointName;
-    fork?: number;
-};
-/** True when `key` is a runtime key of `profile`. The only reconciliation rule. */
-export declare function keyBelongsToProfile(key: string, profile: ProfileName): boolean;
-/**
- * A single named endpoint preset within a profile. Lets one profile cover
- * the local + remote variants of the same app (e.g. an Electron app on this
- * Mac vs. on a remote host) instead of forcing two parallel profiles.
- *
- * Per-endpoint overrides take precedence over profile-level fields.
- */
-export interface EndpointPreset {
-    /**
-     * CDP URL — `cdp://host:port` or `ssh://host?port=N`.
-     *
-     * For an SSH target whose remote is Windows, append `&os=windows` (e.g.
-     * `ssh://user@host?port=9222&os=windows`). The driver then speaks the
-     * Windows dialect (launch via WMI Win32_Process.Create so the browser
-     * survives the ssh session, teardown via Get-NetTCPConnection/Stop-Process)
-     * instead of the POSIX default. The query param is the single source of
-     * truth for remote-OS selection.
-     */
-    target: string;
-    /** Override the profile-level binary (e.g. a remote host has no local binary). */
-    binary?: string;
-    /** Override the profile-level targetFilter (Electron app builds may diverge). */
-    targetFilter?: string;
-}
-export interface BrowserProfile {
-    /**
-     * The user-facing profile name, ALWAYS bare — never `name@endpoint`. The
-     * runtime key that carries the endpoint is a separate value
-     * ({@link ConnectionKey}); nothing may write one here.
-     */
-    name: ProfileName;
-    description?: string;
-    browser: BrowserType;
-    binary?: string;
-    electron?: boolean;
-    /**
-     * `url:<substring>` or `title:<substring>`. Picks which CDP page target
-     * represents the visible UI for Electron apps with multiple WebContents.
-     */
-    targetFilter?: string;
-    /**
-     * Endpoint presets. Accepts two shapes for backward compatibility:
-     *   - Legacy: `string[]` of CDP URLs; first entry is the default.
-     *   - New:    `{ [presetName]: EndpointPreset }`, with optional `defaultEndpoint`.
-     * Normalize via `resolveEndpoint(profile, name?)` instead of reading directly.
-     */
-    endpoints: string[] | Record<string, EndpointPreset>;
-    defaultEndpoint?: string;
-    /**
-     * How agents obtain a live browser for this profile (PHNX-3967):
-     *   - `launch` (default when absent): spawn the browser under a managed
-     *     `--user-data-dir` when nothing is serving CDP on the port.
-     *   - `attach-only`: NEVER spawn a rival window — attach to a browser the user
-     *     already started with remote debugging, else fail loud with a relaunch
-     *     hint. Arc is inherently attach-only; a canonical signed-in Comet uses it.
-     * Pairs with a durable {@link userDataDir}.
-     */
-    launchPolicy?: 'attach-only' | 'launch';
-    /**
-     * Absolute durable `--user-data-dir` for this profile (PHNX-3967). When absent,
-     * an attach-only profile resolves a default durable dir outside `.cache` so a
-     * one-time sign-in survives relaunch. The value the ownership guard compares a
-     * running instance against to reject a port-squatter. Resolve via
-     * `resolveProfileDataDir(profile)` rather than reading directly.
-     */
-    userDataDir?: string;
-    /** Chromium profile directory inside `userDataDir` for a discovered native profile (PHNX-4042). */
-    profileDirectory?: string;
-    chrome?: ChromeOptions;
-    secrets?: string;
-    viewport?: {
-        width: number;
-        height: number;
-        x?: number;
-        y?: number;
-    };
-    /** Directory holding source-side JSONL logs (e.g. ~/.rush/logs). */
-    logDir?: string;
-    /** Optional SSH host where logDir lives, e.g. "user@remote-host". */
-    logHost?: string;
-    /** Native Arc identity. Present only for an `arc-native:` profile. */
-    arc?: ArcNativeProfileIdentity;
-    /**
-     * The Firefox profile this agents-cli profile is pinned to (PHNX-4043).
-     * Present only for a `bidi:` profile discovered from `profiles.ini`; the
-     * directory itself is {@link userDataDir}, which is what Firefox is launched
-     * with (`--profile <dir>`).
-     */
-    firefox?: FirefoxProfileIdentity;
-}
-/**
- * Stable identity of a Firefox profile discovered from `profiles.ini` (PHNX-4043).
- * One agents-cli profile is one Firefox profile: it already carries the cookies
- * and logins, so agents never learn a second concept.
- */
-export interface FirefoxProfileIdentity {
-    /** The `Name=` of the `[ProfileN]` section. Display + slug source only. */
-    profileName: string;
-    /** The `profiles.ini` the entry was read from. Display only. */
-    iniPath: string;
-    /** Whether `profiles.ini` marks the entry `Default=1`. Display only. */
-    isDefault: boolean;
-}
-/** Parsed form of `BrowserProfile.targetFilter`. */
-export interface TargetFilter {
-    kind: 'url' | 'title';
-    value: string;
-}
-export interface ChromeOptions {
-    headless?: boolean;
-    args?: string[];
-    viewport?: {
-        width: number;
-        height: number;
-        x?: number;
-        y?: number;
-    };
-    /** The browser's own user-data dir; set only for a discovered native profile (PHNX-4042). */
-    userDataDir?: string;
-    /** Chromium profile directory inside `userDataDir` (`Default`, `Profile 1`, ...). */
-    profileDirectory?: string;
-}
-export interface Task {
-    id: string;
-    /**
-     * Unique addressable handle used as the tasks map key, capture-dir name, and
-     * the value agents export as `$AGENTS_BROWSER_TASK`. Prefer the short `id`
-     * for auto-generated tasks; an explicit `--task` name still wins.
-     */
-    name: string;
-    /**
-     * Human-readable label for `browser status`. Derived once from `--title`,
-     * else the first navigated host, else `untitled`. Distinct from `name` so a
-     * short machine id can stay addressable while status stays readable.
-     */
-    label?: string;
-    /**
-     * The RUNTIME key of the browser this task lives on (`<profile>@<endpoint>`),
-     * not the bare profile name — it addresses the runtime dir this task's
-     * `tasks.json` and captures are written under. Use
-     * {@link parseConnectionKey} to get the user-facing name out of it.
-     */
-    profile: ConnectionKey;
-    /** shortId -> CDP target id, or native tab id mirrored from arcNative.tabs. */
-    tabs: Record<string, string>;
-    /**
-     * Tabs this task DRIVES but did not create, by shortId — a tab that already
-     * existed in the browser and was reused because the browser cannot open new
-     * ones (legacy CDP Arc is one example). Every close path
-     * skips these: the task never opened the tab, so closing it on `done` would
-     * take away something that was there first. Same rule `adoptTabShowing`
-     * states for unowned pages, kept when reuse is unavoidable rather than
-     * optional.
-     */
-    borrowedTabs?: string[];
-    currentTabId?: string;
-    createdAt: number;
-    /**
-     * When this task last did anything. Stamped at creation (equal to
-     * `createdAt`) and refreshed by every task-scoped action, because every one
-     * of them resolves the task through `BrowserService.findTask`.
-     *
-     * Read by the idle half of the abandoned-task reaper (`hygiene.ts`): a task
-     * nobody has driven for `idleMs` is stopped so its tabs stop piling up in the
-     * profile window (RUSH-2622).
-     *
-     * Persisted in tasks.json. Tasks written before RUSH-2622 carry none;
-     * `loadTaskState` normalizes those to `createdAt` on read, so every task in
-     * memory has one and the reaper never has to guess.
-     */
-    lastActionAt: number;
-    pid: number;
-    /**
-     * Resolved actor id (`resolveActor().id`) stamped at task start — WHO launched
-     * this browser task (a person/agent identity, stable across runs). Forwarded
-     * from the caller over IPC — the daemon is shared, so it cannot resolve the
-     * caller's actor itself. Optional: tasks persisted before RUSH-2020 carry none.
-     */
-    owner?: string;
-    /**
-     * The caller's per-run launch id (`$AGENT_LAUNCH_ID`, minted by exec.ts for
-     * every harness) stamped at task start — WHICH run created this task. Distinct
-     * from `owner`: two runs by the same actor get different launchIds, which is
-     * the scope the current-task default and `status --mine` filter on. Forwarded
-     * from the caller over IPC. Optional: tasks from before this shipped carry none.
-     */
-    launchId?: string;
-    /**
-     * The agent session that started this task (`$AGENT_SESSION_ID`), forwarded
-     * from the caller at `start`. The durable copy lives in the `browser_sessions`
-     * table, which survives `stop`; this in-memory/tasks.json copy is the live one
-     * (RUSH-2549).
-     */
-    sessionId?: string;
-    /**
-     * Per-tab snapshot of the last ref listing captured for that tab
-     * (shortId -> {descriptors, opts}). Persisted to tasks.json so a later
-     * `click`/`type <ref>` can self-heal a drifted ref — the cached `opts` let
-     * the action rebuild its node map with the SAME accessibility filter the
-     * listing was numbered against. Owned by `refs()`; actions never overwrite
-     * it. See RefSnapshot / RefDescriptor.
-     */
-    refDescriptors?: Record<string, import('./refs.js').RefSnapshot>;
-    /** Durable stable native ids and crash-intent ledger for an Arc task. */
-    arcNative?: ArcNativeTaskState;
-}
-export interface TabInfo {
-    id: string;
-    url: string;
-    title: string;
-    task: string;
-    /** Whether this is the task's current tab (the one URL-less verbs act on). */
-    current?: boolean;
-}
-/**
- * One row of `agents browser tabs --all`: a top-level tab open in the profile's
- * browser. Owned by an agents-cli task → `task` names it and `id` is that
- * task's short tab id; otherwise (the owner's own tab, or a tab from another
- * tool) `task` is absent and `id` is the browser's own tab id.
- */
-export interface ProfileTabInfo {
-    id: string;
-    url: string;
-    title: string;
-    task?: string;
-    /** The queried task's current tab. */
-    current?: boolean;
-}
-export interface ProfileStatus {
-    /**
-     * The BARE profile name — what the user passed to `--profile` and what
-     * `status` prints. The endpoint is reported separately in {@link endpoint};
-     * the raw runtime key (if a caller genuinely needs it) is {@link key}.
-     */
-    name: ProfileName;
-    /** Endpoint preset this browser is running at, when the key carries one. */
-    endpoint?: EndpointName;
-    /** The runtime key backing this status: `<profile>@<endpoint>[.<fork>]`. */
-    key?: ConnectionKey;
-    running: boolean;
-    port?: number;
-    pid?: number;
-    /** The port declared in the profile's first endpoint, when it differs from the running port. */
-    configuredPort?: number;
-    tasks: TaskStatus[];
-    /**
-     * Why this profile's live state could not be read, when it could not be.
-     *
-     * `status` is read-only, so one unreadable profile must not hide the others:
-     * the profile is still listed, with what is known from disk, and this says
-     * what is missing. Absent means the read succeeded — it is never set to paper
-     * over a failure that did not happen.
-     */
-    unavailable?: string;
-}
-export interface TaskStatus {
-    id: string;
-    name: string;
-    /** Human label for status tables; falls back to name when absent. */
-    label?: string;
-    tabCount: number;
-    currentTabId?: string;
-    createdAt: number;
-    endedAt?: number;
-    domains?: string[];
-    tabs?: Array<{
-        id: string;
-        url: string;
-        title?: string;
-        current?: boolean;
-        task?: string;
-    }>;
-    /**
-     * Why this task's live tabs could not be enumerated, when they could not be.
-     *
-     * Set together with an ABSENT {@link tabs} — the recorded {@link tabCount}
-     * still reports what the task owns on disk, but nothing claims those tabs are
-     * live, because that is exactly what could not be verified. An Arc tab moved
-     * to another window or Space is the case this exists for.
-     */
-    unavailable?: string;
-}
-export interface HistoricalTask {
-    id: string;
-    name: string;
-    profile: string;
-    createdAt: number;
-    endedAt: number;
-    domains: string[];
-    tabCount: number;
-    /** Actor id who launched the task (RUSH-2020); absent for pre-RUSH-2020 history. */
-    owner?: string;
-}
-/**
- * Why the reaper stopped a task. `session-dead` — the agent session (or run)
- * that started it is provably gone; `idle` — nothing has driven it for the
- * idle window. See `hygiene.ts`.
- */
-export type ReapReason = 'session-dead' | 'idle';
-/** One task the reaper stopped (or, under `dryRun`, would have stopped). */
-export interface ReapedTask {
-    task: string;
-    profile: string;
-    reason: ReapReason;
-}
-export interface ReapResult {
-    closed: ReapedTask[];
-    /** Tasks left alone this pass: still live, still inside the idle window, or recording. */
-    skipped: number;
-}
-export type IPCAction = 'start' | 'show' | 'gc' | 'record-start' | 'record-stop' | 'done' | 'stop' | 'status' | 'history' | 'navigate' | 'tab-add' | 'tab-focus' | 'tab-close' | 'tab-list' | 'evaluate' | 'screenshot' | 'pdf' | 'refs' | 'click' | 'type' | 'press' | 'hover' | 'scroll' | 'set-viewport' | 'set-device' | 'console' | 'errors' | 'requests' | 'response-body' | 'wait' | 'set-download-path' | 'wait-download' | 'upload' | 'getAppLogs' | 'version' | 'request-self-update';
-export interface IPCRequest {
-    action: IPCAction;
-    task?: string;
-    taskName?: string;
-    /** tab-list: every tab open in the profile browser, not only the task's own. */
-    all?: boolean;
-    profile?: string;
-    url?: string;
-    tabId?: string;
-    expr?: string;
-    path?: string;
-    ref?: number;
-    atX?: number;
-    atY?: number;
-    text?: string;
-    key?: string;
-    scrollX?: number;
-    scrollY?: number;
-    scrollAtX?: number;
-    scrollAtY?: number;
-    interactive?: boolean;
-    limit?: number;
-    width?: number;
-    height?: number;
-    deviceName?: string;
-    mobile?: boolean;
-    deviceScaleFactor?: number;
-    level?: 'log' | 'info' | 'warn' | 'error';
-    clear?: boolean;
-    filter?: string;
-    urlPattern?: string;
-    maxChars?: number;
-    waitType?: 'time' | 'selector' | 'url' | 'function' | 'load';
-    waitValue?: string | number;
-    timeout?: number;
-    downloadPath?: string;
-    files?: string[];
-    trigger?: number;
-    uploadMode?: 'auto' | 'input' | 'drop' | 'chooser';
-    quality?: 'compressed' | 'raw';
-    endpoint?: string;
-    fps?: number;
-    duration?: number;
-    maxMb?: number;
-    source?: string;
-    lines?: number;
-    message?: string;
-    since?: string;
-    until?: string;
-    appLevel?: string;
-    skipDomainSkill?: boolean;
-    /**
-     * Explicit human label for a new task (`agents browser start --title …`).
-     * When omitted, the label is derived from the first navigated host.
-     */
-    title?: string;
-    /**
-     * Browser start: always open a new tab. Without it, `start --url` reclaims a
-     * tab that an ABANDONED task is still holding on this exact URL rather than
-     * opening a duplicate (RUSH-2622). A tab held by a live task, or one nobody's
-     * task owns (the user's own), is never taken either way — set this when the
-     * caller wants its own tab regardless.
-     */
-    fresh?: boolean;
-    idleMinutes?: number;
-    dryRun?: boolean;
-    actor?: string;
-    launchId?: string;
-    /**
-     * The calling agent session (`$AGENT_SESSION_ID` / `$AGENTS_SESSION_ID`) —
-     * the id that answers "which agent drove this task" and the one persisted to
-     * `browser_sessions` (RUSH-2549).
-     *
-     * This is the primary identity, not a spare: `launchId` alone was the join
-     * key, and a fleet measurement found it present on only 2 of 5 live agent
-     * processes while a session id was on 5 of 5 — every agent reaching the
-     * browser carries one. It is the same env `stampProvenance()` already reads
-     * for `computer.action` events, so both tool surfaces key on one signal.
-     */
-    sessionId?: string;
-    /**
-     * True when the CLI process that issued this request was itself dispatched to
-     * this machine by a fleet `--device` hop.
-     *
-     * Stamped client-side for the same reason actor/launchId are — and
-     * additionally because the daemon may have been auto-started BY a fleet-remote
-     * CLI and inherited AGENTS_FLEET_REMOTE for its whole life (startDetached
-     * passes `env: opts.env ?? process.env`). The daemon's own env is therefore
-     * not a truthful signal about the CURRENT caller; only the request is.
-     */
-    fleetRemote?: boolean;
-    /**
-     * SERVER-INTERNAL, never trusted off the wire (PHNX-2399). When a page verb's
-     * `bindTask` implicitly CREATED the task and `start` already opened the URL,
-     * the daemon stamps the resulting {@link PageOpenResult} here so the handler
-     * reports that first open truthfully (adopt → created:false, Arc/Electron
-     * reuse → created:false, fresh tab → created:true) WITHOUT re-executing the
-     * URL. `bindTask` clears any client-supplied value before binding.
-     */
-    firstOpen?: PageOpenResult;
-}
-/**
- * The outcome of opening/showing a URL on a task tab (PHNX-2399): the ONE shared
- * shape `navigate` / `tab add` / `start`'s first-open all report, so no surface
- * has to re-derive created/refreshed from ad-hoc booleans.
- *   - `created`   — a NEW page target was opened.
- *   - `refreshed` — an existing OWNED tab showing this URL was reloaded in place.
- *   - neither     — an existing tab was reused as-is (adopted abandoned tab, or
- *                   navigated the current tab to a different URL).
- * `created` and `refreshed` are mutually exclusive.
- */
-export interface PageOpenResult {
-    tabId?: string;
-    created: boolean;
-    refreshed: boolean;
-    message?: string;
-}
-export interface IPCResponse {
-    ok: boolean;
-    error?: string;
-    task?: string;
-    tabId?: string;
-    /**
-     * navigate / tab-add: whether this action OPENED a new page target (true) or
-     * acted on an existing owned tab (false). A same-task reopen — the requested
-     * URL was already live in one of the task's own tabs — reports `created: false`
-     * with `refreshed: true`, so the caller can say "opened" vs "refreshed" honestly.
-     */
-    created?: boolean;
-    /**
-     * navigate / tab-add: the requested URL was already open in an owned tab, so
-     * that SAME tab was reloaded in place (same tabId) rather than a duplicate
-     * opened. Mutually exclusive with `created: true`.
-     */
-    refreshed?: boolean;
-    /**
-     * start: a same-name retry matched an existing task and REUSED it (task-level,
-     * distinct from the page-level `created`/`refreshed`). A no-URL retry is
-     * `reused: true` with `refreshed: undefined` — it did no page operation, so it
-     * must NOT read as a refresh (PHNX-2399).
-     */
-    reused?: boolean;
-    windowTargetId?: string;
-    /** `tab-list` rows; `task` is absent for a tab no agents-cli task owns (`--all`). */
-    tabs?: ProfileTabInfo[];
-    profiles?: ProfileStatus[];
-    history?: HistoricalTask[];
-    /** `gc`: what the abandoned-task reaper closed (or would close under dryRun). */
-    reaped?: ReapResult;
-    result?: unknown;
-    path?: string;
-    bytes?: number;
-    width?: number;
-    height?: number;
-    refs?: string;
-    nodes?: RefNodeJson[];
-    /** Human-readable note surfaced to the CLI (e.g. a self-heal notice on click). */
-    message?: string;
-    port?: number;
-    pid?: number;
-    fps?: number;
-    durationCapSec?: number;
-    maxMb?: number;
-    durationMs?: number;
-    stopReason?: 'manual' | 'duration-cap' | 'size-cap';
-    logs?: ConsoleEntry[];
-    errors?: ErrorEntry[];
-    requests?: NetworkRequest[];
-    body?: string;
-    downloadPath?: string;
-    devices?: string[];
-    uploadMode?: 'input' | 'drop' | 'chooser';
-    appLogs?: any[];
-    version?: string;
-    selfUpdateTriggered?: boolean;
-    reason?: string;
-    skill?: {
-        name: string;
-        path: string;
-        content: string;
-        hostname: string;
-    };
-}
-export interface ConsoleEntry {
-    level: 'log' | 'info' | 'warn' | 'error';
-    text: string;
-    timestamp: number;
-    url?: string;
-    line?: number;
-}
-export interface ErrorEntry {
-    message: string;
-    stack?: string;
-    timestamp: number;
-    url?: string;
-    line?: number;
-}
-export interface NetworkRequest {
-    id: string;
-    url: string;
-    method: string;
-    status?: number;
-    mimeType?: string;
-    timestamp: number;
-}
-export interface RefNodeJson {
-    ref: number;
-    role: string;
-    name: string;
-    attrs: string[];
-    editor?: string;
-}
-export interface DeviceDescriptor {
-    width: number;
-    height: number;
-    deviceScaleFactor: number;
-    mobile: boolean;
-}
-export declare function isValidTaskId(id: string): boolean;
-export declare function generateTaskId(): string;
-export declare function generateShortId(): string;