---
title: "useAppContext"
description: "useAppContext() は hosted native surface の中心 runtime API です。@sota/platform から import し、app surface provider の外では throw します。"
url: "https://sotaagents.ai/ja/manual/developer-guide/use-app-context"
generated_by: "sotaagents-ldp"
docs_index: "https://sotaagents.ai/manual/llms.txt"
locale: "ja"
---

# useAppContext

`useAppContext()` は hosted native surface の中心 runtime API です。`@sota/platform` から import し、app surface provider の外では throw します。

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 | 意味 |
| --- | --- |
| `appId`、`appVersion` | この lane に現在選択されている app package。 |
| `organizationId`、`workspaceId` | 検証済み tenant context。 |
| `surface` | 現在の surface kind。Authorization には使用しません。 |
| `theme`、`locale`、`t` | 現在の host presentation と localization。 |
| `fetch` | `useAppFetch` と同じ scoped data-plane function。 |
| `lifecycle` | Mount-owned cancellation と cleanup。 |
| `ui` | Toast、navigation、artifact、lightbox などの host action。 |

値は server-resolved execution から stamp されます。URL や local storage から identity を再構築しません。
