feat(console-ai): split AI surfaces — agent-scoped /ai/:agent routing + launcher by xuyushun441-sys · Pull Request #1868 · objectstack-ai/objectui

xuyushun441-sys · 2026-06-21T15:44:41Z

Why

The two built-in assistants were mixed in one full-page surface behind a hidden, ?agent=-gated dropdown. The product owner found the combined chat/build surface confusing (Claude Code separates "chat" vs "code"; Airtable Omni keeps them distinct). This splits them into their own pages and fixes the known StrictMode deep-link bug where ?agent=metadata_assistant didn't activate on the dev server.

This is the objectui half of a Path A rename (metadata_assistant→build, data_chat→ask). It is written to work before, during, and after the cross-repo rename via an alias layer, so it can land independently. Framework + cloud rename + the agent_id data migration follow in separate PRs.

What

Canonical route is generic & agent-scoped: /ai/:agent and /ai/:agent/:conversationId. The active agent is derived from the path param (resolved against the live GET /ai/agents catalog) — the ?agent= query snapshot is gone (that's what StrictMode's double-mount + the /ai→/ai/:id rewrite used to drop).
New alias module (@object-ui/plugin-chatbot/agentAliases): friendly route names (build/ask) ↔ built-in ids, resolving to whichever the catalog actually serves. resolveDefaultAgentName is now alias-aware. Custom *.agent.ts agents route by their own name, unchanged.
Dropdown → launcher: navigates to /ai/:agent instead of toggling an in-surface mode; always available when >1 agent, lists custom agents naturally.
Back-compat redirects: bare /ai → default agent surface; /ai?agent=X → /ai/X; legacy built-in id (/ai/metadata_assistant) → friendly form (/ai/build); legacy bare /ai/:conversationId → /ai/:agent/:conversationId (resolved via the conversation's agentId).
Per-surface branding + starters: Build = authoring empty-state + build starters; Ask = data-query empty-state + data starters (alias-aware).
Conversations sidebar scoped to the active agent (lenient: never hides a null-agent or the currently-open conversation).
Per-agent conversation resolution fix: landing on /ai/:agent (or switching via the launcher) used to resume a scopeless / previous-agent conversation because useChatConversation resolved once per user. Now keyed per (user, scope), gated on the agent being known, with the URL-mirror guarded against the switch-transition race.
Home: "Build with AI" → /ai/build; added "Ask AI" → /ai/ask.
ConsoleLayout / FAB build-agent checks + labels made alias-aware (FAB binding per app is unchanged).
i18n (en/zh): ask/build labels, per-surface empty states, home.askAI.

Verification (live, against the local EE rig on :3100 — `data_chat` + `metadata_assistant`)

Acceptance	Result
(a) `/ai/build` opens Build directly, build starters, build→draft→Publish	✅ drafted `bug` object + Publish affordance
(b) `/ai/ask` opens the data assistant + data starters	✅
(c) `/ai/<custom>` generic routing	✅ via resolver (unit-tested; no custom agent on the rig)
(d) legacy `/ai`, `/ai?agent=…`, `/ai/:conversationId` redirect	✅ all canonicalize correctly
(e) FAB binds per app	✅ Studio→Build, simple_crm→Ask
(f) old names still resolve (alias) + conversations still appear	✅ + Ask/Build now resolve distinct convs; switch doesn't leak

Added 14 unit tests for the alias resolver (legacy + renamed catalogs, custom-agent, non-agent segments). Note: component test files can't run via direct vitest locally (@tailwindcss/postcss missing from node_modules — reproduces on main too); they run in CI.

Follow-ups (Path A, separate PRs)

framework service-ai: rename data_chat→ask (+ back-compat alias in the agent resolver / /agents/:name/chat); expose agentId on the conversation list+detail API (this rig's build omits it, so sidebar scoping + legacy-id agent resolution currently degrade gracefully to the default).
cloud service-ai-studio: rename metadata_assistant→build; update the Studio app defaultAgent.
one-time migration of ai_conversations.agent_id (+ ai_messages) old→new.

🤖 Generated with Claude Code

…i side) Split the two assistants into their own pages instead of mixing them in one surface behind a hidden dropdown. - Route the active agent in the path (/ai/:agent[/:conversationId]) and derive it from the param against the live catalog — drops the fragile ?agent= query snapshot (StrictMode double-mount used to lose it). - New agentAliases module: friendly route names (build/ask) <-> built-in ids, robust across the Path A rename (metadata_assistant->build, data_chat->ask) and legacy ids. resolveDefaultAgentName is alias-aware. - Dropdown becomes a launcher that navigates between agent surfaces; always available when >1 agent, lists custom agents naturally. - Back-compat redirects: bare /ai -> default agent; legacy /ai/:conversationId -> /ai/:agent/:conversationId (resolved via the conversation's agentId); legacy built-in id -> friendly form. - Per-surface empty-state branding + alias-aware per-agent starters. - Conversations sidebar scoped to the active agent (lenient on null/active). - Home: Build with AI -> /ai/build, add Ask AI -> /ai/ask. - ConsoleLayout/FAB build-agent checks + labels made alias-aware. - i18n: ask/build labels, per-surface empty states, home.askAI (en/zh). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

…witch Landing on /ai/:agent (or switching agents via the launcher) resumed a SCOPELESS / previous-agent conversation: - useChatConversation resolved once per USER, so a scope (agent) change kept the prior agent's conversation. Now keyed per (user, scope): an agent switch re-resolves under the new agent's cache; a same-scope re-render still short-circuits. Stale id is cleared before the async resolve so it can't be mirrored onto the new agent's URL. - The hook now exposes conversationScope (the scope the current id was resolved under); AiChatPage's URL-mirror only fires when it matches the active agent, blocking the switch-transition mirror race. - Gate userId on the resolved agent (AiChatPage + FAB) so the catalog-load window can't bind a scopeless conversation in the first place. Verified on the EE rig: /ai/ask and /ai/build resolve distinct convs, each surface resumes its own, and switching Ask→Build lands on the build conv. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

14 cases for agentAliases (agentRouteName / agentAliasGroup / resolveAgentParam / isBuildAgent / isAskAgent) and resolveDefaultAgentName, across legacy (data_chat/metadata_assistant) and renamed (ask/build) catalogs, plus custom-agent and non-agent (conversation-id) segments. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

vercel · 2026-06-21T15:44:47Z

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectui	Ignored		Jun 21, 2026 3:44pm

github-actions · 2026-06-21T15:48:22Z

✅ Console Performance Budget

Metric	Value	Budget
Main entry (gzip)	58.8 KB	350 KB
Entry file	`index-CcmDmRk7.js`	—
Status	PASS	—

📦 Bundle Size Report

Package	Size	Gzipped
app-shell (index.js)	5.95KB	2.10KB
app-shell (runtime-config.js)	4.72KB	1.69KB
app-shell (types.js)	0.01KB	0.04KB
auth (AuthContext.js)	0.31KB	0.24KB
auth (AuthGuard.js)	1.17KB	0.53KB
auth (AuthProvider.js)	17.16KB	3.44KB
auth (AuthShell.js)	3.49KB	1.40KB
auth (ForgotPasswordForm.js)	4.79KB	1.88KB
auth (LoginForm.js)	5.11KB	1.92KB
auth (PreviewBanner.js)	0.90KB	0.50KB
auth (RegisterForm.js)	6.63KB	2.15KB
auth (SocialSignInButtons.js)	8.89KB	3.61KB
auth (UserMenu.js)	3.40KB	1.22KB
auth (authStyles.js)	5.04KB	1.72KB
auth (createAuthClient.js)	24.74KB	6.00KB
auth (createAuthenticatedFetch.js)	3.33KB	1.32KB
auth (index.js)	1.75KB	0.76KB
auth (types.js)	0.59KB	0.35KB
auth (useAuth.js)	4.01KB	0.79KB
auth (useIsWorkspaceAdmin.js)	1.28KB	0.70KB
collaboration (CommentThread.js)	18.38KB	4.49KB
collaboration (LiveCursors.js)	3.17KB	1.27KB
collaboration (PresenceAvatars.js)	3.65KB	1.42KB
collaboration (PresenceProvider.js)	2.42KB	0.96KB
collaboration (index.js)	1.25KB	0.53KB
collaboration (useCommentSearch.js)	1.98KB	0.88KB
collaboration (useConflictResolution.js)	7.75KB	1.86KB
collaboration (useMentionNotifications.js)	1.81KB	0.68KB
collaboration (usePresence.js)	6.33KB	1.84KB
collaboration (useRealtimeSubscription.js)	7.91KB	2.01KB
components (index.js)	414.48KB	88.02KB
core (index.js)	1.48KB	0.54KB
create-plugin (index.js)	9.28KB	2.98KB
data-objectstack (index.js)	97.05KB	24.16KB
fields (index.js)	166.14KB	40.06KB
i18n (LocalizationContext.js)	1.76KB	0.96KB
i18n (currency.js)	1.22KB	0.64KB
i18n (i18n.js)	4.32KB	1.77KB
i18n (index.js)	2.46KB	0.96KB
i18n (pickLocalized.js)	1.31KB	0.67KB
i18n (provider.js)	5.37KB	1.72KB
i18n (useObjectLabel.js)	21.15KB	4.68KB
i18n (useSafeTranslation.js)	2.68KB	0.98KB
layout (index.js)	36.30KB	10.04KB
mobile (MobileProvider.js)	0.92KB	0.49KB
mobile (ResponsiveContainer.js)	0.94KB	0.38KB
mobile (breakpoints.js)	1.51KB	0.70KB
mobile (createOfflineDataSource.js)	5.61KB	1.74KB
mobile (index.js)	1.50KB	0.62KB
mobile (offlineQueue.js)	3.91KB	1.35KB
mobile (pwa.js)	0.97KB	0.49KB
mobile (serviceWorker.js)	1.48KB	0.62KB
mobile (serviceWorkerSource.js)	3.41KB	1.48KB
mobile (useBreakpoint.js)	1.54KB	0.65KB
mobile (useGesture.js)	4.42KB	1.27KB
mobile (useOfflineSync.js)	1.99KB	0.72KB
mobile (usePullToRefresh.js)	2.53KB	0.85KB
mobile (useResponsive.js)	0.71KB	0.42KB
mobile (useResponsiveConfig.js)	1.36KB	0.63KB
mobile (useSpecGesture.js)	1.77KB	0.77KB
mobile (useTouchTarget.js)	1.01KB	0.54KB
permissions (MePermissionsProvider.js)	4.87KB	1.77KB
permissions (PermissionContext.js)	0.31KB	0.25KB
permissions (PermissionGuard.js)	0.89KB	0.45KB
permissions (PermissionProvider.js)	3.11KB	0.87KB
permissions (evaluator.js)	4.00KB	1.23KB
permissions (index.js)	0.91KB	0.41KB
permissions (store.js)	0.91KB	0.42KB
permissions (useFieldPermissions.js)	1.28KB	0.52KB
permissions (usePermissions.js)	1.42KB	0.68KB
plugin-ai (index.js)	15.71KB	3.79KB
plugin-calendar (index.js)	45.98KB	12.65KB
plugin-charts (index.js)	42.55KB	12.00KB
plugin-chatbot (index.js)	141.66KB	34.76KB
plugin-dashboard (index.js)	104.31KB	25.91KB
plugin-designer (index.js)	213.42KB	42.94KB
plugin-detail (index.js)	195.59KB	47.19KB
plugin-editor (index.js)	2.38KB	1.06KB
plugin-form (index.js)	93.07KB	22.68KB
plugin-gantt (index.js)	122.48KB	30.19KB
plugin-grid (index.js)	114.67KB	30.78KB
plugin-kanban (index.js)	48.82KB	13.13KB
plugin-list (index.js)	93.15KB	21.90KB
plugin-map (index.js)	16.02KB	4.98KB
plugin-markdown (index.js)	13.58KB	4.64KB
plugin-report (index.js)	35.93KB	9.50KB
plugin-timeline (index.js)	25.37KB	7.20KB
plugin-view (index.js)	84.13KB	20.27KB
providers (DataSourceProvider.js)	0.75KB	0.39KB
providers (MetadataProvider.js)	1.37KB	0.59KB
providers (ThemeProvider.js)	1.55KB	0.67KB
providers (UploadProvider.js)	11.71KB	3.53KB
providers (index.js)	0.44KB	0.22KB
providers (types.js)	0.01KB	0.04KB
react (LazyPluginLoader.js)	3.77KB	1.33KB
react (SchemaRenderer.js)	15.64KB	5.08KB
react (index.js)	0.76KB	0.42KB
tenant (TenantContext.js)	0.31KB	0.25KB
tenant (TenantGuard.js)	1.04KB	0.43KB
tenant (TenantProvider.js)	2.76KB	0.98KB
tenant (TenantScopedQuery.js)	0.77KB	0.44KB
tenant (index.js)	0.75KB	0.38KB
tenant (resolver.js)	2.64KB	0.76KB
tenant (useTenant.js)	0.50KB	0.32KB
tenant (useTenantBranding.js)	0.62KB	0.39KB
types (ai.js)	0.20KB	0.17KB
types (api-types.js)	0.20KB	0.18KB
types (app.js)	2.87KB	0.99KB
types (base.js)	0.20KB	0.18KB
types (blocks.js)	0.20KB	0.18KB
types (complex.js)	0.20KB	0.18KB
types (crud.js)	0.20KB	0.18KB
types (data-display.js)	0.20KB	0.18KB
types (data-protocol.js)	0.20KB	0.19KB
types (data.js)	0.20KB	0.18KB
types (designer.js)	0.77KB	0.41KB
types (disclosure.js)	0.20KB	0.18KB
types (feedback.js)	0.20KB	0.18KB
types (field-types.js)	0.20KB	0.18KB
types (form.js)	0.20KB	0.18KB
types (index.js)	1.54KB	0.68KB
types (layout.js)	0.20KB	0.18KB
types (mobile.js)	0.20KB	0.18KB
types (navigation.js)	0.20KB	0.18KB
types (objectql.js)	0.20KB	0.18KB
types (overlay.js)	0.20KB	0.18KB
types (permissions.js)	0.20KB	0.18KB
types (plugin-scope.js)	0.20KB	0.18KB
types (record-components.js)	0.20KB	0.19KB
types (registry.js)	0.20KB	0.18KB
types (reports.js)	0.20KB	0.18KB
types (spec-report.js)	5.26KB	1.96KB
types (tenant.js)	0.20KB	0.18KB
types (theme.js)	0.20KB	0.18KB
types (ui-action.js)	0.75KB	0.46KB
types (views.js)	0.20KB	0.18KB
types (widget.js)	0.20KB	0.18KB

Size Limits

✅ Core packages should be < 50KB gzipped
✅ Component packages should be < 100KB gzipped
⚠️ Plugin packages should be < 150KB gzipped

hotlong and others added 3 commits June 21, 2026 23:08

github-actions Bot added plugin apps tests labels Jun 21, 2026

xuyushun441-sys mentioned this pull request Jun 21, 2026

feat(service-ai)!: rename data agent data_chat → ask (Path A) with back-compat alias objectstack-ai/objectstack#2144

Merged

xuyushun441-sys merged commit 4a714fc into main Jun 21, 2026
10 checks passed

xuyushun441-sys deleted the feat/ai-surface-split branch June 21, 2026 21:17

This was referenced Jun 22, 2026

feat(console-ai): post-build "What's next" checklist #1871

Merged

fix(console-ai): graceful handling when the build agent isn't deployed (routing + home CTA) #1873

Merged

feat(console-ai): reviewable "Proposed plan" card before build #1875

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(console-ai): split AI surfaces — agent-scoped /ai/:agent routing + launcher#1868

feat(console-ai): split AI surfaces — agent-scoped /ai/:agent routing + launcher#1868
xuyushun441-sys merged 3 commits into
mainfrom
feat/ai-surface-split

xuyushun441-sys commented Jun 21, 2026

Uh oh!

vercel Bot commented Jun 21, 2026

Uh oh!

github-actions Bot commented Jun 21, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

xuyushun441-sys commented Jun 21, 2026

Why

What

Verification (live, against the local EE rig on :3100 — data_chat + metadata_assistant)

Follow-ups (Path A, separate PRs)

Uh oh!

vercel Bot commented Jun 21, 2026

Uh oh!

github-actions Bot commented Jun 21, 2026

✅ Console Performance Budget

📦 Bundle Size Report

Size Limits

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Verification (live, against the local EE rig on :3100 — `data_chat` + `metadata_assistant`)