SDKs

Embed Frontal with the official TypeScript SDK or integrate through its CLI and MCP interfaces.

Table of Contents

Shared model

The official SDK in this repository is the TypeScript package [`@frontal/sdk. It embeds the local Frontal CLI rather than calling a hosted HTTP API.

Option	Package or command	Best for
TypeScript SDK	`npm install @frontal/sdk`	Node.js applications and services
CLI	`npm install -g @frontal/cli`	Humans, scripts, and CI
MCP server	Expose a local Frontal engine to another MCP client over stdio.

Shared model

A thread is persisted conversation state.
A turn is one user request within a thread.
Items are structured results such as agent messages, reasoning summaries, command executions, file changes, MCP calls, web searches, and errors.
A stream is an async sequence of events emitted while a turn runs.

The SDK requires Node.js 18 or later. The package uses ES modules. Other languages can invoke the CLI or connect to the MCP server with their own wrapper.

更新于 2026年9月17日