@smooai/smooth-operator — the Lambda-native TypeScript client for the smooth-operator service.
Streaming agent turns, HITL resume, fully typed. One of five native SDKs over one schema-driven WebSocket protocol.
---
## What is this?
The **native TypeScript client** for the [smooth-operator](https://github.com/SmooAI/smooth-operator/blob/main/docs/PROTOCOL.md) WebSocket protocol — and the one the [smooai monorepo dogfoods](https://github.com/SmooAI/smooth-operator). It connects to a running smooth-operator **service** (create a session, send a message, stream the agent's events back) — not the agent engine itself. Types are **generated** from the language-neutral JSON Schemas in [`spec/`](https://github.com/SmooAI/smooth-operator/tree/main/spec) (and committed, so consumers don't need the generator), with an ergonomic layer — discriminated unions + type guards — on top. It's Lambda-native and transport-injectable, so it runs in a browser, on Node, or inside a Lambda handler unchanged.
---
## 30-second quickstart
```bash
pnpm add @smooai/smooth-operator
```
Requires Node ≥ 22, ESM only.
### One package, three subpath exports
`@smooai/smooth-operator` is the whole TypeScript SDK — install once, import the
layer you need. `react` / `react-dom` are **optional** peer deps (only the
`./react` subpath needs them), so a client-only or widget-only consumer never
pulls React into their bundle.
| Import | What |
| --- | --- |
| `@smooai/smooth-operator` | the protocol client (`SmoothAgentClient`, streaming turns, HITL) |
| `@smooai/smooth-operator/react` | React bindings — `useConversation` hook + `` (see [the guide](https://github.com/SmooAI/smooth-operator/blob/main/docs/Guides/React%20Components%20and%20Custom%20UIs.md)) |
| `@smooai/smooth-operator/react/styles.css` | default stylesheet for the React components |
| `@smooai/smooth-operator/widget` | the embeddable web-component chat widget (`mountChatWidget`, ``) |
| `@smooai/smooth-operator/widget/standalone` | the prebuilt IIFE bundle for a no-build `