chaipro v0.4.2
Released 2026-10-09. Upgrading from v0.4.1.
A feature release. Block settings get a new form with collapsible groups, blocks can say how
deep they may be placed, an AI session can take over a page someone has open, and agents can
write blog posts and legal pages in Payload. Hosts that already own an apps table can rename
ChaiBuilder's tables in code.
Breaking
- ChaiBuilder branding is off by default. The "Learn more" docs link in the Add page dialog
and the console banner are hidden unless you set
features: { chaiBranding: true }. See Configuration. - Custom table names are set in code only. Build the schema with
chaipro/db/schema-factoryand pass it to the adapter'stablesoption, drizzle-kit and the Payload hook. Hosts on the default names need no change. See Database Setup. tableMappingtakes more. Entries can map column keys, andnulldeclares a column absent. Hosts with a customtableMappingshould re-check their keys.- New columns on
ai_page_edits:baseRevision,lastEditAt,endedAtandendedBy. Reads fall back when they are missing; add them to get the full AI handover. Generate a migration after upgrading.
Added
- A new block settings form. Grouped, collapsible object fields, plus rich text, link,
icon and visibility controls. Settings groups can nest one level, and
groupPropstakesdefaultOpen. The Image and Button blocks have grouped settings. See Custom Blocks. maxDepthon blocks.0keeps a block at the top level, so a Footer no longer nests into the current selection. ThelibraryGroupMaxDeptheditor prop sets limits per library group.- AI page handover. The person editing a page can hand it to an AI session, or be asked to. The page saves first and turns read-only for everyone, and a lock badge shows in the pages list. See MCP Server Setup.
- MCP tools for Payload content.
payloadContentMcpPluginlets agents list, read, draft, edit and publish documents in a drafts-enabled collection, withpayloadBlogMcpPluginandpayloadLegalMcpPluginpresets. Writes only save drafts, and publishing needsconfirmed: true. See MCP Server Setup. - Libraries panel: an Add button on block cards, and the selected group is remembered.
- "Publish with translation pages" is back, and the publish warning lists untranslated blocks.
CHAI_UNTRANSLATED_LINK_FALLBACKdecides where links to untranslated pages go:homefor the language home,noneto leave them unresolved. The default is unchanged. See Multilingual.
Changed
- Smaller page payloads to the browser, and block
pageDatano longer carriesglobal. - Streaming fallbacks receive the block's props.
- Theme font preloading covers up to four weights.
Security
- Payload content collections that are not scoped to a site are refused rather than served.
- Uploading to storage needs
assets:create, and deleting from storage is permission gated.
Fixed
- The site is resolved from the requested hostname on every request.
NEXT_PUBLIC_*values reach the browser at runtime.- A failed save stays unsaved and skips after-save hooks.
- A Button with a link renders as a single
<a>, and default link text no longer leaks intoaria-label. - Backspace in a canvas input no longer deletes the block.
*-screenand viewport height classes scale with the fit-to-width canvas.- The font selector no longer rewrites a theme font that is not registered.
- Creating a page with a
{{...}}slug is refused, and page style compile errors no longer return 500. - Publishing waits for the page's own global blocks.
- Asset files are deleted when the trash is emptied.
Upgrade notes
- Upgrade the package with
pnpm up chaipro@^0.4.2, then generate and apply a migration for the newai_page_editscolumns. - Want the ChaiBuilder links back? Set
features: { chaiBranding: true }. - Using a custom
tableMappingor table names? Move them to the schema factory and re-check the mapping keys.
Related
- chaipro v0.4.3 - the next release.
- chaipro v0.4.1 - the previous release.
- chaipro Changelog - all releases.

