Restore custom Kapa chat with trigger-based support handoff by dannyneira · Pull Request #466 · warpdotdev/docs

dannyneira · 2026-08-04T15:09:39Z

Summary

restores the custom React-based Ask AI chat experience
adds trigger-based Create ticket handoff in the custom UI (conversation length >= 3, downvote, uncertainty)
stores and reuses Kapa thread IDs and builds a direct Kapa conversation link in the ticket draft
opens a prefilled mailto: handoff draft instead of relying on the prior server endpoint
re-enables required React/Kapa dependencies and adds PUBLIC_KAPA_PROJECT_ID env support

Validation

npm run typecheck
npm run build

Co-Authored-By: Warp Agent agent@warp.dev

Adds an always-on Create ticket action in the Kapa chat UI, includes transcript context in submissions, and provides a preview/webhook backend endpoint for handoff testing. Co-Authored-By: Oz <oz-agent@warp.dev>

Set the handoff endpoint to non-prerendered so static/SSR build inputs resolve correctly in CI and Vercel. Co-Authored-By: Oz <oz-agent@warp.dev>

Move the custom handoff POST route to /kapa-handoff and remove the stale /api/kapa-handoff file to avoid CI/Vercel SSR rollup conflicts with the /api docs page. Co-Authored-By: Oz <oz-agent@warp.dev>

Co-authored-by: Oz <oz-agent@warp.dev>

Co-Authored-By: Oz <oz-agent@warp.dev>

This reverts commit fd762df.

This reverts commit 93f73dd.

This reverts commit c805b22.

This reverts commit a6048d3.

Co-Authored-By: Oz <oz-agent@warp.dev>

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel · 2026-08-04T15:09:45Z

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

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview	Aug 11, 2026 8:02pm

Co-Authored-By: Warp Agent <agent@warp.dev>

oz-for-oss · 2026-08-08T00:09:55Z

@dannyneira

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

oz-for-oss

Overview

This PR restores the custom Kapa chat UI, adds a support handoff flow, updates Kapa-related environment configuration, and expands CSP allowances for the chat dependencies.

Concerns

The new /api/support-handoff route is public and forwards ticket-creation payloads without server-side abuse protection.
The route falls back to a hard-coded external endpoint, so missing configuration can still send user email and chat transcript data to an implicit destination.

Security

Public support ticket forwarding needs server-side bot/rate-limit protection or a validated challenge token before it is exposed.
User support data should only be forwarded to an explicitly configured endpoint.

Verdict

Found: 0 critical, 2 important, 0 suggestions

Request changes

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

oz-for-oss · 2026-08-08T00:14:41Z

