From 7e7b6fe5e9fbdb782cd33d0e8afb9c50f7491590 Mon Sep 17 00:00:00 2001
From: jessiemongeon1 <jessie.mongeon@mystenlabs.com>
Date: Tue, 23 Jun 2026 18:19:40 -0500
Subject: [PATCH 1/8] feat(docs): add Kapa.ai sidebar integration

Add AI-powered knowledge assistant (Kapa.ai) as a sidebar widget
to the SDK documentation site. Includes KapaWidget React component
with sidebar state detection, navbar trigger button, and CSS rules
for responsive content shifting.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 packages/docs/app/global.css            |  51 +++++++++++
 packages/docs/app/layout.config.tsx     |   2 +
 packages/docs/app/layout.tsx            |  16 ++++
 packages/docs/components/KapaWidget.tsx | 111 ++++++++++++++++++++++++
 4 files changed, 180 insertions(+)
 create mode 100644 packages/docs/components/KapaWidget.tsx

diff --git a/packages/docs/app/global.css b/packages/docs/app/global.css
index 2bf66070c..021fdc4f0 100644
--- a/packages/docs/app/global.css
+++ b/packages/docs/app/global.css
@@ -3,3 +3,54 @@
 @import 'fumadocs-ui/css/preset.css';
 
 @source '../node_modules/fumadocs-ui/dist/**/*.js';
