IsolateGlobals and SmartApp

interface IsolateGlobals {
  definition: SmartAppDefinition;
  preferences: SmartAppPreferences;
  installed?: () => void | Promise<void>;
  updated?: () => void | Promise<void>;
  uninstalled?: () => void | Promise<void>;
  // Operator-invoked "run now" / test-fire. Fired by
  // SmartAppManager.runSmartAppInstance — wired to the Run button in
  // the admin UI. Subscriptions and the runner's running state are
  // left alone; this is purely a synchronous one-shot dispatch of
  // whatever the smart app considers a manual run (e.g. SimpleRule
  // fires every configured action). Distinct from pause/resume, which
  // own the RUNNING/PAUSED lifecycle.
  run?: () => void | Promise<void>;
  // Mutable per-instance state. Injected from the runner before each handler
  // runs and copied back out + persisted after the handler returns (see
  // `SmartAppEngine.runHandler`). Survives restarts. Each smart app narrows
  // this via the second `SmartApp<Inputs, State>` type parameter.
  state: Record<string, unknown>;
}

type SmartApp<Inputs, State extends Record<string, unknown> = Record<string, unknown>> =
  Omit<IsolateGlobals, 'state'> & { state: State } & Inputs;