インフラであり、チャットボットではない。
機能ごとに専用ページがあります。まずクライアントと runtime — 他はこの組み合わせにぶら下がります。
Sveda の各面：JS クライアント、Rust runtime、stream プロトコル、MCP と tools、モデルカタログ、embed token、host SDK。
CLIENT
JS クライアント
@sveda-ai/core をインストール。SvedaClient は endpoint、header、tool を保持。session.send がターンを送る。ストリーミングは wire 上。
RUNTIME
Rust runtime
sveda-server は既定で 0.0.0.0:8787 にバインド。ループ、カタログ、tools、MCP を所有。ルート、認証、デプロイはあなたの責任。
STREAM
Stream プロトコル
トークン、tools、MCP、エラーは同じ SSE パイプ。クライアントは application/vnd.sveda.stream+json を要求。runtime は text/event-stream で応答。
TOOLS
MCP と tools
Backend tools は sveda-server 内。Frontend tools はブラウザ。Host MCP は embed token mint 時に渡す HTTP サーバー。
CATALOG
モデル
ChatGPT または Claude キー、または任意の Responses/Anthropic API。DeepSeek は builtin wrapper。フェイルオーバーはリストを順に試す。stream は再起動しない。
EMBED
Embed token
訪問者ごとにスコープ付き embed token を mint。ブラウザは host キーを保持しない。
HOST
Host SDK
ブラウザは SVEDA_EMBED_HOST_API_KEY を見ない。バックエンドが POST /sveda/embed/token を呼び、ページが JS チャットまたは iframe を開く。
重要なペアから始める。
@sveda-ai/core を入れる。sveda-server を :8787 で起動。embed トークンを mint し、session.send で最初の turn を送る。