+
+/* ---- Kapa sidebar content shift ---- */
+html.kapa-sidebar-open body {
+  width: calc(100vw - 500px) !important;
+  overflow-x: hidden;
+  transition: width 0.3s ease;
+}
+
+html.kapa-sidebar-open nav {
+  right: 500px !important;
+  overflow: hidden;
+  transition: right 0.3s ease;
+}
+
+html.kapa-sidebar-open .kapa-trigger-btn {
+  display: none !important;
+}
+
+nav {
+  transition: right 0.3s ease;
+}
+
+body {
+  transition: width 0.3s ease;
+}
+
+@media (max-width: 768px) {
+  html.kapa-sidebar-open body {
+    width: 100vw !important;
+  }
+}
+
+/* Kapa trigger button */
+.kapa-trigger-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  cursor: pointer;
+  background: var(--fd-background);
+  color: var(--fd-foreground);
+  font-weight: 500;
+  font-size: 0.875rem;
+  padding: 0.5rem 1rem;
+  border-radius: 9999px;
+  border: 1px solid var(--fd-border);
+  transition: background-color 0.15s;
+}
+
+.kapa-trigger-btn:hover {
+  background: var(--fd-muted);
+}
diff --git a/packages/docs/app/layout.config.tsx b/packages/docs/app/layout.config.tsx
index d5d2e5f03..c3412527a 100644
--- a/packages/docs/app/layout.config.tsx
+++ b/packages/docs/app/layout.config.tsx
@@ -1,6 +1,7 @@
 // Copyright (c) Mysten Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
 import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+import { KapaButton } from '@/components/KapaWidget';
 
 /**
  * Shared layout configurations
@@ -12,6 +13,7 @@ import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
 export const baseOptions: BaseLayoutProps = {
 	nav: {
 		title: 'Mysten Labs SDKs',
+		children: <KapaButton />,
 	},
 	links: [
 		{
diff --git a/packages/docs/app/layout.tsx b/packages/docs/app/layout.tsx
index 3ded3165e..b884a280e 100644
--- a/packages/docs/app/layout.tsx
+++ b/packages/docs/app/layout.tsx
@@ -9,6 +9,7 @@ import { Inter } from 'next/font/google';
 import Link from 'next/link';
 import Script from 'next/script';
 import CloudFlareAnalytics from '@/components/CloudFlareAnalytics';
+import { KapaSidebar } from '@/components/KapaWidget';
 
 export const metadata: Metadata = {
 	title: {
@@ -72,6 +73,21 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 				</Banner>
 				<RootProvider>{children}</RootProvider>
 				<CloudFlareAnalytics />
+				<KapaSidebar />
+				<Script
+					src="https://widget.kapa.ai/kapa-widget.bundle.js"
+					data-website-id="71684c7d-f008-4145-b4e0-67b2477287fc"
+					data-project-name="Sui SDK Knowledge"
+					data-project-color="#298DFF"
+					data-button-hide="true"
+					data-view-mode="sidebar"
+					data-modal-title="Ask SDK AI"
+					data-modal-ask-ai-input-placeholder="Ask me anything about the Sui SDKs!"
+					data-modal-example-questions="How do I create a transaction in TypeScript?,How do I connect a wallet with dApp Kit?,How do I query objects with the Sui SDK?,How do I use BCS encoding?"
+					data-modal-overlay-hidden="true"
+					data-modal-lock-scroll="false"
+					strategy="afterInteractive"
+				/>
 			</body>
 		</html>
 	);
diff --git a/packages/docs/components/KapaWidget.tsx b/packages/docs/components/KapaWidget.tsx
new file mode 100644
index 000000000..da300d8ac
--- /dev/null
+++ b/packages/docs/components/KapaWidget.tsx
@@ -0,0 +1,111 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+'use client';
+
+import { useEffect, useState } from 'react';
+
+declare global {
+	interface Window {
+		Kapa?: {
+			open: (query?: string) => void;
+			close: () => void;
+		};
+	}
+}
+
+const OPEN_CLASS = 'kapa-sidebar-open';
+
+export function KapaSidebar() {
+	useEffect(() => {
+		let kapaOpen = false;
+		let hookedRef: typeof window.Kapa?.open | null = null;
+
+		function syncClass() {
+			document.documentElement.classList.toggle(OPEN_CLASS, kapaOpen);
+		}
+
+		function hookKapa() {
+			if (!window.Kapa || !window.Kapa.open || window.Kapa.open === hookedRef) return;
+
+			const origOpen = window.Kapa.open;
+			const origClose = window.Kapa.close;
+
+			window.Kapa.open = function (...args: Parameters<typeof origOpen>) {
+				kapaOpen = true;
+				syncClass();
+				return origOpen.apply(this, args);
+			};
+
+			window.Kapa.close = function (...args: Parameters<typeof origClose>) {
+				kapaOpen = false;
+				syncClass();
+				return origClose.apply(this, args);
+			};
+
+			hookedRef = window.Kapa.open;
+		}
+
+		function isSidebarVisible() {
+			const x = window.innerWidth - 50;
+			const y = window.innerHeight / 2;
+			const el = document.elementFromPoint(x, y);
+			if (!el) return false;
+			if (el === document.body || el === document.documentElement) return false;
+			const root = document.getElementById('nd-docs-layout') || document.querySelector('main');
+			if (root && root.contains(el)) return false;
+			return true;
+		}
+
+		const interval = setInterval(() => {
+			hookKapa();
+			const visible = isSidebarVisible();
+			if (visible && !kapaOpen) {
+				kapaOpen = true;
+			} else if (!visible && kapaOpen) {
+				kapaOpen = false;
+			}
+			syncClass();
+		}, 300);
+
+		return () => clearInterval(interval);
+	}, []);
+
+	return null;
+}
+
+export function KapaButton() {
+	const [mounted, setMounted] = useState(false);
+
+	useEffect(() => {
+		setMounted(true);
+	}, []);
+
+	if (!mounted) return null;
+
+	return (
+		<button
+			type="button"
+			onClick={() => window.Kapa?.open()}
+			className="kapa-trigger-btn"
+		>
+			<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
+				<path d="M15 4V2" />
+				<path d="M15 16v-2" />
+				<path d="M8 9h2" />
+				<path d="M20 9h2" />
+				<path d="M17.8 11.8L19 13" />
+				<path d="M15 9h.01" />
+				<path d="M17.8 6.2L19 5" />
+				<path d="M11 6.2L9.7 5" />
+				<path d="M11 11.8L9.7 13" />
+				<path d="M8 15h8a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2H8a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2z" />
+				<path d="M9 18h6" />
+				<path d="M10 22h4" />
+				<path d="M10 18v4" />
+				<path d="M14 18v4" />
+			</svg>
+			<span className="hidden lg:inline">Ask SDK AI</span>
+		</button>
+	);
+}

From 933d4c8b585765f0dd294c397b845554aef6dad5 Mon Sep 17 00:00:00 2001
From: jessiemongeon1 <jessie.mongeon@mystenlabs.com>
Date: Tue, 23 Jun 2026 18:27:03 -0500
Subject: [PATCH 2/8] fix: fix type error in KapaWidget and update Kapa.ai
 website ID

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 packages/docs/app/layout.tsx            | 2 +-
 packages/docs/components/KapaWidget.tsx | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/docs/app/layout.tsx b/packages/docs/app/layout.tsx
index b884a280e..828936be0 100644
--- a/packages/docs/app/layout.tsx
+++ b/packages/docs/app/layout.tsx
@@ -76,7 +76,7 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 				<KapaSidebar />
 				<Script
 					src="https://widget.kapa.ai/kapa-widget.bundle.js"
-					data-website-id="71684c7d-f008-4145-b4e0-67b2477287fc"
+					data-website-id="f40e82ec-5fe9-4776-a287-f889da70eaaa"
 					data-project-name="Sui SDK Knowledge"
 					data-project-color="#298DFF"
 					data-button-hide="true"
diff --git a/packages/docs/components/KapaWidget.tsx b/packages/docs/components/KapaWidget.tsx
index da300d8ac..d147c641d 100644
--- a/packages/docs/components/KapaWidget.tsx
+++ b/packages/docs/components/KapaWidget.tsx
@@ -19,7 +19,7 @@ const OPEN_CLASS = 'kapa-sidebar-open';
 export function KapaSidebar() {
 	useEffect(() => {
 		let kapaOpen = false;
-		let hookedRef: typeof window.Kapa?.open | null = null;
+		let hookedRef: ((query?: string) => void) | null = null;
 
 		function syncClass() {
 			document.documentElement.classList.toggle(OPEN_CLASS, kapaOpen);

From b0c3bed9e71230491e4a34a2c9744b1019338230 Mon Sep 17 00:00:00 2001
From: jessiemongeon1 <jessie.mongeon@mystenlabs.com>
Date: Wed, 24 Jun 2026 09:42:58 -0500
Subject: [PATCH 3/8] fix(docs): fix Kapa button placement, icon, and modal
 title

- Use Kapa default floating button instead of navbar injection
- Set data-launcher-button-image and data-modal-image for proper icons
- Rename modal title to "Ask Mysten Labs SDK AI"
- Add floating button CSS styles
- Revert layout.config.tsx to clean state

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 packages/docs/app/global.css            |  30 ++++++++++++++++++++++++
 packages/docs/app/layout.config.tsx     |   2 --
 packages/docs/app/layout.tsx            |  11 ++++++---
 packages/docs/components/KapaWidget.tsx |  21 ++---------------
 packages/docs/public/logo.png           | Bin 0 -> 3018 bytes
 5 files changed, 40 insertions(+), 24 deletions(-)
 create mode 100644 packages/docs/public/logo.png

diff --git a/packages/docs/app/global.css b/packages/docs/app/global.css
index 021fdc4f0..da6591e89 100644
--- a/packages/docs/app/global.css
+++ b/packages/docs/app/global.css
@@ -54,3 +54,33 @@ body {
 .kapa-trigger-btn:hover {
   background: var(--fd-muted);
 }
+
+/* Floating Kapa button (bottom-right) */
+.kapa-floating-btn {
+  position: fixed;
+  bottom: 1.5rem;
+  right: 1.5rem;
+  z-index: 999;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  cursor: pointer;
+  background: #298DFF;
+  color: white;
+  font-weight: 600;
+  font-size: 0.875rem;
+  padding: 0.75rem 1.25rem;
+  border-radius: 9999px;
+  border: none;
+  box-shadow: 0 4px 12px rgba(41, 141, 255, 0.4);
+  transition: background-color 0.15s, box-shadow 0.15s;
+}
+
+.kapa-floating-btn:hover {
+  background: #1B6FD1;
+  box-shadow: 0 6px 16px rgba(41, 141, 255, 0.5);
+}
+
+html.kapa-sidebar-open .kapa-floating-btn {
+  display: none !important;
+}
diff --git a/packages/docs/app/layout.config.tsx b/packages/docs/app/layout.config.tsx
index c3412527a..d5d2e5f03 100644
--- a/packages/docs/app/layout.config.tsx
+++ b/packages/docs/app/layout.config.tsx
@@ -1,7 +1,6 @@
 // Copyright (c) Mysten Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
 import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
