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 7, 2026 11:37pm

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

…By: Warp Agent <agent@warp.dev>

…ored-By: Warp Agent <agent@warp.dev>

…Agent <agent@warp.dev>

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.

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

Refine custom Kapa handoff form visibility and validation UX

0aa8fb8

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

vercel Bot deployed to Preview August 6, 2026 19:58 View deployment

Fix first-response handoff thread context resolution

91d4d74

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

vercel Bot deployed to Preview August 6, 2026 20:44 View deployment

Support Enter submit and optional Kapa project ID in handoff

0ff8286

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

vercel Bot deployed to Preview August 6, 2026 20:58 View deployment

Add fallback docs handoff endpoint for preview testing

2488457

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

vercel Bot deployed to Preview August 6, 2026 21:26 View deployment

Improve handoff status visibility and hide Front link\n\nCo-Authored-…

2b751e0

…By: Warp Agent <agent@warp.dev>

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

Fix handoff auth header and auto-scroll inline ticket form\n\nCo-Auth…

a077468

…ored-By: Warp Agent <agent@warp.dev>

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

Auto-scroll chat while Kapa responses stream\n\nCo-Authored-By: Warp …

42e174c

…Agent <agent@warp.dev>

vercel Bot deployed to Preview August 7, 2026 01:29 View deployment

Render chat code blocks with scoped scroll and copy button

886ff84

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

vercel Bot deployed to Preview August 7, 2026 01:43 View deployment

Use icon copy control for chat code blocks

09ce625

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

vercel Bot deployed to Preview August 7, 2026 01:58 View deployment

Use Hookdeck endpoint and simplify handoff success copy

617b335

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

vercel Bot deployed to Preview August 7, 2026 23:37 View deployment

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

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 35 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