+	return `https://app.kapa.ai/${kapaProjectId}/conversations/${kapaThreadId}`;
+}
+
+export const POST: APIRoute = async ({ request }) => {


⚠️ [IMPORTANT] [SECURITY] This public POST route forwards support-ticket payloads without bot protection, rate limiting, or a same-origin check, so anyone can script ticket creation with arbitrary email/transcript data. Require a server-validated Kapa/hCaptcha token or add rate limiting before forwarding.

oz-for-oss · 2026-08-08T00:14:41Z

+
+export const POST: APIRoute = async ({ request }) => {
+	const supportHandoffEndpointUrl =
+		SUPPORT_HANDOFF_ENDPOINT_URL || DEFAULT_SUPPORT_HANDOFF_ENDPOINT_URL;


⚠️ [IMPORTANT] [SECURITY] Falling back to the hard-coded Hookdeck URL means any environment missing SUPPORT_HANDOFF_ENDPOINT_URL will still forward user email and chat transcripts to that endpoint. Fail closed when the env var is absent so PII only leaves via an explicitly configured destination.

Co-Authored-By: Warp Agent <agent@warp.dev>

Root cause: astro-expressive-code's Vite plugin rewrites Shiki's bundled theme registry (shiki/dist/themes.mjs) and strips every theme that is not listed as a string in the Expressive Code `themes` config. Starlight passes its themes as theme objects, so the registry was emptied to `bundledThemesInfo = []` across the whole Vite module graph. The Kapa side-chat island's runtime createHighlighter(['github-light', 'github-dark']) then threw "theme is not included in this bundle" and every chat code block fell back to plaintext. The same stripping also broke the earlier server-side /api/highlight-code approach. Fix: set `removeUnusedThemes: false` in the Expressive Code config so the registry ships intact. Theme data is still lazy-loaded, so only the two requested GitHub themes are ever fetched in the browser, and docs pages (build-time Expressive Code rendering) are unaffected. Co-Authored-By: Warp Agent <agent@warp.dev>

Two flicker sources in the Kapa side-chat markdown rendering: 1. Inline code rendered as full code blocks. react-markdown v9+ no longer passes the `inline` flag to the `code` component, so the existing `if (inline)` branch never ran and every inline code span (e.g. `.rpm`, `zypper`) rendered as a framed ChatCodeBlock with a copy button and horizontal scrollbar. During streaming these frames popped in and out of the prose, causing large layout shifts. Fenced blocks are always emitted as <pre><code>, so block handling now lives in the `pre` component and bare `code` renders as a plain inline chip (already styled by KapaChatLauncher.css). 2. Per-token highlight churn. The `deferHighlight` prop (true while the answer is streaming) was accepted but never honored, so every streamed token queued a Shiki highlight of the partial code and the block flipped between plaintext and (stale) highlighted DOM. The highlight effect now skips work entirely while `deferHighlight` is set and highlights the final text once when streaming settles. Highlighted HTML is also keyed to the exact code text + theme it was produced for, so stale markup is never rendered. Co-Authored-By: Warp Agent <agent@warp.dev>

Shiki's codeToHtml output separates each <span class="line"> with a literal newline character, which the chat code block's `white-space: pre` already renders as a line break. The extra `.sl-kapa-codeblock code .line { display: block }` rule added a second break per line, so every highlighted code block rendered with a blank line between each line of code. Drop the rule and keep the line spans inline. Co-Authored-By: Warp Agent <agent@warp.dev>

dannyneira and others added 23 commits July 23, 2026 17:30

Add custom Kapa handoff ticket flow for docs chat

18e7ccf

Adds an always-on Create ticket action in the Kapa chat UI, includes transcript context in submissions, and provides a preview/webhook backend endpoint for handoff testing. Co-Authored-By: Oz <oz-agent@warp.dev>

Fix PR preview build for Kapa handoff API route

939c966

Set the handoff endpoint to non-prerendered so static/SSR build inputs resolve correctly in CI and Vercel. Co-Authored-By: Oz <oz-agent@warp.dev>

Fix preview build by moving handoff endpoint off /api

6c0eb87

Move the custom handoff POST route to /kapa-handoff and remove the stale /api/kapa-handoff file to avoid CI/Vercel SSR rollup conflicts with the /api docs page. Co-Authored-By: Oz <oz-agent@warp.dev>

docs: document MCP OAuth workarounds (#422)

5a22dc9

Co-authored-by: Oz <oz-agent@warp.dev>

Replace custom Kapa chat with website widget

4a9c518

Co-Authored-By: Oz <oz-agent@warp.dev>

Tweak Ask AI widget title and panel behavior

b5ebf2e

Co-Authored-By: Oz <oz-agent@warp.dev>

Hide Ask tooltip while Kapa panel is open

a6048d3

Co-Authored-By: Oz <oz-agent@warp.dev>

Move Ask tooltip above the panel

c805b22

Co-Authored-By: Oz <oz-agent@warp.dev>

Suppress clipped Kapa attachment tooltip artifact

93f73dd

Co-Authored-By: Oz <oz-agent@warp.dev>

Broaden Kapa tooltip suppression for portal tooltips

fd762df

Co-Authored-By: Oz <oz-agent@warp.dev>

Revert "Broaden Kapa tooltip suppression for portal tooltips"

05d2674

This reverts commit fd762df.

Revert "Suppress clipped Kapa attachment tooltip artifact"

cfdf79e

This reverts commit 93f73dd.

Revert "Move Ask tooltip above the panel"

7e955bc

This reverts commit c805b22.

Revert "Hide Ask tooltip while Kapa panel is open"

6a5cef3

This reverts commit a6048d3.

Allow Vercel live feedback script in CSP

1e12da1

Co-Authored-By: Oz <oz-agent@warp.dev>

Stabilize Kapa preview CORS and CSP allowances

97b247d

Co-Authored-By: Oz <oz-agent@warp.dev>

Adjust Kapa answer bubble padding

05572a2

Co-Authored-By: Oz <oz-agent@warp.dev>

Add focus dim effect behind Kapa sidebar

c8c6a12

Co-Authored-By: Oz <oz-agent@warp.dev>

Remove Kapa sidebar focus blur overlay

60edc9a

Co-Authored-By: Oz <oz-agent@warp.dev>

Add spacing between Kapa question and answer bubbles

98b7933

Co-Authored-By: Oz <oz-agent@warp.dev>

Tune Kapa handoff trigger conditions

8a85cc6

Co-Authored-By: Oz <oz-agent@warp.dev>

Disable Kapa feedback survey prompts

57e560b

Co-Authored-By: Oz <oz-agent@warp.dev>

Restore custom Kapa chat with trigger-based support handoff

875f234

Co-Authored-By: Warp Agent <agent@warp.dev>

cla-bot Bot added the cla-signed label Aug 4, 2026

Allow hCaptcha in CSP for custom Kapa chat previews

a0f688c

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 5, 2026 22:59 View deployment

Add docs support-handoff API flow for custom Kapa chat

76ba532

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 6, 2026 17:18 View deployment

warp-agent-staging Bot mentioned this pull request Aug 6, 2026

fix(redirects): add no-slash redirect for /agent-platform/capabilities/computer-use #485

Merged

dannyneira marked this pull request as ready for review August 8, 2026 00:09

oz-for-oss Bot reviewed Aug 8, 2026

View reviewed changes

Align docs and chat codeblock rendering behavior

7885467

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 10, 2026 17:54 View deployment

Match chat codeblock DOM to docs expressive-code

8463838

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 10, 2026 18:05 View deployment

Use docs-style highlighted code blocks in chat

5db8636

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 10, 2026 18:43 View deployment

Improve chat codeblock syntax highlighting

48b075d

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 10, 2026 19:06 View deployment

Preserve Shiki token colors in chat code blocks

a001b5b

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 10, 2026 20:46 View deployment

Use browser-safe Shiki bundle for chat highlighting

37e6728

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 10, 2026 20:59 View deployment

Highlight chat code blocks via server API

191c061

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 10, 2026 21:13 View deployment

Queue and cache chat highlight requests

15cc3e2

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 10, 2026 22:10 View deployment

Reduce chat highlight churn and copy scroll jump

8d5c2a6

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 11, 2026 17:47 View deployment

Use full Shiki bundle for chat syntax themes

8b8f92b

Co-Authored-By: Warp Agent <agent@warp.dev>

vercel Bot deployed to Preview August 11, 2026 18:08 View deployment

vercel Bot deployed to Preview August 11, 2026 19:30 View deployment

vercel Bot deployed to Preview August 11, 2026 19:46 View deployment

vercel Bot deployed to Preview August 11, 2026 20:02 View deployment

dannyneira closed this Aug 11, 2026

Navigation Menu

Uh oh!

Restore custom Kapa chat with trigger-based support handoff - #466

Restore custom Kapa chat with trigger-based support handoff#466
dannyneira wants to merge 48 commits into
mainfrom
danny/kapa-custom-chat-handoff-v2

dannyneira commented Aug 4, 2026

Uh oh!

vercel Bot commented Aug 4, 2026 •

edited

Loading

Uh oh!

oz-for-oss Bot commented Aug 8, 2026 •

edited

Loading

Uh oh!

oz-for-oss Bot left a comment

Uh oh!

oz-for-oss Bot Aug 8, 2026

Uh oh!

oz-for-oss Bot Aug 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

dannyneira commented Aug 4, 2026

Summary

Validation

Uh oh!

vercel Bot commented Aug 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

oz-for-oss Bot commented Aug 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

oz-for-oss Bot left a comment

Choose a reason for hiding this comment

Overview

Concerns

Security

Verdict

Uh oh!

oz-for-oss Bot Aug 8, 2026

Choose a reason for hiding this comment

Uh oh!

oz-for-oss Bot Aug 8, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

vercel Bot commented Aug 4, 2026 •

edited

Loading

oz-for-oss Bot commented Aug 8, 2026 •

edited

Loading