# web-ai-sdk

> Building blocks for the Web's built-in AI APIs. Composable. No runtime deps. Just lifecycle, streaming, AbortSignals. Vanilla TypeScript by default, with optional React hooks.

Each package wraps one Built-in AI surface (Prompt, Summarizer, Translator, Detector, WebMCP) plus an optional `/react` adapter. The per-package READMEs (linked below) are the source of truth for the API surface; the docs site hosts hand-curated conceptual guides. Full README content is also available concatenated at [llms-full.txt](https://web-ai-sdk.dev/llms-full.txt).

## Packages

- [@web-ai-sdk/all](https://github.com/obetomuniz/web-ai-sdk/tree/main/packages/sdk#readme): One-install meta-package for every `@web-ai-sdk/*` building block: `prompt`, `summarizer`, `translator`, `detector`, and `webmcp`. Pulls each scoped package in as a regular dependency so consumers don't have to track them individually.
- [@web-ai-sdk/prompt](https://github.com/obetomuniz/web-ai-sdk/tree/main/packages/prompt#readme): Building block for the Web's Built-in [Prompt API](https://developer.chrome.com/docs/extensions/ai/prompt-api) (`LanguageModel`). One-shot `ask()` for embeds and widgets, plus a thin `createSession()` primitive (and React `useSession`) for chat-shaped apps that need independent per-conversation sessions and delta-shaped streaming. The wrapper smooths cross-browser quirks (delta-vs-cumulative chunks, output sanitization, abort wiring); UI state and conversation history are the consumer's concern.
- [@web-ai-sdk/webmcp](https://github.com/obetomuniz/web-ai-sdk/tree/main/packages/webmcp#readme): Building block for the W3C [WebMCP](https://webmachinelearning.github.io/webmcp/) API exposed at `navigator.modelContext`.
- [@web-ai-sdk/summarizer](https://github.com/obetomuniz/web-ai-sdk/tree/main/packages/summarizer#readme): Building block for the Web's Built-in [Summarizer API](https://developer.chrome.com/docs/ai/summarizer-api). Skeleton extraction, sentence-boundary trimming, streaming, and sessionStorage caching.
- [@web-ai-sdk/translator](https://github.com/obetomuniz/web-ai-sdk/tree/main/packages/translator#readme): Building block for the Web's Built-in [Translator API](https://developer.chrome.com/docs/ai/translator-api) (on-demand language packs). Block-level translation with inline placeholder serialization, casing restoration, and a snapshot-based restore.
- [@web-ai-sdk/detector](https://github.com/obetomuniz/web-ai-sdk/tree/main/packages/detector#readme): Building block for [the Web's Built-in Language Detector API](https://developer.chrome.com/docs/ai/language-detection). Detect the language of any text on-device, with confidence scores and a sorted list of alternates. Session reuse, pluggable result caching, AbortSignal-driven cleanup.

## Guides

- [Browser support](https://web-ai-sdk.dev/docs/browser-support/): which Chrome/Edge versions and flags each API needs.
- [Meta-package](https://web-ai-sdk.dev/docs/guides/meta-package/): `@web-ai-sdk/all` — subpath vs namespaced import shapes.
- [Prompt](https://web-ai-sdk.dev/docs/guides/prompt/): conceptual overview — sessions, streaming, sampling, structured output, abort.
- [WebMCP](https://web-ai-sdk.dev/docs/guides/webmcp/): registering tools with `navigator.modelContext`.
- [Summarizer](https://web-ai-sdk.dev/docs/guides/summarizer/): TL;DR / key-points / headline with streaming.
- [Translator](https://web-ai-sdk.dev/docs/guides/translator/): block-level DOM translation with snapshot restore.
- [Detector](https://web-ai-sdk.dev/docs/guides/detector/): on-device language detection with confidence.

## React adapters

- [usePrompt](https://web-ai-sdk.dev/docs/react/use-prompt/)
- [useSession](https://web-ai-sdk.dev/docs/react/use-session/)
- [useWebMCP](https://web-ai-sdk.dev/docs/react/use-web-mcp/)
- [useSummarizer](https://web-ai-sdk.dev/docs/react/use-summarizer/)
- [useTranslator](https://web-ai-sdk.dev/docs/react/use-translator/)
- [useDetector](https://web-ai-sdk.dev/docs/react/use-detector/)

## Optional

- [Source repository](https://github.com/obetomuniz/web-ai-sdk)
- [Full text of every README](https://web-ai-sdk.dev/llms-full.txt)