useAppContext

useAppContext() is the primary runtime API for every hosted native surface. Import it from @sota/platform; it throws when no app surface provider is mounted.

TSX

import { useAppContext } from '@sota/platform';

export function RuntimeDetails() {
  const context = useAppContext();
  return (
    <dl>
      <dt>App</dt><dd>{context.appId}@{context.appVersion}</dd>
      <dt>Organization</dt><dd>{context.organizationId}</dd>
      <dt>Workspace</dt><dd>{context.workspaceId ?? 'none'}</dd>
      <dt>Surface</dt><dd>{context.surface}</dd>
    </dl>
  );
}

Field	Meaning
`appId`, `appVersion`	The current app package selected for this lane.
`organizationId`, `workspaceId`	Verified tenant context. `workspaceId` may be absent outside workspace scope.
`surface`	The current surface kind; use it for presentation differences, not authorization.
`theme`, `locale`, `t`	Current host presentation and localization.
`fetch`	The same scoped data-plane function returned by `useAppFetch`.
`lifecycle`	Mount-owned cancellation and cleanup primitives.
`ui`	Host UI actions such as toast, navigation, artifact, and lightbox.

Values are stamped from the server-resolved execution. Never reconstruct organization, workspace, app, or environment identity from URLs or local storage.