-import { KapaButton } from '@/components/KapaWidget';
 
 /**
  * Shared layout configurations
@@ -13,7 +12,6 @@ import { KapaButton } from '@/components/KapaWidget';
 export const baseOptions: BaseLayoutProps = {
 	nav: {
 		title: 'Mysten Labs SDKs',
-		children: <KapaButton />,
 	},
 	links: [
 		{
diff --git a/packages/docs/app/layout.tsx b/packages/docs/app/layout.tsx
index 828936be0..ce9345d56 100644
--- a/packages/docs/app/layout.tsx
+++ b/packages/docs/app/layout.tsx
@@ -9,7 +9,7 @@ import { Inter } from 'next/font/google';
 import Link from 'next/link';
 import Script from 'next/script';
 import CloudFlareAnalytics from '@/components/CloudFlareAnalytics';
-import { KapaSidebar } from '@/components/KapaWidget';
+import { KapaSidebar, KapaButton } from '@/components/KapaWidget';
 
 export const metadata: Metadata = {
 	title: {
@@ -73,15 +73,20 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 				</Banner>
 				<RootProvider>{children}</RootProvider>
 				<CloudFlareAnalytics />
+				<KapaButton />
 				<KapaSidebar />
 				<Script
 					src="https://widget.kapa.ai/kapa-widget.bundle.js"
 					data-website-id="f40e82ec-5fe9-4776-a287-f889da70eaaa"
 					data-project-name="Sui SDK Knowledge"
 					data-project-color="#298DFF"
-					data-button-hide="true"
+					data-button-hide="false"
+					data-launcher-button-image="/logo.png"
+					data-launcher-button-image-height="24"
+					data-launcher-button-image-width="24"
 					data-view-mode="sidebar"
-					data-modal-title="Ask SDK AI"
+					data-modal-image="/logo.png"
+					data-modal-title="Ask Mysten Labs SDK AI"
 					data-modal-ask-ai-input-placeholder="Ask me anything about the Sui SDKs!"
 					data-modal-example-questions="How do I create a transaction in TypeScript?,How do I connect a wallet with dApp Kit?,How do I query objects with the Sui SDK?,How do I use BCS encoding?"
 					data-modal-overlay-hidden="true"
diff --git a/packages/docs/components/KapaWidget.tsx b/packages/docs/components/KapaWidget.tsx
index d147c641d..f69381843 100644
--- a/packages/docs/components/KapaWidget.tsx
+++ b/packages/docs/components/KapaWidget.tsx
@@ -75,37 +75,20 @@ export function KapaSidebar() {
 }
 
 export function KapaButton() {
-	const [mounted, setMounted] = useState(false);
-
-	useEffect(() => {
-		setMounted(true);
-	}, []);
-
-	if (!mounted) return null;
-
 	return (
 		<button
 			type="button"
 			onClick={() => window.Kapa?.open()}
-			className="kapa-trigger-btn"
+			className="kapa-floating-btn"
 		>
 			<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
-				<path d="M15 4V2" />
-				<path d="M15 16v-2" />
-				<path d="M8 9h2" />
-				<path d="M20 9h2" />
-				<path d="M17.8 11.8L19 13" />
-				<path d="M15 9h.01" />
-				<path d="M17.8 6.2L19 5" />
-				<path d="M11 6.2L9.7 5" />
-				<path d="M11 11.8L9.7 13" />
 				<path d="M8 15h8a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2H8a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2z" />
 				<path d="M9 18h6" />
 				<path d="M10 22h4" />
 				<path d="M10 18v4" />
 				<path d="M14 18v4" />
 			</svg>
-			<span className="hidden lg:inline">Ask SDK AI</span>
+			<span>Ask SDK AI</span>
 		</button>
 	);
 }
diff --git a/packages/docs/public/logo.png b/packages/docs/public/logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..5d8ea6f901c1dcb8396e08421390c73f384ca7a6
GIT binary patch
literal 3018
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
W^pjczcbDVz9Bsed(Yjz8=j3n3H0*T%

literal 0
HcmV?d00001


From 235689daa32d703df9135c927e12f13a16afdfd6 Mon Sep 17 00:00:00 2001
From: jessiemongeon1 <jessie.mongeon@mystenlabs.com>
Date: Wed, 24 Jun 2026 16:16:23 -0500
Subject: [PATCH 4/8] fix(docs): add Kapa dark mode detection

- Add data-color-scheme-selector for automatic dark mode following
- Clean up unused KapaButton component and layout config import

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 packages/docs/app/layout.tsx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/docs/app/layout.tsx b/packages/docs/app/layout.tsx
index ce9345d56..a37c95cbe 100644
--- a/packages/docs/app/layout.tsx
+++ b/packages/docs/app/layout.tsx
@@ -89,6 +89,7 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 					data-modal-title="Ask Mysten Labs SDK AI"
 					data-modal-ask-ai-input-placeholder="Ask me anything about the Sui SDKs!"
 					data-modal-example-questions="How do I create a transaction in TypeScript?,How do I connect a wallet with dApp Kit?,How do I query objects with the Sui SDK?,How do I use BCS encoding?"
+					data-color-scheme-selector=".dark"
 					data-modal-overlay-hidden="true"
 					data-modal-lock-scroll="false"
 					strategy="afterInteractive"

From 12d258d0eec6e5284666512281b1c3c25d8edd2e Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <jessie.mongeon@mystenlabs.com>
Date: Thu, 25 Jun 2026 19:41:11 +0000
Subject: [PATCH 5/8] style(docs): fix prettier formatting in Kapa widget

---
 packages/docs/app/global.css            | 92 +++++++++++++------------
 packages/docs/components/KapaWidget.tsx | 17 +++--
 2 files changed, 58 insertions(+), 51 deletions(-)

diff --git a/packages/docs/app/global.css b/packages/docs/app/global.css
index da6591e89..727d15234 100644
--- a/packages/docs/app/global.css
+++ b/packages/docs/app/global.css
@@ -6,81 +6,83 @@
 
 /* ---- Kapa sidebar content shift ---- */
 html.kapa-sidebar-open body {
-  width: calc(100vw - 500px) !important;
-  overflow-x: hidden;
-  transition: width 0.3s ease;
+	width: calc(100vw - 500px) !important;
+	overflow-x: hidden;
+	transition: width 0.3s ease;
 }
 
 html.kapa-sidebar-open nav {
-  right: 500px !important;
-  overflow: hidden;
-  transition: right 0.3s ease;
+	right: 500px !important;
+	overflow: hidden;
+	transition: right 0.3s ease;
 }
 
 html.kapa-sidebar-open .kapa-trigger-btn {
-  display: none !important;
+	display: none !important;
 }
 
 nav {
-  transition: right 0.3s ease;
+	transition: right 0.3s ease;
 }
 
 body {
-  transition: width 0.3s ease;
+	transition: width 0.3s ease;
 }
 
 @media (max-width: 768px) {
-  html.kapa-sidebar-open body {
-    width: 100vw !important;
-  }
+	html.kapa-sidebar-open body {
+		width: 100vw !important;
+	}
 }
 
 /* Kapa trigger button */
 .kapa-trigger-btn {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.5rem;
-  cursor: pointer;
-  background: var(--fd-background);
-  color: var(--fd-foreground);
-  font-weight: 500;
-  font-size: 0.875rem;
-  padding: 0.5rem 1rem;
-  border-radius: 9999px;
-  border: 1px solid var(--fd-border);
-  transition: background-color 0.15s;
+	display: inline-flex;
+	align-items: center;
+	gap: 0.5rem;
+	cursor: pointer;
+	background: var(--fd-background);
+	color: var(--fd-foreground);
+	font-weight: 500;
+	font-size: 0.875rem;
+	padding: 0.5rem 1rem;
+	border-radius: 9999px;
+	border: 1px solid var(--fd-border);
+	transition: background-color 0.15s;
 }
 
 .kapa-trigger-btn:hover {
-  background: var(--fd-muted);
+	background: var(--fd-muted);
 }
 
 /* Floating Kapa button (bottom-right) */
 .kapa-floating-btn {
-  position: fixed;
-  bottom: 1.5rem;
-  right: 1.5rem;
-  z-index: 999;
-  display: inline-flex;
-  align-items: center;
-  gap: 0.5rem;
-  cursor: pointer;
-  background: #298DFF;
-  color: white;
-  font-weight: 600;
-  font-size: 0.875rem;
-  padding: 0.75rem 1.25rem;
-  border-radius: 9999px;
-  border: none;
-  box-shadow: 0 4px 12px rgba(41, 141, 255, 0.4);
-  transition: background-color 0.15s, box-shadow 0.15s;
+	position: fixed;
+	bottom: 1.5rem;
+	right: 1.5rem;
+	z-index: 999;
+	display: inline-flex;
+	align-items: center;
+	gap: 0.5rem;
+	cursor: pointer;
+	background: #298dff;
+	color: white;
+	font-weight: 600;
+	font-size: 0.875rem;
+	padding: 0.75rem 1.25rem;
+	border-radius: 9999px;
+	border: none;
+	box-shadow: 0 4px 12px rgba(41, 141, 255, 0.4);
+	transition:
+		background-color 0.15s,
+		box-shadow 0.15s;
 }
 
 .kapa-floating-btn:hover {
-  background: #1B6FD1;
-  box-shadow: 0 6px 16px rgba(41, 141, 255, 0.5);
+	background: #1b6fd1;
+	box-shadow: 0 6px 16px rgba(41, 141, 255, 0.5);
 }
 
 html.kapa-sidebar-open .kapa-floating-btn {
-  display: none !important;
+	display: none !important;
 }
