Give your app access to ISPO's files, structured data, connectors, and host UI through one typed API. ISPO owns permissions; your app owns its experience.
The framework-free @ispo/sdk is the bridge between a project app and its host. @ispo/sdk/react adds providers and hooks over the same API.
Each bundle combines the relevant methods, authority, a checked example, failure behavior, and a verification checklist.
Every page has Markdown and Copy Markdown controls. Agents can start with the compact llms.txt index and fetch only the relevant pages.
Browse @ispo/sdk and @ispo/sdk/react, or search for a namespace, method, or type. The reference is generated from the package's public exports, types, and source comments each time this site is built. Supporting types documents types used by those APIs that are not separately exported from the package.
| Your app needs to… | SDK surface |
|---|---|
| Store structured application data | entities |
| Publish an artifact or open a file picker | files, picker |
| Work with a connected account | connectors |
| Show notifications or manage declared surfaces | ui |
| React to sleep and wake | lifecycle |
| Add host-facing commands and assistant context | commands, assistant |
Start from a project created in ISPO and use its supplied SDK dependency and local ispo-sdk skill. This repository's SDK is currently distributed with ISPO; these docs do not assume a public npm release. Match your app to the SDK bundled with your installed host.
The reference includes compatibility exports marked deprecated. For new work, use Entities for structured state and Files for user-visible artifacts. Keep credentials in ISPO Secrets or Connectors.