Skip to content

fix(plugin-chatbot): make AI-turn liveness real, not a fake clock - #1700

Merged
xuyushun441-sys merged 1 commit into
mainfrom
fix/chat-real-liveness
Jun 13, 2026
Merged

fix(plugin-chatbot): make AI-turn liveness real, not a fake clock#1700
xuyushun441-sys merged 1 commit into
mainfrom
fix/chat-real-liveness

Conversation

@xuyushun441-sys

Copy link
Copy Markdown
Contributor

Why

The elapsed counter shipped in #1699 ticked off a client-side setInterval — it kept counting up regardless of what the server was doing. If the connection dropped, it would happily keep showing "still working." That's reassurance-theater: it looks like liveness but proves nothing. (用户: "不能假装,要真的工作才对" — don't fake it, it has to actually work.)

What

Drive the indicator off real observed stream activity instead of a clock.

useChat (AI SDK v6) surfaces server bytes by mutating its message parts — a streamed token, a tool delta, or a data-build-progress update. We turn that into an honest signal:

  • useTurnLiveness(active, activityKey) — stamps the instant real data arrives (the activityKey changes) and measures seconds since the last byte. live means "the server genuinely sent us something in the last few seconds."
  • LivenessIndicator renders three states, each a real fact:
    • 🟢 receiving (emerald pulse + m:ss) — bytes arrived recently
    • waiting (muted) — request in flight, nothing back yet (pre-first-token). Never claims "receiving" when nothing has been received.
    • 🟠 stalled (amber + "no response for Ns") — genuinely silent past 6s — the honest "we haven't heard back" cue.
  • The build panel feeds its live progress (phase:done:items) as the activity key. A healthy build streams progress every few seconds → reads as receiving; a true stall flips to amber. A hard disconnect still surfaces via the existing error banner.

Honest limitation (follow-up)

During a genuinely silent-but-alive server stretch (e.g. an LLM call inside a tool that emits nothing for >6s), the client can only truthfully say "no response for Ns" — it cannot prove the socket is alive from the client alone. Proving "still connected" there requires a server-side SSE keep-alive heartbeat (encodeVercelDataStream in framework service-ai). This PR stops the lying; the heartbeat (separate, cross-repo) would let those quiet windows read green truthfully. Happy to do that next.

Verification

  • 71/71 unit tests. 4 new ones render the real component under fake timers and assert the honest behavior: pre-first-token shows a neutral wait (not a fake m:ss), a quiet stream escalates to amber "…Ns", a streaming build reads as receiving, and a stalled build flips amber then recovers on the next byte.
  • tsc --noEmit clean, vite build clean. New code is lint-clean (no Date.now()/ref reads during render).

Supersedes the clock-only behavior from #1699.

🤖 Generated with Claude Code

The elapsed counter from #1699 ticked off a client-side setInterval, so it
kept counting up even if the connection had dropped — falsely telling the
user "still working" when nothing was happening. That's exactly the
reassurance-theater we don't want.
Replace it with liveness derived from REAL observed stream activity:
- `useTurnLiveness(active, activityKey)` stamps the moment real data arrives
(a streamed token / tool delta / `data-build-progress` update mutates the
key) and measures seconds-since-last-byte. `live` is a genuine "the server
sent us something recently" signal, not a free clock.
- `LivenessIndicator` renders three honest states:
• receiving (emerald pulse + m:ss) — bytes arrived recently
• waiting (muted) — request in flight, nothing back yet
(pre-first-token; never claims
"receiving" when nothing received)
• stalled (amber + "no response for Ns") — genuinely silent past 6s
- Build panel feeds its real progress as the activity key, so a healthy
build (which streams progress every few seconds) reads as receiving and a
true stall flips to amber. A hard disconnect still surfaces via the error
banner.
Honest limitation (documented, follow-up): during a genuinely silent but
alive server stretch the client can only say "no response for Ns" — proving
"still connected" there needs a server-side SSE keep-alive heartbeat
(framework). This change stops the lying; the heartbeat would let the quiet
windows read green truthfully.
Tests: 71/71. Four new ones render the real component under fake timers and
assert the honest behavior — pre-first-token shows a neutral wait (not a
fake m:ss), a quiet stream escalates to amber "…Ns", a streaming build reads
as receiving, and a stalled build flips amber then recovers on the next byte.
Typecheck + build clean; new code is lint-clean (no Date.now()/refs in render).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercelBot commented Jun 13, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredJun 13, 2026 1:49pm