diff --git a/packages/docs/components/KapaWidget.tsx b/packages/docs/components/KapaWidget.tsx
index f69381843..7368e75b5 100644
--- a/packages/docs/components/KapaWidget.tsx
+++ b/packages/docs/components/KapaWidget.tsx
@@ -76,12 +76,17 @@ export function KapaSidebar() {
 
 export function KapaButton() {
 	return (
-		<button
-			type="button"
-			onClick={() => window.Kapa?.open()}
-			className="kapa-floating-btn"
-		>
-			<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
+		<button type="button" onClick={() => window.Kapa?.open()} className="kapa-floating-btn">
+			<svg
+				width="20"
+				height="20"
+				viewBox="0 0 24 24"
+				fill="none"
+				stroke="currentColor"
+				strokeWidth="2"
+				strokeLinecap="round"
+				strokeLinejoin="round"
+			>
 				<path d="M8 15h8a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2H8a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2z" />
 				<path d="M9 18h6" />
 				<path d="M10 22h4" />

From 21a30786ae557b32abdafd62da0ba6ac3d31b1c0 Mon Sep 17 00:00:00 2001
From: jessiemongeon1 <jessie.mongeon@mystenlabs.com>
Date: Mon, 6 Jul 2026 12:55:14 -0500
Subject: [PATCH 6/8] fix(docs): hide Kapa native launcher button to fix
 overlap

The Kapa widget's built-in launcher button was overlapping with
the custom "Ask SDK AI" button since both were fixed to the
bottom-right corner. Setting data-button-hide to true hides the
native button while keeping the custom one.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 packages/docs/app/layout.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/docs/app/layout.tsx b/packages/docs/app/layout.tsx
index a37c95cbe..616160de7 100644
--- a/packages/docs/app/layout.tsx
+++ b/packages/docs/app/layout.tsx
@@ -80,7 +80,7 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 					data-website-id="f40e82ec-5fe9-4776-a287-f889da70eaaa"
 					data-project-name="Sui SDK Knowledge"
 					data-project-color="#298DFF"
-					data-button-hide="false"
+					data-button-hide="true"
 					data-launcher-button-image="/logo.png"
 					data-launcher-button-image-height="24"
 					data-launcher-button-image-width="24"

From 316de5ca0f8dfc05f849943cfd705c1bd80dcfa9 Mon Sep 17 00:00:00 2001
From: jessiemongeon1 <jessie.mongeon@mystenlabs.com>
Date: Mon, 20 Jul 2026 16:11:03 -0500
Subject: [PATCH 7/8] fix(docs): improve payment-kit discoverability to prevent
 agent hallucination

Payment queries were surfacing fabricated APIs because Kapa and LLM agents
couldn't match natural-language search terms (P2P, send payment, transfer
funds) to the real @mysten/payment-kit docs. Expand frontmatter keywords
across all payment-kit pages, update the meta.json section description, and
add a payment-related Kapa example question.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 packages/docs/app/layout.tsx                      |  2 +-
 .../docs/content/payment-kit/getting-started.mdx  | 15 ++++++++++++++-
 packages/docs/content/payment-kit/index.mdx       |  8 ++++++++
 packages/docs/content/payment-kit/meta.json       |  2 +-
 .../docs/content/payment-kit/payment-kit-sdk.mdx  |  7 +++++++
 .../content/payment-kit/payment-processing.mdx    |  6 ++++++
 .../content/payment-kit/registry-management.mdx   | 15 ++++++++++++++-
 7 files changed, 51 insertions(+), 4 deletions(-)

diff --git a/packages/docs/app/layout.tsx b/packages/docs/app/layout.tsx
index 616160de7..b6f0a6eba 100644
--- a/packages/docs/app/layout.tsx
+++ b/packages/docs/app/layout.tsx
@@ -88,7 +88,7 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 					data-modal-image="/logo.png"
 					data-modal-title="Ask Mysten Labs SDK AI"
 					data-modal-ask-ai-input-placeholder="Ask me anything about the Sui SDKs!"
-					data-modal-example-questions="How do I create a transaction in TypeScript?,How do I connect a wallet with dApp Kit?,How do I query objects with the Sui SDK?,How do I use BCS encoding?"
+					data-modal-example-questions="How do I create a transaction in TypeScript?,How do I connect a wallet with dApp Kit?,How do I process a payment with Payment Kit?,How do I query objects with the Sui SDK?"
 					data-color-scheme-selector=".dark"
 					data-modal-overlay-hidden="true"
 					data-modal-lock-scroll="false"
diff --git a/packages/docs/content/payment-kit/getting-started.mdx b/packages/docs/content/payment-kit/getting-started.mdx
index 8f08763e8..2db0cc546 100644
--- a/packages/docs/content/payment-kit/getting-started.mdx
+++ b/packages/docs/content/payment-kit/getting-started.mdx
@@ -1,7 +1,20 @@
 ---
 title: Getting Started
 description: Install and set up Payment Kit for your Sui application.
-keywords: [Payment Kit, getting started, installation, setup, Sui, TypeScript, payment integration]
+keywords:
+  [
+    Payment Kit,
+    getting started,
+    installation,
+    setup,
+    Sui,
+    TypeScript,
+    payment integration,
+    P2P payments,
+    send payment,
+    transfer funds,
+    '@mysten/payment-kit',
+  ]
 ---
 
 <Callout type="info">
diff --git a/packages/docs/content/payment-kit/index.mdx b/packages/docs/content/payment-kit/index.mdx
index 0ab29b60d..6d89fa1fc 100644
--- a/packages/docs/content/payment-kit/index.mdx
+++ b/packages/docs/content/payment-kit/index.mdx
@@ -7,10 +7,18 @@ keywords:
     Payment Kit,
     Sui payments,
     payment processing,
+    P2P payments,
+    peer-to-peer,
+    send payment,
+    transfer funds,
+    pay with crypto,
+    payment link,
+    QR code payment,
     registry,
     receipts,
     TypeScript,
     blockchain payments,
+    '@mysten/payment-kit',
   ]
 ---
 
diff --git a/packages/docs/content/payment-kit/meta.json b/packages/docs/content/payment-kit/meta.json
index 2ad60f62d..edac786a5 100644
--- a/packages/docs/content/payment-kit/meta.json
+++ b/packages/docs/content/payment-kit/meta.json
@@ -1,7 +1,7 @@
 {
 	"root": true,
 	"title": "Payment Kit",
-	"description": "Accept payments in any coin type on Sui",
+	"description": "Accept P2P and merchant payments in any coin type on Sui with @mysten/payment-kit",
 	"pages": [
 		"index",
 		"getting-started",
diff --git a/packages/docs/content/payment-kit/payment-kit-sdk.mdx b/packages/docs/content/payment-kit/payment-kit-sdk.mdx
index e3f5732b2..5c83eb2ca 100644
--- a/packages/docs/content/payment-kit/payment-kit-sdk.mdx
+++ b/packages/docs/content/payment-kit/payment-kit-sdk.mdx
@@ -10,6 +10,13 @@ keywords:
     Sui,
     TypeScript,
     client extension,
+    processRegistryPayment,
+    processEphemeralPayment,
+    createRegistry,
+    P2P payments,
+    send payment,
+    payment URI,
+    '@mysten/payment-kit',
   ]
 ---
 
diff --git a/packages/docs/content/payment-kit/payment-processing.mdx b/packages/docs/content/payment-kit/payment-processing.mdx
index 9ad071e6a..b03cfc9c3 100644
--- a/packages/docs/content/payment-kit/payment-processing.mdx
+++ b/packages/docs/content/payment-kit/payment-processing.mdx
@@ -10,6 +10,12 @@ keywords:
     duplicate prevention,
     Sui,
     TypeScript,
+    P2P payments,
+    peer-to-peer,
+    send coins,
+    transfer SUI,
+    pay on Sui,
+    '@mysten/payment-kit',
   ]
 ---
 
diff --git a/packages/docs/content/payment-kit/registry-management.mdx b/packages/docs/content/payment-kit/registry-management.mdx
index 061af4978..691dc6394 100644
--- a/packages/docs/content/payment-kit/registry-management.mdx
+++ b/packages/docs/content/payment-kit/registry-management.mdx
@@ -1,7 +1,20 @@
 ---
 title: Registry Management
 description: Create, configure, and manage payment registries and accepted coin types on Sui.
-keywords: [PaymentRegistry, registry management, coin types, expiration, onchain, Sui, Payment Kit]
+keywords:
+  [
+    PaymentRegistry,
+    registry management,
+    coin types,
+    expiration,
+    onchain,
+    Sui,
+    Payment Kit,
+    payment registry,
+    accepted coins,
+    fund management,
+    '@mysten/payment-kit',
+  ]
 ---
 
 <Callout type="info">

From a63837293c7fdc8828d005b226a6d504dc4e2938 Mon Sep 17 00:00:00 2001
From: jessiemongeon1 <jessie.mongeon@mystenlabs.com>
Date: Mon, 20 Jul 2026 16:19:21 -0500
Subject: [PATCH 8/8] Revert "fix(docs): improve payment-kit discoverability to
 prevent agent hallucination"

This reverts commit 316de5ca0f8dfc05f849943cfd705c1bd80dcfa9.
---
 packages/docs/app/layout.tsx                      |  2 +-
 .../docs/content/payment-kit/getting-started.mdx  | 15 +--------------
 packages/docs/content/payment-kit/index.mdx       |  8 --------
 packages/docs/content/payment-kit/meta.json       |  2 +-
 .../docs/content/payment-kit/payment-kit-sdk.mdx  |  7 -------
 .../content/payment-kit/payment-processing.mdx    |  6 ------
 .../content/payment-kit/registry-management.mdx   | 15 +--------------
 7 files changed, 4 insertions(+), 51 deletions(-)

diff --git a/packages/docs/app/layout.tsx b/packages/docs/app/layout.tsx
index b6f0a6eba..616160de7 100644
--- a/packages/docs/app/layout.tsx
+++ b/packages/docs/app/layout.tsx
@@ -88,7 +88,7 @@ export default function Layout({ children }: { children: React.ReactNode }) {
 					data-modal-image="/logo.png"
 					data-modal-title="Ask Mysten Labs SDK AI"
 					data-modal-ask-ai-input-placeholder="Ask me anything about the Sui SDKs!"
-					data-modal-example-questions="How do I create a transaction in TypeScript?,How do I connect a wallet with dApp Kit?,How do I process a payment with Payment Kit?,How do I query objects with the Sui SDK?"
+					data-modal-example-questions="How do I create a transaction in TypeScript?,How do I connect a wallet with dApp Kit?,How do I query objects with the Sui SDK?,How do I use BCS encoding?"
 					data-color-scheme-selector=".dark"
 					data-modal-overlay-hidden="true"
 					data-modal-lock-scroll="false"
diff --git a/packages/docs/content/payment-kit/getting-started.mdx b/packages/docs/content/payment-kit/getting-started.mdx
index 2db0cc546..8f08763e8 100644
--- a/packages/docs/content/payment-kit/getting-started.mdx
+++ b/packages/docs/content/payment-kit/getting-started.mdx
@@ -1,20 +1,7 @@
 ---
 title: Getting Started
 description: Install and set up Payment Kit for your Sui application.
-keywords:
-  [
-    Payment Kit,
-    getting started,
-    installation,
-    setup,
-    Sui,
-    TypeScript,
-    payment integration,
-    P2P payments,
-    send payment,
-    transfer funds,
-    '@mysten/payment-kit',
-  ]
+keywords: [Payment Kit, getting started, installation, setup, Sui, TypeScript, payment integration]
 ---
 
 <Callout type="info">
diff --git a/packages/docs/content/payment-kit/index.mdx b/packages/docs/content/payment-kit/index.mdx
index 6d89fa1fc..0ab29b60d 100644
--- a/packages/docs/content/payment-kit/index.mdx
+++ b/packages/docs/content/payment-kit/index.mdx
@@ -7,18 +7,10 @@ keywords:
     Payment Kit,
     Sui payments,
     payment processing,
-    P2P payments,
-    peer-to-peer,
-    send payment,
-    transfer funds,
-    pay with crypto,
-    payment link,
-    QR code payment,
     registry,
     receipts,
     TypeScript,
     blockchain payments,
-    '@mysten/payment-kit',
   ]
 ---
 
diff --git a/packages/docs/content/payment-kit/meta.json b/packages/docs/content/payment-kit/meta.json
index edac786a5..2ad60f62d 100644
--- a/packages/docs/content/payment-kit/meta.json
+++ b/packages/docs/content/payment-kit/meta.json
@@ -1,7 +1,7 @@
 {
 	"root": true,
 	"title": "Payment Kit",
-	"description": "Accept P2P and merchant payments in any coin type on Sui with @mysten/payment-kit",
+	"description": "Accept payments in any coin type on Sui",
 	"pages": [
 		"index",
 		"getting-started",
diff --git a/packages/docs/content/payment-kit/payment-kit-sdk.mdx b/packages/docs/content/payment-kit/payment-kit-sdk.mdx
index 5c83eb2ca..e3f5732b2 100644
--- a/packages/docs/content/payment-kit/payment-kit-sdk.mdx
+++ b/packages/docs/content/payment-kit/payment-kit-sdk.mdx
@@ -10,13 +10,6 @@ keywords:
     Sui,
     TypeScript,
     client extension,
-    processRegistryPayment,
-    processEphemeralPayment,
-    createRegistry,
-    P2P payments,
-    send payment,
-    payment URI,
-    '@mysten/payment-kit',
   ]
 ---
 
diff --git a/packages/docs/content/payment-kit/payment-processing.mdx b/packages/docs/content/payment-kit/payment-processing.mdx
index b03cfc9c3..9ad071e6a 100644
--- a/packages/docs/content/payment-kit/payment-processing.mdx
+++ b/packages/docs/content/payment-kit/payment-processing.mdx
@@ -10,12 +10,6 @@ keywords:
     duplicate prevention,
     Sui,
     TypeScript,
-    P2P payments,
-    peer-to-peer,
-    send coins,
-    transfer SUI,
-    pay on Sui,
-    '@mysten/payment-kit',
   ]
 ---
 
diff --git a/packages/docs/content/payment-kit/registry-management.mdx b/packages/docs/content/payment-kit/registry-management.mdx
index 691dc6394..061af4978 100644
--- a/packages/docs/content/payment-kit/registry-management.mdx
+++ b/packages/docs/content/payment-kit/registry-management.mdx
@@ -1,20 +1,7 @@
 ---
 title: Registry Management
 description: Create, configure, and manage payment registries and accepted coin types on Sui.
-keywords:
-  [
-    PaymentRegistry,
-    registry management,
-    coin types,
-    expiration,
-    onchain,
-    Sui,
-    Payment Kit,
-    payment registry,
-    accepted coins,
-    fund management,
-    '@mysten/payment-kit',
-  ]
+keywords: [PaymentRegistry, registry management, coin types, expiration, onchain, Sui, Payment Kit]
 ---
 
 <Callout type="info">