Skip to content

docs(adr): ADR-0057 — console AI chat is one system, docked (retire the FAB) - #2411

Merged
os-zhuang merged 1 commit into
mainfrom
worktree-chat-surface-fusion-adr
Jul 13, 2026
Merged

docs(adr): ADR-0057 — console AI chat is one system, docked (retire the FAB)#2411
os-zhuang merged 1 commit into
mainfrom
worktree-chat-surface-fusion-adr

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Adds objectui ADR-0057 — a decision doc (docs-only, no code) for consolidating the console's AI chat surfaces. Requested design review; implementation is tracked separately.

Why

The console renders AI chat through 3 parallel shells (ConsoleFloatingChatbot FAB / AiChatPage full-page / StudioAiCopilot left panel) over one backend, and the shells fork the conversation — the same app's build chat can exist as two disjoint threads. Plus two conversation-state layers, ~5 divergent surface→agent picks, and two enablement gates.

Decision (principle)

surface = view · conversation = model · product (ask/build) = binding axis. Not a merge of ask/build (cloud ADR-0063 already settled that) — console-layer consolidation only:

  • one (user, app, product) conversation context (drop the studio: scope fork)
  • one declarative surface→agent resolver (enforces ADR-0063; no roster representable)
  • canonical presentation = right-docked collapsible panel; the floating FAB retires to a launcher; full-page /ai = the same panel maximized (same thread)
  • runtime end-user apps keep the support bubble; presentation decoupled from state
  • single agent-catalog gate (useAiSurface); OSS degrades to MCP-only (cloud ADR-0025)

Two positions flagged for review (Decision section)

  1. Dock right (VS Code/Cursor idiom) → Studio reflows to [nav] [canvas+properties] [chat]
  2. ask→build handoff is an explicit "Open in Builder →" carrying context (not a silent re-route)

Tracking

🤖 Generated with Claude Code

…he FAB)
Console-layer realization of the two-agent, surface-bound model (cloud
ADR-0063): surfaces become views over one (user, app, product) conversation;
one declarative surface→agent resolver; canonical presentation is a
right-docked collapsible panel with the floating FAB retired to a launcher;
runtime end-user apps keep the support bubble; single agent-catalog gate
(useAiSurface); OSS degrades to MCP-only (cloud ADR-0025). No agent, boundary,
or commercial-model change.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 13, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredJul 13, 2026 4:22am

Request Review

@github-actionsgithub-actionsBot added the documentation Improvements or additions to documentation label Jul 13, 2026
@os-zhuang
os-zhuang merged commit b242ade into mainJul 13, 2026
4 checks passed
@os-zhuang
os-zhuang deleted the worktree-chat-surface-fusion-adr branch July 13, 2026 04:31
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@os-zhuang