Interface ImmediatelyRunGlobal

The sandbox runtime's pre-evaluation discovery global (§4).

interface ImmediatelyRunGlobal {
    appMountPath?: string;
    protocolVersion?: string;
    ready?: Promise<void>;
    region?: string;
    runtimeVersion?: string;
    transport?: unknown;
}

Properties

appMountPath?: string

Canonical /mnt/{hash} path of the app's own repo mount (FILE_SHARING §11.2); surfaced to apps via getAppMountPath(). Absent until the host reports it.

protocolVersion?: string

postMessage envelope/protocol version.

ready?: Promise<void>

Resolves when ports arrive, if they arrive async after register-frame.

region?: string

The chrome region this app instance occupies, e.g. "panel.agent" or "stage.conversation" (UI_AS_APPS_SPEC §4.1); surfaced via getRegion(). Absent for a standalone app, in local dev, or on a host that doesn't report it. Descriptive only — it grants nothing.

runtimeVersion?: string

Sandbox-runtime protocol version (semver).

transport?: unknown

The host channel the SDK talks over (MessagePort | message bus).