#useAiChat

#Import

1import { useAiChat } from "@alepha/ui/ai";

#Overview

The state and actions of an assistant conversation, without any UI: what <AiChat /> is built on, for an app that wants its own.

• send(message) starts a turn in the current conversation (a new one first), with the current route and the innermost useAiContext().
• A turn that pauses on a mutation sets pending; approve() or deny() answers it with the call id only, never the input: the server runs the input it stored.
• A turn that pauses on a client tool runs it here and resumes with its result, on its own: navigate (by page name, through the typed router), fillForm (only a form offered with useAiContext({ form }), never submitted), and any clientTools the app passes.
• open(id) loads a stored conversation; open() starts a new one.

Every action resolves a RunResult and never rejects, as useAction does.