feat: call AI streamtools manually

[YousefED]

This PR exposes low-level functionality to apply operations (add / update / delete blocks) suggested by an LLM to the editor manually.

This makes it possible to completely offload LLM invocation to the client application. The client application can then (based on an LLM response), manually invoke the applicable StreamTools.

Demo @ https://blocknote-git-feature-call-streamtools-manually-typecell.vercel.app/ai/manual-execution (view example source)

Future work
Note that this will not integrate with the BlockNote AI UI components (UI toolbar) and is a very low-level way where the consumer will have full responsibility of setting up the LLM call (including prompts), and BlockNote only handles the "diffing" + display of document updates.

We'll also work on a more higher level abstraction that will make it easier to integrate BlockNote AI with custom backends. The proposed abstraction levels / integration points:

• Lowest level: invoke streamtools directly to apply updates to an editor
• Mid-level: an API that allows you to hook up your own backend / LLM integration to customize LLM requests (TBD)
• Highest level: current version of BlockNote AI: BlockNote handles everything including calling the LLM (which is called either directly or via a Proxy)

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
blocknote	✅ Ready (Inspect)	Visit Preview	Jul 31, 2025 10:37am
blocknote-website	❌ Failed (Inspect)		Jul 31, 2025 10:37am

[pkg-pr-new]

Open in StackBlitz

@blocknote/ariakit

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/ariakit@1898

@blocknote/code-block

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/code-block@1898

@blocknote/core

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/core@1898

@blocknote/mantine

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/mantine@1898

@blocknote/react

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/react@1898

@blocknote/server-util

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/server-util@1898

@blocknote/shadcn

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/shadcn@1898

@blocknote/xl-ai

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-ai@1898

@blocknote/xl-docx-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-docx-exporter@1898

@blocknote/xl-email-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-email-exporter@1898

@blocknote/xl-multi-column

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-multi-column@1898

@blocknote/xl-odt-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-odt-exporter@1898

@blocknote/xl-pdf-exporter

npm i https://pkg.pr.new/TypeCellOS/BlockNote/@blocknote/xl-pdf-exporter@1898

commit: e152550

[nperez0111]

Should be noted that running this once, will close the stream, so you can't call it in a loop or anything (since the .execute method closes the writer once it is done).

imo, this is a bit unexpected, I'd expect to be able to apply multiple executeOne calls, but I see how this is overlapping with just a writer.write.