Request Review

@xuyushun441-sys
xuyushun441-sys merged commit 4f60995 into mainJun 13, 2026
10 checks passed
@xuyushun441-sys
xuyushun441-sys deleted the fix/chat-real-liveness branch June 13, 2026 13:49
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)113.8 KB350 KB
Entry fileindex-BkubFveR.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)5.95KB2.10KB
app-shell (runtime-config.js)4.40KB1.57KB
app-shell (types.js)0.01KB0.04KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)17.16KB3.44KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)4.79KB1.88KB
auth (LoginForm.js)5.11KB1.92KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.63KB2.15KB
auth (SocialSignInButtons.js)8.89KB3.61KB
auth (UserMenu.js)3.40KB1.22KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)24.74KB6.00KB
auth (createAuthenticatedFetch.js)3.33KB1.32KB
auth (index.js)1.75KB0.76KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)4.01KB0.79KB
auth (useIsWorkspaceAdmin.js)1.28KB0.70KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (PresenceProvider.js)2.42KB0.96KB
collaboration (index.js)1.25KB0.53KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)399.21KB84.50KB
core (index.js)1.45KB0.54KB
create-plugin (index.js)9.28KB2.98KB
data-objectstack (index.js)96.04KB23.89KB
fields (index.js)157.36KB37.46KB
i18n (i18n.js)4.32KB1.77KB
i18n (index.js)2.27KB0.91KB
i18n (provider.js)5.37KB1.72KB
i18n (useObjectLabel.js)19.40KB4.48KB
i18n (useSafeTranslation.js)1.63KB0.57KB
layout (index.js)36.05KB9.94KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.74KB
mobile (index.js)1.50KB0.62KB
mobile (offlineQueue.js)3.91KB1.35KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (serviceWorkerSource.js)3.41KB1.48KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)4.42KB1.27KB
mobile (useOfflineSync.js)1.99KB0.72KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)4.87KB1.77KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.11KB0.87KB
permissions (evaluator.js)4.00KB1.23KB
permissions (index.js)0.91KB0.41KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)1.42KB0.68KB
plugin-ai (index.js)15.71KB3.79KB
plugin-calendar (index.js)45.98KB12.65KB
plugin-charts (index.js)39.79KB11.29KB
plugin-chatbot (index.js)135.06KB33.04KB
plugin-dashboard (index.js)93.20KB22.36KB
plugin-designer (index.js)213.42KB42.94KB
plugin-detail (index.js)192.76KB46.42KB
plugin-editor (index.js)2.38KB1.06KB
plugin-form (index.js)89.69KB21.45KB
plugin-gantt (index.js)113.30KB27.68KB
plugin-grid (index.js)110.65KB29.79KB
plugin-kanban (index.js)48.82KB13.13KB
plugin-list (index.js)94.69KB22.11KB
plugin-map (index.js)16.02KB4.98KB
plugin-markdown (index.js)8.84KB2.83KB
plugin-report (index.js)34.79KB9.13KB
plugin-timeline (index.js)25.37KB7.20KB
plugin-view (index.js)81.53KB19.87KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
providers (UploadProvider.js)11.71KB3.53KB
providers (index.js)0.44KB0.22KB
providers (types.js)0.01KB0.04KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)14.98KB4.84KB
react (index.js)0.76KB0.42KB
tenant (TenantContext.js)0.31KB0.25KB
tenant (TenantGuard.js)1.04KB0.43KB
tenant (TenantProvider.js)2.76KB0.98KB
tenant (TenantScopedQuery.js)0.77KB0.44KB
tenant (index.js)0.75KB0.38KB
tenant (resolver.js)2.64KB0.76KB
tenant (useTenant.js)0.50KB0.32KB
tenant (useTenantBranding.js)0.62KB0.39KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.77KB0.41KB
types (disclosure.js)0.20KB0.18KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)1.54KB0.68KB
types (layout.js)0.20KB0.18KB
types (mobile.js)0.20KB0.18KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (spec-report.js)5.26KB1.96KB
types (tenant.js)0.20KB0.18KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)0.75KB0.46KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB

Size Limits

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

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@xuyushun441-sys@os-zhuang