From e8ab08fdf980e2e10ca8cd81a00f7c1b26477feb Mon Sep 17 00:00:00 2001
From: Aleksander Grygier <aleksander.grygier@gmail.com>
Date: Fri, 18 Sep 2026 02:54:44 +0200
Subject: [PATCH] ui : note where qr pairing would plug in

Assisted-by: pi:llama.cpp/DeepSeek-V4.1-Flash
---
 .../lib/components/app/backends/DialogBackendForm.svelte   | 3 +++
 tools/ui/src/lib/constants/backend.constants.ts            | 7 +++++--
 tools/ui/src/lib/types/backend.d.ts                        | 7 ++++++-
 3 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/tools/ui/src/lib/components/app/backends/DialogBackendForm.svelte b/tools/ui/src/lib/components/app/backends/DialogBackendForm.svelte
index 8b428bc3b8..3e1a3279c7 100644
--- a/tools/ui/src/lib/components/app/backends/DialogBackendForm.svelte
+++ b/tools/ui/src/lib/components/app/backends/DialogBackendForm.svelte
@@ -145,6 +145,9 @@
 			<div class="space-y-3 pt-2">
 				<h3 class="text-sm font-medium">Recommended providers</h3>
 
+				<!-- TODO: a "pair by QR code" entry point belongs in this grid, next
+				     to the provider cards. -->
+
 				<div class="grid grid-cols-1 gap-3 sm:grid-cols-2">
 					{#each BACKEND_PRESETS as preset (preset.id)}
 						<BackendPresetCard
diff --git a/tools/ui/src/lib/constants/backend.constants.ts b/tools/ui/src/lib/constants/backend.constants.ts
index e88ff2dadd..5722ce38ef 100644
--- a/tools/ui/src/lib/constants/backend.constants.ts
+++ b/tools/ui/src/lib/constants/backend.constants.ts
@@ -57,8 +57,11 @@ export const BACKEND_COMPAT: Record<BackendProtocol, BackendCompat> = {
 };
 
 /**
- * Ready-made endpoints offered when adding a backend. `custom` intentionally
- * carries no URL so the user starts from an empty form.
+ * Ready-made endpoints offered when adding a backend.
+ *
+ * TODO: pair a llama.cpp server by scanning its QR code (WebRTC transport, so a
+ * hosted PWA can reach a server on the user's network), see
+ * ggml-org/llama.cpp#24577.
  */
 export const BACKEND_PRESETS: readonly BackendPreset[] = [
 	{
diff --git a/tools/ui/src/lib/types/backend.d.ts b/tools/ui/src/lib/types/backend.d.ts
index 728d75a242..019fce3610 100644
--- a/tools/ui/src/lib/types/backend.d.ts
+++ b/tools/ui/src/lib/types/backend.d.ts
@@ -45,7 +45,12 @@ export interface BackendCapabilities {
 	tools: boolean;
 }
 
-/** One configured API endpoint. */
+/**
+ * One configured API endpoint.
+ *
+ * TODO: a backend paired by QR code is reached over WebRTC instead of plain
+ * HTTP, so it needs a transport discriminator and its peer description here.
+ */
 export interface Backend {
 	/** Bearer token / API key used for this backend. */
 	apiKey?: string;