feat(chat): add deep search toggle to chat composer

[suguanYang]

Summary

Adds a Deep search toggle to the chat composer so users can enable or disable agentic retrieval per message. Defaults to on (useAgentic=true).

The toggle state flows from the composer through the chat send path into POST /api/chat, then into the Knowhere retrieval query as useAgentic (SDK param for the API use_agentic field). The hover tooltip explains the tradeoff:

Deep search plans document selection and navigation for more thorough answers. Turn off for faster classic search.

Changes

• ChatComposer: new Deep search checkbox toggle (checked by default, disabled while sending), tooltip, and onSend now passes { useAgentic }.
• ChatPanel / WorkspaceShellLayout / chat workflow: thread the send option through to sendChatMessage.
• POST /api/chat: accepts optional useAgentic (defaults to true server-side), passed into handleChatTurn -> answerQuestionWithRetrieval -> retrieval query params.
• buildRetrievalQueryParams: replaced the hardcoded useAgentic value with the per-request value (default true).
• Tests updated/added for the toggle default, tooltip, off-state send, request parsing, workflow body, and retrieval query param assertions.

Verification

• pnpm typecheck passes.
• Full pnpm test: 694 passed, 14 skipped.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
knowhere-notebook-staging	Ready	Preview	Aug 10, 2026 1:39am

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
knowhere-notebook	Ignored	Preview	Aug 10, 2026 1:39am