diff --git a/.changeset/ai-search-plugin.md b/.changeset/ai-search-plugin.md
new file mode 100644
index 000000000..bd0d59825
--- /dev/null
+++ b/.changeset/ai-search-plugin.md
@@ -0,0 +1,5 @@
+---
+"@emdash-cms/cloudflare": minor
+---
+
+Adds AI Search plugin with content indexing, search modal, and admin settings UI. Includes a Cloudflare-native integration using the AI Search worker binding and a standalone package using the REST API.
diff --git a/demos/cloudflare/astro.config.mjs b/demos/cloudflare/astro.config.mjs
index 3c7c731cc..4534e2f3d 100644
--- a/demos/cloudflare/astro.config.mjs
+++ b/demos/cloudflare/astro.config.mjs
@@ -10,6 +10,7 @@ import {
 	cloudflareImages,
 	cloudflareStream,
 } from "@emdash-cms/cloudflare";
+import { aiSearch } from "@emdash-cms/cloudflare/plugins";
 import { formsPlugin } from "@emdash-cms/plugin-forms";
 import { webhookNotifierPlugin } from "@emdash-cms/plugin-webhook-notifier";
 import { defineConfig, fontProviders } from "astro/config";
@@ -72,6 +73,7 @@ export default defineConfig({
 			plugins: [
 				// Test plugin that exercises all v2 APIs
 				formsPlugin(),
+				aiSearch(),
 			],
 			// Sandboxed plugins (run in isolated workers)
 			sandboxed: [webhookNotifierPlugin()],
diff --git a/demos/cloudflare/emdash-env.d.ts b/demos/cloudflare/emdash-env.d.ts
index ea5f02a61..abb26262f 100644
--- a/demos/cloudflare/emdash-env.d.ts
+++ b/demos/cloudflare/emdash-env.d.ts
@@ -10,7 +10,6 @@ export interface Page {
   slug: string | null;
   status: string;
   title: string;
-  template?: "Default" | "Full Width";
   content?: PortableTextBlock[];
   createdAt: Date;
   updatedAt: Date;
diff --git a/demos/cloudflare/src/components/PostCard.astro b/demos/cloudflare/src/components/PostCard.astro
index 500fbac6e..3fee6edd8 100644
--- a/demos/cloudflare/src/components/PostCard.astro
+++ b/demos/cloudflare/src/components/PostCard.astro
@@ -119,7 +119,7 @@ const formattedDate = date
 	}
 
 	.card-image {
-		aspect-ratio: 16 / 10;
+		aspect-ratio: 16 / 9;
 		overflow: hidden;
 		border-radius: var(--radius-lg);
 		background: var(--color-surface);
@@ -138,7 +138,7 @@ const formattedDate = date
 	}
 
 	.card-placeholder {
-		aspect-ratio: 16 / 10;
+		aspect-ratio: 16 / 9;
 		border-radius: var(--radius-lg);
 		background: var(--color-surface);
 		margin-bottom: var(--spacing-4);
diff --git a/demos/cloudflare/src/components/SearchModal.astro b/demos/cloudflare/src/components/SearchModal.astro
new file mode 100644
index 000000000..39ac1ccc7
--- /dev/null
+++ b/demos/cloudflare/src/components/SearchModal.astro
@@ -0,0 +1,925 @@
+---
+/**
+ * SearchModal - A modal search component for EmDash content
+ *
+ * Opens a centered modal overlay when the trigger button is clicked or
+ * when the user presses Cmd/Ctrl+K. Matches the style of Cloudflare's
+ * AI Search snippet modal.
+ *
+ * ```astro
+ * ---
+ * import SearchModal from "emdash/ui/search-modal";
+ * ---
+ * <SearchModal placeholder="Search articles..." collections={["posts", "pages"]} />
+ * ```
+ */
+
+export interface Props {
+	/** Placeholder text for the search input */
+	placeholder?: string;
+	/** Collections to search (defaults to all searchable collections) */
+	collections?: string[];
+	/** Minimum characters before searching (defaults to 2) */
+	minChars?: number;
+	/** Debounce delay in milliseconds (defaults to 300) */
+	debounce?: number;
+	/** Maximum results to show (defaults to 10) */
+	limit?: number;
+	/** Keyboard shortcut key (defaults to "k", used with Cmd/Ctrl) */
+	shortcut?: string;
+	/**
+	 * Custom search endpoint URL. Overrides the default FTS5 search endpoint.
+	 * Use this to point at a plugin search route, e.g. `"/_emdash/api/plugins/ai-search/query"`.
+	 * The endpoint should accept `q`, `limit`, and `collection` query params
+	 * and return `{ results: [{ collection, id, slug?, title?, snippet?, score }] }`.
+	 */
+	searchEndpoint?: string;
+}
+
+const {
+	placeholder = "Search...",
+	collections,
+	minChars = 2,
+	debounce = 300,
+	limit = 10,
+	shortcut = "k",
+	searchEndpoint,
+} = Astro.props;
+
+const config = {
+	collections: collections?.join(",") ?? "",
+	minChars,
+	debounce,
+	limit,
+	shortcut,
+	searchEndpoint: searchEndpoint ?? null,
+};
+---
+
+<!-- Trigger: rendered inline where the component is placed (e.g. inside a nav) -->
+<emdash-search-modal data-config={JSON.stringify(config)}>
+	<button type="button" class="emdash-search-trigger" aria-label="Search">
+		<svg class="emdash-search-trigger-icon" viewBox="0 -960 960 960" fill="currentColor">
+			<path d="M784-120 532-372q-30 24-69 38t-83 14q-109 0-184.5-75.5T120-580q0-109 75.5-184.5T380-840q109 0 184.5 75.5T640-580q0 44-14 83t-38 69l252 252-56 56ZM380-400q75 0 127.5-52.5T560-580q0-75-52.5-127.5T380-760q-75 0-127.5 52.5T200-580q0 75 52.5 127.5T380-400Z"></path>
+		</svg>
+		<span class="emdash-search-trigger-text">{placeholder}</span>
+		<kbd class="emdash-search-trigger-kbd">
+			<span class="emdash-search-trigger-kbd-mod"></span>{shortcut.toUpperCase()}
+		</kbd>
+	</button>
+
+	<!-- Backdrop template: the script moves this to document.body so it escapes
+	     any parent stacking context (e.g. a sticky header with backdrop-filter). -->
+	<template class="emdash-search-backdrop-tpl">
+		<div class="emdash-search-backdrop">
+			<div class="emdash-search-dialog" role="dialog" aria-modal="true" aria-label="Search">
+				<div class="emdash-search-header">
+					<svg class="emdash-search-icon" viewBox="0 -960 960 960" fill="currentColor">
+						<path d="M784-120 532-372q-30 24-69 38t-83 14q-109 0-184.5-75.5T120-580q0-109 75.5-184.5T380-840q109 0 184.5 75.5T640-580q0 44-14 83t-38 69l252 252-56 56ZM380-400q75 0 127.5-52.5T560-580q0-75-52.5-127.5T380-760q-75 0-127.5 52.5T200-580q0 75 52.5 127.5T380-400Z"></path>
+					</svg>
+					<input
+						type="text"
+						class="emdash-search-input"
+						placeholder={placeholder}
+						autocomplete="off"
+						spellcheck="false"
+						aria-label="Search"
+						aria-autocomplete="list"
+						aria-controls="emdash-search-results"
+						aria-expanded="false"
+					/>
+				</div>
+				<div class="emdash-search-content">
+					<div class="emdash-search-results" id="emdash-search-results" role="listbox" aria-label="Search results">
+						<div class="emdash-search-empty">
+							<svg class="emdash-search-empty-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+								<circle cx="11" cy="11" r="8"></circle>
+								<path d="m21 21-4.35-4.35"></path>
+							</svg>
+							<div class="emdash-search-empty-text">Start typing to search</div>
+						</div>
+					</div>
+				</div>
+				<div class="emdash-search-footer">
+					<div class="emdash-search-hints">
+						<span class="emdash-search-hint"><kbd>&uarr;</kbd><kbd>&darr;</kbd> Navigate</span>
+						<span class="emdash-search-hint"><kbd>&crarr;</kbd> Open</span>
+						<span class="emdash-search-hint"><kbd>Esc</kbd> Close</span>
+					</div>
+				</div>
+			</div>
+		</div>
+	</template>
+</emdash-search-modal>
+
+<script>
+	// Sanitization patterns for search snippets (allow only <mark> tags from FTS5)
+	const SNIPPET_AMP_RE = /&/g;
+	const SNIPPET_LT_RE = /</g;
+	const SNIPPET_GT_RE = />/g;
+	const SNIPPET_MARK_OPEN_RE = /&lt;mark&gt;/g;
+	const SNIPPET_MARK_CLOSE_RE = /&lt;\/mark&gt;/g;
+
+	interface SearchResult {
+		collection: string;
+		id: string;
+		slug: string | null;
+		title?: string;
+		snippet?: string;
+		score: number;
+	}
+
+	interface Config {
+		collections: string;
+		minChars: number;
+		debounce: number;
+		limit: number;
+		shortcut: string;
+		searchEndpoint: string | null;
+	}
+
+	/** Create an SVG element from a static markup string. Only used for icons with no dynamic content. */
+	function createSvgIcon(html: string): SVGElement {
+		const tmp = document.createElement("template");
+		tmp.innerHTML = html.trim();
+		return tmp.content.firstElementChild as SVGElement;
+	}
+
+	/** Sanitize a search snippet to allow only <mark> tags (from FTS5 highlighting). */
+	function sanitizeSnippet(snippet: string): string {
+		return snippet
+			.replace(SNIPPET_AMP_RE, "&amp;")
+			.replace(SNIPPET_LT_RE, "&lt;")
+			.replace(SNIPPET_GT_RE, "&gt;")
+			.replace(SNIPPET_MARK_OPEN_RE, "<mark>")
+			.replace(SNIPPET_MARK_CLOSE_RE, "</mark>");
+	}
+
+	const SEARCH_ICON_SVG = `<svg class="emdash-search-empty-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"></circle><path d="m21 21-4.35-4.35"></path></svg>`;
+
+	class EmDashSearchModal extends HTMLElement {
+		private trigger: HTMLButtonElement | null = null;
+		private backdrop: HTMLElement | null = null;
+		private dialog: HTMLElement | null = null;
+		private input: HTMLInputElement | null = null;
+		private resultsContainer: HTMLElement | null = null;
+		private config: Config = {
+			collections: "",
+			minChars: 2,
+			debounce: 300,
+			limit: 10,
+			shortcut: "k",
+			searchEndpoint: null,
+		};
+		private debounceTimer: ReturnType<typeof setTimeout> | null = null;
+		private abortController: AbortController | null = null;
+		private results: SearchResult[] = [];
+		private activeIndex = -1;
+		private isOpen = false;
+
+		connectedCallback() {
+			const configStr = this.dataset.config;
+			if (configStr) {
+				try {
+					this.config = { ...this.config, ...JSON.parse(configStr) };
+				} catch {
+					// Use defaults
+				}
+			}
+
+			this.trigger = this.querySelector(".emdash-search-trigger");
+
+			// Stamp the backdrop template and append to document.body so it
+			// sits outside any parent stacking context (sticky headers, etc.)
+			const tpl = this.querySelector<HTMLTemplateElement>(".emdash-search-backdrop-tpl");
+			if (tpl) {
+				const fragment = tpl.content.cloneNode(true) as DocumentFragment;
+				document.body.appendChild(fragment);
+				tpl.remove();
+			}
+			this.backdrop = document.body.querySelector(".emdash-search-backdrop");
+			this.dialog = this.backdrop?.querySelector(".emdash-search-dialog") ?? null;
+			this.input = this.backdrop?.querySelector(".emdash-search-input") ?? null;
+			this.resultsContainer = this.backdrop?.querySelector(".emdash-search-results") ?? null;
+
+			// Populate modifier key glyph
+			const modSpan = this.querySelector(".emdash-search-trigger-kbd-mod");
+			if (modSpan) {
+				const isMac =
+					navigator.platform?.startsWith("Mac") ||
+					(navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform === "macOS";
+				modSpan.textContent = isMac ? "\u2318" : "Ctrl+";
+			}
+
+			this.trigger?.addEventListener("click", () => this.open());
+
+			this.backdrop?.addEventListener("click", (e) => {
+				if (e.target === this.backdrop) this.close();
+			});
+
+			this.input?.addEventListener("input", () => this.handleInput());
+			this.input?.addEventListener("keydown", (e) => this.handleKeydown(e));
+
+			document.addEventListener("keydown", (e) => {
+				if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === this.config.shortcut) {
+					e.preventDefault();
+					if (this.isOpen) {
+						this.close();
+					} else {
+						this.open();
+					}
+				}
+			});
+		}
+
+		private open() {
+			if (this.isOpen) return;
+			this.isOpen = true;
+
+			if (this.backdrop) {
+				this.backdrop.classList.add("visible");
+				// Force reflow so opacity transition plays
+				void this.backdrop.offsetHeight;
+				this.backdrop.classList.add("open");
+			}
+
+			// Lock scroll and compensate for scrollbar disappearing
+			const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
+			document.body.style.overflow = "hidden";
+			if (scrollbarWidth > 0) {
+				document.body.style.paddingRight = `${scrollbarWidth}px`;
+			}
+
+			requestAnimationFrame(() => {
+				requestAnimationFrame(() => {
+					this.input?.focus();
+				});
+			});
+		}
+
+		private close() {
+			if (!this.isOpen) return;
+			this.isOpen = false;
+
+			this.backdrop?.classList.remove("open");
+			document.body.style.overflow = "";
+			document.body.style.paddingRight = "";
+
+			// Wait for opacity transition to finish, then hide
+			setTimeout(() => {
+				if (!this.isOpen && this.backdrop) {
+					this.backdrop.classList.remove("visible");
+				}
+			}, 200);
+
+			// Reset state
+			if (this.input) this.input.value = "";
+			this.results = [];
+			this.activeIndex = -1;
+			this.showEmpty();
+		}
+
+		private handleInput() {
+			if (!this.input) return;
+			const query = this.input.value.trim();
+
+			if (this.debounceTimer) clearTimeout(this.debounceTimer);
+
+			if (query.length < this.config.minChars) {
+				this.showEmpty();
+				return;
+			}
+
+			this.debounceTimer = setTimeout(() => {
+				this.search(query);
+			}, this.config.debounce);
+		}
+
+		private handleKeydown(e: KeyboardEvent) {
+			switch (e.key) {
+				case "ArrowDown":
+					e.preventDefault();
+					this.navigate(1);
+					break;
+				case "ArrowUp":
+					e.preventDefault();
+					this.navigate(-1);
+					break;
+				case "Enter":
+					e.preventDefault();
+					this.selectActive();
+					break;
+				case "Escape":
+					e.preventDefault();
+					this.close();
+					break;
+			}
+		}
+
+		private navigate(direction: number) {
+			if (this.results.length === 0) return;
+
+			const newIndex = this.activeIndex + direction;
+			if (newIndex < 0) {
+				this.activeIndex = this.results.length - 1;
+			} else if (newIndex >= this.results.length) {
+				this.activeIndex = 0;
+			} else {
+				this.activeIndex = newIndex;
+			}
+
+			this.updateActive();
+		}
+
+		private updateActive() {
+			const items = this.resultsContainer?.querySelectorAll(".emdash-search-result");
+			if (!items) return;
+
+			items.forEach((item, i) => {
+				if (i === this.activeIndex) {
+					item.classList.add("active");
+					item.setAttribute("aria-selected", "true");
+					(item as HTMLElement).scrollIntoView({ block: "nearest" });
+				} else {
+					item.classList.remove("active");
+					item.setAttribute("aria-selected", "false");
+				}
+			});
+
+			if (this.input) {
+				if (this.activeIndex >= 0) {
+					this.input.setAttribute("aria-activedescendant", `emdash-result-${this.activeIndex}`);
+				} else {
+					this.input.removeAttribute("aria-activedescendant");
+				}
+			}
+		}
+
+		private selectActive() {
+			if (this.activeIndex < 0 || this.activeIndex >= this.results.length) return;
+
+			const result = this.results[this.activeIndex];
+			if (!result) return;
+
+			const path = result.slug ?? result.id;
+			window.location.href = `/${result.collection}/${path}`;
+			this.close();
+		}
+
+		private async search(query: string) {
+			if (this.abortController) this.abortController.abort();
+			this.abortController = new AbortController();
+
+			this.showLoading();
+
+			try {
+				const endpoint = this.config.searchEndpoint ?? "/_emdash/api/search";
+				const params = new URLSearchParams({
+					q: query,
+					limit: String(this.config.limit),
+				});
+
+				if (this.config.collections) {
+					// Custom endpoints use 'collection' (singular) for filtering
+					if (this.config.searchEndpoint) {
+						params.set("collection", this.config.collections);
+					} else {
+						params.set("collections", this.config.collections);
+					}
+				}
+
+				const response = await fetch(`${endpoint}?${params}`, {
+					signal: this.abortController.signal,
+				});
+
+				if (!response.ok) throw new Error("Search failed");
+
+				// eslint-disable-next-line @typescript-eslint/no-explicit-any -- response shape varies by endpoint
+				const responseData: any = await response.json();
+				// Handle API response envelope: { data: { items: [...] } }
+				const data = responseData.data || responseData;
+				const items: SearchResult[] = data.items || data.results || [];
+
+				this.results = items;
+				this.activeIndex = items.length > 0 ? 0 : -1;
+				this.renderResults(items, query);
+			} catch (error) {
+				if ((error as Error).name === "AbortError") return;
+				this.showError();
+			}
+		}
+
+		private renderResults(results: SearchResult[], _query: string) {
+			if (!this.resultsContainer) return;
+
+			if (results.length === 0) {
+				this.showNoResults(_query);
+				return;
+			}
+
+			// Clear previous results
+			this.resultsContainer.textContent = "";
+
+			for (let i = 0; i < results.length; i++) {
+				const result = results[i]!;
+				const link = document.createElement("a");
+				link.href = `/${result.collection}/${result.slug ?? result.id}`;
+				link.className = `emdash-search-result${i === this.activeIndex ? " active" : ""}`;
+				link.role = "option";
+				link.id = `emdash-result-${i}`;
+				link.setAttribute("aria-selected", String(i === this.activeIndex));
+				link.dataset.index = String(i);
+
+				const body = document.createElement("div");
+				body.className = "emdash-search-result-body";
+
+				const titleEl = document.createElement("div");
+				titleEl.className = "emdash-search-result-title";
+				titleEl.textContent = result.title ?? result.slug ?? result.id;
+				body.appendChild(titleEl);
+
+				if (result.snippet) {
+					const snippetEl = document.createElement("div");
+					snippetEl.className = "emdash-search-result-snippet";
+					// innerHTML is intentional: sanitizeSnippet allows only <mark> tags
+					snippetEl.innerHTML = sanitizeSnippet(result.snippet);
+					body.appendChild(snippetEl);
+				}
+
+				const meta = document.createElement("div");
+				meta.className = "emdash-search-result-meta";
+				const collectionEl = document.createElement("span");
+				collectionEl.className = "emdash-search-result-collection";
+				collectionEl.textContent = result.collection;
+				meta.appendChild(collectionEl);
+				body.appendChild(meta);
+
+				link.appendChild(body);
+
+				// Mouse hover sets active index
+				link.addEventListener("mouseenter", () => {
+					this.activeIndex = i;
+					this.updateActive();
+				});
+
+				this.resultsContainer.appendChild(link);
+			}
+
+			if (this.input) this.input.setAttribute("aria-expanded", "true");
+		}
+
+		private showEmpty() {
+			if (!this.resultsContainer) return;
+			this.resultsContainer.textContent = "";
+
+			const wrap = document.createElement("div");
+			wrap.className = "emdash-search-empty";
+			wrap.appendChild(createSvgIcon(SEARCH_ICON_SVG));
+			const text = document.createElement("div");
+			text.className = "emdash-search-empty-text";
+			text.textContent = "Start typing to search";
+			wrap.appendChild(text);
+			this.resultsContainer.appendChild(wrap);
+
+			if (this.input) this.input.setAttribute("aria-expanded", "false");
+		}
+
+		private showLoading() {
+			if (!this.resultsContainer) return;
+			this.resultsContainer.textContent = "";
+
+			const wrap = document.createElement("div");
+			wrap.className = "emdash-search-loading";
+			const spinner = document.createElement("div");
+			spinner.className = "emdash-search-spinner";
+			wrap.appendChild(spinner);
+			const text = document.createElement("div");
+			text.className = "emdash-search-loading-text";
+			text.textContent = "Searching...";
+			wrap.appendChild(text);
+			this.resultsContainer.appendChild(wrap);
+		}
+
+		private showNoResults(query: string) {
+			if (!this.resultsContainer) return;
+			this.resultsContainer.textContent = "";
+
+			const wrap = document.createElement("div");
+			wrap.className = "emdash-search-empty";
+			wrap.appendChild(createSvgIcon(SEARCH_ICON_SVG));
+			const title = document.createElement("div");
+			title.className = "emdash-search-empty-title";
+			title.textContent = "No results found";
+			wrap.appendChild(title);
+			const text = document.createElement("div");
+			text.className = "emdash-search-empty-text";
+			text.textContent = `No results for "${query}"`;
+			wrap.appendChild(text);
+			this.resultsContainer.appendChild(wrap);
+
+			if (this.input) this.input.setAttribute("aria-expanded", "false");
+		}
+
+		private showError() {
+			if (!this.resultsContainer) return;
+			this.resultsContainer.textContent = "";
+
+			const wrap = document.createElement("div");
+			wrap.className = "emdash-search-empty";
+			const title = document.createElement("div");
+			title.className = "emdash-search-empty-title";
+			title.textContent = "Search unavailable";
+			wrap.appendChild(title);
+			const text = document.createElement("div");
+			text.className = "emdash-search-empty-text";
+			text.textContent = "Please try again later";
+			wrap.appendChild(text);
+			this.resultsContainer.appendChild(wrap);
+		}
+	}
+
+	customElements.define("emdash-search-modal", EmDashSearchModal);
+</script>
+
+<style>
+	/*
+	 * SearchModal uses CSS custom properties for theming.
+	 * Override these in your site's CSS to match your design:
+	 *
+	 * --emdash-search-bg: Background color for the modal
+	 * --emdash-search-surface: Subtle surface color (footer, hover)
+	 * --emdash-search-text: Primary text color
+	 * --emdash-search-muted: Secondary/muted text color
+	 * --emdash-search-border: Border color
+	 * --emdash-search-accent: Primary accent color
+	 * --emdash-search-accent-ring: Focus ring color (with alpha)
+	 * --emdash-search-radius: Border radius
+	 * --emdash-search-font: Font family
+	 */
+
+	/* ========= Trigger button ========= */
+
+	.emdash-search-trigger {
+		display: inline-flex;
+		align-items: center;
+		gap: 8px;
+		padding: 6px 12px;
+		background: var(--emdash-search-bg, #fff);
+		border: 1px solid var(--emdash-search-border, #dee2e6);
+		border-radius: var(--emdash-search-radius, 18px);
+		color: var(--emdash-search-muted, #6c757d);
+		font-family: var(--emdash-search-font, inherit);
+		font-size: 14px;
+		cursor: pointer;
+		transition: border-color 150ms ease, box-shadow 150ms ease;
+		white-space: nowrap;
+	}
+
+	.emdash-search-trigger:hover {
+		border-color: var(--emdash-search-accent, #2563eb);
+	}
+
+	.emdash-search-trigger:focus-visible {
+		outline: none;
+		border-color: var(--emdash-search-accent, #2563eb);
+		box-shadow: 0 0 0 3px var(--emdash-search-accent-ring, rgba(37, 99, 235, 0.25));
+	}
+
+	.emdash-search-trigger-icon {
+		width: 16px;
+		height: 16px;
+		flex-shrink: 0;
+	}
+
+	.emdash-search-trigger-text {
+		flex: 1;
+		text-align: left;
+	}
+
+	.emdash-search-trigger-kbd {
+		display: inline-flex;
+		align-items: center;
+		gap: 1px;
+		padding: 1px 6px;
+		background: var(--emdash-search-surface, #f8f9fa);
+		border: 1px solid var(--emdash-search-border, #dee2e6);
+		border-radius: 4px;
+		font-size: 11px;
+		font-family: var(--emdash-search-font, inherit);
+		color: var(--emdash-search-muted, #6c757d);
+		line-height: 1.6;
+	}
+
+	/* ========= Backdrop ========= */
+	/* Backdrop and descendants use :global() because the <template> is stamped
+	   into document.body at runtime, outside Astro's scoped style boundary. */
+
+	:global(.emdash-search-backdrop) {
+		position: fixed;
+		inset: 0;
+		z-index: 10000;
+		display: none;
+		align-items: flex-start;
+		justify-content: center;
+		padding-top: 15vh;
+		background: rgba(0, 0, 0, 0.5);
+		backdrop-filter: blur(4px);
+		opacity: 0;
+		transition: opacity 200ms ease;
+	}
+
+	:global(.emdash-search-backdrop.visible) {
+		display: flex;
+	}
+
+	:global(.emdash-search-backdrop.open) {
+		opacity: 1;
+	}
+
+	/* ========= Dialog ========= */
+
+	:global(.emdash-search-dialog) {
+		width: 90%;
+		max-width: 600px;
+		max-height: 70vh;
+		background: var(--emdash-search-bg, #fff);
+		border: 1px solid var(--emdash-search-border, #dee2e6);
+		border-radius: var(--emdash-search-radius, 18px);
+		box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);
+		display: flex;
+		flex-direction: column;
+		overflow: hidden;
+		transform: scale(0.95) translateY(-10px);
+		transition: transform 200ms ease;
+	}
+
+	:global(.emdash-search-backdrop.open .emdash-search-dialog) {
+		transform: scale(1) translateY(0);
+	}
+
+	/* ========= Header ========= */
+
+	:global(.emdash-search-header) {
+		display: flex;
+		align-items: center;
+		gap: 8px;
+		padding: 12px 16px;
+		border-bottom: 1px solid var(--emdash-search-border, #dee2e6);
+	}
+
+	:global(.emdash-search-icon) {
+		width: 20px;
+		height: 20px;
+		color: var(--emdash-search-muted, #6c757d);
+		flex-shrink: 0;
+	}
+
+	:global(.emdash-search-input) {
+		flex: 1;
+		border: none;
+		outline: none;
+		background: transparent;
+		color: var(--emdash-search-text, #212529);
+		font-size: 16px;
+		font-family: var(--emdash-search-font, inherit);
+		padding: 4px 0;
+	}
+
+	:global(.emdash-search-input::placeholder) {
+		color: var(--emdash-search-muted, #6c757d);
+	}
+
+	/* ========= Content ========= */
+
+	:global(.emdash-search-content) {
+		flex: 1;
+		overflow-y: auto;
+		overflow-x: hidden;
+		padding: 8px;
+	}
+
+	:global(.emdash-search-content::-webkit-scrollbar) {
+		width: 8px;
+	}
+
+	:global(.emdash-search-content::-webkit-scrollbar-track) {
+		background: var(--emdash-search-surface, #f8f9fa);
+	}
+
+	:global(.emdash-search-content::-webkit-scrollbar-thumb) {
+		background: var(--emdash-search-border, #dee2e6);
+		border-radius: 18px;
+	}
+
+	:global(.emdash-search-content::-webkit-scrollbar-thumb:hover) {
+		background: var(--emdash-search-muted, #6c757d);
+	}
+
+	/* ========= Results ========= */
+
+	:global(.emdash-search-results) {
+		display: flex;
+		flex-direction: column;
+		gap: 4px;
+	}
+
+	:global(.emdash-search-result) {
+		display: flex;
+		align-items: flex-start;
+		gap: 12px;
+		padding: 12px;
+		background: transparent;
+		border: 1px solid transparent;
+		border-radius: calc(var(--emdash-search-radius, 18px) - 4px);
+		text-decoration: none;
+		color: inherit;
+		cursor: pointer;
+		transition: background 150ms ease, border-color 150ms ease;
+	}
+
+	:global(.emdash-search-result:hover),
+	:global(.emdash-search-result.active) {
+		background: var(--emdash-search-surface, #f1f3f5);
+		border-color: var(--emdash-search-border, #dee2e6);
+	}
+
+	:global(.emdash-search-result.active) {
+		border-color: var(--emdash-search-accent, #2563eb);
+		background: var(--emdash-search-accent-ring, rgba(37, 99, 235, 0.08));
+	}
+
+	:global(.emdash-search-result:focus-visible) {
+		outline: 2px solid var(--emdash-search-accent, #2563eb);
+		outline-offset: -2px;
+	}
+
+	:global(.emdash-search-result-body) {
+		flex: 1;
+		min-width: 0;
+		display: flex;
+		flex-direction: column;
+		gap: 4px;
+	}
+
+	:global(.emdash-search-result-title) {
+		font-size: 14px;
+		font-weight: 500;
+		color: var(--emdash-search-text, #212529);
+		display: -webkit-box;
+		-webkit-line-clamp: 1;
+		-webkit-box-orient: vertical;
+		overflow: hidden;
+	}
+
+	:global(.emdash-search-result-snippet) {
+		font-size: 12px;
+		color: var(--emdash-search-muted, #495057);
+		line-height: 1.5;
+		display: -webkit-box;
+		-webkit-line-clamp: 2;
+		-webkit-box-orient: vertical;
+		overflow: hidden;
+	}
+
+	:global(.emdash-search-result-snippet mark) {
+		font-weight: 600;
+		background: none;
+		color: var(--emdash-search-text, #212529);
+	}
+
+	:global(.emdash-search-result-meta) {
+		display: flex;
+		align-items: center;
+		gap: 8px;
+	}
+
+	:global(.emdash-search-result-collection) {
+		font-size: 11px;
+		color: var(--emdash-search-accent, #2563eb);
+		text-transform: uppercase;
+		letter-spacing: 0.05em;
+		font-weight: 500;
+	}
+
+	/* ========= Empty / Loading states ========= */
+
+	:global(.emdash-search-empty) {
+		display: flex;
+		flex-direction: column;
+		align-items: center;
+		justify-content: center;
+		padding: 32px;
+		gap: 12px;
+		color: var(--emdash-search-muted, #6c757d);
+		text-align: center;
+	}
+
+	:global(.emdash-search-empty-icon) {
+		width: 48px;
+		height: 48px;
+		opacity: 0.5;
+	}
+
+	:global(.emdash-search-empty-title) {
+		font-size: 14px;
+		font-weight: 500;
+		color: var(--emdash-search-text, #212529);
+	}
+
+	:global(.emdash-search-empty-text) {
+		font-size: 13px;
+	}
+
+	:global(.emdash-search-loading) {
+		display: flex;
+		flex-direction: column;
+		align-items: center;
+		justify-content: center;
+		padding: 32px;
+		gap: 12px;
+		color: var(--emdash-search-muted, #6c757d);
+	}
+
+	:global(.emdash-search-spinner) {
+		width: 20px;
+		height: 20px;
+		border: 2px solid currentColor;
+		border-top-color: transparent;
+		border-radius: 50%;
+		animation: emdash-spin 0.6s linear infinite;
+	}
+
+	@keyframes emdash-spin {
+		to { transform: rotate(360deg); }
+	}
+
+	:global(.emdash-search-loading-text) {
+		font-size: 13px;
+	}
+
+	/* ========= Footer ========= */
+
+	:global(.emdash-search-footer) {
+		display: flex;
+		align-items: center;
+		justify-content: space-between;
+		padding: 8px 16px;
+		border-top: 1px solid var(--emdash-search-border, #dee2e6);
+		background: var(--emdash-search-surface, #f8f9fa);
+		font-size: 12px;
+		color: var(--emdash-search-muted, #6c757d);
+		border-radius: 0 0 var(--emdash-search-radius, 18px) var(--emdash-search-radius, 18px);
+	}
+
+	:global(.emdash-search-hints) {
+		display: flex;
+		align-items: center;
+		gap: 12px;
+	}
+
+	:global(.emdash-search-hint) {
+		display: flex;
+		align-items: center;
+		gap: 4px;
+	}
+
+	:global(.emdash-search-hint kbd) {
+		display: inline-flex;
+		align-items: center;
+		justify-content: center;
+		min-width: 20px;
+		height: 20px;
+		padding: 0 4px;
+		background: var(--emdash-search-bg, #fff);
+		border: 1px solid var(--emdash-search-border, #dee2e6);
+		border-radius: 4px;
+		font-size: 11px;
+		font-family: var(--emdash-search-font, inherit);
+		color: var(--emdash-search-muted, #6c757d);
+	}
+
+	/* ========= Responsive ========= */
+
+	@media (max-width: 640px) {
+		:global(.emdash-search-backdrop) {
+			padding-top: 10%;
+		}
+
+		:global(.emdash-search-dialog) {
+			width: 95%;
+			max-height: 80vh;
+		}
+
+		:global(.emdash-search-hints) {
+			display: none;
+		}
+
+		.emdash-search-trigger-text {
+			display: none;
+		}
+
+		.emdash-search-trigger-kbd {
+			display: none;
+		}
+	}
+</style>
diff --git a/demos/cloudflare/src/layouts/Base.astro b/demos/cloudflare/src/layouts/Base.astro
index e662077d9..df0ee59c1 100644
--- a/demos/cloudflare/src/layouts/Base.astro
+++ b/demos/cloudflare/src/layouts/Base.astro
@@ -8,7 +8,7 @@ import {
 } from "emdash/ui";
 import { createPublicPageContext } from "emdash/page";
 import { Font } from "astro:assets";
-import LiveSearch from "emdash/ui/search";
+import SearchModal from "../components/SearchModal.astro";
 import "../styles/theme.css";
 
 interface Props {
@@ -99,14 +99,11 @@ const isLoggedIn = !!Astro.locals.user;
 			<nav class="nav">
 				<a href="/" class="site-title">{siteTitle}</a>
 				<div class="nav-right">
-					<LiveSearch
-						placeholder="Search..."
-						class="site-search"
-						inputClass="site-search-input"
-						resultsClass="site-search-results"
-						resultClass="site-search-result"
-						collections={["posts", "pages"]}
-					/>
+				<SearchModal
+					placeholder="Search..."
+					collections={["posts", "pages"]}
+					searchEndpoint="/_emdash/api/plugins/ai-search/query"
+				/>
 					<div class="nav-links">
 						{
 							menu?.items.map((item) => (
@@ -441,9 +438,6 @@ const isLoggedIn = !!Astro.locals.user;
 				/* Nav */
 				--nav-height: 64px;
 
-				/* Search */
-				--search-input-width: 180px;
-
 				/* Article layout */
 				--meta-col-width: 180px;
 
@@ -618,107 +612,19 @@ const isLoggedIn = !!Astro.locals.user;
 				opacity: 1;
 			}
 
-			/* Search styling */
-			.site-search {
-				position: relative;
-				width: var(--search-input-width);
-				--emdash-search-border-focus: var(--color-accent);
-			}
-
-			:global(.site-search-input) {
-				width: var(--search-input-width);
-				padding: var(--spacing-2) var(--spacing-3);
-				font-family: var(--font-sans);
-				font-size: var(--font-size-sm);
-				border: 1px solid var(--color-border);
-				border-radius: var(--radius);
-				background: var(--color-bg);
-				color: var(--color-text);
-				transition:
-					border-color var(--transition-fast),
-					box-shadow var(--transition-fast);
-			}
-
-			:global(.site-search-input)::placeholder {
-				color: var(--color-muted);
-			}
-
-			:global(.site-search-input):focus,
-			:global(.site-search-input):focus-visible {
-				outline: none;
-				border-color: var(--color-accent) !important;
-				box-shadow: 0 0 0 3px var(--color-accent-ring);
-			}
-
-			:global(.site-search-results) {
-				position: absolute;
-				top: 100%;
-				left: 0;
-				right: 0;
-				margin-top: var(--spacing-2);
-				background: var(--color-bg);
-				border: 1px solid var(--color-border);
-				border-radius: var(--radius-lg);
-				box-shadow: var(--shadow-dropdown);
-				max-height: 400px;
-				overflow-y: auto;
-				z-index: 1000;
-			}
-
-			:global(.site-search-results .emdash-live-search-loading),
-			:global(.site-search-results .emdash-live-search-no-results) {
-				padding: var(--spacing-4);
-				text-align: center;
-				color: var(--color-muted);
-				font-size: var(--font-size-sm);
-			}
-
-			:global(.site-search-result) {
-				display: block;
-				padding: var(--spacing-3) var(--spacing-4);
-				text-decoration: none;
-				color: var(--color-text);
-				border-bottom: 1px solid var(--color-border-subtle);
-				transition: background var(--transition-fast);
-			}
-
-			:global(.site-search-result):last-child {
-				border-bottom: none;
-			}
-
-			:global(.site-search-result):hover,
-			:global(.site-search-result):focus,
-			:global(.site-search-result.focused) {
-				background: var(--color-surface);
-				outline: none;
-			}
-
-			:global(.site-search-result .emdash-live-search-result-title) {
-				display: block;
-				font-weight: 500;
-				font-size: var(--font-size-sm);
-			}
-
-			:global(.site-search-result .emdash-live-search-result-collection) {
-				display: block;
-				font-size: var(--font-size-xs);
-				color: var(--color-muted);
-				text-transform: uppercase;
-				letter-spacing: var(--tracking-wide);
-				margin-top: 2px;
-			}
-
-			:global(.site-search-result .emdash-live-search-result-snippet) {
-				display: block;
-				font-size: var(--font-size-sm);
-				color: var(--color-muted);
-				margin-top: var(--spacing-1);
-				line-height: var(--leading-snug);
-			}
-
-			:global(.site-search-result .emdash-live-search-result-snippet mark) {
-				font-weight: 600;
-				color: var(--color-text);
+			/* Search modal theming -- applied to both the trigger (inside the nav)
+			   and the backdrop (appended to document.body at runtime) */
+			:global(emdash-search-modal),
+			:global(.emdash-search-backdrop) {
+				--emdash-search-bg: var(--color-bg);
+				--emdash-search-surface: var(--color-surface);
+				--emdash-search-text: var(--color-text);
+				--emdash-search-muted: var(--color-muted);
+				--emdash-search-border: var(--color-border);
+				--emdash-search-accent: var(--color-accent);
+				--emdash-search-accent-ring: var(--color-accent-ring);
+				--emdash-search-radius: var(--radius-lg);
+				--emdash-search-font: var(--font-sans);
 			}
 
 			main {
@@ -909,17 +815,6 @@ const isLoggedIn = !!Astro.locals.user;
 					display: contents;
 				}
 
-				.site-search {
-					order: 0;
-					max-width: 140px;
-				}
-
-				:global(.site-search-input) {
-					width: 140px !important;
-					padding: var(--spacing-1) var(--spacing-2) !important;
-					font-size: var(--font-size-sm) !important;
-				}
-
 				.nav-links {
 					order: 1;
 					width: 100%;
@@ -959,20 +854,6 @@ const isLoggedIn = !!Astro.locals.user;
 			}
 		</style>
 
-		<script>
-			// ⌘K / Ctrl+K to focus search
-			document.addEventListener("keydown", (e) => {
-				if ((e.metaKey || e.ctrlKey) && e.key === "k") {
-					e.preventDefault();
-					const searchInput = document.querySelector(
-						".site-search-input"
-					) as HTMLInputElement;
-					if (searchInput) {
-						searchInput.focus();
-					}
-				}
-			});
-		</script>
 		<EmDashBodyEnd page={pageCtx} />
 	</body>
 </html>
diff --git a/demos/cloudflare/src/pages/search.astro b/demos/cloudflare/src/pages/search.astro
index fd296062d..4cb1e4c3e 100644
--- a/demos/cloudflare/src/pages/search.astro
+++ b/demos/cloudflare/src/pages/search.astro
@@ -1,29 +1,38 @@
 ---
 export const prerender = false;
 
-import { getEmDashCollection } from "emdash";
 import Base from "../layouts/Base.astro";
-import PostCard from "../components/PostCard.astro";
-import { getReadingTime, extractText } from "../utils/reading-time";
 
 const query = Astro.url.searchParams.get("q")?.trim() || "";
 
-const { entries: allPosts } = await getEmDashCollection("posts");
-
-// Simple search: match query against title, excerpt, and content
-function matchesQuery(post: (typeof allPosts)[0], q: string): boolean {
-	if (!q) return false;
-	const lower = q.toLowerCase();
-	const title = (post.data.title || "").toLowerCase();
-	const excerpt = (post.data.excerpt || "").toLowerCase();
-	// Extract plain text from portable text blocks (avoids matching on _type, _key, etc.)
-	const content = extractText(post.data.content).toLowerCase();
-	return (
-		title.includes(lower) || excerpt.includes(lower) || content.includes(lower)
-	);
+interface AISearchResult {
+	collection: string;
+	id: string;
+	slug: string | null;
+	title: string | null;
+	score: number;
+	snippet: string;
 }
 
-const results = query ? allPosts.filter((p) => matchesQuery(p, query)) : [];
+let results: AISearchResult[] = [];
+let searchError: string | null = null;
+
+if (query) {
+	try {
+		const params = new URLSearchParams({ q: query, limit: "20" });
+		const apiUrl = new URL(`/_emdash/api/plugins/ai-search/query?${params}`, Astro.url);
+		const response = await fetch(apiUrl, {
+			headers: { Cookie: Astro.request.headers.get("Cookie") || "" },
+		});
+		if (response.ok) {
+			const data = (await response.json()) as { results: AISearchResult[]; error?: string };
+			results = data.results ?? [];
+			if (data.error) searchError = data.error;
+		}
+	} catch {
+		searchError = "Search is temporarily unavailable.";
+	}
+}
 ---
 
 <Base
@@ -46,7 +55,13 @@ const results = query ? allPosts.filter((p) => matchesQuery(p, query)) : [];
 		</form>
 
 		{
-			query && (
+			searchError && (
+				<p class="search-error">{searchError}</p>
+			)
+		}
+
+		{
+			query && !searchError && (
 				<p class="search-summary">
 					{results.length === 0
 						? `No results for "${query}"`
@@ -58,15 +73,14 @@ const results = query ? allPosts.filter((p) => matchesQuery(p, query)) : [];
 		{
 			results.length > 0 && (
 				<div class="search-results">
-					{results.map((post) => (
-						<PostCard
-							title={post.data.title}
-							excerpt={post.data.excerpt}
-							featuredImage={post.data.featured_image}
-							href={`/posts/${post.id}`}
-							date={post.data.publishedAt ?? undefined}
-							readingTime={getReadingTime(post.data.content)}
-						/>
+					{results.map((result) => (
+						<a href={`/${result.collection}/${result.slug ?? result.id}`} class="search-result-card">
+							<h3 class="search-result-title">{result.title ?? result.slug ?? result.id}</h3>
+							<span class="search-result-collection">{result.collection}</span>
+							{result.snippet && (
+								<p class="search-result-snippet">{result.snippet}</p>
+							)}
+						</a>
 					))}
 				</div>
 			)
@@ -129,6 +143,11 @@ const results = query ? allPosts.filter((p) => matchesQuery(p, query)) : [];
 		margin-bottom: var(--spacing-6);
 	}
 
+	.search-error {
+		color: #c33;
+		margin-bottom: var(--spacing-6);
+	}
+
 	.search-hint {
 		color: var(--color-muted);
 	}
@@ -136,6 +155,40 @@ const results = query ? allPosts.filter((p) => matchesQuery(p, query)) : [];
 	.search-results {
 		display: flex;
 		flex-direction: column;
-		gap: var(--spacing-8);
+		gap: var(--spacing-4);
+	}
+
+	.search-result-card {
+		display: block;
+		padding: var(--spacing-4) var(--spacing-5);
+		border: 1px solid var(--color-border);
+		border-radius: var(--radius-lg);
+		text-decoration: none;
+		color: var(--color-text);
+		transition: border-color var(--transition-fast);
+	}
+
+	.search-result-card:hover {
+		border-color: var(--color-accent);
+	}
+
+	.search-result-title {
+		font-size: var(--font-size-lg);
+		font-weight: 500;
+		margin-bottom: var(--spacing-1);
+	}
+
+	.search-result-collection {
+		font-size: var(--font-size-xs);
+		color: var(--color-muted);
+		text-transform: uppercase;
+		letter-spacing: 0.06em;
+	}
+
+	.search-result-snippet {
+		font-size: var(--font-size-sm);
+		color: var(--color-text-secondary);
+		margin-top: var(--spacing-2);
+		line-height: var(--leading-normal);
 	}
 </style>
diff --git a/demos/cloudflare/worker-configuration.d.ts b/demos/cloudflare/worker-configuration.d.ts
index 629f0c737..660300735 100644
--- a/demos/cloudflare/worker-configuration.d.ts
+++ b/demos/cloudflare/worker-configuration.d.ts
@@ -1,6 +1,6 @@
 /* eslint-disable */
-// Generated by Wrangler by running `wrangler types` (hash: 9c265de5f60dc95e990b3e1fb3254e99)
-// Runtime types generated with workerd@1.20260205.0 2026-01-14 disable_nodejs_process_v2,nodejs_compat
+// Generated by Wrangler by running `wrangler types` (hash: 7157f5986bd33a0a4daf3c50515c3bdc)
+// Runtime types generated with workerd@1.20260401.1 2026-01-14 disable_nodejs_process_v2,nodejs_compat
 declare namespace Cloudflare {
 	interface GlobalProps {
 		mainModule: typeof import("./src/worker");
@@ -9,20 +9,10 @@ declare namespace Cloudflare {
 		MEDIA: R2Bucket;
 		DB: D1Database;
 		LOADER: WorkerLoader;
-		CF_ACCESS_AUDIENCE: string;
-		CF_MEDIA_API_TOKEN: string;
-		CF_MEDIA_ACCOUNT_ID: string;
+		AI_SEARCH: AiSearchNamespace;
 	}
 }
 interface Env extends Cloudflare.Env {}
-type StringifyValues<EnvType extends Record<string, unknown>> = {
-	[Binding in keyof EnvType]: EnvType[Binding] extends string ? EnvType[Binding] : string;
-};
-declare namespace NodeJS {
-	interface ProcessEnv extends StringifyValues<
-		Pick<Cloudflare.Env, "CF_ACCESS_AUDIENCE" | "CF_MEDIA_API_TOKEN" | "CF_MEDIA_ACCOUNT_ID">
-	> {}
-}
 
 // Begin runtime types
 /*! *****************************************************************************
@@ -486,50 +476,61 @@ interface ExecutionContext<Props = unknown> {
 	readonly exports: Cloudflare.Exports;
 	readonly props: Props;
 }
-type ExportedHandlerFetchHandler<Env = unknown, CfHostMetadata = unknown> = (
+type ExportedHandlerFetchHandler<Env = unknown, CfHostMetadata = unknown, Props = unknown> = (
 	request: Request<CfHostMetadata, IncomingRequestCfProperties<CfHostMetadata>>,
 	env: Env,
-	ctx: ExecutionContext,
+	ctx: ExecutionContext<Props>,
 ) => Response | Promise<Response>;
-type ExportedHandlerTailHandler<Env = unknown> = (
+type ExportedHandlerConnectHandler<Env = unknown, Props = unknown> = (
+	socket: Socket,
+	env: Env,
+	ctx: ExecutionContext<Props>,
+) => void | Promise<void>;
+type ExportedHandlerTailHandler<Env = unknown, Props = unknown> = (
 	events: TraceItem[],
 	env: Env,
-	ctx: ExecutionContext,
+	ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
-type ExportedHandlerTraceHandler<Env = unknown> = (
+type ExportedHandlerTraceHandler<Env = unknown, Props = unknown> = (
 	traces: TraceItem[],
 	env: Env,
-	ctx: ExecutionContext,
+	ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
-type ExportedHandlerTailStreamHandler<Env = unknown> = (
+type ExportedHandlerTailStreamHandler<Env = unknown, Props = unknown> = (
 	event: TailStream.TailEvent<TailStream.Onset>,
 	env: Env,
-	ctx: ExecutionContext,
+	ctx: ExecutionContext<Props>,
 ) => TailStream.TailEventHandlerType | Promise<TailStream.TailEventHandlerType>;
-type ExportedHandlerScheduledHandler<Env = unknown> = (
+type ExportedHandlerScheduledHandler<Env = unknown, Props = unknown> = (
 	controller: ScheduledController,
 	env: Env,
-	ctx: ExecutionContext,
+	ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
-type ExportedHandlerQueueHandler<Env = unknown, Message = unknown> = (
+type ExportedHandlerQueueHandler<Env = unknown, Message = unknown, Props = unknown> = (
 	batch: MessageBatch<Message>,
 	env: Env,
-	ctx: ExecutionContext,
+	ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
-type ExportedHandlerTestHandler<Env = unknown> = (
+type ExportedHandlerTestHandler<Env = unknown, Props = unknown> = (
 	controller: TestController,
 	env: Env,
-	ctx: ExecutionContext,
+	ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
-interface ExportedHandler<Env = unknown, QueueHandlerMessage = unknown, CfHostMetadata = unknown> {
-	fetch?: ExportedHandlerFetchHandler<Env, CfHostMetadata>;
-	tail?: ExportedHandlerTailHandler<Env>;
-	trace?: ExportedHandlerTraceHandler<Env>;
-	tailStream?: ExportedHandlerTailStreamHandler<Env>;
-	scheduled?: ExportedHandlerScheduledHandler<Env>;
-	test?: ExportedHandlerTestHandler<Env>;
-	email?: EmailExportedHandler<Env>;
-	queue?: ExportedHandlerQueueHandler<Env, QueueHandlerMessage>;
+interface ExportedHandler<
+	Env = unknown,
+	QueueHandlerMessage = unknown,
+	CfHostMetadata = unknown,
+	Props = unknown,
+> {
+	fetch?: ExportedHandlerFetchHandler<Env, CfHostMetadata, Props>;
+	connect?: ExportedHandlerConnectHandler<Env, Props>;
+	tail?: ExportedHandlerTailHandler<Env, Props>;
+	trace?: ExportedHandlerTraceHandler<Env, Props>;
+	tailStream?: ExportedHandlerTailStreamHandler<Env, Props>;
+	scheduled?: ExportedHandlerScheduledHandler<Env, Props>;
+	test?: ExportedHandlerTestHandler<Env, Props>;
+	email?: EmailExportedHandler<Env, Props>;
+	queue?: ExportedHandlerQueueHandler<Env, QueueHandlerMessage, Props>;
 }
 interface StructuredSerializeOptions {
 	transfer?: any[];
@@ -544,12 +545,14 @@ declare abstract class Navigator {
 interface AlarmInvocationInfo {
 	readonly isRetry: boolean;
 	readonly retryCount: number;
+	readonly scheduledTime: number;
 }
 interface Cloudflare {
 	readonly compatibilityFlags: Record<string, boolean>;
 }
 interface DurableObject {
 	fetch(request: Request): Response | Promise<Response>;
+	connect?(socket: Socket): void | Promise<void>;
 	alarm?(alarmInfo?: AlarmInvocationInfo): void | Promise<void>;
 	webSocketMessage?(ws: WebSocket, message: string | ArrayBuffer): void | Promise<void>;
 	webSocketClose?(
@@ -562,7 +565,7 @@ interface DurableObject {
 }
 type DurableObjectStub<T extends Rpc.DurableObjectBranded | undefined = undefined> = Fetcher<
 	T,
-	"alarm" | "webSocketMessage" | "webSocketClose" | "webSocketError"
+	"alarm" | "connect" | "webSocketMessage" | "webSocketClose" | "webSocketError"
 > & {
 	readonly id: DurableObjectId;
 	readonly name?: string;
@@ -571,6 +574,7 @@ interface DurableObjectId {
 	toString(): string;
 	equals(other: DurableObjectId): boolean;
 	readonly name?: string;
+	readonly jurisdiction?: string;
 }
 declare abstract class DurableObjectNamespace<
 	T extends Rpc.DurableObjectBranded | undefined = undefined,
@@ -2916,6 +2920,11 @@ interface QueuingStrategyInit {
 	 */
 	highWaterMark: number;
 }
+interface TracePreviewInfo {
+	id: string;
+	slug: string;
+	name: string;
+}
 interface ScriptVersion {
 	id?: string;
 	tag?: string;
@@ -2930,6 +2939,7 @@ interface TraceItem {
 		| (
 				| TraceItemFetchEventInfo
 				| TraceItemJsRpcEventInfo
+				| TraceItemConnectEventInfo
 				| TraceItemScheduledEventInfo
 				| TraceItemAlarmEventInfo
 				| TraceItemQueueEventInfo
@@ -2948,6 +2958,8 @@ interface TraceItem {
 	readonly scriptVersion?: ScriptVersion;
 	readonly dispatchNamespace?: string;
 	readonly scriptTags?: string[];
+	readonly tailAttributes?: Record<string, boolean | number | string>;
+	readonly preview?: TracePreviewInfo;
 	readonly durableObjectId?: string;
 	readonly outcome: string;
 	readonly executionModel: string;
@@ -2958,6 +2970,7 @@ interface TraceItem {
 interface TraceItemAlarmEventInfo {
 	readonly scheduledTime: Date;
 }
+interface TraceItemConnectEventInfo {}
 interface TraceItemCustomEventInfo {}
 interface TraceItemScheduledEventInfo {
 	readonly scheduledTime: number;
@@ -3383,7 +3396,7 @@ declare var WebSocket: {
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
  */
 interface WebSocket extends EventTarget<WebSocketEventMap> {
-	accept(): void;
+	accept(options?: WebSocketAcceptOptions): void;
 	/**
 	 * The **`WebSocket.send()`** method enqueues the specified data to be transmitted to the server over the WebSocket connection, increasing the value of `bufferedAmount` by the number of bytes needed to contain the data.
 	 *
@@ -3422,6 +3435,22 @@ interface WebSocket extends EventTarget<WebSocketEventMap> {
 	 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/extensions)
 	 */
 	extensions: string | null;
+	/**
+	 * The **`WebSocket.binaryType`** property controls the type of binary data being received over the WebSocket connection.
+	 *
+	 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/binaryType)
+	 */
+	binaryType: "blob" | "arraybuffer";
+}
+interface WebSocketAcceptOptions {
+	/**
+	 * When set to `true`, receiving a server-initiated WebSocket Close frame will not
+	 * automatically send a reciprocal Close frame, leaving the connection in a half-open
+	 * state. This is useful for proxying scenarios where you need to coordinate closing
+	 * both sides independently. Defaults to `false` when the
+	 * `no_web_socket_half_open_by_default` compatibility flag is enabled.
+	 */
+	allowHalfOpen?: boolean;
 }
 declare const WebSocketPair: {
 	new (): {
@@ -3544,12 +3573,42 @@ interface Container {
 	signal(signo: number): void;
 	getTcpPort(port: number): Fetcher;
 	setInactivityTimeout(durationMs: number | bigint): Promise<void>;
+	interceptOutboundHttp(addr: string, binding: Fetcher): Promise<void>;
+	interceptAllOutboundHttp(binding: Fetcher): Promise<void>;
+	snapshotDirectory(
+		options: ContainerDirectorySnapshotOptions,
+	): Promise<ContainerDirectorySnapshot>;
+	snapshotContainer(options: ContainerSnapshotOptions): Promise<ContainerSnapshot>;
+}
+interface ContainerDirectorySnapshot {
+	id: string;
+	size: number;
+	dir: string;
+	name?: string;
+}
+interface ContainerDirectorySnapshotOptions {
+	dir: string;
+	name?: string;
+}
+interface ContainerDirectorySnapshotRestoreParams {
+	snapshot: ContainerDirectorySnapshot;
+	mountPoint?: string;
+}
+interface ContainerSnapshot {
+	id: string;
+	size: number;
+	name?: string;
+}
+interface ContainerSnapshotOptions {
+	name?: string;
 }
 interface ContainerStartupOptions {
 	entrypoint?: string[];
 	enableInternet: boolean;
 	env?: Record<string, string>;
-	hardTimeout?: number | bigint;
+	labels?: Record<string, string>;
+	directorySnapshots?: ContainerDirectorySnapshotRestoreParams[];
+	containerSnapshot?: ContainerSnapshot;
 }
 /**
  * The **`MessagePort`** interface of the Channel Messaging API represents one of the two ports of a MessageChannel, allowing messages to be sent from one port and listening out for them arriving at the other.
@@ -3651,6 +3710,7 @@ interface WorkerLoader {
 		name: string | null,
 		getCode: () => WorkerLoaderWorkerCode | Promise<WorkerLoaderWorkerCode>,
 	): WorkerStub;
+	load(code: WorkerLoaderWorkerCode): WorkerStub;
 }
 interface WorkerLoaderModule {
 	js?: string;
@@ -3683,6 +3743,463 @@ declare abstract class Performance {
 	get timeOrigin(): number;
 	/* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/#performancenow) */
 	now(): number;
+	/**
+	 * The **`toJSON()`** method of the Performance interface is a Serialization; it returns a JSON representation of the Performance object.
+	 *
+	 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/toJSON)
+	 */
+	toJSON(): object;
+}
+// ============ AI Search Error Interfaces ============
+interface AiSearchInternalError extends Error {}
+interface AiSearchNotFoundError extends Error {}
+// ============ AI Search Request Types ============
+type AiSearchSearchRequest = {
+	messages: Array<{
+		role: "system" | "developer" | "user" | "assistant" | "tool";
+		content: string | null;
+	}>;
+	ai_search_options?: {
+		retrieval?: {
+			retrieval_type?: "vector" | "keyword" | "hybrid";
+			/** Match threshold (0-1, default 0.4) */
+			match_threshold?: number;
+			/** Maximum number of results (1-50, default 10) */
+			max_num_results?: number;
+			filters?: VectorizeVectorMetadataFilter;
+			/** Context expansion (0-3, default 0) */
+			context_expansion?: number;
+			[key: string]: unknown;
+		};
+		query_rewrite?: {
+			enabled?: boolean;
+			model?: string;
+			rewrite_prompt?: string;
+			[key: string]: unknown;
+		};
+		reranking?: {
+			enabled?: boolean;
+			model?: "@cf/baai/bge-reranker-base" | string;
+			/** Match threshold (0-1, default 0.4) */
+			match_threshold?: number;
+			[key: string]: unknown;
+		};
+		[key: string]: unknown;
+	};
+};
+type AiSearchChatCompletionsRequest = {
+	messages: Array<{
+		role: "system" | "developer" | "user" | "assistant" | "tool";
+		content: string | null;
+		[key: string]: unknown;
+	}>;
+	model?: string;
+	stream?: boolean;
+	ai_search_options?: {
+		retrieval?: {
+			retrieval_type?: "vector" | "keyword" | "hybrid";
+			match_threshold?: number;
+			max_num_results?: number;
+			filters?: VectorizeVectorMetadataFilter;
+			context_expansion?: number;
+			[key: string]: unknown;
+		};
+		query_rewrite?: {
+			enabled?: boolean;
+			model?: string;
+			rewrite_prompt?: string;
+			[key: string]: unknown;
+		};
+		reranking?: {
+			enabled?: boolean;
+			model?: "@cf/baai/bge-reranker-base" | string;
+			match_threshold?: number;
+			[key: string]: unknown;
+		};
+		[key: string]: unknown;
+	};
+	[key: string]: unknown;
+};
+// ============ AI Search Response Types ============
+type AiSearchSearchResponse = {
+	search_query: string;
+	chunks: Array<{
+		id: string;
+		type: string;
+		/** Match score (0-1) */
+		score: number;
+		text: string;
+		item: {
+			timestamp?: number;
+			key: string;
+			metadata?: Record<string, unknown>;
+		};
+		scoring_details?: {
+			/** Keyword match score (0-1) */
+			keyword_score?: number;
+			/** Vector similarity score (0-1) */
+			vector_score?: number;
+			[key: string]: unknown;
+		};
+	}>;
+};
+type AiSearchChatCompletionsResponse = {
+	id?: string;
+	object?: string;
+	model?: string;
+	choices: Array<{
+		index?: number;
+		message: {
+			role: "system" | "developer" | "user" | "assistant" | "tool";
+			content: string | null;
+			[key: string]: unknown;
+		};
+		[key: string]: unknown;
+	}>;
+	chunks: AiSearchSearchResponse["chunks"];
+	[key: string]: unknown;
+};
+type AiSearchStatsResponse = {
+	queued?: number;
+	running?: number;
+	completed?: number;
+	error?: number;
+	skipped?: number;
+	outdated?: number;
+	last_activity?: string;
+};
+// ============ AI Search Instance Info Types ============
+type AiSearchInstanceInfo = {
+	id: string;
+	type?: "r2" | "web-crawler" | string;
+	source?: string;
+	paused?: boolean;
+	status?: string;
+	namespace?: string;
+	created_at?: string;
+	modified_at?: string;
+	[key: string]: unknown;
+};
+type AiSearchListResponse = {
+	result: AiSearchInstanceInfo[];
+	result_info?: {
+		count: number;
+		page: number;
+		per_page: number;
+		total_count: number;
+	};
+};
+// ============ AI Search Config Types ============
+type AiSearchConfig = {
+	/** Instance ID (1-32 chars, pattern: ^[a-z0-9_]+(?:-[a-z0-9_]+)*$) */
+	id: string;
+	/** Instance type. Omit to create with built-in storage. */
+	type?: "r2" | "web-crawler" | string;
+	/** Source URL (required for web-crawler type). */
+	source?: string;
+	source_params?: unknown;
+	/** Token ID (UUID format) */
+	token_id?: string;
+	ai_gateway_id?: string;
+	/** Enable query rewriting (default false) */
+	rewrite_query?: boolean;
+	/** Enable reranking (default false) */
+	reranking?: boolean;
+	embedding_model?: string;
+	ai_search_model?: string;
+	[key: string]: unknown;
+};
+// ============ AI Search Item Types ============
+type AiSearchItemInfo = {
+	id: string;
+	key: string;
+	status: "completed" | "error" | "skipped" | "queued" | "processing" | "outdated";
+	metadata?: Record<string, unknown>;
+	[key: string]: unknown;
+};
+type AiSearchItemContentResult = {
+	body: ReadableStream;
+	contentType: string;
+	filename: string;
+	size: number;
+};
+type AiSearchUploadItemOptions = {
+	metadata?: Record<string, unknown>;
+};
+type AiSearchListItemsParams = {
+	page?: number;
+	per_page?: number;
+};
+type AiSearchListItemsResponse = {
+	result: AiSearchItemInfo[];
+	result_info?: {
+		count: number;
+		page: number;
+		per_page: number;
+		total_count: number;
+	};
+};
+// ============ AI Search Job Types ============
+type AiSearchJobInfo = {
+	id: string;
+	source: "user" | "schedule";
+	description?: string;
+	last_seen_at?: string;
+	started_at?: string;
+	ended_at?: string;
+	end_reason?: string;
+};
+type AiSearchJobLog = {
+	id: number;
+	message: string;
+	message_type: number;
+	created_at: number;
+};
+type AiSearchCreateJobParams = {
+	description?: string;
+};
+type AiSearchListJobsParams = {
+	page?: number;
+	per_page?: number;
+};
+type AiSearchListJobsResponse = {
+	result: AiSearchJobInfo[];
+	result_info?: {
+		count: number;
+		page: number;
+		per_page: number;
+		total_count: number;
+	};
+};
+type AiSearchJobLogsParams = {
+	page?: number;
+	per_page?: number;
+};
+type AiSearchJobLogsResponse = {
+	result: AiSearchJobLog[];
+	result_info?: {
+		count: number;
+		page: number;
+		per_page: number;
+		total_count: number;
+	};
+};
+// ============ AI Search Sub-Service Classes ============
+/**
+ * Single item service for an AI Search instance.
+ * Provides info, delete, and download operations on a specific item.
+ */
+declare abstract class AiSearchItem {
+	/** Get metadata about this item. */
+	info(): Promise<AiSearchItemInfo>;
+	/**
+	 * Download the item's content.
+	 * @returns Object with body stream, content type, filename, and size.
+	 */
+	download(): Promise<AiSearchItemContentResult>;
+}
+/**
+ * Items collection service for an AI Search instance.
+ * Provides list, upload, and access to individual items.
+ */
+declare abstract class AiSearchItems {
+	/** List items in this instance. */
+	list(params?: AiSearchListItemsParams): Promise<AiSearchListItemsResponse>;
+	/**
+	 * Upload a file as an item.
+	 * @param name Filename for the uploaded item.
+	 * @param content File content as a ReadableStream, ArrayBuffer, or string.
+	 * @param options Optional metadata to attach to the item.
+	 * @returns The created item info.
+	 */
+	upload(
+		name: string,
+		content: ReadableStream | ArrayBuffer | string,
+		options?: AiSearchUploadItemOptions,
+	): Promise<AiSearchItemInfo>;
+	/**
+	 * Upload a file and poll until processing completes.
+	 * @param name Filename for the uploaded item.
+	 * @param content File content as a ReadableStream, ArrayBuffer, or string.
+	 * @param options Optional metadata to attach to the item.
+	 * @returns The item info after processing completes (or timeout).
+	 */
+	uploadAndPoll(
+		name: string,
+		content: ReadableStream | ArrayBuffer | string,
+		options?: AiSearchUploadItemOptions,
+	): Promise<AiSearchItemInfo>;
+	/**
+	 * Get an item by ID.
+	 * @param itemId The item identifier.
+	 * @returns Item service for info, delete, and download operations.
+	 */
+	get(itemId: string): AiSearchItem;
+	/** Delete this item from the instance.
+	 * @param itemId The item identifier.
+	 */
+	delete(itemId: string): Promise<void>;
+}
+/**
+ * Single job service for an AI Search instance.
+ * Provides info and logs for a specific job.
+ */
+declare abstract class AiSearchJob {
+	/** Get metadata about this job. */
+	info(): Promise<AiSearchJobInfo>;
+	/** Get logs for this job. */
+	logs(params?: AiSearchJobLogsParams): Promise<AiSearchJobLogsResponse>;
+}
+/**
+ * Jobs collection service for an AI Search instance.
+ * Provides list, create, and access to individual jobs.
+ */
+declare abstract class AiSearchJobs {
+	/** List jobs for this instance. */
+	list(params?: AiSearchListJobsParams): Promise<AiSearchListJobsResponse>;
+	/**
+	 * Create a new indexing job.
+	 * @param params Optional job parameters.
+	 * @returns The created job info.
+	 */
+	create(params?: AiSearchCreateJobParams): Promise<AiSearchJobInfo>;
+	/**
+	 * Get a job by ID.
+	 * @param jobId The job identifier.
+	 * @returns Job service for info and logs operations.
+	 */
+	get(jobId: string): AiSearchJob;
+}
+// ============ AI Search Binding Classes ============
+/**
+ * Instance-level AI Search service.
+ *
+ * Used as:
+ * - The return type of `AiSearchNamespace.get(name)` (namespace binding)
+ * - The type of `env.BLOG_SEARCH` (single instance binding via `ai_search`)
+ *
+ * Provides search, chat, update, stats, items, and jobs operations.
+ *
+ * @example
+ * ```ts
+ * // Via namespace binding
+ * const instance = env.AI_SEARCH.get("blog");
+ * const results = await instance.search({
+ *   messages: [{ role: "user", content: "How does caching work?" }],
+ * });
+ *
+ * // Via single instance binding
+ * const results = await env.BLOG_SEARCH.search({
+ *   messages: [{ role: "user", content: "How does caching work?" }],
+ * });
+ * ```
+ */
+declare abstract class AiSearchInstance {
+	/**
+	 * Search the AI Search instance for relevant chunks.
+	 * @param params Search request with messages and optional AI search options.
+	 * @returns Search response with matching chunks and search query.
+	 */
+	search(params: AiSearchSearchRequest): Promise<AiSearchSearchResponse>;
+	/**
+	 * Generate chat completions with AI Search context (streaming).
+	 * @param params Chat completions request with stream: true.
+	 * @returns ReadableStream of server-sent events.
+	 */
+	chatCompletions(
+		params: AiSearchChatCompletionsRequest & {
+			stream: true;
+		},
+	): Promise<ReadableStream>;
+	/**
+	 * Generate chat completions with AI Search context.
+	 * @param params Chat completions request.
+	 * @returns Chat completion response with choices and RAG chunks.
+	 */
+	chatCompletions(params: AiSearchChatCompletionsRequest): Promise<AiSearchChatCompletionsResponse>;
+	/**
+	 * Update the instance configuration.
+	 * @param config Partial configuration to update.
+	 * @returns Updated instance info.
+	 */
+	update(config: Partial<AiSearchConfig>): Promise<AiSearchInstanceInfo>;
+	/** Get metadata about this instance. */
+	info(): Promise<AiSearchInstanceInfo>;
+	/**
+	 * Get instance statistics (item count, indexing status, etc.).
+	 * @returns Statistics with counts per status and last activity time.
+	 */
+	stats(): Promise<AiSearchStatsResponse>;
+	/** Items collection — list, upload, and manage items in this instance. */
+	get items(): AiSearchItems;
+	/** Jobs collection — list, create, and inspect indexing jobs. */
+	get jobs(): AiSearchJobs;
+}
+/**
+ * Namespace-level AI Search service.
+ *
+ * Used as the type of `env.AI_SEARCH` (namespace binding via `ai_search_namespaces`).
+ * Scoped to a single namespace. Provides dynamic instance access, creation, and deletion.
+ *
+ * @example
+ * ```ts
+ * // Access an instance within the namespace
+ * const blog = env.AI_SEARCH.get("blog");
+ * const results = await blog.search({
+ *   messages: [{ role: "user", content: "How does caching work?" }],
+ * });
+ *
+ * // List all instances in the namespace
+ * const instances = await env.AI_SEARCH.list();
+ *
+ * // Create a new instance with built-in storage
+ * const tenant = await env.AI_SEARCH.create({
+ *   id: "tenant-123",
+ * });
+ *
+ * // Upload items into the instance
+ * await tenant.items.upload("doc.pdf", fileContent);
+ *
+ * // Delete an instance
+ * await env.AI_SEARCH.delete("tenant-123");
+ * ```
+ */
+declare abstract class AiSearchNamespace {
+	/**
+	 * Get an instance by name within the bound namespace.
+	 * @param name Instance name.
+	 * @returns Instance service for search, chat, update, stats, items, and jobs.
+	 */
+	get(name: string): AiSearchInstance;
+	/**
+	 * List all instances in the bound namespace.
+	 * @returns Array of instance metadata.
+	 */
+	list(): Promise<AiSearchListResponse>;
+	/**
+	 * Create a new instance within the bound namespace.
+	 * @param config Instance configuration. Only `id` is required — omit `type` and `source` to create with built-in storage.
+	 * @returns Instance service for the newly created instance.
+	 *
+	 * @example
+	 * ```ts
+	 * // Create with built-in storage (upload items manually)
+	 * const instance = await env.AI_SEARCH.create({ id: "my-search" });
+	 *
+	 * // Create with web crawler source
+	 * const instance = await env.AI_SEARCH.create({
+	 *   id: "docs-search",
+	 *   type: "web-crawler",
+	 *   source: "https://developers.cloudflare.com",
+	 * });
+	 * ```
+	 */
+	create(config: AiSearchConfig): Promise<AiSearchInstance>;
+	/**
+	 * Delete an instance from the bound namespace.
+	 * @param name Instance name to delete.
+	 */
+	delete(name: string): Promise<void>;
 }
 type AiImageClassificationInput = {
 	image: number[];
@@ -3953,98 +4470,487 @@ declare abstract class BaseAiTranslation {
 	postProcessedOutputs: AiTranslationOutput;
 }
 /**
- * Workers AI support for OpenAI's Responses API
- * Reference: https://github.com/openai/openai-node/blob/master/src/resources/responses/responses.ts
- *
- * It's a stripped down version from its source.
- * It currently supports basic function calling, json mode and accepts images as input.
- *
- * It does not include types for WebSearch, CodeInterpreter, FileInputs, MCP, CustomTools.
- * We plan to add those incrementally as model + platform capabilities evolve.
+ * Workers AI support for OpenAI's Chat Completions API
  */
-type ResponsesInput = {
-	background?: boolean | null;
-	conversation?: string | ResponseConversationParam | null;
-	include?: Array<ResponseIncludable> | null;
-	input?: string | ResponseInput;
-	instructions?: string | null;
-	max_output_tokens?: number | null;
-	parallel_tool_calls?: boolean | null;
-	previous_response_id?: string | null;
-	prompt_cache_key?: string;
-	reasoning?: Reasoning | null;
-	safety_identifier?: string;
-	service_tier?: "auto" | "default" | "flex" | "scale" | "priority" | null;
-	stream?: boolean | null;
-	stream_options?: StreamOptions | null;
-	temperature?: number | null;
-	text?: ResponseTextConfig;
-	tool_choice?: ToolChoiceOptions | ToolChoiceFunction;
-	tools?: Array<Tool>;
-	top_p?: number | null;
-	truncation?: "auto" | "disabled" | null;
+type ChatCompletionContentPartText = {
+	type: "text";
+	text: string;
 };
-type ResponsesOutput = {
-	id?: string;
-	created_at?: number;
-	output_text?: string;
-	error?: ResponseError | null;
-	incomplete_details?: ResponseIncompleteDetails | null;
-	instructions?: string | Array<ResponseInputItem> | null;
-	object?: "response";
-	output?: Array<ResponseOutputItem>;
-	parallel_tool_calls?: boolean;
-	temperature?: number | null;
-	tool_choice?: ToolChoiceOptions | ToolChoiceFunction;
-	tools?: Array<Tool>;
-	top_p?: number | null;
-	max_output_tokens?: number | null;
-	previous_response_id?: string | null;
-	prompt?: ResponsePrompt | null;
-	reasoning?: Reasoning | null;
-	safety_identifier?: string;
-	service_tier?: "auto" | "default" | "flex" | "scale" | "priority" | null;
-	status?: ResponseStatus;
-	text?: ResponseTextConfig;
-	truncation?: "auto" | "disabled" | null;
-	usage?: ResponseUsage;
+type ChatCompletionContentPartImage = {
+	type: "image_url";
+	image_url: {
+		url: string;
+		detail?: "auto" | "low" | "high";
+	};
 };
-type EasyInputMessage = {
-	content: string | ResponseInputMessageContentList;
-	role: "user" | "assistant" | "system" | "developer";
-	type?: "message";
+type ChatCompletionContentPartInputAudio = {
+	type: "input_audio";
+	input_audio: {
+		/** Base64 encoded audio data. */
+		data: string;
+		format: "wav" | "mp3";
+	};
 };
-type ResponsesFunctionTool = {
+type ChatCompletionContentPartFile = {
+	type: "file";
+	file: {
+		/** Base64 encoded file data. */
+		file_data?: string;
+		/** The ID of an uploaded file. */
+		file_id?: string;
+		filename?: string;
+	};
+};
+type ChatCompletionContentPartRefusal = {
+	type: "refusal";
+	refusal: string;
+};
+type ChatCompletionContentPart =
+	| ChatCompletionContentPartText
+	| ChatCompletionContentPartImage
+	| ChatCompletionContentPartInputAudio
+	| ChatCompletionContentPartFile;
+type FunctionDefinition = {
 	name: string;
-	parameters: {
-		[key: string]: unknown;
-	} | null;
-	strict: boolean | null;
+	description?: string;
+	parameters?: Record<string, unknown>;
+	strict?: boolean | null;
+};
+type ChatCompletionFunctionTool = {
 	type: "function";
-	description?: string | null;
+	function: FunctionDefinition;
 };
-type ResponseIncompleteDetails = {
-	reason?: "max_output_tokens" | "content_filter";
+type ChatCompletionCustomToolGrammarFormat = {
+	type: "grammar";
+	grammar: {
+		definition: string;
+		syntax: "lark" | "regex";
+	};
 };
-type ResponsePrompt = {
-	id: string;
-	variables?: {
-		[key: string]: string | ResponseInputText | ResponseInputImage;
-	} | null;
-	version?: string | null;
+type ChatCompletionCustomToolTextFormat = {
+	type: "text";
 };
-type Reasoning = {
-	effort?: ReasoningEffort | null;
-	generate_summary?: "auto" | "concise" | "detailed" | null;
-	summary?: "auto" | "concise" | "detailed" | null;
+type ChatCompletionCustomToolFormat =
+	| ChatCompletionCustomToolTextFormat
+	| ChatCompletionCustomToolGrammarFormat;
+type ChatCompletionCustomTool = {
+	type: "custom";
+	custom: {
+		name: string;
+		description?: string;
+		format?: ChatCompletionCustomToolFormat;
+	};
 };
-type ResponseContent =
-	| ResponseInputText
-	| ResponseInputImage
-	| ResponseOutputText
-	| ResponseOutputRefusal
-	| ResponseContentReasoningText;
-type ResponseContentReasoningText = {
+type ChatCompletionTool = ChatCompletionFunctionTool | ChatCompletionCustomTool;
+type ChatCompletionMessageFunctionToolCall = {
+	id: string;
+	type: "function";
+	function: {
+		name: string;
+		/** JSON-encoded arguments string. */
+		arguments: string;
+	};
+};
+type ChatCompletionMessageCustomToolCall = {
+	id: string;
+	type: "custom";
+	custom: {
+		name: string;
+		input: string;
+	};
+};
+type ChatCompletionMessageToolCall =
+	| ChatCompletionMessageFunctionToolCall
+	| ChatCompletionMessageCustomToolCall;
+type ChatCompletionToolChoiceFunction = {
+	type: "function";
+	function: {
+		name: string;
+	};
+};
+type ChatCompletionToolChoiceCustom = {
+	type: "custom";
+	custom: {
+		name: string;
+	};
+};
+type ChatCompletionToolChoiceAllowedTools = {
+	type: "allowed_tools";
+	allowed_tools: {
+		mode: "auto" | "required";
+		tools: Array<Record<string, unknown>>;
+	};
+};
+type ChatCompletionToolChoiceOption =
+	| "none"
+	| "auto"
+	| "required"
+	| ChatCompletionToolChoiceFunction
+	| ChatCompletionToolChoiceCustom
+	| ChatCompletionToolChoiceAllowedTools;
+type DeveloperMessage = {
+	role: "developer";
+	content:
+		| string
+		| Array<{
+				type: "text";
+				text: string;
+		  }>;
+	name?: string;
+};
+type SystemMessage = {
+	role: "system";
+	content:
+		| string
+		| Array<{
+				type: "text";
+				text: string;
+		  }>;
+	name?: string;
+};
+/**
+ * Permissive merged content part used inside UserMessage arrays.
+ *
+ * Cabidela has a limitation where anyOf/oneOf with enum-based discrimination
+ * inside nested array items does not correctly match different branches for
+ * different array elements, so the schema uses a single merged object.
+ */
+type UserMessageContentPart = {
+	type: "text" | "image_url" | "input_audio" | "file";
+	text?: string;
+	image_url?: {
+		url?: string;
+		detail?: "auto" | "low" | "high";
+	};
+	input_audio?: {
+		data?: string;
+		format?: "wav" | "mp3";
+	};
+	file?: {
+		file_data?: string;
+		file_id?: string;
+		filename?: string;
+	};
+};
+type UserMessage = {
+	role: "user";
+	content: string | Array<UserMessageContentPart>;
+	name?: string;
+};
+type AssistantMessageContentPart = {
+	type: "text" | "refusal";
+	text?: string;
+	refusal?: string;
+};
+type AssistantMessage = {
+	role: "assistant";
+	content?: string | null | Array<AssistantMessageContentPart>;
+	refusal?: string | null;
+	name?: string;
+	audio?: {
+		id: string;
+	};
+	tool_calls?: Array<ChatCompletionMessageToolCall>;
+	function_call?: {
+		name: string;
+		arguments: string;
+	};
+};
+type ToolMessage = {
+	role: "tool";
+	content:
+		| string
+		| Array<{
+				type: "text";
+				text: string;
+		  }>;
+	tool_call_id: string;
+};
+type FunctionMessage = {
+	role: "function";
+	content: string;
+	name: string;
+};
+type ChatCompletionMessageParam =
+	| DeveloperMessage
+	| SystemMessage
+	| UserMessage
+	| AssistantMessage
+	| ToolMessage
+	| FunctionMessage;
+type ChatCompletionsResponseFormatText = {
+	type: "text";
+};
+type ChatCompletionsResponseFormatJSONObject = {
+	type: "json_object";
+};
+type ResponseFormatJSONSchema = {
+	type: "json_schema";
+	json_schema: {
+		name: string;
+		description?: string;
+		schema?: Record<string, unknown>;
+		strict?: boolean | null;
+	};
+};
+type ResponseFormat =
+	| ChatCompletionsResponseFormatText
+	| ChatCompletionsResponseFormatJSONObject
+	| ResponseFormatJSONSchema;
+type ChatCompletionsStreamOptions = {
+	include_usage?: boolean;
+	include_obfuscation?: boolean;
+};
+type PredictionContent = {
+	type: "content";
+	content:
+		| string
+		| Array<{
+				type: "text";
+				text: string;
+		  }>;
+};
+type AudioParams = {
+	voice:
+		| string
+		| {
+				id: string;
+		  };
+	format: "wav" | "aac" | "mp3" | "flac" | "opus" | "pcm16";
+};
+type WebSearchUserLocation = {
+	type: "approximate";
+	approximate: {
+		city?: string;
+		country?: string;
+		region?: string;
+		timezone?: string;
+	};
+};
+type WebSearchOptions = {
+	search_context_size?: "low" | "medium" | "high";
+	user_location?: WebSearchUserLocation;
+};
+type ChatTemplateKwargs = {
+	/** Whether to enable reasoning, enabled by default. */
+	enable_thinking?: boolean;
+	/** If false, preserves reasoning context between turns. */
+	clear_thinking?: boolean;
+};
+/** Shared optional properties used by both Prompt and Messages input branches. */
+type ChatCompletionsCommonOptions = {
+	model?: string;
+	audio?: AudioParams;
+	frequency_penalty?: number | null;
+	logit_bias?: Record<string, unknown> | null;
+	logprobs?: boolean | null;
+	top_logprobs?: number | null;
+	max_tokens?: number | null;
+	max_completion_tokens?: number | null;
+	metadata?: Record<string, unknown> | null;
+	modalities?: Array<"text" | "audio"> | null;
+	n?: number | null;
+	parallel_tool_calls?: boolean;
+	prediction?: PredictionContent;
+	presence_penalty?: number | null;
+	reasoning_effort?: "low" | "medium" | "high" | null;
+	chat_template_kwargs?: ChatTemplateKwargs;
+	response_format?: ResponseFormat;
+	seed?: number | null;
+	service_tier?: "auto" | "default" | "flex" | "scale" | "priority" | null;
+	stop?: string | Array<string> | null;
+	store?: boolean | null;
+	stream?: boolean | null;
+	stream_options?: ChatCompletionsStreamOptions;
+	temperature?: number | null;
+	tool_choice?: ChatCompletionToolChoiceOption;
+	tools?: Array<ChatCompletionTool>;
+	top_p?: number | null;
+	user?: string;
+	web_search_options?: WebSearchOptions;
+	function_call?:
+		| "none"
+		| "auto"
+		| {
+				name: string;
+		  };
+	functions?: Array<FunctionDefinition>;
+};
+type PromptTokensDetails = {
+	cached_tokens?: number;
+	audio_tokens?: number;
+};
+type CompletionTokensDetails = {
+	reasoning_tokens?: number;
+	audio_tokens?: number;
+	accepted_prediction_tokens?: number;
+	rejected_prediction_tokens?: number;
+};
+type CompletionUsage = {
+	prompt_tokens: number;
+	completion_tokens: number;
+	total_tokens: number;
+	prompt_tokens_details?: PromptTokensDetails;
+	completion_tokens_details?: CompletionTokensDetails;
+};
+type ChatCompletionTopLogprob = {
+	token: string;
+	logprob: number;
+	bytes: Array<number> | null;
+};
+type ChatCompletionTokenLogprob = {
+	token: string;
+	logprob: number;
+	bytes: Array<number> | null;
+	top_logprobs: Array<ChatCompletionTopLogprob>;
+};
+type ChatCompletionAudio = {
+	id: string;
+	/** Base64 encoded audio bytes. */
+	data: string;
+	expires_at: number;
+	transcript: string;
+};
+type ChatCompletionUrlCitation = {
+	type: "url_citation";
+	url_citation: {
+		url: string;
+		title: string;
+		start_index: number;
+		end_index: number;
+	};
+};
+type ChatCompletionResponseMessage = {
+	role: "assistant";
+	content: string | null;
+	refusal: string | null;
+	annotations?: Array<ChatCompletionUrlCitation>;
+	audio?: ChatCompletionAudio;
+	tool_calls?: Array<ChatCompletionMessageToolCall>;
+	function_call?: {
+		name: string;
+		arguments: string;
+	} | null;
+};
+type ChatCompletionLogprobs = {
+	content: Array<ChatCompletionTokenLogprob> | null;
+	refusal?: Array<ChatCompletionTokenLogprob> | null;
+};
+type ChatCompletionChoice = {
+	index: number;
+	message: ChatCompletionResponseMessage;
+	finish_reason: "stop" | "length" | "tool_calls" | "content_filter" | "function_call";
+	logprobs: ChatCompletionLogprobs | null;
+};
+type ChatCompletionsPromptInput = {
+	prompt: string;
+} & ChatCompletionsCommonOptions;
+type ChatCompletionsMessagesInput = {
+	messages: Array<ChatCompletionMessageParam>;
+} & ChatCompletionsCommonOptions;
+type ChatCompletionsOutput = {
+	id: string;
+	object: string;
+	created: number;
+	model: string;
+	choices: Array<ChatCompletionChoice>;
+	usage?: CompletionUsage;
+	system_fingerprint?: string | null;
+	service_tier?: "auto" | "default" | "flex" | "scale" | "priority" | null;
+};
+/**
+ * Workers AI support for OpenAI's Responses API
+ * Reference: https://github.com/openai/openai-node/blob/master/src/resources/responses/responses.ts
+ *
+ * It's a stripped down version from its source.
+ * It currently supports basic function calling, json mode and accepts images as input.
+ *
+ * It does not include types for WebSearch, CodeInterpreter, FileInputs, MCP, CustomTools.
+ * We plan to add those incrementally as model + platform capabilities evolve.
+ */
+type ResponsesInput = {
+	background?: boolean | null;
+	conversation?: string | ResponseConversationParam | null;
+	include?: Array<ResponseIncludable> | null;
+	input?: string | ResponseInput;
+	instructions?: string | null;
+	max_output_tokens?: number | null;
+	parallel_tool_calls?: boolean | null;
+	previous_response_id?: string | null;
+	prompt_cache_key?: string;
+	reasoning?: Reasoning | null;
+	safety_identifier?: string;
+	service_tier?: "auto" | "default" | "flex" | "scale" | "priority" | null;
+	stream?: boolean | null;
+	stream_options?: StreamOptions | null;
+	temperature?: number | null;
+	text?: ResponseTextConfig;
+	tool_choice?: ToolChoiceOptions | ToolChoiceFunction;
+	tools?: Array<Tool>;
+	top_p?: number | null;
+	truncation?: "auto" | "disabled" | null;
+};
+type ResponsesOutput = {
+	id?: string;
+	created_at?: number;
+	output_text?: string;
+	error?: ResponseError | null;
+	incomplete_details?: ResponseIncompleteDetails | null;
+	instructions?: string | Array<ResponseInputItem> | null;
+	object?: "response";
+	output?: Array<ResponseOutputItem>;
+	parallel_tool_calls?: boolean;
+	temperature?: number | null;
+	tool_choice?: ToolChoiceOptions | ToolChoiceFunction;
+	tools?: Array<Tool>;
+	top_p?: number | null;
+	max_output_tokens?: number | null;
+	previous_response_id?: string | null;
+	prompt?: ResponsePrompt | null;
+	reasoning?: Reasoning | null;
+	safety_identifier?: string;
+	service_tier?: "auto" | "default" | "flex" | "scale" | "priority" | null;
+	status?: ResponseStatus;
+	text?: ResponseTextConfig;
+	truncation?: "auto" | "disabled" | null;
+	usage?: ResponseUsage;
+};
+type EasyInputMessage = {
+	content: string | ResponseInputMessageContentList;
+	role: "user" | "assistant" | "system" | "developer";
+	type?: "message";
+};
+type ResponsesFunctionTool = {
+	name: string;
+	parameters: {
+		[key: string]: unknown;
+	} | null;
+	strict: boolean | null;
+	type: "function";
+	description?: string | null;
+};
+type ResponseIncompleteDetails = {
+	reason?: "max_output_tokens" | "content_filter";
+};
+type ResponsePrompt = {
+	id: string;
+	variables?: {
+		[key: string]: string | ResponseInputText | ResponseInputImage;
+	} | null;
+	version?: string | null;
+};
+type Reasoning = {
+	effort?: ReasoningEffort | null;
+	generate_summary?: "auto" | "concise" | "detailed" | null;
+	summary?: "auto" | "concise" | "detailed" | null;
+};
+type ResponseContent =
+	| ResponseInputText
+	| ResponseInputImage
+	| ResponseOutputText
+	| ResponseOutputRefusal
+	| ResponseContentReasoningText;
+type ResponseContentReasoningText = {
 	text: string;
 	type: "reasoning_text";
 };
@@ -4366,6 +5272,12 @@ type ReasoningEffort = "minimal" | "low" | "medium" | "high" | null;
 type StreamOptions = {
 	include_obfuscation?: boolean;
 };
+/** Marks keys from T that aren't in U as optional never */
+type Without<T, U> = {
+	[P in Exclude<keyof T, keyof U>]?: never;
+};
+/** Either T or U, but not both (mutually exclusive) */
+type XOR<T, U> = (T & Without<U, T>) | (U & Without<T, U>);
 type Ai_Cf_Baai_Bge_Base_En_V1_5_Input =
 	| {
 			text: string | string[];
@@ -4658,10 +5570,12 @@ declare abstract class Base_Ai_Cf_Openai_Whisper_Tiny_En {
 	postProcessedOutputs: Ai_Cf_Openai_Whisper_Tiny_En_Output;
 }
 interface Ai_Cf_Openai_Whisper_Large_V3_Turbo_Input {
-	/**
-	 * Base64 encoded value of the audio data.
-	 */
-	audio: string;
+	audio:
+		| string
+		| {
+				body?: object;
+				contentType?: string;
+		  };
 	/**
 	 * Supported tasks are 'translate' or 'transcribe'.
 	 */
@@ -4679,9 +5593,33 @@ interface Ai_Cf_Openai_Whisper_Large_V3_Turbo_Input {
 	 */
 	initial_prompt?: string;
 	/**
-	 * The prefix it appended the the beginning of the output of the transcription and can guide the transcription result.
+	 * The prefix appended to the beginning of the output of the transcription and can guide the transcription result.
 	 */
 	prefix?: string;
+	/**
+	 * The number of beams to use in beam search decoding. Higher values may improve accuracy at the cost of speed.
+	 */
+	beam_size?: number;
+	/**
+	 * Whether to condition on previous text during transcription. Setting to false may help prevent hallucination loops.
+	 */
+	condition_on_previous_text?: boolean;
+	/**
+	 * Threshold for detecting no-speech segments. Segments with no-speech probability above this value are skipped.
+	 */
+	no_speech_threshold?: number;
+	/**
+	 * Threshold for filtering out segments with high compression ratio, which often indicate repetitive or hallucinated text.
+	 */
+	compression_ratio_threshold?: number;
+	/**
+	 * Threshold for filtering out segments with low average log probability, indicating low confidence.
+	 */
+	log_prob_threshold?: number;
+	/**
+	 * Optional threshold (in seconds) to skip silent periods that may cause hallucinations.
+	 */
+	hallucination_silence_threshold?: number;
 }
 interface Ai_Cf_Openai_Whisper_Large_V3_Turbo_Output {
 	transcription_info?: {
@@ -4828,11 +5766,11 @@ interface Ai_Cf_Baai_Bge_M3_Input_Embedding_1 {
 	truncate_inputs?: boolean;
 }
 type Ai_Cf_Baai_Bge_M3_Output =
-	| Ai_Cf_Baai_Bge_M3_Ouput_Query
+	| Ai_Cf_Baai_Bge_M3_Output_Query
 	| Ai_Cf_Baai_Bge_M3_Output_EmbeddingFor_Contexts
-	| Ai_Cf_Baai_Bge_M3_Ouput_Embedding
+	| Ai_Cf_Baai_Bge_M3_Output_Embedding
 	| Ai_Cf_Baai_Bge_M3_AsyncResponse;
-interface Ai_Cf_Baai_Bge_M3_Ouput_Query {
+interface Ai_Cf_Baai_Bge_M3_Output_Query {
 	response?: {
 		/**
 		 * Index of the context in the request
@@ -4852,7 +5790,7 @@ interface Ai_Cf_Baai_Bge_M3_Output_EmbeddingFor_Contexts {
 	 */
 	pooling?: "mean" | "cls";
 }
-interface Ai_Cf_Baai_Bge_M3_Ouput_Embedding {
+interface Ai_Cf_Baai_Bge_M3_Output_Embedding {
 	shape?: number[];
 	/**
 	 * Embeddings of the requested text values
@@ -4957,7 +5895,7 @@ interface Ai_Cf_Meta_Llama_3_2_11B_Vision_Instruct_Messages {
 		 */
 		role?: string;
 		/**
-		 * The tool call id. Must be supplied for tool calls for Mistral-3. If you don't know what to put here you can fall back to 000000001
+		 * The tool call id. If you don't know what to put here you can fall back to 000000001
 		 */
 		tool_call_id?: string;
 		content?:
@@ -5212,10 +6150,18 @@ interface Ai_Cf_Meta_Llama_3_3_70B_Instruct_Fp8_Fast_Messages {
 		 * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').
 		 */
 		role: string;
-		/**
-		 * The content of the message as a string.
-		 */
-		content: string;
+		content:
+			| string
+			| {
+					/**
+					 * Type of the content (text)
+					 */
+					type?: string;
+					/**
+					 * Text content
+					 */
+					text?: string;
+			  }[];
 	}[];
 	functions?: {
 		name: string;
@@ -5869,7 +6815,7 @@ interface Ai_Cf_Qwen_Qwq_32B_Messages {
 		 */
 		role?: string;
 		/**
-		 * The tool call id. Must be supplied for tool calls for Mistral-3. If you don't know what to put here you can fall back to 000000001
+		 * The tool call id. If you don't know what to put here you can fall back to 000000001
 		 */
 		tool_call_id?: string;
 		content?:
@@ -5996,7 +6942,7 @@ interface Ai_Cf_Qwen_Qwq_32B_Messages {
 		  }
 	)[];
 	/**
-	 * JSON schema that should be fulfilled for the response.
+	 * JSON schema that should be fufilled for the response.
 	 */
 	guided_json?: object;
 	/**
@@ -6270,7 +7216,7 @@ interface Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Messages {
 		  }
 	)[];
 	/**
-	 * JSON schema that should be fulfilled for the response.
+	 * JSON schema that should be fufilled for the response.
 	 */
 	guided_json?: object;
 	/**
@@ -6363,7 +7309,7 @@ interface Ai_Cf_Google_Gemma_3_12B_It_Prompt {
 	 */
 	prompt: string;
 	/**
-	 * JSON schema that should be fulfilled for the response.
+	 * JSON schema that should be fufilled for the response.
 	 */
 	guided_json?: object;
 	/**
@@ -6527,7 +7473,7 @@ interface Ai_Cf_Google_Gemma_3_12B_It_Messages {
 		  }
 	)[];
 	/**
-	 * JSON schema that should be fulfilled for the response.
+	 * JSON schema that should be fufilled for the response.
 	 */
 	guided_json?: object;
 	/**
@@ -6808,7 +7754,7 @@ interface Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Messages {
 	)[];
 	response_format?: Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_JSON_Mode;
 	/**
-	 * JSON schema that should be fulfilled for the response.
+	 * JSON schema that should be fufilled for the response.
 	 */
 	guided_json?: object;
 	/**
@@ -7047,7 +7993,7 @@ interface Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_Messages_Inner {
 	)[];
 	response_format?: Ai_Cf_Meta_Llama_4_Scout_17B_16E_Instruct_JSON_Mode;
 	/**
-	 * JSON schema that should be fulfilled for the response.
+	 * JSON schema that should be fufilled for the response.
 	 */
 	guided_json?: object;
 	/**
@@ -7212,14 +8158,22 @@ interface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Messages {
 		 * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').
 		 */
 		role: string;
-		/**
-		 * The content of the message as a string.
-		 */
-		content: string;
-	}[];
-	functions?: {
-		name: string;
-		code: string;
+		content:
+			| string
+			| {
+					/**
+					 * Type of the content (text)
+					 */
+					type?: string;
+					/**
+					 * Text content
+					 */
+					text?: string;
+			  }[];
+	}[];
+	functions?: {
+		name: string;
+		code: string;
 	}[];
 	/**
 	 * A list of tools available for the assistant to use.
@@ -7424,10 +8378,18 @@ interface Ai_Cf_Qwen_Qwen3_30B_A3B_Fp8_Messages_1 {
 		 * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').
 		 */
 		role: string;
-		/**
-		 * The content of the message as a string.
-		 */
-		content: string;
+		content:
+			| string
+			| {
+					/**
+					 * Type of the content (text)
+					 */
+					type?: string;
+					/**
+					 * Text content
+					 */
+					text?: string;
+			  }[];
 	}[];
 	functions?: {
 		name: string;
@@ -7987,12 +8949,12 @@ declare abstract class Base_Ai_Cf_Pipecat_Ai_Smart_Turn_V2 {
 	postProcessedOutputs: Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Output;
 }
 declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_120B {
-	inputs: ResponsesInput;
-	postProcessedOutputs: ResponsesOutput;
+	inputs: XOR<ResponsesInput, ChatCompletionsInput>;
+	postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
 }
 declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_20B {
-	inputs: ResponsesInput;
-	postProcessedOutputs: ResponsesOutput;
+	inputs: XOR<ResponsesInput, ChatCompletionsInput>;
+	postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
 }
 interface Ai_Cf_Leonardo_Phoenix_1_0_Input {
 	/**
@@ -8124,7 +9086,7 @@ interface Ai_Cf_Ai4Bharat_Indictrans2_En_Indic_1B_Input {
 	 */
 	text: string | string[];
 	/**
-	 * Target language to translate to
+	 * Target langauge to translate to
 	 */
 	target_language:
 		| "asm_Beng"
@@ -8240,10 +9202,18 @@ interface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Messages {
 		 * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').
 		 */
 		role: string;
-		/**
-		 * The content of the message as a string.
-		 */
-		content: string;
+		content:
+			| string
+			| {
+					/**
+					 * Type of the content (text)
+					 */
+					type?: string;
+					/**
+					 * Text content
+					 */
+					text?: string;
+			  }[];
 	}[];
 	functions?: {
 		name: string;
@@ -8455,10 +9425,18 @@ interface Ai_Cf_Aisingapore_Gemma_Sea_Lion_V4_27B_It_Messages_1 {
 		 * The role of the message sender (e.g., 'user', 'assistant', 'system', 'tool').
 		 */
 		role: string;
-		/**
-		 * The content of the message as a string.
-		 */
-		content: string;
+		content:
+			| string
+			| {
+					/**
+					 * Type of the content (text)
+					 */
+					type?: string;
+					/**
+					 * Text content
+					 */
+					text?: string;
+			  }[];
 	}[];
 	functions?: {
 		name: string;
@@ -9008,6 +9986,66 @@ declare abstract class Base_Ai_Cf_Deepgram_Aura_2_Es {
 	inputs: Ai_Cf_Deepgram_Aura_2_Es_Input;
 	postProcessedOutputs: Ai_Cf_Deepgram_Aura_2_Es_Output;
 }
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Dev_Input {
+	multipart: {
+		body?: object;
+		contentType?: string;
+	};
+}
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Dev_Output {
+	/**
+	 * Generated image as Base64 string.
+	 */
+	image?: string;
+}
+declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Dev {
+	inputs: Ai_Cf_Black_Forest_Labs_Flux_2_Dev_Input;
+	postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Dev_Output;
+}
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B_Input {
+	multipart: {
+		body?: object;
+		contentType?: string;
+	};
+}
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B_Output {
+	/**
+	 * Generated image as Base64 string.
+	 */
+	image?: string;
+}
+declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B {
+	inputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B_Input;
+	postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B_Output;
+}
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Input {
+	multipart: {
+		body?: object;
+		contentType?: string;
+	};
+}
+interface Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Output {
+	/**
+	 * Generated image as Base64 string.
+	 */
+	image?: string;
+}
+declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B {
+	inputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Input;
+	postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Output;
+}
+declare abstract class Base_Ai_Cf_Zai_Org_Glm_4_7_Flash {
+	inputs: ChatCompletionsInput;
+	postProcessedOutputs: ChatCompletionsOutput;
+}
+declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
+	inputs: ChatCompletionsInput;
+	postProcessedOutputs: ChatCompletionsOutput;
+}
+declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
+	inputs: ChatCompletionsInput;
+	postProcessedOutputs: ChatCompletionsOutput;
+}
 interface AiModels {
 	"@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
 	"@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
@@ -9026,7 +10064,6 @@ interface AiModels {
 	"@hf/thebloke/zephyr-7b-beta-awq": BaseAiTextGeneration;
 	"@hf/thebloke/openhermes-2.5-mistral-7b-awq": BaseAiTextGeneration;
 	"@hf/thebloke/neural-chat-7b-v3-1-awq": BaseAiTextGeneration;
-	"@hf/thebloke/llamaguard-7b-awq": BaseAiTextGeneration;
 	"@hf/thebloke/deepseek-coder-6.7b-base-awq": BaseAiTextGeneration;
 	"@hf/thebloke/deepseek-coder-6.7b-instruct-awq": BaseAiTextGeneration;
 	"@cf/deepseek-ai/deepseek-math-7b-instruct": BaseAiTextGeneration;
@@ -9093,6 +10130,12 @@ interface AiModels {
 	"@cf/deepgram/flux": Base_Ai_Cf_Deepgram_Flux;
 	"@cf/deepgram/aura-2-en": Base_Ai_Cf_Deepgram_Aura_2_En;
 	"@cf/deepgram/aura-2-es": Base_Ai_Cf_Deepgram_Aura_2_Es;
+	"@cf/black-forest-labs/flux-2-dev": Base_Ai_Cf_Black_Forest_Labs_Flux_2_Dev;
+	"@cf/black-forest-labs/flux-2-klein-4b": Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_4B;
+	"@cf/black-forest-labs/flux-2-klein-9b": Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B;
+	"@cf/zai-org/glm-4.7-flash": Base_Ai_Cf_Zai_Org_Glm_4_7_Flash;
+	"@cf/moonshotai/kimi-k2.5": Base_Ai_Cf_Moonshotai_Kimi_K2_5;
+	"@cf/nvidia/nemotron-3-120b-a12b": Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B;
 }
 type AiOptions = {
 	/**
@@ -9118,6 +10161,7 @@ type AiOptions = {
 	returnRawResponse?: boolean;
 	prefix?: string;
 	extraHeaders?: object;
+	signal?: AbortSignal;
 };
 type AiModelsSearchParams = {
 	author?: string;
@@ -9144,12 +10188,31 @@ type AiModelsSearchObject = {
 		value: string;
 	}[];
 };
+type ChatCompletionsBase = XOR<ChatCompletionsPromptInput, ChatCompletionsMessagesInput>;
+type ChatCompletionsInput = XOR<
+	ChatCompletionsBase,
+	{
+		requests: ChatCompletionsBase[];
+	}
+>;
 interface InferenceUpstreamError extends Error {}
 interface AiInternalError extends Error {}
 type AiModelListType = Record<string, any>;
 declare abstract class Ai<AiModelList extends AiModelListType = AiModels> {
 	aiGatewayLogId: string | null;
 	gateway(gatewayId: string): AiGateway;
+	/**
+	 * @deprecated Use the standalone `ai_search_namespaces` or `ai_search` Workers bindings instead.
+	 * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+	 */
+	aiSearch(): AiSearchNamespace;
+	/**
+	 * @deprecated AutoRAG has been replaced by AI Search.
+	 * Use the standalone `ai_search_namespaces` or `ai_search` Workers bindings instead.
+	 * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+	 *
+	 * @param autoragId Instance ID
+	 */
 	autorag(autoragId: string): AutoRAG;
 	run<
 		Name extends keyof AiModelList,
@@ -9304,9 +10367,25 @@ declare abstract class AiGateway {
 	): Promise<Response>;
 	getUrl(provider?: AIGatewayProviders | string): Promise<string>; // eslint-disable-line
 }
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 interface AutoRAGInternalError extends Error {}
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 interface AutoRAGNotFoundError extends Error {}
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 interface AutoRAGUnauthorizedError extends Error {}
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 interface AutoRAGNameNotSetError extends Error {}
 type ComparisonFilter = {
 	key: string;
@@ -9317,6 +10396,10 @@ type CompoundFilter = {
 	type: "and" | "or";
 	filters: ComparisonFilter[];
 };
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 type AutoRagSearchRequest = {
 	query: string;
 	filters?: CompoundFilter | ComparisonFilter;
@@ -9331,13 +10414,25 @@ type AutoRagSearchRequest = {
 	};
 	rewrite_query?: boolean;
 };
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 type AutoRagAiSearchRequest = AutoRagSearchRequest & {
 	stream?: boolean;
 	system_prompt?: string;
 };
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 type AutoRagAiSearchRequestStreaming = Omit<AutoRagAiSearchRequest, "stream"> & {
 	stream: true;
 };
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 type AutoRagSearchResponse = {
 	object: "vector_store.search_results.page";
 	search_query: string;
@@ -9354,6 +10449,10 @@ type AutoRagSearchResponse = {
 	has_more: boolean;
 	next_page: string | null;
 };
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 type AutoRagListResponse = {
 	id: string;
 	enable: boolean;
@@ -9363,14 +10462,42 @@ type AutoRagListResponse = {
 	paused: boolean;
 	status: string;
 }[];
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 type AutoRagAiSearchResponse = AutoRagSearchResponse & {
 	response: string;
 };
+/**
+ * @deprecated Use the standalone AI Search Workers binding instead.
+ * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+ */
 declare abstract class AutoRAG {
+	/**
+	 * @deprecated Use the standalone AI Search Workers binding instead.
+	 * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+	 */
 	list(): Promise<AutoRagListResponse>;
+	/**
+	 * @deprecated Use the standalone AI Search Workers binding instead.
+	 * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+	 */
 	search(params: AutoRagSearchRequest): Promise<AutoRagSearchResponse>;
+	/**
+	 * @deprecated Use the standalone AI Search Workers binding instead.
+	 * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+	 */
 	aiSearch(params: AutoRagAiSearchRequestStreaming): Promise<Response>;
+	/**
+	 * @deprecated Use the standalone AI Search Workers binding instead.
+	 * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+	 */
 	aiSearch(params: AutoRagAiSearchRequest): Promise<AutoRagAiSearchResponse>;
+	/**
+	 * @deprecated Use the standalone AI Search Workers binding instead.
+	 * See https://developers.cloudflare.com/ai-search/usage/workers-binding/
+	 */
 	aiSearch(params: AutoRagAiSearchRequest): Promise<AutoRagAiSearchResponse | Response>;
 }
 interface BasicImageTransformations {
@@ -9492,6 +10619,41 @@ interface RequestInitCfProperties extends Record<string, unknown> {
 	 * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })
 	 */
 	cacheTtlByStatus?: Record<string, number>;
+	/**
+	 * Explicit Cache-Control header value to set on the response stored in cache.
+	 * This gives full control over cache directives (e.g. 'public, max-age=3600, s-maxage=86400').
+	 *
+	 * Cannot be used together with `cacheTtl` or the `cache` request option (`no-store`/`no-cache`),
+	 * as these are mutually exclusive cache control mechanisms. Setting both will throw a TypeError.
+	 *
+	 * Can be used together with `cacheTtlByStatus`.
+	 */
+	cacheControl?: string;
+	/**
+	 * Whether the response should be eligible for Cache Reserve storage.
+	 */
+	cacheReserveEligible?: boolean;
+	/**
+	 * Whether to respect strong ETags (as opposed to weak ETags) from the origin.
+	 */
+	respectStrongEtag?: boolean;
+	/**
+	 * Whether to strip ETag headers from the origin response before caching.
+	 */
+	stripEtags?: boolean;
+	/**
+	 * Whether to strip Last-Modified headers from the origin response before caching.
+	 */
+	stripLastModified?: boolean;
+	/**
+	 * Whether to enable Cache Deception Armor, which protects against web cache
+	 * deception attacks by verifying the Content-Type matches the URL extension.
+	 */
+	cacheDeceptionArmor?: boolean;
+	/**
+	 * Minimum file size in bytes for a response to be eligible for Cache Reserve storage.
+	 */
+	cacheReserveMinimumFileSize?: number;
 	scrapeShield?: boolean;
 	apps?: boolean;
 	image?: RequestInitCfPropertiesImage;
@@ -10583,10 +11745,10 @@ interface SendEmail {
 declare abstract class EmailEvent extends ExtendableEvent {
 	readonly message: ForwardableEmailMessage;
 }
-declare type EmailExportedHandler<Env = unknown> = (
+declare type EmailExportedHandler<Env = unknown, Props = unknown> = (
 	message: ForwardableEmailMessage,
 	env: Env,
-	ctx: ExecutionContext,
+	ctx: ExecutionContext<Props>,
 ) => void | Promise<void>;
 declare module "cloudflare:email" {
 	let _EmailMessage: {
@@ -10745,6 +11907,86 @@ type ImageOutputOptions = {
 	background?: string;
 	anim?: boolean;
 };
+interface ImageMetadata {
+	id: string;
+	filename?: string;
+	uploaded?: string;
+	requireSignedURLs: boolean;
+	meta?: Record<string, unknown>;
+	variants: string[];
+	draft?: boolean;
+	creator?: string;
+}
+interface ImageUploadOptions {
+	id?: string;
+	filename?: string;
+	requireSignedURLs?: boolean;
+	metadata?: Record<string, unknown>;
+	creator?: string;
+	encoding?: "base64";
+}
+interface ImageUpdateOptions {
+	requireSignedURLs?: boolean;
+	metadata?: Record<string, unknown>;
+	creator?: string;
+}
+interface ImageListOptions {
+	limit?: number;
+	cursor?: string;
+	sortOrder?: "asc" | "desc";
+	creator?: string;
+}
+interface ImageList {
+	images: ImageMetadata[];
+	cursor?: string;
+	listComplete: boolean;
+}
+interface HostedImagesBinding {
+	/**
+	 * Get detailed metadata for a hosted image
+	 * @param imageId The ID of the image (UUID or custom ID)
+	 * @returns Image metadata, or null if not found
+	 */
+	details(imageId: string): Promise<ImageMetadata | null>;
+	/**
+	 * Get the raw image data for a hosted image
+	 * @param imageId The ID of the image (UUID or custom ID)
+	 * @returns ReadableStream of image bytes, or null if not found
+	 */
+	image(imageId: string): Promise<ReadableStream<Uint8Array> | null>;
+	/**
+	 * Upload a new hosted image
+	 * @param image The image file to upload
+	 * @param options Upload configuration
+	 * @returns Metadata for the uploaded image
+	 * @throws {@link ImagesError} if upload fails
+	 */
+	upload(
+		image: ReadableStream<Uint8Array> | ArrayBuffer,
+		options?: ImageUploadOptions,
+	): Promise<ImageMetadata>;
+	/**
+	 * Update hosted image metadata
+	 * @param imageId The ID of the image
+	 * @param options Properties to update
+	 * @returns Updated image metadata
+	 * @throws {@link ImagesError} if update fails
+	 */
+	update(imageId: string, options: ImageUpdateOptions): Promise<ImageMetadata>;
+	/**
+	 * Delete a hosted image
+	 * @param imageId The ID of the image
+	 * @returns True if deleted, false if not found
+	 */
+	delete(imageId: string): Promise<boolean>;
+	/**
+	 * List hosted images with pagination
+	 * @param options List configuration
+	 * @returns List of images with pagination info
+	 * @throws {@link ImagesError} if list fails
+	 */
+	list(options?: ImageListOptions): Promise<ImageList>;
+}
 interface ImagesBinding {
 	/**
 	 * Get image metadata (type, width and height)
@@ -10758,6 +12000,10 @@ interface ImagesBinding {
 	 * @returns A transform handle
 	 */
 	input(stream: ReadableStream<Uint8Array>, options?: ImageInputOptions): ImageTransformer;
+	/**
+	 * Access hosted images CRUD operations
+	 */
+	readonly hosted: HostedImagesBinding;
 }
 interface ImageTransformer {
 	/**
@@ -10827,7 +12073,13 @@ interface MediaTransformer {
 	 * @param transform - Configuration for how the media should be transformed
 	 * @returns A generator for producing the transformed media output
 	 */
-	transform(transform: MediaTransformationInputOptions): MediaTransformationGenerator;
+	transform(transform?: MediaTransformationInputOptions): MediaTransformationGenerator;
+	/**
+	 * Generates the final media output with specified options.
+	 * @param output - Configuration for the output format and parameters
+	 * @returns The final transformation result containing the transformed media
+	 */
+	output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Generator for producing media transformation results.
@@ -10839,7 +12091,7 @@ interface MediaTransformationGenerator {
 	 * @param output - Configuration for the output format and parameters
 	 * @returns The final transformation result containing the transformed media
 	 */
-	output(output: MediaTransformationOutputOptions): MediaTransformationResult;
+	output(output?: MediaTransformationOutputOptions): MediaTransformationResult;
 }
 /**
  * Result of a media transformation operation.
@@ -10848,19 +12100,19 @@ interface MediaTransformationGenerator {
 interface MediaTransformationResult {
 	/**
 	 * Returns the transformed media as a readable stream of bytes.
-	 * @returns A stream containing the transformed media data
+	 * @returns A promise containing a readable stream with the transformed media
 	 */
-	media(): ReadableStream<Uint8Array>;
+	media(): Promise<ReadableStream<Uint8Array>>;
 	/**
 	 * Returns the transformed media as an HTTP response object.
-	 * @returns The transformed media as a Response, ready to store in cache or return to users
+	 * @returns The transformed media as a Promise<Response>, ready to store in cache or return to users
 	 */
-	response(): Response;
+	response(): Promise<Response>;
 	/**
 	 * Returns the MIME type of the transformed media.
-	 * @returns The content type string (e.g., 'image/jpeg', 'video/mp4')
+	 * @returns A promise containing the content type string (e.g., 'image/jpeg', 'video/mp4')
 	 */
-	contentType(): string;
+	contentType(): Promise<string>;
 }
 /**
  * Configuration options for transforming media input.
@@ -11252,6 +12504,7 @@ declare namespace CloudflareWorkersModule {
 		constructor(ctx: ExecutionContext, env: Env);
 		email?(message: ForwardableEmailMessage): void | Promise<void>;
 		fetch?(request: Request): Response | Promise<Response>;
+		connect?(socket: Socket): void | Promise<void>;
 		queue?(batch: MessageBatch<unknown>): void | Promise<void>;
 		scheduled?(controller: ScheduledController): void | Promise<void>;
 		tail?(events: TraceItem[]): void | Promise<void>;
@@ -11270,6 +12523,7 @@ declare namespace CloudflareWorkersModule {
 		constructor(ctx: DurableObjectState, env: Env);
 		alarm?(alarmInfo?: AlarmInvocationInfo): void | Promise<void>;
 		fetch?(request: Request): Response | Promise<Response>;
+		connect?(socket: Socket): void | Promise<void>;
 		webSocketMessage?(ws: WebSocket, message: string | ArrayBuffer): void | Promise<void>;
 		webSocketClose?(
 			ws: WebSocket,
@@ -11310,12 +12564,18 @@ declare namespace CloudflareWorkersModule {
 		timestamp: Date;
 		type: string;
 	};
+	export type WorkflowStepContext = {
+		attempt: number;
+	};
 	export abstract class WorkflowStep {
-		do<T extends Rpc.Serializable<T>>(name: string, callback: () => Promise<T>): Promise<T>;
+		do<T extends Rpc.Serializable<T>>(
+			name: string,
+			callback: (ctx: WorkflowStepContext) => Promise<T>,
+		): Promise<T>;
 		do<T extends Rpc.Serializable<T>>(
 			name: string,
 			config: WorkflowStepConfig,
-			callback: () => Promise<T>,
+			callback: (ctx: WorkflowStepContext) => Promise<T>,
 		): Promise<T>;
 		sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
 		sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
@@ -11374,12 +12634,745 @@ declare module "cloudflare:sockets" {
 	function _connect(address: string | SocketAddress, options?: SocketOptions): Socket;
 	export { _connect as connect };
 }
+/**
+ * Binding entrypoint for Cloudflare Stream.
+ *
+ * Usage:
+ * - Binding-level operations:
+ *   `await env.STREAM.videos.upload`
+ *   `await env.STREAM.videos.createDirectUpload`
+ *   `await env.STREAM.videos.*`
+ *   `await env.STREAM.watermarks.*`
+ * - Per-video operations:
+ *   `await env.STREAM.video(id).downloads.*`
+ *   `await env.STREAM.video(id).captions.*`
+ *
+ * Example usage:
+ * ```ts
+ * await env.STREAM.video(id).downloads.generate();
+ *
+ * const video = env.STREAM.video(id)
+ * const captions = video.captions.list();
+ * const videoDetails = video.details()
+ * ```
+ */
+interface StreamBinding {
+	/**
+	 * Returns a handle scoped to a single video for per-video operations.
+	 * @param id The unique identifier for the video.
+	 * @returns A handle for per-video operations.
+	 */
+	video(id: string): StreamVideoHandle;
+	/**
+	 * Uploads a new video from a provided URL.
+	 * @param url The URL to upload from.
+	 * @param params Optional upload parameters.
+	 * @returns The uploaded video details.
+	 * @throws {BadRequestError} if the upload parameter is invalid or the URL is invalid
+	 * @throws {QuotaReachedError} if the account storage capacity is exceeded
+	 * @throws {MaxFileSizeError} if the file size is too large
+	 * @throws {RateLimitedError} if the server received too many requests
+	 * @throws {AlreadyUploadedError} if a video was already uploaded to this URL
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	upload(url: string, params?: StreamUrlUploadParams): Promise<StreamVideo>;
+	/**
+	 * Creates a direct upload that allows video uploads without an API key.
+	 * @param params Parameters for the direct upload
+	 * @returns The direct upload details.
+	 * @throws {BadRequestError} if the parameters are invalid
+	 * @throws {RateLimitedError} if the server received too many requests
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	createDirectUpload(params: StreamDirectUploadCreateParams): Promise<StreamDirectUpload>;
+	videos: StreamVideos;
+	watermarks: StreamWatermarks;
+}
+/**
+ * Handle for operations scoped to a single Stream video.
+ */
+interface StreamVideoHandle {
+	/**
+	 * The unique identifier for the video.
+	 */
+	id: string;
+	/**
+	 * Get a full videos details
+	 * @returns The full video details.
+	 * @throws {NotFoundError} if the video is not found
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	details(): Promise<StreamVideo>;
+	/**
+	 * Update details for a single video.
+	 * @param params The fields to update for the video.
+	 * @returns The updated video details.
+	 * @throws {NotFoundError} if the video is not found
+	 * @throws {BadRequestError} if the parameters are invalid
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	update(params: StreamUpdateVideoParams): Promise<StreamVideo>;
+	/**
+	 * Deletes a video and its copies from Cloudflare Stream.
+	 * @returns A promise that resolves when deletion completes.
+	 * @throws {NotFoundError} if the video is not found
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	delete(): Promise<void>;
+	/**
+	 * Creates a signed URL token for a video.
+	 * @returns The signed token that was created.
+	 * @throws {InternalError} if the signing key cannot be retrieved or the token cannot be signed
+	 */
+	generateToken(): Promise<string>;
+	downloads: StreamScopedDownloads;
+	captions: StreamScopedCaptions;
+}
+interface StreamVideo {
+	/**
+	 * The unique identifier for the video.
+	 */
+	id: string;
+	/**
+	 * A user-defined identifier for the media creator.
+	 */
+	creator: string | null;
+	/**
+	 * The thumbnail URL for the video.
+	 */
+	thumbnail: string;
+	/**
+	 * The thumbnail timestamp percentage.
+	 */
+	thumbnailTimestampPct: number;
+	/**
+	 * Indicates whether the video is ready to stream.
+	 */
+	readyToStream: boolean;
+	/**
+	 * The date and time the video became ready to stream.
+	 */
+	readyToStreamAt: string | null;
+	/**
+	 * Processing status information.
+	 */
+	status: StreamVideoStatus;
+	/**
+	 * A user modifiable key-value store.
+	 */
+	meta: Record<string, string>;
+	/**
+	 * The date and time the video was created.
+	 */
+	created: string;
+	/**
+	 * The date and time the video was last modified.
+	 */
+	modified: string;
+	/**
+	 * The date and time at which the video will be deleted.
+	 */
+	scheduledDeletion: string | null;
+	/**
+	 * The size of the video in bytes.
+	 */
+	size: number;
+	/**
+	 * The preview URL for the video.
+	 */
+	preview?: string;
+	/**
+	 * Origins allowed to display the video.
+	 */
+	allowedOrigins: Array<string>;
+	/**
+	 * Indicates whether signed URLs are required.
+	 */
+	requireSignedURLs: boolean | null;
+	/**
+	 * The date and time the video was uploaded.
+	 */
+	uploaded: string | null;
+	/**
+	 * The date and time when the upload URL expires.
+	 */
+	uploadExpiry: string | null;
+	/**
+	 * The maximum size in bytes for direct uploads.
+	 */
+	maxSizeBytes: number | null;
+	/**
+	 * The maximum duration in seconds for direct uploads.
+	 */
+	maxDurationSeconds: number | null;
+	/**
+	 * The video duration in seconds. -1 indicates unknown.
+	 */
+	duration: number;
+	/**
+	 * Input metadata for the original upload.
+	 */
+	input: StreamVideoInput;
+	/**
+	 * Playback URLs for the video.
+	 */
+	hlsPlaybackUrl: string;
+	dashPlaybackUrl: string;
+	/**
+	 * The watermark applied to the video, if any.
+	 */
+	watermark: StreamWatermark | null;
+	/**
+	 * The live input id associated with the video, if any.
+	 */
+	liveInputId?: string | null;
+	/**
+	 * The source video id if this is a clip.
+	 */
+	clippedFromId: string | null;
+	/**
+	 * Public details associated with the video.
+	 */
+	publicDetails: StreamPublicDetails | null;
+}
+type StreamVideoStatus = {
+	/**
+	 * The current processing state.
+	 */
+	state: string;
+	/**
+	 * The current processing step.
+	 */
+	step?: string;
+	/**
+	 * The percent complete as a string.
+	 */
+	pctComplete?: string;
+	/**
+	 * An error reason code, if applicable.
+	 */
+	errorReasonCode: string;
+	/**
+	 * An error reason text, if applicable.
+	 */
+	errorReasonText: string;
+};
+type StreamVideoInput = {
+	/**
+	 * The input width in pixels.
+	 */
+	width: number;
+	/**
+	 * The input height in pixels.
+	 */
+	height: number;
+};
+type StreamPublicDetails = {
+	/**
+	 * The public title for the video.
+	 */
+	title: string | null;
+	/**
+	 * The public share link.
+	 */
+	share_link: string | null;
+	/**
+	 * The public channel link.
+	 */
+	channel_link: string | null;
+	/**
+	 * The public logo URL.
+	 */
+	logo: string | null;
+};
+type StreamDirectUpload = {
+	/**
+	 * The URL an unauthenticated upload can use for a single multipart request.
+	 */
+	uploadURL: string;
+	/**
+	 * A Cloudflare-generated unique identifier for a media item.
+	 */
+	id: string;
+	/**
+	 * The watermark profile applied to the upload.
+	 */
+	watermark: StreamWatermark | null;
+	/**
+	 * The scheduled deletion time, if any.
+	 */
+	scheduledDeletion: string | null;
+};
+type StreamDirectUploadCreateParams = {
+	/**
+	 * The maximum duration in seconds for a video upload.
+	 */
+	maxDurationSeconds: number;
+	/**
+	 * The date and time after upload when videos will not be accepted.
+	 */
+	expiry?: string;
+	/**
+	 * A user-defined identifier for the media creator.
+	 */
+	creator?: string;
+	/**
+	 * A user modifiable key-value store used to reference other systems of record for
+	 * managing videos.
+	 */
+	meta?: Record<string, string>;
+	/**
+	 * Lists the origins allowed to display the video.
+	 */
+	allowedOrigins?: Array<string>;
+	/**
+	 * Indicates whether the video can be accessed using the id. When set to `true`,
+	 * a signed token must be generated with a signing key to view the video.
+	 */
+	requireSignedURLs?: boolean;
+	/**
+	 * The thumbnail timestamp percentage.
+	 */
+	thumbnailTimestampPct?: number;
+	/**
+	 * The date and time at which the video will be deleted. Include `null` to remove
+	 * a scheduled deletion.
+	 */
+	scheduledDeletion?: string | null;
+	/**
+	 * The watermark profile to apply.
+	 */
+	watermark?: StreamDirectUploadWatermark;
+};
+type StreamDirectUploadWatermark = {
+	/**
+	 * The unique identifier for the watermark profile.
+	 */
+	id: string;
+};
+type StreamUrlUploadParams = {
+	/**
+	 * Lists the origins allowed to display the video. Enter allowed origin
+	 * domains in an array and use `*` for wildcard subdomains. Empty arrays allow the
+	 * video to be viewed on any origin.
+	 */
+	allowedOrigins?: Array<string>;
+	/**
+	 * A user-defined identifier for the media creator.
+	 */
+	creator?: string;
+	/**
+	 * A user modifiable key-value store used to reference other systems of
+	 * record for managing videos.
+	 */
+	meta?: Record<string, string>;
+	/**
+	 * Indicates whether the video can be a accessed using the id. When
+	 * set to `true`, a signed token must be generated with a signing key to view the
+	 * video.
+	 */
+	requireSignedURLs?: boolean;
+	/**
+	 * Indicates the date and time at which the video will be deleted. Omit
+	 * the field to indicate no change, or include with a `null` value to remove an
+	 * existing scheduled deletion. If specified, must be at least 30 days from upload
+	 * time.
+	 */
+	scheduledDeletion?: string | null;
+	/**
+	 * The timestamp for a thumbnail image calculated as a percentage value
+	 * of the video's duration. To convert from a second-wise timestamp to a
+	 * percentage, divide the desired timestamp by the total duration of the video. If
+	 * this value is not set, the default thumbnail image is taken from 0s of the
+	 * video.
+	 */
+	thumbnailTimestampPct?: number;
+	/**
+	 * The identifier for the watermark profile
+	 */
+	watermarkId?: string;
+};
+interface StreamScopedCaptions {
+	/**
+	 * Uploads the caption or subtitle file to the endpoint for a specific BCP47 language.
+	 * One caption or subtitle file per language is allowed.
+	 * @param language The BCP 47 language tag for the caption or subtitle.
+	 * @param input The caption or subtitle stream to upload.
+	 * @returns The created caption entry.
+	 * @throws {NotFoundError} if the video is not found
+	 * @throws {BadRequestError} if the language or file is invalid
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	upload(language: string, input: ReadableStream): Promise<StreamCaption>;
+	/**
+	 * Generate captions or subtitles for the provided language via AI.
+	 * @param language The BCP 47 language tag to generate.
+	 * @returns The generated caption entry.
+	 * @throws {NotFoundError} if the video is not found
+	 * @throws {BadRequestError} if the language is invalid
+	 * @throws {StreamError} if a generated caption already exists
+	 * @throws {StreamError} if the video duration is too long
+	 * @throws {StreamError} if the video is missing audio
+	 * @throws {StreamError} if the requested language is not supported
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	generate(language: string): Promise<StreamCaption>;
+	/**
+	 * Lists the captions or subtitles.
+	 * Use the language parameter to filter by a specific language.
+	 * @param language The optional BCP 47 language tag to filter by.
+	 * @returns The list of captions or subtitles.
+	 * @throws {NotFoundError} if the video or caption is not found
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	list(language?: string): Promise<StreamCaption[]>;
+	/**
+	 * Removes the captions or subtitles from a video.
+	 * @param language The BCP 47 language tag to remove.
+	 * @returns A promise that resolves when deletion completes.
+	 * @throws {NotFoundError} if the video or caption is not found
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	delete(language: string): Promise<void>;
+}
+interface StreamScopedDownloads {
+	/**
+	 * Generates a download for a video when a video is ready to view. Available
+	 * types are `default` and `audio`. Defaults to `default` when omitted.
+	 * @param downloadType The download type to create.
+	 * @returns The current downloads for the video.
+	 * @throws {NotFoundError} if the video is not found
+	 * @throws {BadRequestError} if the download type is invalid
+	 * @throws {StreamError} if the video duration is too long to generate a download
+	 * @throws {StreamError} if the video is not ready to stream
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	generate(downloadType?: StreamDownloadType): Promise<StreamDownloadGetResponse>;
+	/**
+	 * Lists the downloads created for a video.
+	 * @returns The current downloads for the video.
+	 * @throws {NotFoundError} if the video or downloads are not found
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	get(): Promise<StreamDownloadGetResponse>;
+	/**
+	 * Delete the downloads for a video. Available types are `default` and `audio`.
+	 * Defaults to `default` when omitted.
+	 * @param downloadType The download type to delete.
+	 * @returns A promise that resolves when deletion completes.
+	 * @throws {NotFoundError} if the video or downloads are not found
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	delete(downloadType?: StreamDownloadType): Promise<void>;
+}
+interface StreamVideos {
+	/**
+	 * Lists all videos in a users account.
+	 * @returns The list of videos.
+	 * @throws {BadRequestError} if the parameters are invalid
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	list(params?: StreamVideosListParams): Promise<StreamVideo[]>;
+}
+interface StreamWatermarks {
+	/**
+	 * Generate a new watermark profile
+	 * @param input The image stream to upload
+	 * @param params The watermark creation parameters.
+	 * @returns The created watermark profile.
+	 * @throws {BadRequestError} if the parameters are invalid
+	 * @throws {InvalidURLError} if the URL is invalid
+	 * @throws {TooManyWatermarksError} if the number of allowed watermarks is reached
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	generate(input: ReadableStream, params: StreamWatermarkCreateParams): Promise<StreamWatermark>;
+	/**
+	 * Generate a new watermark profile
+	 * @param url The image url to upload
+	 * @param params The watermark creation parameters.
+	 * @returns The created watermark profile.
+	 * @throws {BadRequestError} if the parameters are invalid
+	 * @throws {InvalidURLError} if the URL is invalid
+	 * @throws {TooManyWatermarksError} if the number of allowed watermarks is reached
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	generate(url: string, params: StreamWatermarkCreateParams): Promise<StreamWatermark>;
+	/**
+	 * Lists all watermark profiles for an account.
+	 * @returns The list of watermark profiles.
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	list(): Promise<StreamWatermark[]>;
+	/**
+	 * Retrieves details for a single watermark profile.
+	 * @param watermarkId The watermark profile identifier.
+	 * @returns The watermark profile details.
+	 * @throws {NotFoundError} if the watermark is not found
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	get(watermarkId: string): Promise<StreamWatermark>;
+	/**
+	 * Deletes a watermark profile.
+	 * @param watermarkId The watermark profile identifier.
+	 * @returns A promise that resolves when deletion completes.
+	 * @throws {NotFoundError} if the watermark is not found
+	 * @throws {InternalError} if an unexpected error occurs
+	 */
+	delete(watermarkId: string): Promise<void>;
+}
+type StreamUpdateVideoParams = {
+	/**
+	 * Lists the origins allowed to display the video. Enter allowed origin
+	 * domains in an array and use `*` for wildcard subdomains. Empty arrays allow the
+	 * video to be viewed on any origin.
+	 */
+	allowedOrigins?: Array<string>;
+	/**
+	 * A user-defined identifier for the media creator.
+	 */
+	creator?: string;
+	/**
+	 * The maximum duration in seconds for a video upload. Can be set for a
+	 * video that is not yet uploaded to limit its duration. Uploads that exceed the
+	 * specified duration will fail during processing. A value of `-1` means the value
+	 * is unknown.
+	 */
+	maxDurationSeconds?: number;
+	/**
+	 * A user modifiable key-value store used to reference other systems of
+	 * record for managing videos.
+	 */
+	meta?: Record<string, string>;
+	/**
+	 * Indicates whether the video can be a accessed using the id. When
+	 * set to `true`, a signed token must be generated with a signing key to view the
+	 * video.
+	 */
+	requireSignedURLs?: boolean;
+	/**
+	 * Indicates the date and time at which the video will be deleted. Omit
+	 * the field to indicate no change, or include with a `null` value to remove an
+	 * existing scheduled deletion. If specified, must be at least 30 days from upload
+	 * time.
+	 */
+	scheduledDeletion?: string | null;
+	/**
+	 * The timestamp for a thumbnail image calculated as a percentage value
+	 * of the video's duration. To convert from a second-wise timestamp to a
+	 * percentage, divide the desired timestamp by the total duration of the video. If
+	 * this value is not set, the default thumbnail image is taken from 0s of the
+	 * video.
+	 */
+	thumbnailTimestampPct?: number;
+};
+type StreamCaption = {
+	/**
+	 * Whether the caption was generated via AI.
+	 */
+	generated?: boolean;
+	/**
+	 * The language label displayed in the native language to users.
+	 */
+	label: string;
+	/**
+	 * The language tag in BCP 47 format.
+	 */
+	language: string;
+	/**
+	 * The status of a generated caption.
+	 */
+	status?: "ready" | "inprogress" | "error";
+};
+type StreamDownloadStatus = "ready" | "inprogress" | "error";
+type StreamDownloadType = "default" | "audio";
+type StreamDownload = {
+	/**
+	 * Indicates the progress as a percentage between 0 and 100.
+	 */
+	percentComplete: number;
+	/**
+	 * The status of a generated download.
+	 */
+	status: StreamDownloadStatus;
+	/**
+	 * The URL to access the generated download.
+	 */
+	url?: string;
+};
+/**
+ * An object with download type keys. Each key is optional and only present if that
+ * download type has been created.
+ */
+type StreamDownloadGetResponse = {
+	/**
+	 * The audio-only download. Only present if this download type has been created.
+	 */
+	audio?: StreamDownload;
+	/**
+	 * The default video download. Only present if this download type has been created.
+	 */
+	default?: StreamDownload;
+};
+type StreamWatermarkPosition = "upperRight" | "upperLeft" | "lowerLeft" | "lowerRight" | "center";
+type StreamWatermark = {
+	/**
+	 * The unique identifier for a watermark profile.
+	 */
+	id: string;
+	/**
+	 * The size of the image in bytes.
+	 */
+	size: number;
+	/**
+	 * The height of the image in pixels.
+	 */
+	height: number;
+	/**
+	 * The width of the image in pixels.
+	 */
+	width: number;
+	/**
+	 * The date and a time a watermark profile was created.
+	 */
+	created: string;
+	/**
+	 * The source URL for a downloaded image. If the watermark profile was created via
+	 * direct upload, this field is null.
+	 */
+	downloadedFrom: string | null;
+	/**
+	 * A short description of the watermark profile.
+	 */
+	name: string;
+	/**
+	 * The translucency of the image. A value of `0.0` makes the image completely
+	 * transparent, and `1.0` makes the image completely opaque. Note that if the image
+	 * is already semi-transparent, setting this to `1.0` will not make the image
+	 * completely opaque.
+	 */
+	opacity: number;
+	/**
+	 * The whitespace between the adjacent edges (determined by position) of the video
+	 * and the image. `0.0` indicates no padding, and `1.0` indicates a fully padded
+	 * video width or length, as determined by the algorithm.
+	 */
+	padding: number;
+	/**
+	 * The size of the image relative to the overall size of the video. This parameter
+	 * will adapt to horizontal and vertical videos automatically. `0.0` indicates no
+	 * scaling (use the size of the image as-is), and `1.0 `fills the entire video.
+	 */
+	scale: number;
+	/**
+	 * The location of the image. Valid positions are: `upperRight`, `upperLeft`,
+	 * `lowerLeft`, `lowerRight`, and `center`. Note that `center` ignores the
+	 * `padding` parameter.
+	 */
+	position: StreamWatermarkPosition;
+};
+type StreamWatermarkCreateParams = {
+	/**
+	 * A short description of the watermark profile.
+	 */
+	name?: string;
+	/**
+	 * The translucency of the image. A value of `0.0` makes the image completely
+	 * transparent, and `1.0` makes the image completely opaque. Note that if the
+	 * image is already semi-transparent, setting this to `1.0` will not make the
+	 * image completely opaque.
+	 */
+	opacity?: number;
+	/**
+	 * The whitespace between the adjacent edges (determined by position) of the
+	 * video and the image. `0.0` indicates no padding, and `1.0` indicates a fully
+	 * padded video width or length, as determined by the algorithm.
+	 */
+	padding?: number;
+	/**
+	 * The size of the image relative to the overall size of the video. This
+	 * parameter will adapt to horizontal and vertical videos automatically. `0.0`
+	 * indicates no scaling (use the size of the image as-is), and `1.0 `fills the
+	 * entire video.
+	 */
+	scale?: number;
+	/**
+	 * The location of the image.
+	 */
+	position?: StreamWatermarkPosition;
+};
+type StreamVideosListParams = {
+	/**
+	 * The maximum number of videos to return.
+	 */
+	limit?: number;
+	/**
+	 * Return videos created before this timestamp.
+	 * (RFC3339/RFC3339Nano)
+	 */
+	before?: string;
+	/**
+	 * Comparison operator for the `before` field.
+	 * @default 'lt'
+	 */
+	beforeComp?: StreamPaginationComparison;
+	/**
+	 * Return videos created after this timestamp.
+	 * (RFC3339/RFC3339Nano)
+	 */
+	after?: string;
+	/**
+	 * Comparison operator for the `after` field.
+	 * @default 'gte'
+	 */
+	afterComp?: StreamPaginationComparison;
+};
+type StreamPaginationComparison = "eq" | "gt" | "gte" | "lt" | "lte";
+/**
+ * Error object for Stream binding operations.
+ */
+interface StreamError extends Error {
+	readonly code: number;
+	readonly statusCode: number;
+	readonly message: string;
+	readonly stack?: string;
+}
+interface InternalError extends StreamError {
+	name: "InternalError";
+}
+interface BadRequestError extends StreamError {
+	name: "BadRequestError";
+}
+interface NotFoundError extends StreamError {
+	name: "NotFoundError";
+}
+interface ForbiddenError extends StreamError {
+	name: "ForbiddenError";
+}
+interface RateLimitedError extends StreamError {
+	name: "RateLimitedError";
+}
+interface QuotaReachedError extends StreamError {
+	name: "QuotaReachedError";
+}
+interface MaxFileSizeError extends StreamError {
+	name: "MaxFileSizeError";
+}
+interface InvalidURLError extends StreamError {
+	name: "InvalidURLError";
+}
+interface AlreadyUploadedError extends StreamError {
+	name: "AlreadyUploadedError";
+}
+interface TooManyWatermarksError extends StreamError {
+	name: "TooManyWatermarksError";
+}
 type MarkdownDocument = {
 	name: string;
 	blob: Blob;
 };
 type ConversionResponse =
 	| {
+			id: string;
 			name: string;
 			mimeType: string;
 			format: "markdown";
@@ -11387,6 +13380,7 @@ type ConversionResponse =
 			data: string;
 	  }
 	| {
+			id: string;
 			name: string;
 			mimeType: string;
 			format: "error";
@@ -11404,6 +13398,8 @@ type ConversionOptions = {
 		images?: EmbeddedImageConversionOptions & {
 			convertOGImage?: boolean;
 		};
+		hostname?: string;
+		cssSelector?: string;
 	};
 	docx?: {
 		images?: EmbeddedImageConversionOptions;
@@ -11498,6 +13494,9 @@ declare namespace TailStream {
 		readonly type: "fetch";
 		readonly statusCode: number;
 	}
+	interface ConnectEventInfo {
+		readonly type: "connect";
+	}
 	type EventOutcome =
 		| "ok"
 		| "canceled"
@@ -11528,6 +13527,7 @@ declare namespace TailStream {
 		readonly scriptVersion?: ScriptVersion;
 		readonly info:
 			| FetchEventInfo
+			| ConnectEventInfo
 			| JsRpcEventInfo
 			| ScheduledEventInfo
 			| AlarmEventInfo
diff --git a/demos/cloudflare/wrangler.jsonc b/demos/cloudflare/wrangler.jsonc
index 2dc5de41f..6e43c36ee 100644
--- a/demos/cloudflare/wrangler.jsonc
+++ b/demos/cloudflare/wrangler.jsonc
@@ -38,4 +38,10 @@
 			"binding": "LOADER",
 		},
 	],
+	"ai_search_namespaces": [
+		{
+			"binding": "AI_SEARCH",
+			"namespace": "default",
+		},
+	],
 }
diff --git a/demos/simple-ai-search/.gitignore b/demos/simple-ai-search/.gitignore
new file mode 100644
index 000000000..b3b110127
--- /dev/null
+++ b/demos/simple-ai-search/.gitignore
@@ -0,0 +1,5 @@
+node_modules
+dist
+.astro
+uploads
+data.db
diff --git a/demos/simple-ai-search/astro.config.mjs b/demos/simple-ai-search/astro.config.mjs
new file mode 100644
index 000000000..39834ce6b
--- /dev/null
+++ b/demos/simple-ai-search/astro.config.mjs
@@ -0,0 +1,51 @@
+import node from "@astrojs/node";
+import react from "@astrojs/react";
+import { aiSearchAPI } from "@emdash-cms/plugin-ai-search";
+import { auditLogPlugin } from "@emdash-cms/plugin-audit-log";
+import { defineConfig, fontProviders } from "astro/config";
+import emdash, { local } from "emdash/astro";
+import { sqlite } from "emdash/db";
+
+export default defineConfig({
+	output: "server",
+	adapter: node({
+		mode: "standalone",
+	}),
+	image: {
+		layout: "constrained",
+		responsiveStyles: true,
+	},
+	integrations: [
+		react(),
+		emdash({
+			database: sqlite({ url: "file:./data.db" }),
+			storage: local({
+				directory: "./uploads",
+				baseUrl: "/_emdash/api/media/file",
+			}),
+			plugins: [
+				auditLogPlugin(),
+				// AI Search via Cloudflare REST API — works on any platform.
+				// Reads CF_ACCOUNT_ID and CF_API_TOKEN from env vars.
+				aiSearchAPI({ instanceName: "emdash-content-api" }),
+			],
+		}),
+	],
+	fonts: [
+		{
+			provider: fontProviders.google(),
+			name: "Inter",
+			cssVariable: "--font-sans",
+			weights: [400, 500, 600, 700],
+			fallbacks: ["sans-serif"],
+		},
+		{
+			provider: fontProviders.google(),
+			name: "JetBrains Mono",
+			cssVariable: "--font-mono",
+			weights: [400, 500],
+			fallbacks: ["monospace"],
+		},
+	],
+	devToolbar: { enabled: false },
+});
diff --git a/demos/simple-ai-search/emdash-env.d.ts b/demos/simple-ai-search/emdash-env.d.ts
new file mode 100644
index 000000000..abb26262f
--- /dev/null
+++ b/demos/simple-ai-search/emdash-env.d.ts
@@ -0,0 +1,39 @@
+// Generated by EmDash on dev server start
+// Do not edit manually
+
+/// <reference types="emdash/locals" />
+
+import type { ContentBylineCredit, PortableTextBlock } from "emdash";
+
+export interface Page {
+  id: string;
+  slug: string | null;
+  status: string;
+  title: string;
+  content?: PortableTextBlock[];
+  createdAt: Date;
+  updatedAt: Date;
+  publishedAt: Date | null;
+  bylines?: ContentBylineCredit[];
+}
+
+export interface Post {
+  id: string;
+  slug: string | null;
+  status: string;
+  title: string;
+  featured_image?: { id: string; src?: string; alt?: string; width?: number; height?: number };
+  content?: PortableTextBlock[];
+  excerpt?: string;
+  createdAt: Date;
+  updatedAt: Date;
+  publishedAt: Date | null;
+  bylines?: ContentBylineCredit[];
+}
+
+declare module "emdash" {
+  interface EmDashCollections {
+    pages: Page;
+    posts: Post;
+  }
+}
\ No newline at end of file
diff --git a/demos/simple-ai-search/package.json b/demos/simple-ai-search/package.json
new file mode 100644
index 000000000..077b580b1
--- /dev/null
+++ b/demos/simple-ai-search/package.json
@@ -0,0 +1,35 @@
+{
+  "name": "@emdash-cms/demo-simple-ai-search",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "emdash": {
+    "seed": "seed/seed.json"
+  },
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "start": "node ./dist/server/entry.mjs",
+    "bootstrap": "emdash init && emdash seed",
+    "seed": "emdash seed",
+    "typecheck": "astro check"
+  },
+  "dependencies": {
+    "@astrojs/node": "catalog:",
+    "@astrojs/react": "catalog:",
+    "@emdash-cms/plugin-ai-search": "workspace:*",
+    "@emdash-cms/plugin-audit-log": "workspace:*",
+    "@emdash-cms/plugin-color": "workspace:*",
+    "astro": "catalog:",
+    "better-sqlite3": "catalog:",
+    "emdash": "workspace:*",
+    "react": "catalog:",
+    "react-dom": "catalog:"
+  },
+  "devDependencies": {
+    "@astrojs/check": "catalog:"
+  },
+  "peerDependencies": {},
+  "optionalDependencies": {}
+}
diff --git a/demos/simple-ai-search/seed/seed.json b/demos/simple-ai-search/seed/seed.json
new file mode 100644
index 000000000..b6c7845bc
--- /dev/null
+++ b/demos/simple-ai-search/seed/seed.json
@@ -0,0 +1,778 @@
+{
+	"$schema": "https://emdashcms.com/seed.schema.json",
+	"version": "1",
+	"meta": {
+		"name": "Blog Starter",
+		"description": "A blog with posts and pages",
+		"author": "EmDash"
+	},
+
+	"settings": {
+		"title": "My Blog",
+		"tagline": "Thoughts on building for the web"
+	},
+
+	"collections": [
+		{
+			"slug": "posts",
+			"label": "Posts",
+			"labelSingular": "Post",
+			"supports": ["drafts", "revisions", "search", "seo"],
+			"commentsEnabled": true,
+			"fields": [
+				{
+					"slug": "title",
+					"label": "Title",
+					"type": "string",
+					"required": true,
+					"searchable": true
+				},
+				{
+					"slug": "featured_image",
+					"label": "Featured Image",
+					"type": "image"
+				},
+				{
+					"slug": "content",
+					"label": "Content",
+					"type": "portableText",
+					"searchable": true
+				},
+				{
+					"slug": "excerpt",
+					"label": "Excerpt",
+					"type": "text"
+				}
+			]
+		},
+		{
+			"slug": "pages",
+			"label": "Pages",
+			"labelSingular": "Page",
+			"supports": ["drafts", "revisions", "search"],
+			"fields": [
+				{
+					"slug": "title",
+					"label": "Title",
+					"type": "string",
+					"required": true,
+					"searchable": true
+				},
+				{
+					"slug": "content",
+					"label": "Content",
+					"type": "portableText",
+					"searchable": true
+				}
+			]
+		}
+	],
+
+	"taxonomies": [
+		{
+			"name": "category",
+			"label": "Categories",
+			"labelSingular": "Category",
+			"hierarchical": true,
+			"collections": ["posts"],
+			"terms": [
+				{ "slug": "development", "label": "Development" },
+				{ "slug": "design", "label": "Design" },
+				{ "slug": "notes", "label": "Notes" }
+			]
+		},
+		{
+			"name": "tag",
+			"label": "Tags",
+			"labelSingular": "Tag",
+			"hierarchical": false,
+			"collections": ["posts"],
+			"terms": [
+				{ "slug": "webdev", "label": "Web Development" },
+				{ "slug": "opinion", "label": "Opinion" },
+				{ "slug": "tools", "label": "Tools" },
+				{ "slug": "creativity", "label": "Creativity" }
+			]
+		}
+	],
+
+	"bylines": [
+		{
+			"id": "byline-editorial",
+			"slug": "emdash-editorial",
+			"displayName": "EmDash Editorial"
+		},
+		{
+			"id": "byline-guest",
+			"slug": "guest-contributor",
+			"displayName": "Guest Contributor",
+			"isGuest": true
+		}
+	],
+
+	"menus": [
+		{
+			"name": "primary",
+			"label": "Primary Navigation",
+			"items": [
+				{ "type": "custom", "label": "Home", "url": "/" },
+				{ "type": "custom", "label": "About", "url": "/pages/about" },
+				{ "type": "custom", "label": "Posts", "url": "/posts" }
+			]
+		}
+	],
+
+	"widgetAreas": [
+		{
+			"name": "sidebar",
+			"label": "Sidebar",
+			"description": "Widget area displayed on single post pages",
+			"widgets": [
+				{
+					"type": "component",
+					"componentId": "core:search",
+					"title": "Search"
+				},
+				{
+					"type": "component",
+					"componentId": "core:categories",
+					"title": "Categories"
+				},
+				{
+					"type": "component",
+					"componentId": "core:tags",
+					"title": "Tags"
+				},
+				{
+					"type": "component",
+					"componentId": "core:recent-posts",
+					"title": "Recent Posts",
+					"settings": {
+						"count": 5,
+						"showDate": true
+					}
+				},
+				{
+					"type": "component",
+					"componentId": "core:archives",
+					"title": "Archives",
+					"settings": {
+						"type": "monthly",
+						"limit": 6
+					}
+				}
+			]
+		},
+		{
+			"name": "footer",
+			"label": "Footer",
+			"description": "Widget area displayed in the site footer",
+			"widgets": [
+				{
+					"type": "content",
+					"title": "About",
+					"content": [
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "A blog about software, design, and the occasional stray thought."
+								}
+							]
+						}
+					]
+				}
+			]
+		}
+	],
+
+	"sections": [
+		{
+			"slug": "newsletter-signup",
+			"title": "Newsletter Signup",
+			"description": "A call-to-action block for newsletter subscriptions",
+			"keywords": ["newsletter", "subscribe", "email", "cta"],
+			"source": "theme",
+			"content": [
+				{
+					"_type": "block",
+					"style": "h3",
+					"children": [{ "_type": "span", "text": "Stay in the loop" }]
+				},
+				{
+					"_type": "block",
+					"style": "normal",
+					"children": [
+						{
+							"_type": "span",
+							"text": "Get notified when new posts are published. No spam, unsubscribe anytime."
+						}
+					]
+				}
+			]
+		},
+		{
+			"slug": "about-author",
+			"title": "About the Author",
+			"description": "Brief author bio for use in posts or pages",
+			"keywords": ["author", "bio", "about"],
+			"source": "theme",
+			"content": [
+				{
+					"_type": "block",
+					"style": "normal",
+					"children": [
+						{
+							"_type": "span",
+							"text": "A software developer who writes about building things on the web. Based somewhere with good coffee and reliable internet."
+						}
+					]
+				}
+			]
+		}
+	],
+
+	"content": {
+		"pages": [
+			{
+				"id": "about",
+				"slug": "about",
+				"status": "published",
+				"data": {
+					"title": "About",
+					"content": [
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "A place for writing about software, design, and the occasional stray thought. No posting schedule, no newsletter funnel. Just things I wanted to write down."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "Built with Astro and EmDash. The source is open if you want to see how it works."
+								}
+							]
+						}
+					]
+				}
+			}
+		],
+		"posts": [
+			{
+				"id": "post-1",
+				"slug": "building-for-the-long-term",
+				"status": "published",
+				"data": {
+					"title": "Building for the Long Term",
+					"excerpt": "The frameworks will change. The databases will change. What survives is the clarity of your thinking.",
+					"featured_image": {
+						"$media": {
+							"url": "https://images.unsplash.com/photo-1461749280684-dccba630e2f6?w=1200&h=800&fit=crop",
+							"alt": "Code on a monitor in a dark room",
+							"filename": "building-long-term.jpg"
+						}
+					},
+					"content": [
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "Every few years the industry collectively decides that everything we've been doing is wrong and there's a better way. New frameworks, new paradigms, new build tools. The churn is relentless, and if you're not careful, you spend more time migrating than building."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "I've been writing software long enough to have seen several of these cycles. jQuery to Backbone to Angular to React to whatever comes next. Each transition felt urgent at the time. Looking back, the things that actually mattered were rarely about the framework."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "h2",
+							"children": [{ "_type": "span", "text": "What survives" }]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "Clean data models survive. Clear boundaries between systems survive. Good naming survives. The decision to keep things simple when you could have made them clever - that definitely survives."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "What doesn't survive is code that was written to impress, abstractions built for problems that never materialized, and architectures designed around a framework's opinions rather than the domain's reality."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "The best code I've written is boring. It reads like prose, does one thing well, and doesn't require a PhD in category theory to understand. The worst code I've written was technically impressive at the time."
+								}
+							]
+						}
+					]
+				},
+				"bylines": [
+					{ "byline": "byline-editorial" },
+					{ "byline": "byline-guest", "roleLabel": "Guest essay" }
+				],
+				"taxonomies": {
+					"category": ["development"],
+					"tag": ["opinion"]
+				}
+			},
+			{
+				"id": "post-2",
+				"slug": "the-case-for-static",
+				"status": "published",
+				"data": {
+					"title": "The Case for Static",
+					"excerpt": "Static sites aren't a step backwards. They're what you get when you take performance and simplicity seriously.",
+					"featured_image": {
+						"$media": {
+							"url": "https://images.unsplash.com/photo-1499750310107-5fef28a66643?w=1200&h=800&fit=crop",
+							"alt": "Laptop and coffee on a wooden table",
+							"filename": "case-for-static.jpg"
+						}
+					},
+					"content": [
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "There's a certain irony in the fact that the web started static, went dynamic, and is now swinging back toward static again. But the static sites of today aren't the hand-coded HTML pages of 1998. They're generated, optimized, and deployed to edge networks that serve them in milliseconds."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "The pitch for server-rendered everything was compelling: dynamic content, personalization, real-time data. But most sites don't need most of that most of the time. A blog post doesn't need to be rendered on every request. A product page doesn't change every second."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "h2",
+							"children": [{ "_type": "span", "text": "The performance argument" }]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "A static file served from a CDN is as fast as the web gets. No cold starts, no database queries, no server-side rendering overhead. The Time to First Byte is essentially the network latency to your nearest edge node. You can't beat physics."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "And when you do need dynamic behavior, you can add it surgically. An island of interactivity in a sea of static HTML. The best of both worlds, without paying the cost of either at all times."
+								}
+							]
+						}
+					]
+				},
+				"bylines": [{ "byline": "byline-editorial" }],
+				"taxonomies": {
+					"category": ["development"],
+					"tag": ["webdev", "opinion"]
+				}
+			},
+			{
+				"id": "post-3",
+				"slug": "learning-in-public",
+				"status": "published",
+				"data": {
+					"title": "Learning in Public",
+					"excerpt": "Writing about what you're learning is the fastest way to find out what you don't actually understand.",
+					"featured_image": {
+						"$media": {
+							"url": "https://images.unsplash.com/photo-1432821596592-e2c18b78144f?w=1200&h=800&fit=crop",
+							"alt": "Notebook and pen on a desk",
+							"filename": "learning-in-public.jpg"
+						}
+					},
+					"content": [
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "I started writing about things I was learning not because I had anything original to say, but because I kept forgetting what I'd figured out. The blog posts were notes to my future self, published publicly more out of laziness than courage."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "What I didn't expect was how much the writing itself would accelerate the learning. There's a particular kind of clarity that comes from trying to explain something to someone else. The gaps in your understanding, which you can happily ignore when the knowledge lives only in your head, become painfully obvious when you try to put it into sentences."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "h2",
+							"children": [{ "_type": "span", "text": "The fear of being wrong" }]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "The biggest barrier isn't time or writing skill. It's the fear of publishing something that turns out to be wrong. But here's the thing: being wrong publicly is one of the most efficient ways to learn. Someone will correct you, often kindly, and you'll remember that correction forever."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "The posts that helped me most weren't written by experts. They were written by people one step ahead of me on the same path, in language that hadn't yet been polished into abstraction. There's a place for that kind of writing, and it's more valuable than most people realize."
+								}
+							]
+						}
+					]
+				},
+				"taxonomies": {
+					"category": ["notes"],
+					"tag": ["opinion"]
+				}
+			},
+			{
+				"id": "post-4",
+				"slug": "small-tools-big-impact",
+				"status": "published",
+				"data": {
+					"title": "Small Tools, Big Impact",
+					"excerpt": "The best developer tools do one thing well and get out of your way. A love letter to focused software.",
+					"featured_image": {
+						"$media": {
+							"url": "https://images.unsplash.com/photo-1575026615908-666710ae5e47?w=1200&h=800&fit=crop",
+							"alt": "Wrenches and hand tools hanging on a workshop wall",
+							"filename": "small-tools.jpg"
+						}
+					},
+					"content": [
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "There's a class of software that doesn't get enough appreciation. Not the frameworks or the platforms or the IDEs, but the small, sharp tools that solve one problem so well you stop thinking about them. They become invisible, which is the highest compliment you can pay a tool."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "I'm talking about things like ripgrep, which searches code so fast it changed how I think about searching. Or jq, which makes JSON feel like a first-class data format in the terminal. Or curl, which has been quietly powering the internet's plumbing for decades."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "h2",
+							"children": [{ "_type": "span", "text": "The Unix philosophy, revisited" }]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "Do one thing well. The advice is old enough to be a cliche, but the best modern tools still follow it. They don't try to be platforms. They don't have plugin ecosystems or configuration languages or startup wizards. They do their job and they compose with other tools that do theirs."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "The temptation is always to add more. One more feature, one more option, one more integration. But every addition is a decision someone has to make, a path through the code that has to be maintained, a thing that can break. The best tools resist this. They stay small, and in staying small, they stay reliable."
+								}
+							]
+						}
+					]
+				},
+				"taxonomies": {
+					"category": ["development"],
+					"tag": ["tools"]
+				}
+			},
+			{
+				"id": "post-5",
+				"slug": "designing-with-constraints",
+				"status": "published",
+				"data": {
+					"title": "Designing with Constraints",
+					"excerpt": "Limitations aren't obstacles to creativity. They're the structure that makes creativity possible.",
+					"featured_image": {
+						"$media": {
+							"url": "https://images.unsplash.com/photo-1513542789411-b6a5d4f31634?w=1200&h=800&fit=crop",
+							"alt": "Pencils and design tools on a desk",
+							"filename": "designing-with-constraints.jpg"
+						}
+					},
+					"content": [
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "Give a designer a blank canvas and unlimited time, and they'll often produce something mediocre. Give them a tight brief, a small screen, and a deadline, and they'll surprise you. This isn't a paradox - it's how creativity actually works."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "Constraints force decisions. When you can't use more than two typefaces, you have to choose carefully. When the page has to load in under a second, every element earns its place. When the interface has to work on a 320px screen, you discover what's truly essential."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "h2",
+							"children": [{ "_type": "span", "text": "Embracing the box" }]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "The web itself is a constraint. HTML flows in one direction. CSS has a box model. Browsers have viewport sizes and font rendering quirks. You can fight these constraints or you can work with them, and the results are dramatically different."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "The designs I admire most don't look like they were forced through a framework. They look like they grew naturally from the medium, respecting its grain rather than working against it. That only happens when you treat constraints as creative partners rather than enemies."
+								}
+							]
+						}
+					]
+				},
+				"taxonomies": {
+					"category": ["design"],
+					"tag": ["creativity"]
+				}
+			},
+			{
+				"id": "post-6",
+				"slug": "a-weekend-with-a-side-project",
+				"status": "published",
+				"data": {
+					"title": "A Weekend with a Side Project",
+					"excerpt": "No stakeholders, no deadlines, no Jira tickets. Just you and a dumb idea that might turn into something.",
+					"featured_image": {
+						"$media": {
+							"url": "https://images.unsplash.com/photo-1542831371-29b0f74f9713?w=1200&h=800&fit=crop",
+							"alt": "Code on a screen with a dark theme",
+							"filename": "weekend-side-project.jpg"
+						}
+					},
+					"content": [
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "Saturday morning. Coffee's made, the house is quiet, and I've got an idea that's been nagging at me all week. Not a good idea, necessarily - just a persistent one. A small tool that does a thing I keep doing manually. How hard could it be?"
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "This is the best kind of programming. No requirements document, no sprint planning, no pull request reviews. Just a text editor and a problem. The freedom to make terrible architectural decisions, rewrite everything twice, and follow tangents that turn out to be dead ends."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "h2",
+							"children": [{ "_type": "span", "text": "Why side projects matter" }]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "Side projects are where you learn things your day job would never teach you. Not because the problems are harder, but because you're free to take risks. Try a language you've never used. Build something without a framework. Deploy to a platform you've only read about. The stakes are zero, which makes the learning maximum."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "By Sunday evening, the thing sort of works. It's rough, the error handling is nonexistent, and the README is a single sentence. But it solves the problem I set out to solve, and I learned three things I didn't know on Friday. Not a bad weekend."
+								}
+							]
+						}
+					]
+				},
+				"taxonomies": {
+					"category": ["development"],
+					"tag": ["creativity"]
+				}
+			},
+			{
+				"id": "post-7",
+				"slug": "notes-on-simplicity",
+				"status": "published",
+				"data": {
+					"title": "Notes on Simplicity",
+					"excerpt": "Simplicity isn't the absence of complexity. It's the result of understanding a problem well enough to solve it cleanly.",
+					"featured_image": {
+						"$media": {
+							"url": "https://images.unsplash.com/photo-1559051668-e1fa58f25786?w=1200&h=800&fit=crop",
+							"alt": "Geometric pattern carved into white paper",
+							"filename": "notes-on-simplicity.jpg"
+						}
+					},
+					"content": [
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "Every piece of software starts simple. A few files, a clear purpose, a small surface area. Then features get added, edge cases get handled, and before long you're looking at something that requires a diagram to understand. This isn't inevitable, but it takes discipline to prevent."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "The hard part of simplicity isn't the initial design. It's the ongoing resistance to complication. Every feature request, every bug fix, every refactor is an opportunity to add complexity. Saying no is the most important design skill, and the least celebrated."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "h2",
+							"children": [{ "_type": "span", "text": "Removing as a feature" }]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "The best version of a product often has fewer features than the previous one. Not because features were missing, but because someone had the courage to remove things that weren't earning their keep. Every feature has a cost - in maintenance, in cognitive load, in the weight of the interface."
+								}
+							]
+						},
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "Simplicity is a practice, not a destination. You never arrive at simple. You just keep asking: is this necessary? Could this be clearer? Is there a way to solve this problem by removing something instead of adding something? The answer is yes more often than you'd expect."
+								}
+							]
+						}
+					]
+				},
+				"taxonomies": {
+					"category": ["notes"],
+					"tag": ["opinion"]
+				}
+			},
+			{
+				"id": "post-draft",
+				"slug": "work-in-progress",
+				"status": "draft",
+				"data": {
+					"title": "Work in Progress",
+					"excerpt": "This post is still being written.",
+					"content": [
+						{
+							"_type": "block",
+							"style": "normal",
+							"children": [
+								{
+									"_type": "span",
+									"text": "This is a draft post that won't appear in the public listing."
+								}
+							]
+						}
+					]
+				}
+			}
+		]
+	}
+}
diff --git a/demos/simple-ai-search/src/components/PostCard.astro b/demos/simple-ai-search/src/components/PostCard.astro
new file mode 100644
index 000000000..3fee6edd8
--- /dev/null
+++ b/demos/simple-ai-search/src/components/PostCard.astro
@@ -0,0 +1,279 @@
+---
+import type { MediaValue, ContentBylineCredit } from "emdash";
+import { Image } from "emdash/ui";
+
+interface Props {
+	title: string;
+	excerpt?: string;
+	featuredImage?: MediaValue | string;
+	href: string;
+	date?: Date;
+	readingTime?: number;
+	tags?: Array<{ slug: string; label: string }>;
+	bylines?: ContentBylineCredit[];
+}
+
+const {
+	title,
+	excerpt,
+	featuredImage,
+	href,
+	date,
+	readingTime,
+	tags,
+	bylines,
+} = Astro.props;
+
+const formattedDate = date
+	? date.toLocaleDateString("en-US", {
+			year: "numeric",
+			month: "short",
+			day: "numeric",
+		})
+	: null;
+---
+
+<article class="post-card">
+	<a href={href} class="card-link">
+		{
+			featuredImage ? (
+				<div class="card-image">
+					<Image image={featuredImage} />
+				</div>
+			) : (
+				<div class="card-placeholder" />
+			)
+		}
+		<div class="card-body">
+			<div class="card-meta">
+				{
+					bylines && bylines.length > 0 && (
+						<>
+							<div class="card-bylines">
+								{bylines.slice(0, 1).map((credit) => (
+									<span class="card-byline">
+										{credit.byline.avatarMediaId && (
+											<img
+												src={`/_emdash/api/media/file/${credit.byline.avatarMediaId}`}
+												alt={credit.byline.displayName}
+												class="card-byline-avatar"
+											/>
+										)}
+										<span class="card-byline-name">
+											{credit.byline.displayName}
+										</span>
+									</span>
+								))}
+								{bylines.length > 1 && (
+									<span
+										class="byline-more"
+										data-tooltip={bylines
+											.slice(1)
+											.map((c) => c.byline.displayName)
+											.join(", ")}
+										title={bylines
+											.slice(1)
+											.map((c) => c.byline.displayName)
+											.join(", ")}
+										tabindex="0"
+									>
+										+{bylines.length - 1}
+									</span>
+								)}
+							</div>
+							{(formattedDate || readingTime) && <span class="meta-dot" />}
+						</>
+					)
+				}
+				{formattedDate && <time>{formattedDate}</time>}
+				{formattedDate && readingTime && <span class="meta-dot" />}
+				{readingTime && <span>{readingTime} min</span>}
+			</div>
+			<h2 class="card-title">{title}</h2>
+			{excerpt && <p class="card-excerpt">{excerpt}</p>}
+		</div>
+	</a>
+	{
+		tags && tags.length > 0 && (
+			<div class="card-tags">
+				{tags.slice(0, 2).map((tag) => (
+					<a href={`/tag/${tag.slug}`} class="card-tag">
+						{tag.label}
+					</a>
+				))}
+			</div>
+		)
+	}
+</article>
+
+<style>
+	.post-card {
+		display: flex;
+		flex-direction: column;
+	}
+
+	.card-link {
+		display: block;
+		text-decoration: none;
+		color: inherit;
+	}
+
+	.card-image {
+		aspect-ratio: 16 / 9;
+		overflow: hidden;
+		border-radius: var(--radius-lg);
+		background: var(--color-surface);
+		margin-bottom: var(--spacing-4);
+	}
+
+	.card-image img {
+		width: 100%;
+		height: 100%;
+		object-fit: cover;
+		transition: transform 0.3s ease;
+	}
+
+	.card-link:hover .card-image img {
+		transform: scale(1.03);
+	}
+
+	.card-placeholder {
+		aspect-ratio: 16 / 9;
+		border-radius: var(--radius-lg);
+		background: var(--color-surface);
+		margin-bottom: var(--spacing-4);
+	}
+
+	.card-body {
+		flex: 1;
+	}
+
+	.card-meta {
+		display: flex;
+		align-items: center;
+		flex-wrap: wrap;
+		column-gap: var(--spacing-2);
+		row-gap: 0;
+		font-size: var(--font-size-sm);
+		color: var(--color-muted);
+		margin-bottom: var(--spacing-2);
+	}
+
+	.card-meta time,
+	.card-meta span:not(.meta-dot) {
+		white-space: nowrap;
+	}
+
+	.meta-dot {
+		width: 3px;
+		height: 3px;
+		border-radius: 50%;
+		background: var(--color-muted);
+	}
+
+	.card-title {
+		font-size: var(--font-size-xl);
+		font-weight: 600;
+		line-height: var(--leading-snug);
+		letter-spacing: var(--tracking-snug);
+		margin-bottom: var(--spacing-2);
+		transition: color var(--transition-fast);
+	}
+
+	.card-link:hover .card-title {
+		color: var(--color-accent);
+	}
+
+	.card-excerpt {
+		font-size: var(--font-size-base);
+		line-height: var(--leading-relaxed);
+		color: var(--color-text-secondary);
+		display: -webkit-box;
+		-webkit-line-clamp: 2;
+		-webkit-box-orient: vertical;
+		overflow: hidden;
+	}
+
+	.card-tags {
+		display: flex;
+		flex-wrap: wrap;
+		gap: var(--spacing-2);
+		margin-top: var(--spacing-3);
+	}
+
+	.card-tag {
+		display: inline-block;
+		padding: var(--tag-padding-y) var(--spacing-2);
+		font-size: var(--font-size-xs);
+		color: var(--color-muted);
+		background: var(--color-surface);
+		border-radius: var(--radius);
+		text-decoration: none;
+		transition:
+			color var(--transition-fast),
+			background var(--transition-fast);
+	}
+
+	.card-tag:hover {
+		color: var(--color-text);
+		background: var(--color-border);
+	}
+
+	/* Byline styles */
+	.card-bylines {
+		display: flex;
+		align-items: center;
+		gap: 2px;
+		white-space: nowrap;
+	}
+
+	.card-byline {
+		display: inline-flex;
+		align-items: center;
+		gap: var(--spacing-1);
+	}
+
+	.card-byline-avatar {
+		width: var(--avatar-size-xs);
+		height: var(--avatar-size-xs);
+		border-radius: 50%;
+		object-fit: cover;
+	}
+
+	.card-byline-name {
+		font-weight: 500;
+		color: var(--color-text-secondary);
+	}
+
+	.byline-more {
+		position: relative;
+		font-size: var(--font-size-xs);
+		color: var(--color-muted);
+		margin-left: 2px;
+		cursor: default;
+		border-radius: var(--radius);
+		outline-offset: 2px;
+	}
+
+	.byline-more:focus-visible {
+		outline: 2px solid var(--color-accent);
+	}
+
+	.byline-more[data-tooltip]:hover::after,
+	.byline-more[data-tooltip]:focus-visible::after {
+		content: attr(data-tooltip);
+		position: absolute;
+		bottom: calc(100% + 6px);
+		left: 50%;
+		transform: translateX(-50%);
+		white-space: nowrap;
+		background: var(--color-text);
+		color: var(--color-bg);
+		font-size: var(--font-size-xs);
+		font-weight: 400;
+		padding: var(--spacing-1) var(--spacing-2);
+		border-radius: var(--radius);
+		pointer-events: none;
+		z-index: 10;
+	}
+</style>
diff --git a/demos/simple-ai-search/src/components/SearchModal.astro b/demos/simple-ai-search/src/components/SearchModal.astro
new file mode 100644
index 000000000..39ac1ccc7
--- /dev/null
+++ b/demos/simple-ai-search/src/components/SearchModal.astro
@@ -0,0 +1,925 @@
+---
+/**
+ * SearchModal - A modal search component for EmDash content
+ *
+ * Opens a centered modal overlay when the trigger button is clicked or
+ * when the user presses Cmd/Ctrl+K. Matches the style of Cloudflare's
+ * AI Search snippet modal.
+ *
+ * ```astro
+ * ---
+ * import SearchModal from "emdash/ui/search-modal";
+ * ---
+ * <SearchModal placeholder="Search articles..." collections={["posts", "pages"]} />
+ * ```
+ */
+
+export interface Props {
+	/** Placeholder text for the search input */
+	placeholder?: string;
+	/** Collections to search (defaults to all searchable collections) */
+	collections?: string[];
+	/** Minimum characters before searching (defaults to 2) */
+	minChars?: number;
+	/** Debounce delay in milliseconds (defaults to 300) */
+	debounce?: number;
+	/** Maximum results to show (defaults to 10) */
+	limit?: number;
+	/** Keyboard shortcut key (defaults to "k", used with Cmd/Ctrl) */
+	shortcut?: string;
+	/**
+	 * Custom search endpoint URL. Overrides the default FTS5 search endpoint.
+	 * Use this to point at a plugin search route, e.g. `"/_emdash/api/plugins/ai-search/query"`.
+	 * The endpoint should accept `q`, `limit`, and `collection` query params
+	 * and return `{ results: [{ collection, id, slug?, title?, snippet?, score }] }`.
+	 */
+	searchEndpoint?: string;
+}
+
+const {
+	placeholder = "Search...",
+	collections,
+	minChars = 2,
+	debounce = 300,
+	limit = 10,
+	shortcut = "k",
+	searchEndpoint,
+} = Astro.props;
+
+const config = {
+	collections: collections?.join(",") ?? "",
+	minChars,
+	debounce,
+	limit,
+	shortcut,
+	searchEndpoint: searchEndpoint ?? null,
+};
+---
+
+<!-- Trigger: rendered inline where the component is placed (e.g. inside a nav) -->
+<emdash-search-modal data-config={JSON.stringify(config)}>
+	<button type="button" class="emdash-search-trigger" aria-label="Search">
+		<svg class="emdash-search-trigger-icon" viewBox="0 -960 960 960" fill="currentColor">
+			<path d="M784-120 532-372q-30 24-69 38t-83 14q-109 0-184.5-75.5T120-580q0-109 75.5-184.5T380-840q109 0 184.5 75.5T640-580q0 44-14 83t-38 69l252 252-56 56ZM380-400q75 0 127.5-52.5T560-580q0-75-52.5-127.5T380-760q-75 0-127.5 52.5T200-580q0 75 52.5 127.5T380-400Z"></path>
+		</svg>
+		<span class="emdash-search-trigger-text">{placeholder}</span>
+		<kbd class="emdash-search-trigger-kbd">
+			<span class="emdash-search-trigger-kbd-mod"></span>{shortcut.toUpperCase()}
+		</kbd>
+	</button>
+
+	<!-- Backdrop template: the script moves this to document.body so it escapes
+	     any parent stacking context (e.g. a sticky header with backdrop-filter). -->
+	<template class="emdash-search-backdrop-tpl">
+		<div class="emdash-search-backdrop">
+			<div class="emdash-search-dialog" role="dialog" aria-modal="true" aria-label="Search">
+				<div class="emdash-search-header">
+					<svg class="emdash-search-icon" viewBox="0 -960 960 960" fill="currentColor">
+						<path d="M784-120 532-372q-30 24-69 38t-83 14q-109 0-184.5-75.5T120-580q0-109 75.5-184.5T380-840q109 0 184.5 75.5T640-580q0 44-14 83t-38 69l252 252-56 56ZM380-400q75 0 127.5-52.5T560-580q0-75-52.5-127.5T380-760q-75 0-127.5 52.5T200-580q0 75 52.5 127.5T380-400Z"></path>
+					</svg>
+					<input
+						type="text"
+						class="emdash-search-input"
+						placeholder={placeholder}
+						autocomplete="off"
+						spellcheck="false"
+						aria-label="Search"
+						aria-autocomplete="list"
+						aria-controls="emdash-search-results"
+						aria-expanded="false"
+					/>
+				</div>
+				<div class="emdash-search-content">
+					<div class="emdash-search-results" id="emdash-search-results" role="listbox" aria-label="Search results">
+						<div class="emdash-search-empty">
+							<svg class="emdash-search-empty-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+								<circle cx="11" cy="11" r="8"></circle>
+								<path d="m21 21-4.35-4.35"></path>
+							</svg>
+							<div class="emdash-search-empty-text">Start typing to search</div>
+						</div>
+					</div>
+				</div>
+				<div class="emdash-search-footer">
+					<div class="emdash-search-hints">
+						<span class="emdash-search-hint"><kbd>&uarr;</kbd><kbd>&darr;</kbd> Navigate</span>
+						<span class="emdash-search-hint"><kbd>&crarr;</kbd> Open</span>
+						<span class="emdash-search-hint"><kbd>Esc</kbd> Close</span>
+					</div>
+				</div>
+			</div>
+		</div>
+	</template>
+</emdash-search-modal>
+
+<script>
+	// Sanitization patterns for search snippets (allow only <mark> tags from FTS5)
+	const SNIPPET_AMP_RE = /&/g;
+	const SNIPPET_LT_RE = /</g;
+	const SNIPPET_GT_RE = />/g;
+	const SNIPPET_MARK_OPEN_RE = /&lt;mark&gt;/g;
+	const SNIPPET_MARK_CLOSE_RE = /&lt;\/mark&gt;/g;
+
+	interface SearchResult {
+		collection: string;
+		id: string;
+		slug: string | null;
+		title?: string;
+		snippet?: string;
+		score: number;
+	}
+
+	interface Config {
+		collections: string;
+		minChars: number;
+		debounce: number;
+		limit: number;
+		shortcut: string;
+		searchEndpoint: string | null;
+	}
+
+	/** Create an SVG element from a static markup string. Only used for icons with no dynamic content. */
+	function createSvgIcon(html: string): SVGElement {
+		const tmp = document.createElement("template");
+		tmp.innerHTML = html.trim();
+		return tmp.content.firstElementChild as SVGElement;
+	}
+
+	/** Sanitize a search snippet to allow only <mark> tags (from FTS5 highlighting). */
+	function sanitizeSnippet(snippet: string): string {
+		return snippet
+			.replace(SNIPPET_AMP_RE, "&amp;")
+			.replace(SNIPPET_LT_RE, "&lt;")
+			.replace(SNIPPET_GT_RE, "&gt;")
+			.replace(SNIPPET_MARK_OPEN_RE, "<mark>")
+			.replace(SNIPPET_MARK_CLOSE_RE, "</mark>");
+	}
+
+	const SEARCH_ICON_SVG = `<svg class="emdash-search-empty-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"></circle><path d="m21 21-4.35-4.35"></path></svg>`;
+
+	class EmDashSearchModal extends HTMLElement {
+		private trigger: HTMLButtonElement | null = null;
+		private backdrop: HTMLElement | null = null;
+		private dialog: HTMLElement | null = null;
+		private input: HTMLInputElement | null = null;
+		private resultsContainer: HTMLElement | null = null;
+		private config: Config = {
+			collections: "",
+			minChars: 2,
+			debounce: 300,
+			limit: 10,
+			shortcut: "k",
+			searchEndpoint: null,
+		};
+		private debounceTimer: ReturnType<typeof setTimeout> | null = null;
+		private abortController: AbortController | null = null;
+		private results: SearchResult[] = [];
+		private activeIndex = -1;
+		private isOpen = false;
+
+		connectedCallback() {
+			const configStr = this.dataset.config;
+			if (configStr) {
+				try {
+					this.config = { ...this.config, ...JSON.parse(configStr) };
+				} catch {
+					// Use defaults
+				}
+			}
+
+			this.trigger = this.querySelector(".emdash-search-trigger");
+
+			// Stamp the backdrop template and append to document.body so it
+			// sits outside any parent stacking context (sticky headers, etc.)
+			const tpl = this.querySelector<HTMLTemplateElement>(".emdash-search-backdrop-tpl");
+			if (tpl) {
+				const fragment = tpl.content.cloneNode(true) as DocumentFragment;
+				document.body.appendChild(fragment);
+				tpl.remove();
+			}
+			this.backdrop = document.body.querySelector(".emdash-search-backdrop");
+			this.dialog = this.backdrop?.querySelector(".emdash-search-dialog") ?? null;
+			this.input = this.backdrop?.querySelector(".emdash-search-input") ?? null;
+			this.resultsContainer = this.backdrop?.querySelector(".emdash-search-results") ?? null;
+
+			// Populate modifier key glyph
+			const modSpan = this.querySelector(".emdash-search-trigger-kbd-mod");
+			if (modSpan) {
+				const isMac =
+					navigator.platform?.startsWith("Mac") ||
+					(navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform === "macOS";
+				modSpan.textContent = isMac ? "\u2318" : "Ctrl+";
+			}
+
+			this.trigger?.addEventListener("click", () => this.open());
+
+			this.backdrop?.addEventListener("click", (e) => {
+				if (e.target === this.backdrop) this.close();
+			});
+
+			this.input?.addEventListener("input", () => this.handleInput());
+			this.input?.addEventListener("keydown", (e) => this.handleKeydown(e));
+
+			document.addEventListener("keydown", (e) => {
+				if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === this.config.shortcut) {
+					e.preventDefault();
+					if (this.isOpen) {
+						this.close();
+					} else {
+						this.open();
+					}
+				}
+			});
+		}
+
+		private open() {
+			if (this.isOpen) return;
+			this.isOpen = true;
+
+			if (this.backdrop) {
+				this.backdrop.classList.add("visible");
+				// Force reflow so opacity transition plays
+				void this.backdrop.offsetHeight;
+				this.backdrop.classList.add("open");
+			}
+
+			// Lock scroll and compensate for scrollbar disappearing
+			const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
+			document.body.style.overflow = "hidden";
+			if (scrollbarWidth > 0) {
+				document.body.style.paddingRight = `${scrollbarWidth}px`;
+			}
+
+			requestAnimationFrame(() => {
+				requestAnimationFrame(() => {
+					this.input?.focus();
+				});
+			});
+		}
+
+		private close() {
+			if (!this.isOpen) return;
+			this.isOpen = false;
+
+			this.backdrop?.classList.remove("open");
+			document.body.style.overflow = "";
+			document.body.style.paddingRight = "";
+
+			// Wait for opacity transition to finish, then hide
+			setTimeout(() => {
+				if (!this.isOpen && this.backdrop) {
+					this.backdrop.classList.remove("visible");
+				}
+			}, 200);
+
+			// Reset state
+			if (this.input) this.input.value = "";
+			this.results = [];
+			this.activeIndex = -1;
+			this.showEmpty();
+		}
+
+		private handleInput() {
+			if (!this.input) return;
+			const query = this.input.value.trim();
+
+			if (this.debounceTimer) clearTimeout(this.debounceTimer);
+
+			if (query.length < this.config.minChars) {
+				this.showEmpty();
+				return;
+			}
+
+			this.debounceTimer = setTimeout(() => {
+				this.search(query);
+			}, this.config.debounce);
+		}
+
+		private handleKeydown(e: KeyboardEvent) {
+			switch (e.key) {
+				case "ArrowDown":
+					e.preventDefault();
+					this.navigate(1);
+					break;
+				case "ArrowUp":
+					e.preventDefault();
+					this.navigate(-1);
+					break;
+				case "Enter":
+					e.preventDefault();
+					this.selectActive();
+					break;
+				case "Escape":
+					e.preventDefault();
+					this.close();
+					break;
+			}
+		}
+
+		private navigate(direction: number) {
+			if (this.results.length === 0) return;
+
+			const newIndex = this.activeIndex + direction;
+			if (newIndex < 0) {
+				this.activeIndex = this.results.length - 1;
+			} else if (newIndex >= this.results.length) {
+				this.activeIndex = 0;
+			} else {
+				this.activeIndex = newIndex;
+			}
+
+			this.updateActive();
+		}
+
+		private updateActive() {
+			const items = this.resultsContainer?.querySelectorAll(".emdash-search-result");
+			if (!items) return;
+
+			items.forEach((item, i) => {
+				if (i === this.activeIndex) {
+					item.classList.add("active");
+					item.setAttribute("aria-selected", "true");
+					(item as HTMLElement).scrollIntoView({ block: "nearest" });
+				} else {
+					item.classList.remove("active");
+					item.setAttribute("aria-selected", "false");
+				}
+			});
+
+			if (this.input) {
+				if (this.activeIndex >= 0) {
+					this.input.setAttribute("aria-activedescendant", `emdash-result-${this.activeIndex}`);
+				} else {
+					this.input.removeAttribute("aria-activedescendant");
+				}
+			}
+		}
+
+		private selectActive() {
+			if (this.activeIndex < 0 || this.activeIndex >= this.results.length) return;
+
+			const result = this.results[this.activeIndex];
+			if (!result) return;
+
+			const path = result.slug ?? result.id;
+			window.location.href = `/${result.collection}/${path}`;
+			this.close();
+		}
+
+		private async search(query: string) {
+			if (this.abortController) this.abortController.abort();
+			this.abortController = new AbortController();
+
+			this.showLoading();
+
+			try {
+				const endpoint = this.config.searchEndpoint ?? "/_emdash/api/search";
+				const params = new URLSearchParams({
+					q: query,
+					limit: String(this.config.limit),
+				});
+
+				if (this.config.collections) {
+					// Custom endpoints use 'collection' (singular) for filtering
+					if (this.config.searchEndpoint) {
+						params.set("collection", this.config.collections);
+					} else {
+						params.set("collections", this.config.collections);
+					}
+				}
+
+				const response = await fetch(`${endpoint}?${params}`, {
+					signal: this.abortController.signal,
+				});
+
+				if (!response.ok) throw new Error("Search failed");
+
+				// eslint-disable-next-line @typescript-eslint/no-explicit-any -- response shape varies by endpoint
+				const responseData: any = await response.json();
+				// Handle API response envelope: { data: { items: [...] } }
+				const data = responseData.data || responseData;
+				const items: SearchResult[] = data.items || data.results || [];
+
+				this.results = items;
+				this.activeIndex = items.length > 0 ? 0 : -1;
+				this.renderResults(items, query);
+			} catch (error) {
+				if ((error as Error).name === "AbortError") return;
+				this.showError();
+			}
+		}
+
+		private renderResults(results: SearchResult[], _query: string) {
+			if (!this.resultsContainer) return;
+
+			if (results.length === 0) {
+				this.showNoResults(_query);
+				return;
+			}
+
+			// Clear previous results
+			this.resultsContainer.textContent = "";
+
+			for (let i = 0; i < results.length; i++) {
+				const result = results[i]!;
+				const link = document.createElement("a");
+				link.href = `/${result.collection}/${result.slug ?? result.id}`;
+				link.className = `emdash-search-result${i === this.activeIndex ? " active" : ""}`;
+				link.role = "option";
+				link.id = `emdash-result-${i}`;
+				link.setAttribute("aria-selected", String(i === this.activeIndex));
+				link.dataset.index = String(i);
+
+				const body = document.createElement("div");
+				body.className = "emdash-search-result-body";
+
+				const titleEl = document.createElement("div");
+				titleEl.className = "emdash-search-result-title";
+				titleEl.textContent = result.title ?? result.slug ?? result.id;
+				body.appendChild(titleEl);
+
+				if (result.snippet) {
+					const snippetEl = document.createElement("div");
+					snippetEl.className = "emdash-search-result-snippet";
+					// innerHTML is intentional: sanitizeSnippet allows only <mark> tags
+					snippetEl.innerHTML = sanitizeSnippet(result.snippet);
+					body.appendChild(snippetEl);
+				}
+
+				const meta = document.createElement("div");
+				meta.className = "emdash-search-result-meta";
+				const collectionEl = document.createElement("span");
+				collectionEl.className = "emdash-search-result-collection";
+				collectionEl.textContent = result.collection;
+				meta.appendChild(collectionEl);
+				body.appendChild(meta);
+
+				link.appendChild(body);
+
+				// Mouse hover sets active index
+				link.addEventListener("mouseenter", () => {
+					this.activeIndex = i;
+					this.updateActive();
+				});
+
+				this.resultsContainer.appendChild(link);
+			}
+
+			if (this.input) this.input.setAttribute("aria-expanded", "true");
+		}
+
+		private showEmpty() {
+			if (!this.resultsContainer) return;
+			this.resultsContainer.textContent = "";
+
+			const wrap = document.createElement("div");
+			wrap.className = "emdash-search-empty";
+			wrap.appendChild(createSvgIcon(SEARCH_ICON_SVG));
+			const text = document.createElement("div");
+			text.className = "emdash-search-empty-text";
+			text.textContent = "Start typing to search";
+			wrap.appendChild(text);
+			this.resultsContainer.appendChild(wrap);
+
+			if (this.input) this.input.setAttribute("aria-expanded", "false");
+		}
+
+		private showLoading() {
+			if (!this.resultsContainer) return;
+			this.resultsContainer.textContent = "";
+
+			const wrap = document.createElement("div");
+			wrap.className = "emdash-search-loading";
+			const spinner = document.createElement("div");
+			spinner.className = "emdash-search-spinner";
+			wrap.appendChild(spinner);
+			const text = document.createElement("div");
+			text.className = "emdash-search-loading-text";
+			text.textContent = "Searching...";
+			wrap.appendChild(text);
+			this.resultsContainer.appendChild(wrap);
+		}
+
+		private showNoResults(query: string) {
+			if (!this.resultsContainer) return;
+			this.resultsContainer.textContent = "";
+
+			const wrap = document.createElement("div");
+			wrap.className = "emdash-search-empty";
+			wrap.appendChild(createSvgIcon(SEARCH_ICON_SVG));
+			const title = document.createElement("div");
+			title.className = "emdash-search-empty-title";
+			title.textContent = "No results found";
+			wrap.appendChild(title);
+			const text = document.createElement("div");
+			text.className = "emdash-search-empty-text";
+			text.textContent = `No results for "${query}"`;
+			wrap.appendChild(text);
+			this.resultsContainer.appendChild(wrap);
+
+			if (this.input) this.input.setAttribute("aria-expanded", "false");
+		}
+
+		private showError() {
+			if (!this.resultsContainer) return;
+			this.resultsContainer.textContent = "";
+
+			const wrap = document.createElement("div");
+			wrap.className = "emdash-search-empty";
+			const title = document.createElement("div");
+			title.className = "emdash-search-empty-title";
+			title.textContent = "Search unavailable";
+			wrap.appendChild(title);
+			const text = document.createElement("div");
+			text.className = "emdash-search-empty-text";
+			text.textContent = "Please try again later";
+			wrap.appendChild(text);
+			this.resultsContainer.appendChild(wrap);
+		}
+	}
+
+	customElements.define("emdash-search-modal", EmDashSearchModal);
+</script>
+
+<style>
+	/*
+	 * SearchModal uses CSS custom properties for theming.
+	 * Override these in your site's CSS to match your design:
+	 *
+	 * --emdash-search-bg: Background color for the modal
+	 * --emdash-search-surface: Subtle surface color (footer, hover)
+	 * --emdash-search-text: Primary text color
+	 * --emdash-search-muted: Secondary/muted text color
+	 * --emdash-search-border: Border color
+	 * --emdash-search-accent: Primary accent color
+	 * --emdash-search-accent-ring: Focus ring color (with alpha)
+	 * --emdash-search-radius: Border radius
+	 * --emdash-search-font: Font family
+	 */
+
+	/* ========= Trigger button ========= */
+
+	.emdash-search-trigger {
+		display: inline-flex;
+		align-items: center;
+		gap: 8px;
+		padding: 6px 12px;
+		background: var(--emdash-search-bg, #fff);
+		border: 1px solid var(--emdash-search-border, #dee2e6);
+		border-radius: var(--emdash-search-radius, 18px);
+		color: var(--emdash-search-muted, #6c757d);
+		font-family: var(--emdash-search-font, inherit);
+		font-size: 14px;
+		cursor: pointer;
+		transition: border-color 150ms ease, box-shadow 150ms ease;
+		white-space: nowrap;
+	}
+
+	.emdash-search-trigger:hover {
+		border-color: var(--emdash-search-accent, #2563eb);
+	}
+
+	.emdash-search-trigger:focus-visible {
+		outline: none;
+		border-color: var(--emdash-search-accent, #2563eb);
+		box-shadow: 0 0 0 3px var(--emdash-search-accent-ring, rgba(37, 99, 235, 0.25));
+	}
+
+	.emdash-search-trigger-icon {
+		width: 16px;
+		height: 16px;
+		flex-shrink: 0;
+	}
+
+	.emdash-search-trigger-text {
+		flex: 1;
+		text-align: left;
+	}
+
+	.emdash-search-trigger-kbd {
+		display: inline-flex;
+		align-items: center;
+		gap: 1px;
+		padding: 1px 6px;
+		background: var(--emdash-search-surface, #f8f9fa);
+		border: 1px solid var(--emdash-search-border, #dee2e6);
+		border-radius: 4px;
+		font-size: 11px;
+		font-family: var(--emdash-search-font, inherit);
+		color: var(--emdash-search-muted, #6c757d);
+		line-height: 1.6;
+	}
+
+	/* ========= Backdrop ========= */
+	/* Backdrop and descendants use :global() because the <template> is stamped
+	   into document.body at runtime, outside Astro's scoped style boundary. */
+
+	:global(.emdash-search-backdrop) {
+		position: fixed;
+		inset: 0;
+		z-index: 10000;
+		display: none;
+		align-items: flex-start;
+		justify-content: center;
+		padding-top: 15vh;
+		background: rgba(0, 0, 0, 0.5);
+		backdrop-filter: blur(4px);
+		opacity: 0;
+		transition: opacity 200ms ease;
+	}
+
+	:global(.emdash-search-backdrop.visible) {
+		display: flex;
+	}
+
+	:global(.emdash-search-backdrop.open) {
+		opacity: 1;
+	}
+
+	/* ========= Dialog ========= */
+
+	:global(.emdash-search-dialog) {
+		width: 90%;
+		max-width: 600px;
+		max-height: 70vh;
+		background: var(--emdash-search-bg, #fff);
+		border: 1px solid var(--emdash-search-border, #dee2e6);
+		border-radius: var(--emdash-search-radius, 18px);
+		box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);
+		display: flex;
+		flex-direction: column;
+		overflow: hidden;
+		transform: scale(0.95) translateY(-10px);
+		transition: transform 200ms ease;
+	}
+
+	:global(.emdash-search-backdrop.open .emdash-search-dialog) {
+		transform: scale(1) translateY(0);
+	}
+
+	/* ========= Header ========= */
+
+	:global(.emdash-search-header) {
+		display: flex;
+		align-items: center;
+		gap: 8px;
+		padding: 12px 16px;
+		border-bottom: 1px solid var(--emdash-search-border, #dee2e6);
+	}
+
+	:global(.emdash-search-icon) {
+		width: 20px;
+		height: 20px;
+		color: var(--emdash-search-muted, #6c757d);
+		flex-shrink: 0;
+	}
+
+	:global(.emdash-search-input) {
+		flex: 1;
+		border: none;
+		outline: none;
+		background: transparent;
+		color: var(--emdash-search-text, #212529);
+		font-size: 16px;
+		font-family: var(--emdash-search-font, inherit);
+		padding: 4px 0;
+	}
+
+	:global(.emdash-search-input::placeholder) {
+		color: var(--emdash-search-muted, #6c757d);
+	}
+
+	/* ========= Content ========= */
+
+	:global(.emdash-search-content) {
+		flex: 1;
+		overflow-y: auto;
+		overflow-x: hidden;
+		padding: 8px;
+	}
+
+	:global(.emdash-search-content::-webkit-scrollbar) {
+		width: 8px;
+	}
+
+	:global(.emdash-search-content::-webkit-scrollbar-track) {
+		background: var(--emdash-search-surface, #f8f9fa);
+	}
+
+	:global(.emdash-search-content::-webkit-scrollbar-thumb) {
+		background: var(--emdash-search-border, #dee2e6);
+		border-radius: 18px;
+	}
+
+	:global(.emdash-search-content::-webkit-scrollbar-thumb:hover) {
+		background: var(--emdash-search-muted, #6c757d);
+	}
+
+	/* ========= Results ========= */
+
+	:global(.emdash-search-results) {
+		display: flex;
+		flex-direction: column;
+		gap: 4px;
+	}
+
+	:global(.emdash-search-result) {
+		display: flex;
+		align-items: flex-start;
+		gap: 12px;
+		padding: 12px;
+		background: transparent;
+		border: 1px solid transparent;
+		border-radius: calc(var(--emdash-search-radius, 18px) - 4px);
+		text-decoration: none;
+		color: inherit;
+		cursor: pointer;
+		transition: background 150ms ease, border-color 150ms ease;
+	}
+
+	:global(.emdash-search-result:hover),
+	:global(.emdash-search-result.active) {
+		background: var(--emdash-search-surface, #f1f3f5);
+		border-color: var(--emdash-search-border, #dee2e6);
+	}
+
+	:global(.emdash-search-result.active) {
+		border-color: var(--emdash-search-accent, #2563eb);
+		background: var(--emdash-search-accent-ring, rgba(37, 99, 235, 0.08));
+	}
+
+	:global(.emdash-search-result:focus-visible) {
+		outline: 2px solid var(--emdash-search-accent, #2563eb);
+		outline-offset: -2px;
+	}
+
+	:global(.emdash-search-result-body) {
+		flex: 1;
+		min-width: 0;
+		display: flex;
+		flex-direction: column;
+		gap: 4px;
+	}
+
+	:global(.emdash-search-result-title) {
+		font-size: 14px;
+		font-weight: 500;
+		color: var(--emdash-search-text, #212529);
+		display: -webkit-box;
+		-webkit-line-clamp: 1;
+		-webkit-box-orient: vertical;
+		overflow: hidden;
+	}
+
+	:global(.emdash-search-result-snippet) {
+		font-size: 12px;
+		color: var(--emdash-search-muted, #495057);
+		line-height: 1.5;
+		display: -webkit-box;
+		-webkit-line-clamp: 2;
+		-webkit-box-orient: vertical;
+		overflow: hidden;
+	}
+
+	:global(.emdash-search-result-snippet mark) {
+		font-weight: 600;
+		background: none;
+		color: var(--emdash-search-text, #212529);
+	}
+
+	:global(.emdash-search-result-meta) {
+		display: flex;
+		align-items: center;
+		gap: 8px;
+	}
+
+	:global(.emdash-search-result-collection) {
+		font-size: 11px;
+		color: var(--emdash-search-accent, #2563eb);
+		text-transform: uppercase;
+		letter-spacing: 0.05em;
+		font-weight: 500;
+	}
+
+	/* ========= Empty / Loading states ========= */
+
+	:global(.emdash-search-empty) {
+		display: flex;
+		flex-direction: column;
+		align-items: center;
+		justify-content: center;
+		padding: 32px;
+		gap: 12px;
+		color: var(--emdash-search-muted, #6c757d);
+		text-align: center;
+	}
+
+	:global(.emdash-search-empty-icon) {
+		width: 48px;
+		height: 48px;
+		opacity: 0.5;
+	}
+
+	:global(.emdash-search-empty-title) {
+		font-size: 14px;
+		font-weight: 500;
+		color: var(--emdash-search-text, #212529);
+	}
+
+	:global(.emdash-search-empty-text) {
+		font-size: 13px;
+	}
+
+	:global(.emdash-search-loading) {
+		display: flex;
+		flex-direction: column;
+		align-items: center;
+		justify-content: center;
+		padding: 32px;
+		gap: 12px;
+		color: var(--emdash-search-muted, #6c757d);
+	}
+
+	:global(.emdash-search-spinner) {
+		width: 20px;
+		height: 20px;
+		border: 2px solid currentColor;
+		border-top-color: transparent;
+		border-radius: 50%;
+		animation: emdash-spin 0.6s linear infinite;
+	}
+
+	@keyframes emdash-spin {
+		to { transform: rotate(360deg); }
+	}
+
+	:global(.emdash-search-loading-text) {
+		font-size: 13px;
+	}
+
+	/* ========= Footer ========= */
+
+	:global(.emdash-search-footer) {
+		display: flex;
+		align-items: center;
+		justify-content: space-between;
+		padding: 8px 16px;
+		border-top: 1px solid var(--emdash-search-border, #dee2e6);
+		background: var(--emdash-search-surface, #f8f9fa);
+		font-size: 12px;
+		color: var(--emdash-search-muted, #6c757d);
+		border-radius: 0 0 var(--emdash-search-radius, 18px) var(--emdash-search-radius, 18px);
+	}
+
+	:global(.emdash-search-hints) {
+		display: flex;
+		align-items: center;
+		gap: 12px;
+	}
+
+	:global(.emdash-search-hint) {
+		display: flex;
+		align-items: center;
+		gap: 4px;
+	}
+
+	:global(.emdash-search-hint kbd) {
+		display: inline-flex;
+		align-items: center;
+		justify-content: center;
+		min-width: 20px;
+		height: 20px;
+		padding: 0 4px;
+		background: var(--emdash-search-bg, #fff);
+		border: 1px solid var(--emdash-search-border, #dee2e6);
+		border-radius: 4px;
+		font-size: 11px;
+		font-family: var(--emdash-search-font, inherit);
+		color: var(--emdash-search-muted, #6c757d);
+	}
+
+	/* ========= Responsive ========= */
+
+	@media (max-width: 640px) {
+		:global(.emdash-search-backdrop) {
+			padding-top: 10%;
+		}
+
+		:global(.emdash-search-dialog) {
+			width: 95%;
+			max-height: 80vh;
+		}
+
+		:global(.emdash-search-hints) {
+			display: none;
+		}
+
+		.emdash-search-trigger-text {
+			display: none;
+		}
+
+		.emdash-search-trigger-kbd {
+			display: none;
+		}
+	}
+</style>
diff --git a/demos/simple-ai-search/src/components/TagList.astro b/demos/simple-ai-search/src/components/TagList.astro
new file mode 100644
index 000000000..d93122d26
--- /dev/null
+++ b/demos/simple-ai-search/src/components/TagList.astro
@@ -0,0 +1,45 @@
+---
+interface Props {
+  tags: Array<{ slug: string; label: string }>;
+  class?: string;
+}
+
+const { tags, class: className } = Astro.props;
+---
+
+{tags.length > 0 && (
+  <ul class:list={["tag-list", className]}>
+    {tags.map((tag) => (
+      <li>
+        <a href={`/tag/${tag.slug}`} class="tag">{tag.label}</a>
+      </li>
+    ))}
+  </ul>
+)}
+
+<style>
+  .tag-list {
+    display: flex;
+    flex-wrap: wrap;
+    gap: var(--spacing-2);
+    list-style: none;
+    padding: 0;
+    margin: 0;
+  }
+
+  .tag {
+    display: inline-block;
+    padding: var(--tag-padding-y) var(--spacing-3);
+    font-size: var(--font-size-sm);
+    color: var(--color-text-secondary);
+    background: var(--color-surface);
+    border-radius: var(--radius);
+    text-decoration: none;
+    transition: color var(--transition-fast), background var(--transition-fast);
+  }
+
+  .tag:hover {
+    color: var(--color-text);
+    background: var(--color-border);
+  }
+</style>
diff --git a/demos/simple-ai-search/src/layouts/Base.astro b/demos/simple-ai-search/src/layouts/Base.astro
new file mode 100644
index 000000000..d10e49b78
--- /dev/null
+++ b/demos/simple-ai-search/src/layouts/Base.astro
@@ -0,0 +1,859 @@
+---
+import { getMenu, getEmDashCollection } from "emdash";
+import {
+	WidgetArea,
+	EmDashHead,
+	EmDashBodyStart,
+	EmDashBodyEnd,
+} from "emdash/ui";
+import { createPublicPageContext } from "emdash/page";
+import { Font } from "astro:assets";
+import SearchModal from "../components/SearchModal.astro";
+import "../styles/theme.css";
+
+interface Props {
+	title: string;
+	pageTitle?: string | null;
+	description?: string | null;
+	image?: string | null;
+	canonical?: string | null;
+	robots?: string | null;
+	type?: "website" | "article";
+	publishedTime?: string | null;
+	modifiedTime?: string | null;
+	author?: string | null;
+	/** Pass content reference for plugin page contributions on content pages */
+	content?: { collection: string; id: string; slug?: string | null };
+}
+
+const {
+	title,
+	pageTitle,
+	description,
+	image,
+	canonical,
+	robots,
+	type = "website",
+	publishedTime,
+	modifiedTime,
+	author,
+	content,
+} = Astro.props;
+const siteTitle = "My Blog";
+// If title already includes site title (from getSeoMeta), use as-is
+const fullTitle = title.includes(siteTitle) ? title : `${title} — ${siteTitle}`;
+
+// Fetch primary menu defined in seed
+const menu = await getMenu("primary");
+
+// Fetch pages for footer
+const { entries: pages } = await getEmDashCollection("pages");
+
+// Build public page context for plugin contributions
+// SEO data is passed here and rendered securely by EmDashHead
+const pageCtx = createPublicPageContext({
+	Astro,
+	kind: content ? "content" : "custom",
+	pageType: type,
+	title: fullTitle,
+	pageTitle: pageTitle ?? title,
+	description,
+	canonical,
+	image,
+	content,
+	seo: { ogImage: image, robots },
+	articleMeta: { publishedTime, modifiedTime, author },
+	siteName: siteTitle,
+});
+
+// Check if user is logged in (for showing admin link)
+const isLoggedIn = !!Astro.locals.user;
+---
+
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="UTF-8" />
+		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+		<Font cssVariable="--font-sans" preload />
+		<Font cssVariable="--font-mono" />
+		<title>{fullTitle}</title>
+		<EmDashHead page={pageCtx} />
+		<script is:inline>
+			// Apply theme immediately to prevent flash
+			(function () {
+				var c = document.cookie;
+				var i = c.indexOf("theme=");
+				var theme = i >= 0 ? c.slice(i + 6).split(";")[0] : null;
+				if (theme === "dark" || theme === "light") {
+					document.documentElement.classList.add(theme);
+				} else if (window.matchMedia("(prefers-color-scheme: dark)").matches) {
+					document.documentElement.classList.add("dark");
+				}
+			})();
+		</script>
+	</head>
+	<body>
+		<EmDashBodyStart page={pageCtx} />
+		<header class="site-header">
+			<nav class="nav">
+				<a href="/" class="site-title">{siteTitle}</a>
+				<div class="nav-right">
+				<SearchModal
+					placeholder="Search..."
+					collections={["posts", "pages"]}
+					searchEndpoint="/_emdash/api/plugins/ai-search-api/query"
+				/>
+					<div class="nav-links">
+						{
+							menu?.items.map((item) => (
+								<a href={item.url} target={item.target}>
+									{item.label}
+								</a>
+							))
+						}
+					</div>
+					{
+						isLoggedIn && (
+							<a href="/_emdash/admin" class="nav-admin">
+								Admin
+							</a>
+						)
+					}
+				</div>
+			</nav>
+		</header>
+
+		<main>
+			<slot />
+		</main>
+
+		<footer class="site-footer">
+			<div class="footer-inner">
+				<div class="footer-grid">
+					<div class="footer-brand">
+						<a href="/" class="footer-logo">{siteTitle}</a>
+						<p class="footer-tagline">Thoughts, stories, and ideas.</p>
+					</div>
+					<div class="footer-nav">
+						<h4 class="footer-heading">Navigate</h4>
+						<ul class="footer-links">
+							<li><a href="/">Home</a></li>
+							<li><a href="/posts">All Posts</a></li>
+							{
+								pages.slice(0, 3).map((page) => (
+									<li>
+										<a href={`/pages/${page.data.slug || page.id}`}>
+											{page.data.title}
+										</a>
+									</li>
+								))
+							}
+						</ul>
+					</div>
+					<div class="footer-nav">
+						<h4 class="footer-heading">Connect</h4>
+						<ul class="footer-links">
+							{
+								menu?.items.map((item) => (
+									<li>
+										<a
+											href={item.url}
+											target={item.target}
+											rel={
+												item.target === "_blank"
+													? "noopener noreferrer"
+													: undefined
+											}
+										>
+											{item.label}
+										</a>
+									</li>
+								))
+							}
+							<li><a href="/rss.xml">RSS Feed</a></li>
+						</ul>
+					</div>
+					<div class="footer-widgets-section">
+						<WidgetArea name="footer" />
+					</div>
+				</div>
+				<div class="footer-bottom">
+					<p class="footer-copyright">
+						Powered by <a href="https://emdashcms.com">EmDash</a>
+					</p>
+					<div class="theme-switcher">
+						<button
+							type="button"
+							class="theme-btn"
+							data-theme="light"
+							aria-label="Light mode"
+						>
+							<svg
+								width="16"
+								height="16"
+								viewBox="0 0 24 24"
+								fill="none"
+								stroke="currentColor"
+								stroke-width="2"
+								stroke-linecap="round"
+								stroke-linejoin="round"
+								><circle cx="12" cy="12" r="5"></circle><line
+									x1="12"
+									y1="1"
+									x2="12"
+									y2="3"></line><line x1="12" y1="21" x2="12" y2="23"
+								></line><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"
+								></line><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"
+								></line><line x1="1" y1="12" x2="3" y2="12"></line><line
+									x1="21"
+									y1="12"
+									x2="23"
+									y2="12"></line><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"
+								></line><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"
+								></line></svg
+							>
+						</button>
+						<button
+							type="button"
+							class="theme-btn"
+							data-theme="dark"
+							aria-label="Dark mode"
+						>
+							<svg
+								width="16"
+								height="16"
+								viewBox="0 0 24 24"
+								fill="none"
+								stroke="currentColor"
+								stroke-width="2"
+								stroke-linecap="round"
+								stroke-linejoin="round"
+								><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"
+								></path></svg
+							>
+						</button>
+						<button
+							type="button"
+							class="theme-btn"
+							data-theme="system"
+							aria-label="System theme"
+						>
+							<svg
+								width="16"
+								height="16"
+								viewBox="0 0 24 24"
+								fill="none"
+								stroke="currentColor"
+								stroke-width="2"
+								stroke-linecap="round"
+								stroke-linejoin="round"
+								><rect x="2" y="3" width="20" height="14" rx="2" ry="2"
+								></rect><line x1="8" y1="21" x2="16" y2="21"></line><line
+									x1="12"
+									y1="17"
+									x2="12"
+									y2="21"></line></svg
+							>
+						</button>
+					</div>
+				</div>
+			</div>
+		</footer>
+
+		<script>
+			// Theme switcher
+			const THEME_REGEX = /theme=([^;]+)/;
+			const themeBtns =
+				document.querySelectorAll<HTMLButtonElement>(".theme-btn");
+			const root = document.documentElement;
+
+			function setCookie(
+				name: string,
+				value: string,
+				maxAge: number = 31536000
+			) {
+				const secure = location.protocol === "https:" ? "; Secure" : "";
+				if (value === "") {
+					document.cookie = `${name}=; path=/; max-age=0; SameSite=Lax${secure}`;
+				} else {
+					document.cookie = `${name}=${value}; path=/; max-age=${maxAge}; SameSite=Lax${secure}`;
+				}
+			}
+
+			function setTheme(theme: string) {
+				if (theme === "system") {
+					setCookie("theme", "");
+					root.classList.remove("light", "dark");
+					if (window.matchMedia("(prefers-color-scheme: dark)").matches) {
+						root.classList.add("dark");
+					}
+				} else {
+					setCookie("theme", theme);
+					root.classList.remove("light", "dark");
+					root.classList.add(theme);
+				}
+				updateActiveBtn(theme);
+			}
+
+			function updateActiveBtn(theme: string) {
+				themeBtns.forEach((btn) => {
+					btn.classList.toggle("active", btn.dataset.theme === theme);
+				});
+			}
+
+			function getStoredTheme(): string {
+				const match = document.cookie.match(THEME_REGEX);
+				return match ? match[1] : "system";
+			}
+
+			// Initialize
+			const storedTheme = getStoredTheme();
+			setTheme(storedTheme);
+
+			themeBtns.forEach((btn) => {
+				btn.addEventListener("click", () => {
+					setTheme(btn.dataset.theme || "system");
+				});
+			});
+
+			// Listen for system preference changes
+			window
+				.matchMedia("(prefers-color-scheme: dark)")
+				.addEventListener("change", (e) => {
+					if (getStoredTheme() === "system") {
+						root.classList.toggle("dark", e.matches);
+					}
+				});
+		</script>
+
+		<style is:global>
+			*:where(:not([class*="emdash"]):not([class*="ec-"])),
+			*:where(:not([class*="emdash"]):not([class*="ec-"]))::before,
+			*:where(:not([class*="emdash"]):not([class*="ec-"]))::after {
+				box-sizing: border-box;
+			}
+
+			body,
+			h1,
+			h2,
+			h3,
+			h4,
+			h5,
+			h6,
+			p,
+			ul,
+			ol,
+			figure,
+			blockquote,
+			dl,
+			dd {
+				margin: 0;
+			}
+
+			ul,
+			ol {
+				padding: 0;
+			}
+
+			:root {
+				/* Colors - Light mode (default) */
+				--color-bg: #ffffff;
+				--color-bg-subtle: #fafafa;
+				--color-text: #1a1a1a;
+				--color-text-secondary: #525252;
+				--color-muted: #8b8b8b;
+				--color-border: #e5e5e5;
+				--color-border-subtle: #f0f0f0;
+				--color-surface: #f7f7f7;
+				--color-accent: #0066cc;
+				--color-accent-hover: #0052a3;
+				--color-on-accent: white;
+				--color-accent-ring: color-mix(
+					in srgb,
+					var(--color-accent) 25%,
+					transparent
+				);
+
+				/* EmDash search theming */
+				--emdash-search-bg: var(--color-bg);
+				--emdash-search-text: var(--color-text);
+				--emdash-search-muted: var(--color-muted);
+				--emdash-search-border: var(--color-border);
+				--emdash-search-hover: var(--color-surface);
+				--emdash-search-highlight: var(--color-text);
+
+				/* Type scale - more refined */
+				--font-size-xs: 0.8125rem;
+				--font-size-sm: 0.875rem;
+				--font-size-base: 1rem;
+				--font-size-lg: 1.125rem;
+				--font-size-xl: 1.25rem;
+				--font-size-2xl: 1.5rem;
+				--font-size-3xl: 2rem;
+				--font-size-4xl: 2.5rem;
+				--font-size-5xl: 3.5rem;
+
+				/* Line heights */
+				--leading-tight: 1.15;
+				--leading-snug: 1.3;
+				--leading-normal: 1.5;
+				--leading-relaxed: 1.7;
+
+				/* Spacing - more generous */
+				--spacing-1: 0.25rem;
+				--spacing-2: 0.5rem;
+				--spacing-3: 0.75rem;
+				--spacing-4: 1rem;
+				--spacing-5: 1.25rem;
+				--spacing-6: 1.5rem;
+				--spacing-8: 2rem;
+				--spacing-10: 2.5rem;
+				--spacing-12: 3rem;
+				--spacing-16: 4rem;
+				--spacing-20: 5rem;
+				--spacing-24: 6rem;
+
+				/* Legacy spacing aliases */
+				--spacing-xs: var(--spacing-1);
+				--spacing-sm: var(--spacing-2);
+				--spacing-md: var(--spacing-4);
+				--spacing-lg: var(--spacing-6);
+				--spacing-xl: var(--spacing-8);
+				--spacing-2xl: var(--spacing-12);
+				--spacing-3xl: var(--spacing-16);
+
+				/* Layout - wider for three-column */
+				--content-width: 680px;
+				--wide-width: 1200px;
+				--max-width: var(--content-width);
+				--gutter-width: 200px;
+				--radius: 4px;
+				--radius-lg: 8px;
+
+				/* Transitions */
+				--transition-fast: 120ms ease;
+				--transition-base: 180ms ease;
+
+				/* Nav */
+				--nav-height: 64px;
+
+				/* Article layout */
+				--meta-col-width: 180px;
+
+				/* Avatar sizes */
+				--avatar-size-xs: 18px;
+				--avatar-size-sm: 20px;
+				--avatar-size-md: 24px;
+				--avatar-size-lg: 32px;
+
+				/* Letter spacing */
+				--tracking-tight: -0.03em;
+				--tracking-snug: -0.02em;
+				--tracking-wide: 0.06em;
+				--tracking-wider: 0.08em;
+
+				/* Tag pill */
+				--tag-padding-y: 2px;
+
+				/* Shadows */
+				--shadow-dropdown: 0 8px 30px rgba(0, 0, 0, 0.12);
+				--shadow-btn-active: 0 1px 2px rgba(0, 0, 0, 0.05);
+			}
+
+			/* Dark mode via system preference (when no explicit class) */
+			@media (prefers-color-scheme: dark) {
+				:root:not(.light) {
+					--color-bg: #0d0d0d;
+					--color-bg-subtle: #141414;
+					--color-text: #ededed;
+					--color-text-secondary: #a0a0a0;
+					--color-muted: #6b6b6b;
+					--color-border: #2a2a2a;
+					--color-border-subtle: #1f1f1f;
+					--color-surface: #181818;
+					--color-accent: #4d9fff;
+					--color-accent-hover: #6eb0ff;
+				}
+			}
+
+			/* Explicit dark mode */
+			:root.dark {
+				--color-bg: #0d0d0d;
+				--color-bg-subtle: #141414;
+				--color-text: #ededed;
+				--color-text-secondary: #a0a0a0;
+				--color-muted: #6b6b6b;
+				--color-border: #2a2a2a;
+				--color-border-subtle: #1f1f1f;
+				--color-surface: #181818;
+				--color-accent: #4d9fff;
+				--color-accent-hover: #6eb0ff;
+			}
+
+			html {
+				scroll-behavior: smooth;
+			}
+
+			body {
+				font-family: var(--font-sans);
+				font-size: var(--font-size-base);
+				line-height: var(--leading-relaxed);
+				color: var(--color-text);
+				background: var(--color-bg);
+				-webkit-font-smoothing: antialiased;
+				-moz-osx-font-smoothing: grayscale;
+				min-height: 100vh;
+			}
+
+			a:where(:not([class*="emdash"]):not([class*="ec-"])) {
+				color: var(--color-accent);
+				text-decoration: none;
+				transition: color var(--transition-fast);
+			}
+
+			a:where(:not([class*="emdash"]):not([class*="ec-"])):hover {
+				color: var(--color-accent-hover);
+			}
+
+			img {
+				max-width: 100%;
+				height: auto;
+				display: block;
+			}
+
+			h1,
+			h2,
+			h3,
+			h4,
+			h5,
+			h6 {
+				font-family: var(--font-sans);
+				line-height: var(--leading-tight);
+				font-weight: 600;
+				letter-spacing: var(--tracking-snug);
+			}
+
+			h1 {
+				font-weight: 700;
+				letter-spacing: var(--tracking-tight);
+			}
+
+			::selection {
+				background: var(--color-accent);
+				color: white;
+			}
+		</style>
+
+		<style>
+			.site-header {
+				position: sticky;
+				top: 0;
+				z-index: 100;
+				background: color-mix(in srgb, var(--color-bg) 65%, transparent);
+				backdrop-filter: blur(12px);
+				-webkit-backdrop-filter: blur(12px);
+				border-bottom: 1px solid var(--color-border-subtle);
+			}
+
+			.nav {
+				display: flex;
+				justify-content: space-between;
+				align-items: center;
+				max-width: var(--wide-width);
+				margin: 0 auto;
+				padding: var(--spacing-4) var(--spacing-6);
+				height: var(--nav-height);
+			}
+
+			.site-title {
+				font-size: var(--font-size-lg);
+				font-weight: 600;
+				color: var(--color-text);
+				text-decoration: none;
+				letter-spacing: var(--tracking-snug);
+			}
+
+			.site-title:hover {
+				color: var(--color-accent);
+			}
+
+			.nav-right {
+				display: flex;
+				align-items: center;
+				gap: var(--spacing-6);
+			}
+
+			.nav-links {
+				display: flex;
+				gap: var(--spacing-5);
+				font-size: var(--font-size-sm);
+			}
+
+			.nav-links a {
+				text-decoration: none;
+				color: var(--color-text);
+				transition: color var(--transition-fast);
+			}
+
+			.nav-links a:hover {
+				color: var(--color-accent);
+			}
+
+			.nav-admin {
+				font-size: var(--font-size-sm);
+				color: var(--color-muted);
+				text-decoration: none;
+				opacity: 0.5;
+				transition: opacity var(--transition-fast);
+			}
+
+			.nav-admin:hover {
+				opacity: 1;
+			}
+
+			/* Search modal theming -- applied to both the trigger (inside the nav)
+			   and the backdrop (appended to document.body at runtime) */
+			:global(emdash-search-modal),
+			:global(.emdash-search-backdrop) {
+				--emdash-search-bg: var(--color-bg);
+				--emdash-search-surface: var(--color-surface);
+				--emdash-search-text: var(--color-text);
+				--emdash-search-muted: var(--color-muted);
+				--emdash-search-border: var(--color-border);
+				--emdash-search-accent: var(--color-accent);
+				--emdash-search-accent-ring: var(--color-accent-ring);
+				--emdash-search-radius: var(--radius-lg);
+				--emdash-search-font: var(--font-sans);
+			}
+
+			main {
+				min-height: calc(100vh - var(--nav-height) - 300px);
+			}
+
+			/* Footer */
+			.site-footer {
+				background: var(--color-bg-subtle);
+				border-top: 1px solid var(--color-border-subtle);
+			}
+
+			.footer-inner {
+				max-width: var(--wide-width);
+				margin: 0 auto;
+				padding: var(--spacing-16) var(--spacing-6) var(--spacing-8);
+			}
+
+			.footer-grid {
+				display: grid;
+				grid-template-columns: 2fr 1fr 1fr 1fr;
+				gap: var(--spacing-12);
+				margin-bottom: var(--spacing-12);
+			}
+
+			.footer-brand {
+				max-width: 280px;
+			}
+
+			.footer-logo {
+				font-size: var(--font-size-lg);
+				font-weight: 600;
+				color: var(--color-text);
+				text-decoration: none;
+				letter-spacing: var(--tracking-snug);
+			}
+
+			.footer-tagline {
+				margin-top: var(--spacing-3);
+				font-size: var(--font-size-sm);
+				color: var(--color-muted);
+				line-height: var(--leading-relaxed);
+			}
+
+			.footer-nav {
+				min-width: 0;
+			}
+
+			.footer-heading {
+				font-size: var(--font-size-xs);
+				font-weight: 500;
+				text-transform: uppercase;
+				letter-spacing: var(--tracking-wider);
+				color: var(--color-muted);
+				margin-bottom: var(--spacing-4);
+			}
+
+			.footer-links {
+				list-style: none;
+			}
+
+			.footer-links li {
+				margin-bottom: var(--spacing-2);
+			}
+
+			.footer-links a {
+				color: var(--color-text-secondary);
+				text-decoration: none;
+				font-size: var(--font-size-sm);
+				transition: color var(--transition-fast);
+			}
+
+			.footer-links a:hover {
+				color: var(--color-text);
+			}
+
+			.footer-widgets-section :global(.widget-area) {
+				display: block;
+			}
+
+			.footer-widgets-section :global(.widget) {
+				color: var(--color-text-secondary);
+			}
+
+			.footer-widgets-section :global(.widget__title) {
+				font-size: var(--font-size-xs);
+				font-weight: 500;
+				text-transform: uppercase;
+				letter-spacing: var(--tracking-wider);
+				color: var(--color-muted);
+				margin-bottom: var(--spacing-4);
+			}
+
+			.footer-widgets-section :global(.widget__content) {
+				color: var(--color-text-secondary);
+				font-size: var(--font-size-sm);
+				line-height: var(--leading-relaxed);
+			}
+
+			.footer-bottom {
+				display: flex;
+				justify-content: space-between;
+				align-items: center;
+				padding-top: var(--spacing-6);
+				border-top: 1px solid var(--color-border);
+			}
+
+			.footer-copyright {
+				font-size: var(--font-size-sm);
+				color: var(--color-muted);
+			}
+
+			.footer-copyright a {
+				color: var(--color-text-secondary);
+			}
+
+			/* Theme switcher */
+			.theme-switcher {
+				display: flex;
+				gap: var(--spacing-1);
+				padding: var(--spacing-1);
+				background: var(--color-surface);
+				border-radius: var(--radius);
+			}
+
+			.theme-btn {
+				display: flex;
+				align-items: center;
+				justify-content: center;
+				width: 32px;
+				height: 28px;
+				background: transparent;
+				border: none;
+				color: var(--color-muted);
+				border-radius: var(--radius);
+				cursor: pointer;
+				transition: all var(--transition-fast);
+			}
+
+			.theme-btn:hover {
+				color: var(--color-text-secondary);
+			}
+
+			.theme-btn.active {
+				background: var(--color-bg);
+				color: var(--color-text);
+				box-shadow: var(--shadow-btn-active);
+			}
+
+			.theme-btn svg {
+				width: 16px;
+				height: 16px;
+			}
+
+			@media (max-width: 900px) {
+				.footer-grid {
+					grid-template-columns: 1fr 1fr;
+					gap: var(--spacing-8);
+				}
+
+				.footer-brand {
+					grid-column: span 2;
+					max-width: none;
+				}
+			}
+
+			@media (max-width: 640px) {
+				.site-header {
+					position: relative;
+					border-bottom: none;
+				}
+
+				.nav {
+					flex-direction: row;
+					flex-wrap: wrap;
+					justify-content: space-between;
+					align-items: center;
+					height: auto;
+					gap: var(--spacing-2);
+					padding: var(--spacing-3) var(--spacing-4);
+				}
+
+				.site-title {
+					font-size: var(--font-size-base);
+				}
+
+				.nav-right {
+					display: contents;
+				}
+
+				.nav-links {
+					order: 1;
+					width: 100%;
+					display: flex;
+					column-gap: var(--spacing-3);
+					row-gap: var(--spacing-1);
+					flex-wrap: wrap;
+					justify-content: flex-start;
+				}
+
+				.nav-admin {
+					order: 2;
+					position: absolute;
+					right: var(--spacing-4);
+					top: var(--spacing-3);
+					font-size: var(--font-size-xs);
+				}
+
+				.footer-grid {
+					grid-template-columns: 1fr;
+				}
+
+				.footer-brand {
+					grid-column: span 1;
+				}
+
+				.footer-bottom {
+					flex-direction: column;
+					gap: var(--spacing-4);
+					text-align: center;
+				}
+
+				.footer-controls {
+					flex-wrap: wrap;
+					justify-content: center;
+				}
+			}
+		</style>
+
+		<EmDashBodyEnd page={pageCtx} />
+	</body>
+</html>
diff --git a/demos/simple-ai-search/src/live.config.ts b/demos/simple-ai-search/src/live.config.ts
new file mode 100644
index 000000000..c8c819d40
--- /dev/null
+++ b/demos/simple-ai-search/src/live.config.ts
@@ -0,0 +1,13 @@
+/**
+ * EmDash Live Content Collections
+ *
+ * Defines the _emdash collection that handles all content types from the database.
+ * Query specific types using getEmDashCollection() and getEmDashEntry().
+ */
+
+import { defineLiveCollection } from "astro:content";
+import { emdashLoader } from "emdash/runtime";
+
+export const collections = {
+	_emdash: defineLiveCollection({ loader: emdashLoader() }),
+};
diff --git a/demos/simple-ai-search/src/pages/404.astro b/demos/simple-ai-search/src/pages/404.astro
new file mode 100644
index 000000000..0078a14ab
--- /dev/null
+++ b/demos/simple-ai-search/src/pages/404.astro
@@ -0,0 +1,33 @@
+---
+import Base from "../layouts/Base.astro";
+---
+
+<Base title="Page not found">
+	<div class="not-found">
+		<h1>404</h1>
+		<p>The page you're looking for doesn't exist.</p>
+		<a href="/">Go back home</a>
+	</div>
+</Base>
+
+<style>
+	.not-found {
+		text-align: center;
+		padding: var(--spacing-24) var(--spacing-6);
+	}
+
+	.not-found h1 {
+		font-size: var(--font-size-5xl);
+		margin-bottom: var(--spacing-2);
+		color: var(--color-border);
+	}
+
+	.not-found p {
+		color: var(--color-muted);
+		margin-bottom: var(--spacing-6);
+	}
+
+	.not-found a {
+		color: var(--color-text);
+	}
+</style>
diff --git a/demos/simple-ai-search/src/pages/category/[slug].astro b/demos/simple-ai-search/src/pages/category/[slug].astro
new file mode 100644
index 000000000..e0a94ef5a
--- /dev/null
+++ b/demos/simple-ai-search/src/pages/category/[slug].astro
@@ -0,0 +1,117 @@
+---
+import { getTerm, getEmDashCollection, getEntryTerms, decodeSlug } from "emdash";
+import Base from "../../layouts/Base.astro";
+import PostCard from "../../components/PostCard.astro";
+import { getReadingTime } from "../../utils/reading-time";
+
+const slug = decodeSlug(Astro.params.slug);
+const term = slug ? await getTerm("category", slug) : null;
+
+if (!term) {
+	return Astro.redirect("/404");
+}
+
+const { entries: posts } = await getEmDashCollection("posts", {
+	where: { category: term.slug },
+	orderBy: { published_at: "desc" },
+});
+
+// Fetch tags for display on each post card
+const filteredPosts = await Promise.all(
+	posts.map(async (post) => {
+		const tags = await getEntryTerms("posts", post.data.id, "tag");
+		return { post, tags };
+	})
+);
+---
+
+<Base title={`${term.label} posts`} description={`All posts in ${term.label}`}>
+	<section class="archive-section">
+		<header class="archive-header">
+			<span class="archive-label">Category</span>
+			<h1 class="archive-title">{term.label}</h1>
+			<p class="archive-count">
+				{filteredPosts.length}
+				{filteredPosts.length === 1 ? "post" : "posts"}
+			</p>
+		</header>
+
+		{
+			filteredPosts.length === 0 ? (
+				<p class="no-posts">No posts in this category yet.</p>
+			) : (
+				<div class="posts-grid">
+					{filteredPosts.map(({ post, tags }) => (
+						<PostCard
+							title={post.data.title}
+							excerpt={post.data.excerpt}
+							featuredImage={post.data.featured_image}
+							href={`/posts/${post.id}`}
+							date={post.data.publishedAt ?? undefined}
+							readingTime={getReadingTime(post.data.content)}
+							tags={tags.map((t) => ({ slug: t.slug, label: t.label }))}
+						/>
+					))}
+				</div>
+			)
+		}
+	</section>
+</Base>
+
+<style>
+	.archive-section {
+		max-width: var(--wide-width);
+		margin: 0 auto;
+		padding: var(--spacing-12) var(--spacing-6);
+	}
+
+	.archive-header {
+		margin-bottom: var(--spacing-12);
+		padding-bottom: var(--spacing-8);
+		border-bottom: 1px solid var(--color-border-subtle);
+	}
+
+	.archive-label {
+		display: block;
+		font-size: var(--font-size-xs);
+		font-weight: 500;
+		color: var(--color-accent);
+		text-transform: uppercase;
+		letter-spacing: var(--tracking-wider);
+		margin-bottom: var(--spacing-2);
+	}
+
+	.archive-title {
+		font-size: var(--font-size-4xl);
+		font-weight: 700;
+		letter-spacing: var(--tracking-tight);
+		margin-bottom: var(--spacing-2);
+	}
+
+	.archive-count {
+		font-size: var(--font-size-sm);
+		color: var(--color-muted);
+	}
+
+	.posts-grid {
+		display: grid;
+		grid-template-columns: repeat(3, 1fr);
+		gap: var(--spacing-12) var(--spacing-8);
+	}
+
+	.no-posts {
+		color: var(--color-muted);
+	}
+
+	@media (max-width: 900px) {
+		.posts-grid {
+			grid-template-columns: repeat(2, 1fr);
+		}
+	}
+
+	@media (max-width: 600px) {
+		.posts-grid {
+			grid-template-columns: 1fr;
+		}
+	}
+</style>
diff --git a/demos/simple-ai-search/src/pages/index.astro b/demos/simple-ai-search/src/pages/index.astro
new file mode 100644
index 000000000..4c72f48e9
--- /dev/null
+++ b/demos/simple-ai-search/src/pages/index.astro
@@ -0,0 +1,448 @@
+---
+import { getEmDashCollection, getEntryTerms } from "emdash";
+import { Image } from "emdash/ui";
+import Base from "../layouts/Base.astro";
+import PostCard from "../components/PostCard.astro";
+import { getReadingTime } from "../utils/reading-time";
+
+const { entries: posts, cacheHint } = await getEmDashCollection("posts");
+
+Astro.cache.set(cacheHint);
+
+const sortedPosts = posts.toSorted((a, b) => {
+	const dateA = a.data.publishedAt?.getTime() ?? 0;
+	const dateB = b.data.publishedAt?.getTime() ?? 0;
+	return dateB - dateA;
+});
+
+// Find the first post with a featured image for the hero
+const featuredPost = sortedPosts.find((p) => p.data.featured_image);
+const featuredIndex = featuredPost ? sortedPosts.indexOf(featuredPost) : -1;
+
+// Get remaining posts (exclude featured if found, limit to 6 for grid)
+const gridPosts = sortedPosts.filter((_, i) => i !== featuredIndex).slice(0, 6);
+
+// Total posts shown = featured (if any) + grid posts
+const totalShown = (featuredPost ? 1 : 0) + gridPosts.length;
+const hasMorePosts = sortedPosts.length > totalShown;
+
+// Fetch tags for featured post (bylines are already hydrated by getEmDashCollection)
+let featuredTags: Array<{ slug: string; label: string }> = [];
+const featuredBylines = featuredPost?.data.bylines ?? [];
+if (featuredPost) {
+	const tags = await getEntryTerms("posts", featuredPost.data.id, "tag");
+	featuredTags = tags.map((t) => ({ slug: t.slug, label: t.label }));
+}
+
+// Fetch tags for grid posts (bylines are already hydrated by getEmDashCollection)
+const gridPostsWithTags = await Promise.all(
+	gridPosts.map(async (post) => {
+		const tags = await getEntryTerms("posts", post.data.id, "tag");
+		const bylines = post.data.bylines ?? [];
+		return {
+			post,
+			tags: tags.map((t) => ({ slug: t.slug, label: t.label })),
+			bylines,
+		};
+	})
+);
+
+// Format date helper
+function formatDate(date: Date | null | undefined) {
+	if (!date) return null;
+	return date.toLocaleDateString("en-US", {
+		year: "numeric",
+		month: "long",
+		day: "numeric",
+	});
+}
+---
+
+<Base title="My Blog" description="Welcome to my blog">
+	{
+		posts.length === 0 ? (
+			<section class="empty-state">
+				<h2>No posts yet</h2>
+				<p>Create your first post in the admin panel.</p>
+				<a href="/_emdash/admin/content/posts/new" class="btn">
+					Create a post
+				</a>
+			</section>
+		) : (
+			<div class="home-content">
+				{/* Featured Post - Side by side */}
+				{featuredPost && (
+					<section class="featured-section">
+						<div class="featured-grid">
+							<a href={`/posts/${featuredPost.id}`} class="featured-image-link">
+								<div class="featured-image">
+									<Image image={featuredPost.data.featured_image} />
+								</div>
+							</a>
+							<div class="featured-content">
+								<div class="featured-meta">
+									{featuredBylines.length > 0 && (
+										<>
+											<div class="featured-bylines">
+												{featuredBylines.slice(0, 2).map((credit, index) => (
+													<>
+														{index > 0 && <span class="byline-sep">,</span>}
+														<span class="featured-byline">
+															{credit.byline.avatarMediaId && (
+																<img
+																	src={`/_emdash/api/media/file/${credit.byline.avatarMediaId}`}
+																	alt={credit.byline.displayName}
+																	class="featured-byline-avatar"
+																/>
+															)}
+															<span class="featured-byline-name">
+																{credit.byline.displayName}
+															</span>
+														</span>
+													</>
+												))}
+												{featuredBylines.length > 2 && (
+													<span class="byline-more">
+														+{featuredBylines.length - 2}
+													</span>
+												)}
+											</div>
+											<span class="meta-dot" />
+										</>
+									)}
+									{formatDate(featuredPost.data.publishedAt) && (
+										<time>{formatDate(featuredPost.data.publishedAt)}</time>
+									)}
+									<span class="meta-dot" />
+									<span>
+										{getReadingTime(featuredPost.data.content)} min read
+									</span>
+								</div>
+								<a
+									href={`/posts/${featuredPost.id}`}
+									class="featured-title-link"
+								>
+									<h1 class="featured-title">{featuredPost.data.title}</h1>
+								</a>
+								{featuredPost.data.excerpt && (
+									<p class="featured-excerpt">{featuredPost.data.excerpt}</p>
+								)}
+								{featuredTags.length > 0 && (
+									<div class="featured-tags">
+										{featuredTags.map((tag) => (
+											<a href={`/tag/${tag.slug}`} class="featured-tag">
+												{tag.label}
+											</a>
+										))}
+									</div>
+								)}
+							</div>
+						</div>
+					</section>
+				)}
+
+				{/* Latest Posts */}
+				{gridPostsWithTags.length > 0 && (
+					<section class="posts-section">
+						<header class="section-header">
+							<h2 class="section-title">Latest</h2>
+							{hasMorePosts && (
+								<a href="/posts" class="section-link">
+									View all
+								</a>
+							)}
+						</header>
+						<div class="posts-grid">
+							{gridPostsWithTags.map(({ post, tags, bylines }) => (
+								<PostCard
+									title={post.data.title ?? "Untitled"}
+									excerpt={post.data.excerpt}
+									featuredImage={post.data.featured_image}
+									href={`/posts/${post.id}`}
+									date={post.data.publishedAt ?? undefined}
+									readingTime={getReadingTime(post.data.content)}
+									tags={tags}
+									bylines={bylines}
+								/>
+							))}
+						</div>
+					</section>
+				)}
+			</div>
+		)
+	}
+</Base>
+
+<style>
+	.home-content {
+		max-width: var(--wide-width);
+		margin: 0 auto;
+		padding: var(--spacing-16) var(--spacing-6);
+	}
+
+	/* Featured Section - Side by side */
+	.featured-section {
+		margin-bottom: var(--spacing-16);
+	}
+
+	.featured-grid {
+		display: grid;
+		grid-template-columns: repeat(3, 1fr);
+		gap: var(--spacing-8);
+		align-items: center;
+	}
+
+	.featured-image-link {
+		grid-column: 1 / 3;
+		display: block;
+		/* Extend to viewport edge, but cap at -6rem minimum extension */
+		margin-left: min(
+			-6rem,
+			calc(-1 * (var(--spacing-6) + (100vw - var(--wide-width)) / 2))
+		);
+	}
+
+	.featured-image {
+		overflow: hidden;
+		border-radius: 0 var(--radius-lg) var(--radius-lg) 0;
+		background: var(--color-surface);
+	}
+
+	.featured-image img {
+		width: 100%;
+		height: auto;
+		aspect-ratio: 4 / 3;
+		object-fit: cover;
+		transition: transform 0.4s ease;
+	}
+
+	.featured-image-link:hover .featured-image img,
+	.featured-grid:has(.featured-title-link:hover) .featured-image img {
+		transform: scale(1.02);
+	}
+
+	.featured-content {
+		display: flex;
+		flex-direction: column;
+		gap: var(--spacing-4);
+	}
+
+	.featured-meta {
+		display: flex;
+		align-items: center;
+		flex-wrap: wrap;
+		column-gap: var(--spacing-3);
+		row-gap: var(--spacing-1);
+		font-size: var(--font-size-sm);
+		color: var(--color-muted);
+	}
+
+	.meta-dot {
+		width: 3px;
+		height: 3px;
+		border-radius: 50%;
+		background: var(--color-muted);
+	}
+
+	/* Featured bylines */
+	.featured-bylines {
+		display: flex;
+		align-items: center;
+		gap: 2px;
+	}
+
+	.featured-byline {
+		display: inline-flex;
+		align-items: center;
+		gap: var(--spacing-2);
+	}
+
+	.featured-byline-avatar {
+		width: var(--avatar-size-md);
+		height: var(--avatar-size-md);
+		border-radius: 50%;
+		object-fit: cover;
+	}
+
+	.featured-byline-name {
+		font-weight: 500;
+		color: var(--color-text-secondary);
+	}
+
+	.byline-sep {
+		color: var(--color-muted);
+		margin-right: 2px;
+	}
+
+	.byline-more {
+		font-size: var(--font-size-xs);
+		color: var(--color-muted);
+		margin-left: 2px;
+	}
+
+	.featured-title-link {
+		text-decoration: none;
+		color: inherit;
+	}
+
+	.featured-title {
+		font-size: clamp(var(--font-size-2xl), 4vw, var(--font-size-4xl));
+		font-weight: 700;
+		line-height: var(--leading-tight);
+		letter-spacing: var(--tracking-tight);
+		transition: color var(--transition-fast);
+	}
+
+	.featured-title-link:hover .featured-title,
+	.featured-grid:has(.featured-image-link:hover) .featured-title {
+		color: var(--color-accent);
+	}
+
+	.featured-excerpt {
+		font-size: var(--font-size-lg);
+		line-height: var(--leading-relaxed);
+		color: var(--color-text-secondary);
+	}
+
+	.featured-tags {
+		display: flex;
+		flex-wrap: wrap;
+		gap: var(--spacing-2);
+		margin-top: var(--spacing-2);
+	}
+
+	.featured-tag {
+		display: inline-block;
+		padding: var(--spacing-1) var(--spacing-3);
+		font-size: var(--font-size-sm);
+		color: var(--color-text-secondary);
+		background: var(--color-surface);
+		border-radius: var(--radius);
+		text-decoration: none;
+		transition:
+			color var(--transition-fast),
+			background var(--transition-fast);
+	}
+
+	.featured-tag:hover {
+		color: var(--color-text);
+		background: var(--color-border);
+	}
+
+	/* Section header */
+	.section-header {
+		display: flex;
+		justify-content: space-between;
+		align-items: baseline;
+		margin-bottom: var(--spacing-8);
+		padding-bottom: var(--spacing-4);
+		border-bottom: 1px solid var(--color-border-subtle);
+	}
+
+	.section-title {
+		font-size: var(--font-size-sm);
+		font-weight: 500;
+		text-transform: uppercase;
+		letter-spacing: var(--tracking-wider);
+		color: var(--color-muted);
+	}
+
+	.section-link {
+		font-size: var(--font-size-sm);
+		color: var(--color-accent);
+		text-decoration: none;
+		transition: color var(--transition-fast);
+	}
+
+	.section-link:hover {
+		color: var(--color-accent-hover);
+	}
+
+	/* Posts Grid */
+	.posts-section {
+	}
+
+	.posts-grid {
+		display: grid;
+		grid-template-columns: repeat(3, 1fr);
+		gap: var(--spacing-12) var(--spacing-8);
+	}
+
+	/* Empty State */
+	.empty-state {
+		display: flex;
+		flex-direction: column;
+		align-items: center;
+		gap: var(--spacing-3);
+		text-align: center;
+		padding: var(--spacing-20) var(--spacing-6);
+		max-width: 400px;
+		margin: 0 auto;
+	}
+
+	.empty-state h2 {
+		font-size: var(--font-size-2xl);
+		font-weight: 600;
+	}
+
+	.empty-state p {
+		color: var(--color-muted);
+	}
+
+	.btn {
+		display: inline-block;
+		margin-top: var(--spacing-4);
+		padding: var(--spacing-3) var(--spacing-6);
+		background: var(--color-accent);
+		color: var(--color-on-accent);
+		text-decoration: none;
+		border-radius: var(--radius);
+		font-size: var(--font-size-sm);
+		font-weight: 500;
+		transition: background var(--transition-fast);
+	}
+
+	.btn:hover {
+		background: var(--color-accent-hover);
+	}
+
+	/* Responsive */
+	@media (max-width: 900px) {
+		.home-content {
+			padding: var(--spacing-6) var(--spacing-4) var(--spacing-12);
+		}
+
+		.featured-image-link {
+			margin-left: 0;
+		}
+
+		.featured-grid {
+			grid-template-columns: 1fr;
+			gap: var(--spacing-6);
+		}
+
+		.featured-image {
+			border-radius: var(--radius-lg);
+		}
+
+		.featured-image img {
+			aspect-ratio: 16 / 9;
+		}
+
+		.posts-grid {
+			grid-template-columns: repeat(2, 1fr);
+			gap: var(--spacing-8) var(--spacing-6);
+		}
+	}
+
+	@media (max-width: 600px) {
+		.featured-title {
+			font-size: var(--font-size-2xl);
+		}
+
+		.posts-grid {
+			grid-template-columns: 1fr;
+			gap: var(--spacing-8);
+		}
+	}
+</style>
diff --git a/demos/simple-ai-search/src/pages/pages/[slug].astro b/demos/simple-ai-search/src/pages/pages/[slug].astro
new file mode 100644
index 000000000..2e816258b
--- /dev/null
+++ b/demos/simple-ai-search/src/pages/pages/[slug].astro
@@ -0,0 +1,108 @@
+---
+import { getEmDashEntry, decodeSlug } from "emdash";
+import { PortableText } from "emdash/ui";
+import Base from "../../layouts/Base.astro";
+
+const slug = decodeSlug(Astro.params.slug);
+
+if (!slug) {
+	return Astro.redirect("/404");
+}
+
+const { entry: page, cacheHint } = await getEmDashEntry("pages", slug);
+
+if (!page) {
+	return Astro.redirect("/404");
+}
+
+Astro.cache.set(cacheHint);
+---
+
+<Base
+	title={page.data.title}
+	content={{ collection: "pages", id: page.data.id, slug }}
+>
+	<article class="page-article">
+		<header class="page-header">
+			<h1 class="page-title" {...page.edit.title}>{page.data.title}</h1>
+		</header>
+
+		<div class="page-content">
+			<PortableText value={page.data.content} />
+		</div>
+	</article>
+</Base>
+
+<style>
+	.page-article {
+		max-width: var(--max-width);
+		margin: 0 auto;
+		padding: var(--spacing-16) var(--spacing-6) var(--spacing-16);
+	}
+
+	.page-header {
+		margin-bottom: var(--spacing-8);
+	}
+
+	.page-title {
+		font-size: clamp(var(--font-size-2xl), 4vw, var(--font-size-4xl));
+		font-weight: 700;
+		line-height: var(--leading-tight);
+	}
+
+	.page-content :global(p) {
+		margin-bottom: 1.5em;
+	}
+
+	.page-content :global(h2) {
+		font-size: var(--font-size-2xl);
+		margin-top: 2em;
+		margin-bottom: 0.75em;
+	}
+
+	.page-content :global(h3) {
+		font-size: var(--font-size-xl);
+		margin-top: 1.75em;
+		margin-bottom: 0.5em;
+	}
+
+	.page-content :global(blockquote) {
+		margin: 1.5em 0;
+		padding-left: var(--spacing-6);
+		border-left: 3px solid var(--color-border);
+		color: var(--color-muted);
+	}
+
+	.page-content :global(pre) {
+		margin: 1.5em 0;
+		padding: var(--spacing-4);
+		background: var(--color-surface);
+		border-radius: var(--radius);
+		overflow-x: auto;
+		font-family: var(--font-mono);
+		font-size: var(--font-size-sm);
+	}
+
+	.page-content :global(code) {
+		font-family: var(--font-mono);
+		font-size: 0.9em;
+		background: var(--color-surface);
+		padding: 0.15em 0.3em;
+		border-radius: var(--radius);
+	}
+
+	.page-content :global(pre code) {
+		background: none;
+		padding: 0;
+	}
+
+	.page-content :global(ul),
+	.page-content :global(ol) {
+		margin-bottom: 1.5em;
+		padding-left: var(--spacing-5);
+	}
+
+	.page-content :global(li) {
+		margin-bottom: 0.5em;
+	}
+</style>
diff --git a/demos/simple-ai-search/src/pages/posts/[slug].astro b/demos/simple-ai-search/src/pages/posts/[slug].astro
new file mode 100644
index 000000000..1f3ecd0ad
--- /dev/null
+++ b/demos/simple-ai-search/src/pages/posts/[slug].astro
@@ -0,0 +1,960 @@
+---
+import {
+	getEmDashEntry,
+	getEmDashCollection,
+	getEntryTerms,
+	getSeoMeta,
+	decodeSlug,
+} from "emdash";
+import {
+	Image,
+	PortableText,
+	Comments,
+	CommentForm,
+	WidgetArea,
+} from "emdash/ui";
+import Base from "../../layouts/Base.astro";
+import PostCard from "../../components/PostCard.astro";
+import { getReadingTime } from "../../utils/reading-time";
+
+const slug = decodeSlug(Astro.params.slug);
+
+if (!slug) {
+	return Astro.redirect("/404");
+}
+
+const { entry: post, cacheHint } = await getEmDashEntry("posts", slug);
+
+if (!post) {
+	return Astro.redirect("/404");
+}
+
+Astro.cache.set(cacheHint);
+
+// Get featured image URL for OG fallback
+// The image may have src (external) or meta.storageKey (local)
+function getImageUrl(img: unknown): string | undefined {
+	if (!img || typeof img !== "object") return undefined;
+	const image = img as Record<string, unknown>;
+	// Check for direct src
+	if (typeof image.src === "string" && image.src) {
+		return image.src.startsWith("http")
+			? image.src
+			: `${Astro.url.origin}${image.src}`;
+	}
+	// Build from storageKey for local images
+	const meta = image.meta as Record<string, unknown> | undefined;
+	const storageKey =
+		(typeof meta?.storageKey === "string" ? meta.storageKey : undefined) ||
+		(typeof image.id === "string" ? image.id : undefined);
+	if (storageKey) {
+		return `${Astro.url.origin}/_emdash/api/media/file/${storageKey}`;
+	}
+	return undefined;
+}
+const featuredImageUrl = getImageUrl(post.data.featured_image);
+
+// Generate SEO meta from content
+const seo = getSeoMeta(post, {
+	siteTitle: "My Blog",
+	siteUrl: Astro.url.origin,
+	path: `/posts/${slug}`,
+	defaultOgImage: featuredImageUrl,
+});
+
+// Get tags for this post
+// Note: post.id is the slug, post.data.id is the database ULID
+const tags = await getEntryTerms("posts", post.data.id, "tag");
+
+// Bylines are already hydrated by getEmDashEntry
+const bylines = post.data.bylines ?? [];
+
+// Get reading time
+const readingTime = getReadingTime(post.data.content);
+
+// Get other posts for "More posts" section, with their tags
+// Fetch a few extra in case the current post is among them
+const { entries: recentPosts } = await getEmDashCollection("posts", {
+	orderBy: { published_at: "desc" },
+	limit: 4,
+});
+const otherPosts = recentPosts.filter((p) => p.id !== post.id).slice(0, 3);
+
+// Fetch tags for related posts (bylines are already hydrated by getEmDashCollection)
+const otherPostsWithTags = await Promise.all(
+	otherPosts.map(async (p) => {
+		const postTags = await getEntryTerms("posts", p.data.id, "tag");
+		const postBylines = p.data.bylines ?? [];
+		return { post: p, tags: postTags, bylines: postBylines };
+	})
+);
+
+const publishDate =
+	post.data.publishedAt?.toLocaleDateString("en-US", {
+		year: "numeric",
+		month: "long",
+		day: "numeric",
+	}) ?? null;
+---
+
+<Base
+	title={seo.title}
+	pageTitle={seo.ogTitle}
+	description={seo.description}
+	image={seo.ogImage}
+	canonical={seo.canonical}
+	robots={seo.robots}
+	type="article"
+	publishedTime={post.data.publishedAt?.toISOString() ?? null}
+	modifiedTime={post.data.updatedAt.toISOString()}
+	content={{ collection: "posts", id: post.data.id, slug }}
+>
+	<article class="article">
+		{/* Hero: Full-width featured image */}
+		{
+			post.data.featured_image && (
+				<div class="article-hero" {...post.edit.featured_image}>
+					<Image image={post.data.featured_image} />
+				</div>
+			)
+		}
+
+		{/* Three-column layout */}
+		<div class="article-grid">
+			{/* Left gutter: Meta information */}
+			<aside class="article-meta-col">
+				<div class="meta-sticky">
+					{
+						bylines.length > 0 && (
+							<div class="meta-block byline-block">
+								<span class="meta-label">
+									{bylines.length === 1 ? "Author" : "Authors"}
+								</span>
+								<div class="bylines">
+									{bylines.map((credit) => (
+										<div class="byline">
+											{credit.byline.avatarMediaId && (
+												<img
+													src={`/_emdash/api/media/file/${credit.byline.avatarMediaId}`}
+													alt={credit.byline.displayName}
+													class="byline-avatar"
+												/>
+											)}
+											<div class="byline-info">
+												<span class="byline-name">
+													{credit.byline.displayName}
+												</span>
+												{credit.roleLabel && (
+													<span class="byline-role">{credit.roleLabel}</span>
+												)}
+											</div>
+										</div>
+									))}
+								</div>
+							</div>
+						)
+					}
+					{
+						publishDate && (
+							<div class="meta-block">
+								<span class="meta-label">Published</span>
+								<time class="meta-value">{publishDate}</time>
+							</div>
+						)
+					}
+					<div class="meta-block">
+						<span class="meta-label">Reading time</span>
+						<span class="meta-value">{readingTime} min</span>
+					</div>
+					{
+						tags.length > 0 && (
+							<div class="meta-block">
+								<span class="meta-label">Tags</span>
+								<div class="meta-tags">
+									{tags.map((t) => (
+										<a href={`/tag/${t.slug}`} class="meta-tag">
+											{t.label}
+										</a>
+									))}
+								</div>
+							</div>
+						)
+					}
+				</div>
+			</aside>
+
+			{/* Main content */}
+			<div class="article-main">
+				<header class="article-header">
+					<div class="article-meta">
+						{
+							bylines.length > 0 && (
+								<>
+									<span class="article-meta-byline">
+										{bylines.map((credit, i) => (
+											<>
+												{i > 0 && ", "}
+												{credit.byline.displayName}
+											</>
+										))}
+									</span>
+									<span class="meta-dot" />
+								</>
+							)
+						}
+						{
+							publishDate && (
+								<>
+									<time>{publishDate}</time>
+									<span class="meta-dot" />
+								</>
+							)
+						}
+						<span>{readingTime} min read</span>
+					</div>
+					<h1 class="article-title" {...post.edit.title}>{post.data.title}</h1>
+					{
+						post.data.excerpt && (
+							<p class="article-excerpt" {...post.edit.excerpt}>{post.data.excerpt}</p>
+						)
+					}
+				</header>
+
+				<div class="article-content">
+					<PortableText value={post.data.content} />
+				</div>
+
+				<div class="article-comments">
+					<Comments collection="posts" contentId={post.data.id} threaded />
+					<CommentForm collection="posts" contentId={post.data.id} />
+				</div>
+			</div>
+
+			{/* Right gutter: TOC + Sidebar widgets */}
+			<aside class="article-sidebar">
+				<div class="sidebar-sticky">
+					<nav class="toc" aria-label="Table of contents">
+						<h4 class="toc-title">On this page</h4>
+						<div class="toc-content" id="toc-content">
+							<!-- Populated by JS -->
+						</div>
+					</nav>
+					<div class="sidebar-widgets">
+						<WidgetArea name="sidebar" />
+					</div>
+				</div>
+			</aside>
+		</div>
+	</article>
+
+	{
+		otherPostsWithTags.length > 0 && (
+			<section class="more-posts">
+				<div class="more-inner">
+					<h2 class="more-title">Continue reading</h2>
+					<div class="more-grid">
+						{otherPostsWithTags.map(
+							({ post: p, tags: postTags, bylines: postBylines }) => (
+								<PostCard
+									title={p.data.title}
+									excerpt={p.data.excerpt}
+									featuredImage={p.data.featured_image}
+									href={`/posts/${p.id}`}
+									date={p.data.publishedAt ?? undefined}
+									readingTime={getReadingTime(p.data.content)}
+									tags={postTags.map((t) => ({ slug: t.slug, label: t.label }))}
+									bylines={postBylines}
+								/>
+							)
+						)}
+					</div>
+				</div>
+			</section>
+		)
+	}
+
+	<script>
+		// Build table of contents from h2/h3 headings
+		function buildToc() {
+			const content = document.querySelector(".article-content");
+			const tocContainer = document.getElementById("toc-content");
+			if (!content || !tocContainer) return;
+
+			const headings = content.querySelectorAll("h2, h3");
+			if (headings.length === 0) {
+				// Hide TOC if no headings
+				const toc = document.querySelector(".toc") as HTMLElement | null;
+				if (toc) toc.style.display = "none";
+				return;
+			}
+
+			const list = document.createElement("ul");
+			list.className = "toc-list";
+
+			headings.forEach((heading, index) => {
+				// Add ID if missing
+				if (!heading.id) {
+					heading.id = `heading-${index}`;
+				}
+
+				const li = document.createElement("li");
+				li.className =
+					heading.tagName === "H3" ? "toc-item toc-item--nested" : "toc-item";
+
+				const link = document.createElement("a");
+				link.href = `#${heading.id}`;
+				link.className = "toc-link";
+				link.textContent = heading.textContent;
+
+				li.appendChild(link);
+				list.appendChild(li);
+			});
+
+			tocContainer.appendChild(list);
+
+			// Highlight current section on scroll
+			const observer = new IntersectionObserver(
+				(entries) => {
+					entries.forEach((entry) => {
+						const id = entry.target.id;
+						const link = tocContainer.querySelector(`a[href="#${id}"]`);
+						if (link) {
+							if (entry.isIntersecting) {
+								tocContainer
+									.querySelectorAll(".toc-link")
+									.forEach((l) => l.classList.remove("active"));
+								link.classList.add("active");
+							}
+						}
+					});
+				},
+				{ rootMargin: "-80px 0px -80% 0px" }
+			);
+
+			headings.forEach((heading) => observer.observe(heading));
+		}
+
+		buildToc();
+	</script>
+</Base>
+
+<style>
+	/* Article container */
+	.article {
+		max-width: var(--wide-width);
+		margin: 0 auto;
+	}
+
+	/* Hero image - full width within container */
+	.article-hero {
+		margin: var(--spacing-16) var(--spacing-6);
+		border-radius: var(--radius-lg);
+		overflow: hidden;
+	}
+
+	.article-hero img {
+		width: 100%;
+		height: auto;
+		max-height: 500px;
+		object-fit: cover;
+	}
+
+	/* Three-column grid */
+	.article-grid {
+		display: grid;
+		grid-template-columns:
+			var(--meta-col-width) minmax(0, var(--content-width))
+			var(--gutter-width);
+		gap: var(--spacing-10);
+		justify-content: center;
+		padding: 0 var(--spacing-6);
+		margin: var(--spacing-16) 0;
+	}
+
+	/* Left column: Meta */
+	.article-meta-col {
+		display: block;
+	}
+
+	.meta-sticky {
+		position: sticky;
+		top: calc(var(--nav-height) + var(--spacing-8));
+	}
+
+	.meta-block {
+		margin-bottom: var(--spacing-6);
+	}
+
+	.meta-label {
+		display: block;
+		font-size: var(--font-size-xs);
+		font-weight: 500;
+		text-transform: uppercase;
+		letter-spacing: var(--tracking-wide);
+		color: var(--color-muted);
+		margin-bottom: var(--spacing-1);
+	}
+
+	.meta-value {
+		display: block;
+		font-size: var(--font-size-sm);
+		color: var(--color-text-secondary);
+	}
+
+	.meta-tags {
+		display: flex;
+		flex-wrap: wrap;
+		gap: var(--spacing-1);
+	}
+
+	.meta-tag {
+		display: inline-block;
+		padding: var(--tag-padding-y) var(--spacing-2);
+		font-size: var(--font-size-xs);
+		color: var(--color-text-secondary);
+		background: var(--color-surface);
+		border-radius: var(--radius);
+		text-decoration: none;
+		transition:
+			color var(--transition-fast),
+			background var(--transition-fast);
+	}
+
+	.meta-tag:hover {
+		color: var(--color-text);
+		background: var(--color-border);
+	}
+
+	/* Byline styles */
+	.bylines {
+		display: flex;
+		flex-direction: column;
+		gap: var(--spacing-1);
+	}
+
+	.byline {
+		display: flex;
+		align-items: center;
+		gap: var(--spacing-2);
+	}
+
+	.byline-avatar {
+		width: var(--avatar-size-lg);
+		height: var(--avatar-size-lg);
+		border-radius: 50%;
+		object-fit: cover;
+	}
+
+	.byline-info {
+		display: flex;
+		flex-direction: column;
+	}
+
+	.byline-name {
+		font-size: var(--font-size-sm);
+		font-weight: 500;
+		color: var(--color-text);
+	}
+
+	.byline-role {
+		font-size: var(--font-size-xs);
+		color: var(--color-muted);
+	}
+
+	/* Main content column */
+	.article-main {
+		min-width: 0;
+	}
+
+	.article-header {
+		margin-bottom: var(--spacing-10);
+	}
+
+	.article-header .article-meta {
+		display: none;
+		align-items: center;
+		flex-wrap: wrap;
+		column-gap: var(--spacing-3);
+		row-gap: var(--spacing-1);
+		font-size: var(--font-size-sm);
+		color: var(--color-muted);
+		margin-bottom: var(--spacing-4);
+	}
+
+	.article-meta-byline {
+		font-weight: 500;
+		color: var(--color-text-secondary);
+	}
+
+	.article-title {
+		font-size: clamp(2rem, 5vw, var(--font-size-5xl));
+		font-weight: 700;
+		line-height: var(--leading-tight);
+		letter-spacing: var(--tracking-tight);
+		margin-bottom: var(--spacing-4);
+	}
+
+	.article-excerpt {
+		font-size: var(--font-size-xl);
+		line-height: var(--leading-relaxed);
+		color: var(--color-text-secondary);
+	}
+
+	/* Article content typography */
+	.article-content {
+		font-size: var(--font-size-lg);
+		line-height: var(--leading-relaxed);
+	}
+
+	.article-content :global(p) {
+		margin-bottom: 1.5em;
+	}
+
+	.article-content :global(h2) {
+		font-size: var(--font-size-2xl);
+		margin-top: 2.5em;
+		margin-bottom: 0.75em;
+		scroll-margin-top: calc(var(--nav-height) + var(--spacing-4));
+	}
+
+	.article-content :global(h3) {
+		font-size: var(--font-size-xl);
+		margin-top: 2em;
+		margin-bottom: 0.5em;
+		scroll-margin-top: calc(var(--nav-height) + var(--spacing-4));
+	}
+
+	.article-content :global(blockquote) {
+		margin: 2em 0;
+		padding: var(--spacing-4) var(--spacing-6);
+		border-left: 3px solid var(--color-border);
+		background: var(--color-bg-subtle);
+		border-radius: 0 var(--radius) var(--radius) 0;
+		color: var(--color-text-secondary);
+		font-style: italic;
+	}
+
+	.article-content :global(pre) {
+		margin: 2em 0;
+		padding: var(--spacing-5);
+		background: var(--color-surface);
+		border: 1px solid var(--color-border);
+		border-radius: var(--radius-lg);
+		overflow-x: auto;
+		font-family: var(--font-mono);
+		font-size: var(--font-size-sm);
+		line-height: 1.6;
+	}
+
+	.article-content :global(code) {
+		font-family: var(--font-mono);
+		font-size: 0.9em;
+		background: var(--color-surface);
+		padding: 0.2em 0.4em;
+		border-radius: var(--radius);
+	}
+
+	.article-content :global(pre code) {
+		background: none;
+		padding: 0;
+	}
+
+	.article-content :global(ul),
+	.article-content :global(ol) {
+		margin-bottom: 1.5em;
+		padding-left: 1.5em;
+	}
+
+	.article-content :global(li) {
+		margin-bottom: 0.5em;
+	}
+
+	.article-content :global(img) {
+		margin: 2em 0;
+		border-radius: var(--radius-lg);
+	}
+
+	.article-content :global(hr) {
+		margin: 3em 0;
+		border: none;
+		border-top: 1px solid var(--color-border);
+	}
+
+	.article-content :global(a) {
+		color: var(--color-accent);
+		text-decoration: underline;
+		text-underline-offset: 3px;
+		text-decoration-thickness: 1px;
+	}
+
+	.article-content :global(a:hover) {
+		text-decoration-thickness: 2px;
+	}
+
+	/* Right column: TOC + Sidebar */
+	.article-sidebar {
+		display: block;
+	}
+
+	.sidebar-sticky {
+		position: sticky;
+		top: calc(var(--nav-height) + var(--spacing-8));
+	}
+
+	.toc {
+		margin-bottom: var(--spacing-8);
+		padding-bottom: var(--spacing-6);
+		border-bottom: 1px solid var(--color-border-subtle);
+	}
+
+	.toc-title {
+		font-size: var(--font-size-xs);
+		font-weight: 500;
+		text-transform: uppercase;
+		letter-spacing: var(--tracking-wide);
+		color: var(--color-muted);
+		margin-bottom: var(--spacing-3);
+	}
+
+	.toc-content :global(.toc-list) {
+		list-style: none;
+		padding: 0;
+		margin: 0;
+	}
+
+	.toc-content :global(.toc-item) {
+		margin-bottom: var(--spacing-1);
+	}
+
+	.toc-content :global(.toc-item--nested) {
+		padding-left: var(--spacing-3);
+	}
+
+	.toc-content :global(.toc-link) {
+		display: block;
+		font-size: var(--font-size-sm);
+		color: var(--color-muted);
+		text-decoration: none;
+		padding: var(--spacing-1) 0;
+		transition: color var(--transition-fast);
+		line-height: var(--leading-snug);
+	}
+
+	.toc-content :global(.toc-link:hover),
+	.toc-content :global(.toc-link.active) {
+		color: var(--color-text);
+	}
+
+	/* Sidebar widgets */
+	.sidebar-widgets :global(.widget-area) {
+		display: flex;
+		flex-direction: column;
+		gap: var(--spacing-6);
+	}
+
+	.sidebar-widgets :global(.widget) {
+		font-size: var(--font-size-sm);
+	}
+
+	.sidebar-widgets :global(.widget__title) {
+		font-size: var(--font-size-xs);
+		font-weight: 500;
+		text-transform: uppercase;
+		letter-spacing: var(--tracking-wide);
+		color: var(--color-muted);
+		margin-bottom: var(--spacing-3);
+	}
+
+	.sidebar-widgets :global(.widget__content) {
+		color: var(--color-text-secondary);
+		line-height: var(--leading-relaxed);
+	}
+
+	/* Sidebar search widget */
+	.sidebar-widgets :global(.widget-search) {
+		display: flex;
+		flex-direction: column;
+		gap: var(--spacing-2);
+	}
+
+	.sidebar-widgets :global(.widget-search__input) {
+		width: 100%;
+		padding: var(--spacing-2) var(--spacing-3);
+		font-family: var(--font-sans);
+		font-size: var(--font-size-sm);
+		border: 1px solid var(--color-border);
+		border-radius: var(--radius);
+		background: var(--color-bg);
+		color: var(--color-text);
+		transition:
+			border-color var(--transition-fast),
+			box-shadow var(--transition-fast);
+	}
+
+	.sidebar-widgets :global(.widget-search__input)::placeholder {
+		color: var(--color-muted);
+	}
+
+	.sidebar-widgets :global(.widget-search__input):focus,
+	.sidebar-widgets :global(.widget-search__input):focus-visible {
+		outline: none;
+		border-color: var(--color-accent);
+		box-shadow: 0 0 0 3px var(--color-accent-ring);
+	}
+
+	.sidebar-widgets :global(.widget-search__button) {
+		display: none;
+	}
+
+	/* Sidebar categories widget */
+	.sidebar-widgets :global(.widget-categories) {
+		list-style: none;
+		padding: 0;
+		margin: 0;
+	}
+
+	.sidebar-widgets :global(.widget-categories li) {
+		display: flex;
+		justify-content: space-between;
+		align-items: center;
+		padding: var(--spacing-2) 0;
+		border-bottom: 1px solid var(--color-border-subtle);
+	}
+
+	.sidebar-widgets :global(.widget-categories li:last-child) {
+		border-bottom: none;
+	}
+
+	.sidebar-widgets :global(.widget-categories__link) {
+		color: var(--color-text-secondary);
+		text-decoration: none;
+		transition: color var(--transition-fast);
+	}
+
+	.sidebar-widgets :global(.widget-categories__link:hover) {
+		color: var(--color-text);
+	}
+
+	.sidebar-widgets :global(.widget-categories__count) {
+		font-size: var(--font-size-xs);
+		color: var(--color-muted);
+		background: var(--color-surface);
+		padding: var(--tag-padding-y) var(--spacing-2);
+		border-radius: var(--radius);
+	}
+
+	/* Sidebar tags widget - pill style */
+	.sidebar-widgets :global(.widget-tags__cloud) {
+		list-style: none;
+		padding: 0;
+		margin: 0;
+		display: flex;
+		flex-wrap: wrap;
+		gap: var(--spacing-2);
+	}
+
+	.sidebar-widgets :global(.widget-tags__cloud li) {
+		margin: 0;
+	}
+
+	.sidebar-widgets :global(.widget-tags__link) {
+		display: inline-block;
+		padding: var(--spacing-1) var(--spacing-3);
+		font-size: var(--font-size-sm);
+		color: var(--color-text-secondary);
+		background: var(--color-surface);
+		border-radius: var(--radius);
+		text-decoration: none;
+		transition:
+			color var(--transition-fast),
+			background var(--transition-fast);
+	}
+
+	.sidebar-widgets :global(.widget-tags__link:hover) {
+		color: var(--color-text);
+		background: var(--color-border);
+	}
+
+	.sidebar-widgets :global(.widget-tags__count) {
+		display: none;
+	}
+
+	/* Sidebar recent posts widget */
+	.sidebar-widgets :global(.widget-recent-posts) {
+		list-style: none;
+		padding: 0;
+		margin: 0;
+	}
+
+	.sidebar-widgets :global(.widget-recent-posts li) {
+		padding: var(--spacing-2) 0;
+		border-bottom: 1px solid var(--color-border-subtle);
+	}
+
+	.sidebar-widgets :global(.widget-recent-posts li:last-child) {
+		border-bottom: none;
+	}
+
+	.sidebar-widgets :global(.widget-recent-posts a) {
+		color: var(--color-text-secondary);
+		text-decoration: none;
+		transition: color var(--transition-fast);
+		line-height: var(--leading-snug);
+	}
+
+	.sidebar-widgets :global(.widget-recent-posts a:hover) {
+		color: var(--color-text);
+	}
+
+	/* Sidebar archives widget */
+	.sidebar-widgets :global(.widget-archives) {
+		list-style: none;
+		padding: 0;
+		margin: 0;
+	}
+
+	.sidebar-widgets :global(.widget-archives li) {
+		display: flex;
+		justify-content: space-between;
+		align-items: center;
+		padding: var(--spacing-2) 0;
+		border-bottom: 1px solid var(--color-border-subtle);
+	}
+
+	.sidebar-widgets :global(.widget-archives li:last-child) {
+		border-bottom: none;
+	}
+
+	.sidebar-widgets :global(.widget-archives__link) {
+		color: var(--color-text-secondary);
+		text-decoration: none;
+		transition: color var(--transition-fast);
+	}
+
+	.sidebar-widgets :global(.widget-archives__link:hover) {
+		color: var(--color-text);
+	}
+
+	.sidebar-widgets :global(.widget-archives__count) {
+		font-size: var(--font-size-xs);
+		color: var(--color-muted);
+		background: var(--color-surface);
+		padding: var(--tag-padding-y) var(--spacing-2);
+		border-radius: var(--radius);
+	}
+
+	/* Comments section */
+	.article-comments {
+		margin-top: var(--spacing-16);
+		padding-top: var(--spacing-10);
+		border-top: 1px solid var(--color-border);
+	}
+
+	.article-comments :global(.ec-comments) {
+		--ec-comment-border: 1px solid var(--color-border);
+	}
+
+	.article-comments :global(.ec-comments-heading) {
+		font-size: var(--font-size-2xl);
+		font-weight: 600;
+		margin-bottom: var(--spacing-8);
+	}
+
+	.article-comments :global(.ec-comment-author) {
+		color: var(--color-text);
+	}
+
+	.article-comments :global(.ec-comment-date) {
+		font-family: var(--font-mono);
+		color: var(--color-muted);
+	}
+
+	.article-comments :global(.ec-comment-body) {
+		color: var(--color-text);
+	}
+
+	.article-comments :global(.ec-comment-form-field input),
+	.article-comments :global(.ec-comment-form-field textarea) {
+		background: var(--color-surface) !important;
+		border-color: var(--color-border) !important;
+		color: var(--color-text) !important;
+	}
+
+	.article-comments :global(.ec-comment-user-info) {
+		background: var(--color-surface) !important;
+		border-color: var(--color-border) !important;
+	}
+
+	.article-comments :global(.ec-comment-form-submit) {
+		background: var(--color-accent) !important;
+		color: var(--color-on-accent) !important;
+	}
+
+	/* More posts section */
+	.more-posts {
+		background: var(--color-bg-subtle);
+		padding: var(--spacing-16) 0;
+		margin-top: var(--spacing-16);
+	}
+
+	.more-inner {
+		max-width: var(--wide-width);
+		margin: 0 auto;
+		padding: 0 var(--spacing-6);
+	}
+
+	.more-title {
+		font-size: var(--font-size-2xl);
+		font-weight: 600;
+		margin-bottom: var(--spacing-10);
+	}
+
+	.more-grid {
+		display: grid;
+		grid-template-columns: repeat(3, 1fr);
+		grid-template-rows: repeat(5, auto);
+		gap: var(--spacing-8);
+	}
+
+	/* Responsive */
+	@media (max-width: 1100px) {
+		.article-grid {
+			grid-template-columns: minmax(0, var(--content-width));
+			gap: 0;
+		}
+
+		.article-meta-col,
+		.article-sidebar {
+			display: none;
+		}
+
+		.article-header .article-meta {
+			display: flex;
+		}
+	}
+
+	@media (max-width: 900px) {
+		.article-hero {
+			margin: var(--spacing-4) var(--spacing-4) var(--spacing-8);
+			border-radius: var(--radius);
+		}
+
+		.article-grid {
+			padding: 0 var(--spacing-4);
+		}
+
+		.more-grid {
+			grid-template-columns: repeat(2, 1fr);
+		}
+	}
+
+	@media (max-width: 600px) {
+		.article-title {
+			font-size: var(--font-size-3xl);
+		}
+
+		.more-grid {
+			grid-template-columns: 1fr;
+		}
+	}
+</style>
diff --git a/demos/simple-ai-search/src/pages/posts/index.astro b/demos/simple-ai-search/src/pages/posts/index.astro
new file mode 100644
index 000000000..26355921f
--- /dev/null
+++ b/demos/simple-ai-search/src/pages/posts/index.astro
@@ -0,0 +1,268 @@
+---
+import { getEmDashCollection, getEntryTerms } from "emdash";
+import Base from "../../layouts/Base.astro";
+import { getReadingTime } from "../../utils/reading-time";
+
+const { entries: posts, cacheHint } = await getEmDashCollection("posts");
+
+Astro.cache.set(cacheHint);
+
+const sortedPosts = posts.toSorted((a, b) => {
+	const dateA = a.data.publishedAt?.getTime() ?? 0;
+	const dateB = b.data.publishedAt?.getTime() ?? 0;
+	return dateB - dateA;
+});
+
+// Fetch tags for each post (bylines are already hydrated by getEmDashCollection)
+const postsWithTags = await Promise.all(
+	sortedPosts.map(async (post) => {
+		const tags = await getEntryTerms("posts", post.data.id, "tag");
+		const bylines = post.data.bylines ?? [];
+		return { post, tags, bylines };
+	})
+);
+
+const formatDate = (date: Date) =>
+	date.toLocaleDateString("en-US", {
+		year: "numeric",
+		month: "long",
+		day: "numeric",
+	});
+---
+
+<Base title="All Posts" description="Browse all blog posts">
+	<div class="posts-page">
+		<header class="page-header">
+			<h1 class="page-title">All Posts</h1>
+			<p class="page-description">
+				{posts.length}
+				{posts.length === 1 ? "article" : "articles"}
+			</p>
+		</header>
+
+		{
+			sortedPosts.length === 0 ? (
+				<p class="empty">No posts yet.</p>
+			) : (
+				<div class="posts-list">
+					{postsWithTags.map(({ post, tags, bylines }) => (
+						<article class="post-item">
+							<a href={`/posts/${post.id}`} class="post-link">
+								<div class="post-meta">
+									{bylines.length > 0 && (
+										<>
+											<div class="post-bylines">
+												{bylines.slice(0, 2).map((credit, index) => (
+													<>
+														{index > 0 && <span class="byline-sep">,</span>}
+														<span class="post-byline">
+															{credit.byline.avatarMediaId && (
+																<img
+																	src={`/_emdash/api/media/file/${credit.byline.avatarMediaId}`}
+																	alt={credit.byline.displayName}
+																	class="post-byline-avatar"
+																/>
+															)}
+															<span class="post-byline-name">
+																{credit.byline.displayName}
+															</span>
+														</span>
+													</>
+												))}
+												{bylines.length > 2 && (
+													<span class="byline-more">+{bylines.length - 2}</span>
+												)}
+											</div>
+											<span class="meta-dot" />
+										</>
+									)}
+									{post.data.publishedAt && (
+										<time>{formatDate(post.data.publishedAt)}</time>
+									)}
+									{post.data.publishedAt && <span class="meta-dot" />}
+									<span>{getReadingTime(post.data.content)} min read</span>
+								</div>
+								<h2 class="post-title">{post.data.title}</h2>
+								{post.data.excerpt && (
+									<p class="post-excerpt">{post.data.excerpt}</p>
+								)}
+							</a>
+							{tags.length > 0 && (
+								<div class="post-tags">
+									{tags.slice(0, 3).map((t) => (
+										<a href={`/tag/${t.slug}`} class="post-tag">
+											{t.label}
+										</a>
+									))}
+								</div>
+							)}
+						</article>
+					))}
+				</div>
+			)
+		}
+	</div>
+</Base>
+
+<style>
+	.posts-page {
+		max-width: var(--content-width);
+		margin: 0 auto;
+		padding: var(--spacing-8) var(--spacing-6) var(--spacing-16);
+	}
+
+	.page-header {
+		margin-bottom: var(--spacing-12);
+	}
+
+	.page-title {
+		font-size: var(--font-size-4xl);
+		font-weight: 700;
+		letter-spacing: var(--tracking-tight);
+		margin-bottom: var(--spacing-2);
+	}
+
+	.page-description {
+		font-size: var(--font-size-lg);
+		color: var(--color-muted);
+	}
+
+	.empty {
+		color: var(--color-muted);
+		font-size: var(--font-size-lg);
+	}
+
+	.posts-list {
+		display: flex;
+		flex-direction: column;
+	}
+
+	.post-item {
+		padding: var(--spacing-8) 0;
+		border-bottom: 1px solid var(--color-border-subtle);
+	}
+
+	.post-item:first-child {
+		padding-top: 0;
+	}
+
+	.post-item:last-child {
+		border-bottom: none;
+	}
+
+	.post-link {
+		display: block;
+		text-decoration: none;
+		color: inherit;
+	}
+
+	.post-meta {
+		display: flex;
+		align-items: center;
+		gap: var(--spacing-3);
+		font-size: var(--font-size-sm);
+		color: var(--color-muted);
+		margin-bottom: var(--spacing-2);
+	}
+
+	.meta-dot {
+		width: 3px;
+		height: 3px;
+		border-radius: 50%;
+		background: var(--color-muted);
+	}
+
+	/* Post bylines */
+	.post-bylines {
+		display: flex;
+		align-items: center;
+		gap: 2px;
+	}
+
+	.post-byline {
+		display: inline-flex;
+		align-items: center;
+		gap: var(--spacing-1);
+	}
+
+	.post-byline-avatar {
+		width: var(--avatar-size-sm);
+		height: var(--avatar-size-sm);
+		border-radius: 50%;
+		object-fit: cover;
+	}
+
+	.post-byline-name {
+		font-weight: 500;
+		color: var(--color-text-secondary);
+	}
+
+	.byline-sep {
+		color: var(--color-muted);
+		margin-right: 2px;
+	}
+
+	.byline-more {
+		font-size: var(--font-size-xs);
+		color: var(--color-muted);
+		margin-left: 2px;
+	}
+
+	.post-title {
+		font-size: var(--font-size-2xl);
+		font-weight: 600;
+		line-height: var(--leading-snug);
+		letter-spacing: var(--tracking-snug);
+		margin-bottom: var(--spacing-2);
+		transition: color var(--transition-fast);
+	}
+
+	.post-link:hover .post-title {
+		color: var(--color-accent);
+	}
+
+	.post-excerpt {
+		font-size: var(--font-size-lg);
+		line-height: var(--leading-relaxed);
+		color: var(--color-text-secondary);
+	}
+
+	.post-tags {
+		display: flex;
+		flex-wrap: wrap;
+		gap: var(--spacing-2);
+		margin-top: var(--spacing-4);
+	}
+
+	.post-tag {
+		display: inline-block;
+		padding: var(--tag-padding-y) var(--spacing-3);
+		font-size: var(--font-size-sm);
+		color: var(--color-text-secondary);
+		background: var(--color-surface);
+		border-radius: var(--radius);
+		text-decoration: none;
+		transition:
+			color var(--transition-fast),
+			background var(--transition-fast);
+	}
+
+	.post-tag:hover {
+		color: var(--color-text);
+		background: var(--color-border);
+	}
+
+	@media (max-width: 600px) {
+		.posts-page {
+			padding: var(--spacing-6) var(--spacing-4) var(--spacing-12);
+		}
+
+		.page-title {
+			font-size: var(--font-size-3xl);
+		}
+
+		.post-title {
+			font-size: var(--font-size-xl);
+		}
+	}
+</style>
diff --git a/demos/simple-ai-search/src/pages/rss.xml.ts b/demos/simple-ai-search/src/pages/rss.xml.ts
new file mode 100644
index 000000000..a944a747b
--- /dev/null
+++ b/demos/simple-ai-search/src/pages/rss.xml.ts
@@ -0,0 +1,70 @@
+import type { APIRoute } from "astro";
+import { getEmDashCollection } from "emdash";
+
+const siteTitle = "My Blog";
+const siteDescription = "A blog about software, design, and the occasional stray thought.";
+
+export const GET: APIRoute = async ({ site, url }) => {
+	const siteUrl = site?.toString() || url.origin;
+
+	const { entries: posts } = await getEmDashCollection("posts", {
+		orderBy: { published_at: "desc" },
+		limit: 20,
+	});
+
+	const items = posts
+		.map((post) => {
+			if (!post.data.publishedAt) return null;
+			const pubDate = post.data.publishedAt.toUTCString();
+
+			const postUrl = `${siteUrl}/posts/${post.id}`;
+			const title = escapeXml(post.data.title || "Untitled");
+			const description = escapeXml(post.data.excerpt || "");
+
+			return `    <item>
+      <title>${title}</title>
+      <link>${postUrl}</link>
+      <guid isPermaLink="true">${postUrl}</guid>
+      <pubDate>${pubDate}</pubDate>
+      <description>${description}</description>
+    </item>`;
+		})
+		.filter(Boolean)
+		.join("\n");
+
+	const rss = `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>${escapeXml(siteTitle)}</title>
+    <description>${escapeXml(siteDescription)}</description>
+    <link>${siteUrl}</link>
+    <atom:link href="${siteUrl}/rss.xml" rel="self" type="application/rss+xml"/>
+    <language>en-us</language>
+    <lastBuildDate>${new Date().toUTCString()}</lastBuildDate>
+${items}
+  </channel>
+</rss>`;
+
+	return new Response(rss, {
+		headers: {
+			"Content-Type": "application/rss+xml; charset=utf-8",
+			"Cache-Control": "public, max-age=3600",
+		},
+	});
+};
+
+const XML_ESCAPE_PATTERNS = [
+	[/&/g, "&amp;"],
+	[/</g, "&lt;"],
+	[/>/g, "&gt;"],
+	[/"/g, "&quot;"],
+	[/'/g, "&apos;"],
+] as const;
+
+function escapeXml(str: string): string {
+	let result = str;
+	for (const [pattern, replacement] of XML_ESCAPE_PATTERNS) {
+		result = result.replace(pattern, replacement);
+	}
+	return result;
+}
diff --git a/demos/simple-ai-search/src/pages/search.astro b/demos/simple-ai-search/src/pages/search.astro
new file mode 100644
index 000000000..d82ded991
--- /dev/null
+++ b/demos/simple-ai-search/src/pages/search.astro
@@ -0,0 +1,194 @@
+---
+export const prerender = false;
+
+import Base from "../layouts/Base.astro";
+
+const query = Astro.url.searchParams.get("q")?.trim() || "";
+
+interface AISearchResult {
+	collection: string;
+	id: string;
+	slug: string | null;
+	title: string | null;
+	score: number;
+	snippet: string;
+}
+
+let results: AISearchResult[] = [];
+let searchError: string | null = null;
+
+if (query) {
+	try {
+		const params = new URLSearchParams({ q: query, limit: "20" });
+		const apiUrl = new URL(`/_emdash/api/plugins/ai-search-api/query?${params}`, Astro.url);
+		const response = await fetch(apiUrl, {
+			headers: { Cookie: Astro.request.headers.get("Cookie") || "" },
+		});
+		if (response.ok) {
+			const data = (await response.json()) as { results: AISearchResult[]; error?: string };
+			results = data.results ?? [];
+			if (data.error) searchError = data.error;
+		}
+	} catch {
+		searchError = "Search is temporarily unavailable.";
+	}
+}
+---
+
+<Base
+	title={query ? `Search: ${query}` : "Search"}
+	description="Search blog posts"
+>
+	<section class="search-page">
+		<h1 class="search-title">Search</h1>
+
+		<form method="get" action="/search" class="search-form">
+			<input
+				type="search"
+				name="q"
+				value={query}
+				placeholder="Search posts..."
+				class="search-input"
+				autofocus
+			/>
+			<button type="submit" class="search-button">Search</button>
+		</form>
+
+		{
+			searchError && (
+				<p class="search-error">{searchError}</p>
+			)
+		}
+
+		{
+			query && !searchError && (
+				<p class="search-summary">
+					{results.length === 0
+						? `No results for "${query}"`
+						: `${results.length} result${results.length === 1 ? "" : "s"} for "${query}"`}
+				</p>
+			)
+		}
+
+		{
+			results.length > 0 && (
+				<div class="search-results">
+					{results.map((result) => (
+						<a href={`/${result.collection}/${result.slug ?? result.id}`} class="search-result-card">
+							<h3 class="search-result-title">{result.title ?? result.slug ?? result.id}</h3>
+							<span class="search-result-collection">{result.collection}</span>
+							{result.snippet && (
+								<p class="search-result-snippet">{result.snippet}</p>
+							)}
+						</a>
+					))}
+				</div>
+			)
+		}
+
+		{!query && <p class="search-hint">Enter a search term to find posts.</p>}
+	</section>
+</Base>
+
+<style>
+	.search-page {
+		max-width: var(--max-width);
+		margin: 0 auto;
+		padding: var(--spacing-8) var(--spacing-6) var(--spacing-16);
+	}
+
+	.search-title {
+		font-size: var(--font-size-2xl);
+		margin-bottom: var(--spacing-6);
+	}
+
+	.search-form {
+		display: flex;
+		gap: var(--spacing-2);
+		margin-bottom: var(--spacing-8);
+	}
+
+	.search-input {
+		flex: 1;
+		padding: var(--spacing-2) var(--spacing-4);
+		font-size: var(--font-size-base);
+		border: 1px solid var(--color-border);
+		border-radius: var(--radius);
+		background: var(--color-bg);
+		color: var(--color-text);
+	}
+
+	.search-input:focus {
+		outline: none;
+		border-color: var(--color-accent);
+	}
+
+	.search-button {
+		padding: var(--spacing-2) var(--spacing-6);
+		font-size: var(--font-size-base);
+		background: var(--color-accent);
+		color: var(--color-on-accent);
+		border: none;
+		border-radius: var(--radius);
+		cursor: pointer;
+		font-weight: 500;
+	}
+
+	.search-button:hover {
+		opacity: 0.9;
+	}
+
+	.search-summary {
+		color: var(--color-muted);
+		margin-bottom: var(--spacing-6);
+	}
+
+	.search-error {
+		color: #c33;
+		margin-bottom: var(--spacing-6);
+	}
+
+	.search-hint {
+		color: var(--color-muted);
+	}
+
+	.search-results {
+		display: flex;
+		flex-direction: column;
+		gap: var(--spacing-4);
+	}
+
+	.search-result-card {
+		display: block;
+		padding: var(--spacing-4) var(--spacing-5);
+		border: 1px solid var(--color-border);
+		border-radius: var(--radius-lg);
+		text-decoration: none;
+		color: var(--color-text);
+		transition: border-color var(--transition-fast);
+	}
+
+	.search-result-card:hover {
+		border-color: var(--color-accent);
+	}
+
+	.search-result-title {
+		font-size: var(--font-size-lg);
+		font-weight: 500;
+		margin-bottom: var(--spacing-1);
+	}
+
+	.search-result-collection {
+		font-size: var(--font-size-xs);
+		color: var(--color-muted);
+		text-transform: uppercase;
+		letter-spacing: 0.06em;
+	}
+
+	.search-result-snippet {
+		font-size: var(--font-size-sm);
+		color: var(--color-text-secondary);
+		margin-top: var(--spacing-2);
+		line-height: var(--leading-normal);
+	}
+</style>
diff --git a/demos/simple-ai-search/src/pages/tag/[slug].astro b/demos/simple-ai-search/src/pages/tag/[slug].astro
new file mode 100644
index 000000000..34f3cc75d
--- /dev/null
+++ b/demos/simple-ai-search/src/pages/tag/[slug].astro
@@ -0,0 +1,120 @@
+---
+import { getTerm, getEmDashCollection, getEntryTerms, decodeSlug } from "emdash";
+import Base from "../../layouts/Base.astro";
+import PostCard from "../../components/PostCard.astro";
+import { getReadingTime } from "../../utils/reading-time";
+
+const slug = decodeSlug(Astro.params.slug);
+const term = slug ? await getTerm("tag", slug) : null;
+
+if (!term) {
+	return Astro.redirect("/404");
+}
+
+const { entries: posts } = await getEmDashCollection("posts", {
+	where: { tag: term.slug },
+	orderBy: { published_at: "desc" },
+});
+
+// Fetch tags for display on each post card
+const filteredPosts = await Promise.all(
+	posts.map(async (post) => {
+		const tags = await getEntryTerms("posts", post.data.id, "tag");
+		return { post, tags };
+	})
+);
+---
+
+<Base
+	title={`Posts tagged "${term.label}"`}
+	description={`All posts tagged with ${term.label}`}
+>
+	<section class="archive-section">
+		<header class="archive-header">
+			<span class="archive-label">Tag</span>
+			<h1 class="archive-title">{term.label}</h1>
+			<p class="archive-count">
+				{filteredPosts.length}
+				{filteredPosts.length === 1 ? "post" : "posts"}
+			</p>
+		</header>
+
+		{
+			filteredPosts.length === 0 ? (
+				<p class="no-posts">No posts with this tag yet.</p>
+			) : (
+				<div class="posts-grid">
+					{filteredPosts.map(({ post, tags }) => (
+						<PostCard
+							title={post.data.title}
+							excerpt={post.data.excerpt}
+							featuredImage={post.data.featured_image}
+							href={`/posts/${post.id}`}
+							date={post.data.publishedAt ?? undefined}
+							readingTime={getReadingTime(post.data.content)}
+							tags={tags.map((t) => ({ slug: t.slug, label: t.label }))}
+						/>
+					))}
+				</div>
+			)
+		}
+	</section>
+</Base>
+
+<style>
+	.archive-section {
+		max-width: var(--wide-width);
+		margin: 0 auto;
+		padding: var(--spacing-12) var(--spacing-6);
+	}
+
+	.archive-header {
+		margin-bottom: var(--spacing-12);
+		padding-bottom: var(--spacing-8);
+		border-bottom: 1px solid var(--color-border-subtle);
+	}
+
+	.archive-label {
+		display: block;
+		font-size: var(--font-size-xs);
+		font-weight: 500;
+		color: var(--color-accent);
+		text-transform: uppercase;
+		letter-spacing: var(--tracking-wider);
+		margin-bottom: var(--spacing-2);
+	}
+
+	.archive-title {
+		font-size: var(--font-size-4xl);
+		font-weight: 700;
+		letter-spacing: var(--tracking-tight);
+		margin-bottom: var(--spacing-2);
+	}
+
+	.archive-count {
+		font-size: var(--font-size-sm);
+		color: var(--color-muted);
+	}
+
+	.posts-grid {
+		display: grid;
+		grid-template-columns: repeat(3, 1fr);
+		gap: var(--spacing-12) var(--spacing-8);
+	}
+
+	.no-posts {
+		color: var(--color-muted);
+	}
+
+	@media (max-width: 900px) {
+		.posts-grid {
+			grid-template-columns: repeat(2, 1fr);
+		}
+	}
+
+	@media (max-width: 600px) {
+		.posts-grid {
+			grid-template-columns: 1fr;
+		}
+	}
+</style>
diff --git a/demos/simple-ai-search/src/styles/theme.css b/demos/simple-ai-search/src/styles/theme.css
new file mode 100644
index 000000000..9bc2861fb
--- /dev/null
+++ b/demos/simple-ai-search/src/styles/theme.css
@@ -0,0 +1,105 @@
+/*
+  theme.css — override any :root variable here to retheme the blog.
+
+  This is the only file you need to edit to customize the site's visual
+  appearance. All defaults are listed below as comments. Uncomment and
+  change any value to override it.
+
+  Note: this template defines explicit dark mode colors in Base.astro.
+  Overriding light-mode --color-* variables here won't affect dark mode.
+  To customize dark mode, also override --color-* variables inside a
+  @media (prefers-color-scheme: dark) block and/or in the :root.dark rule.
+*/
+
+:root {
+	/* --- Colors ---
+	--color-bg: #ffffff;
+	--color-bg-subtle: #fafafa;
+	--color-text: #1a1a1a;
+	--color-text-secondary: #525252;
+	--color-muted: #8b8b8b;
+	--color-border: #e5e5e5;
+	--color-border-subtle: #f0f0f0;
+	--color-surface: #f7f7f7;
+	--color-accent: #0066cc;
+	--color-accent-hover: #0052a3;
+	--color-on-accent: white;
+	--color-accent-ring: color-mix(in srgb, var(--color-accent) 25%, transparent);
+	*/
+
+	/* --- Type scale ---
+	--font-size-xs: 0.8125rem;
+	--font-size-sm: 0.875rem;
+	--font-size-base: 1rem;
+	--font-size-lg: 1.125rem;
+	--font-size-xl: 1.25rem;
+	--font-size-2xl: 1.5rem;
+	--font-size-3xl: 2rem;
+	--font-size-4xl: 2.5rem;
+	--font-size-5xl: 3.5rem;
+	*/
+
+	/* --- Line heights ---
+	--leading-tight: 1.15;
+	--leading-snug: 1.3;
+	--leading-normal: 1.5;
+	--leading-relaxed: 1.7;
+	*/
+
+	/* --- Letter spacing ---
+	--tracking-tight: -0.03em;    used on h1 and large titles
+	--tracking-snug: -0.02em;     used on h2–h6, site/card titles
+	--tracking-wide: 0.06em;      used on meta labels, TOC/widget titles
+	--tracking-wider: 0.08em;     used on footer headings, section labels
+	*/
+
+	/* --- Spacing ---
+	--spacing-1: 0.25rem;
+	--spacing-2: 0.5rem;
+	--spacing-3: 0.75rem;
+	--spacing-4: 1rem;
+	--spacing-5: 1.25rem;
+	--spacing-6: 1.5rem;
+	--spacing-8: 2rem;
+	--spacing-10: 2.5rem;
+	--spacing-12: 3rem;
+	--spacing-16: 4rem;
+	--spacing-20: 5rem;
+	--spacing-24: 6rem;
+	*/
+
+	/* --- Layout ---
+	--content-width: 680px;       article/page body column width
+	--wide-width: 1200px;         max container width (home, archives)
+	--gutter-width: 200px;        right sidebar column (TOC) on article pages
+	--meta-col-width: 180px;      left meta column on article pages
+	--nav-height: 64px;           sticky header height
+	--search-input-width: 180px;  nav search box width
+	*/
+
+	/* --- Borders & radius ---
+	--radius: 4px;
+	--radius-lg: 8px;
+	*/
+
+	/* --- Transitions ---
+	--transition-fast: 120ms ease;
+	--transition-base: 180ms ease;
+	*/
+
+	/* --- Avatars ---
+	--avatar-size-xs: 18px;    card byline avatars
+	--avatar-size-sm: 20px;    post list byline avatars
+	--avatar-size-md: 24px;    featured post byline avatars
+	--avatar-size-lg: 32px;    single post byline avatars
+	*/
+
+	/* --- Shadows ---
+	--shadow-dropdown: 0 8px 30px rgba(0, 0, 0, 0.12);
+	--shadow-btn-active: 0 1px 2px rgba(0, 0, 0, 0.05);
+	*/
+
+	/* --- Misc ---
+	--tag-padding-y: 2px;    vertical padding on tag pills
+	*/
+}
diff --git a/demos/simple-ai-search/src/utils/reading-time.ts b/demos/simple-ai-search/src/utils/reading-time.ts
new file mode 100644
index 000000000..c17794e15
--- /dev/null
+++ b/demos/simple-ai-search/src/utils/reading-time.ts
@@ -0,0 +1,66 @@
+import type { PortableTextBlock } from "emdash";
+
+const WORDS_PER_MINUTE = 200;
+const CJK_CHARACTERS_PER_MINUTE = 500;
+const WHITESPACE_REGEX = /\s+/;
+const CJK_CHARACTER_REGEX =
+	/\p{Script=Han}|\p{Script=Hangul}|\p{Script=Hiragana}|\p{Script=Katakana}/gu;
+
+type PortableTextSpan = {
+	_type: string;
+	text?: string;
+};
+
+type PortableTextTextBlock = PortableTextBlock & {
+	_type: "block";
+	children: PortableTextSpan[];
+};
+
+function isTextBlock(block: PortableTextBlock): block is PortableTextTextBlock {
+	return block._type === "block" && Array.isArray(block.children);
+}
+
+function countWords(text: string): number {
+	return text.split(WHITESPACE_REGEX).filter(Boolean).length;
+}
+
+function countCjkCharacters(text: string): number {
+	return text.match(CJK_CHARACTER_REGEX)?.length ?? 0;
+}
+
+/**
+ * Extract plain text from Portable Text blocks
+ */
+export function extractText(blocks: PortableTextBlock[] | undefined): string {
+	if (!blocks || !Array.isArray(blocks)) return "";
+
+	return blocks
+		.filter(isTextBlock)
+		.map((block) =>
+			block.children
+				.filter((child) => child._type === "span" && typeof child.text === "string")
+				.map((span) => span.text)
+				.join(""),
+		)
+		.join(" ");
+}
+
+/**
+ * Calculate reading time in minutes from Portable Text content
+ */
+export function getReadingTime(content: PortableTextBlock[] | undefined): number {
+	const text = extractText(content);
+	const cjkCharacterCount = countCjkCharacters(text);
+	const wordCount = countWords(text.replace(CJK_CHARACTER_REGEX, " "));
+	const minutes = Math.ceil(
+		wordCount / WORDS_PER_MINUTE + cjkCharacterCount / CJK_CHARACTERS_PER_MINUTE,
+	);
+	return Math.max(1, minutes);
+}
+
+/**
+ * Format reading time for display
+ */
+export function formatReadingTime(minutes: number): string {
+	return `${minutes} min read`;
+}
diff --git a/demos/simple-ai-search/tsconfig.json b/demos/simple-ai-search/tsconfig.json
new file mode 100644
index 000000000..090375311
--- /dev/null
+++ b/demos/simple-ai-search/tsconfig.json
@@ -0,0 +1,7 @@
+{
+	"extends": "astro/tsconfigs/base",
+	"compilerOptions": {
+		"types": ["node"]
+	},
+	"include": ["src", ".astro/types.d.ts", "emdash-env.d.ts"]
+}
diff --git a/packages/cloudflare/package.json b/packages/cloudflare/package.json
index 2dd42ae81..06604c517 100644
--- a/packages/cloudflare/package.json
+++ b/packages/cloudflare/package.json
@@ -45,6 +45,15 @@
       "types": "./dist/plugins/index.d.mts",
       "default": "./dist/plugins/index.mjs"
     },
+    "./plugins/ai-search": {
+      "types": "./dist/plugins/ai-search.d.mts",
+      "default": "./dist/plugins/ai-search.mjs"
+    },
+    "./plugins/ai-search-admin": {
+      "types": "./dist/plugins/ai-search-admin.d.mts",
+      "default": "./dist/plugins/ai-search-admin.mjs"
+    },
+
     "./media/images-runtime": {
       "types": "./dist/media/images-runtime.d.mts",
       "default": "./dist/media/images-runtime.mjs"
@@ -78,13 +87,26 @@
   },
   "peerDependencies": {
     "@cloudflare/workers-types": ">=4.0.0",
+    "@phosphor-icons/react": "^2.1.10",
     "astro": ">=6.0.0-beta.0",
-    "kysely": ">=0.27.0"
+    "kysely": ">=0.27.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@phosphor-icons/react": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "catalog:",
     "@cloudflare/workers-types": "catalog:",
+    "@phosphor-icons/react": "catalog:",
+    "@types/react": "catalog:",
     "publint": "catalog:",
+    "react": "catalog:",
     "tsdown": "catalog:",
     "typescript": "catalog:",
     "vitest": "catalog:"
diff --git a/packages/cloudflare/src/cache/runtime.ts b/packages/cloudflare/src/cache/runtime.ts
index ee2e00be2..fb9f27675 100644
--- a/packages/cloudflare/src/cache/runtime.ts
+++ b/packages/cloudflare/src/cache/runtime.ts
@@ -293,11 +293,12 @@ const factory: CacheProviderFactory<CloudflareCacheConfig> = (config) => {
 				const apiToken = resolveEnvValue(config?.apiToken, apiTokenEnvVar);
 
 				if (!zoneId || !apiToken) {
-					throw new Error(
-						`[cloudflare-cache-api] Tag-based invalidation requires a Zone ID and API token. ` +
+					console.warn(
+						`[cloudflare-cache-api] Tag-based invalidation skipped: missing Zone ID or API token. ` +
 							`Set the ${zoneIdEnvVar} and ${apiTokenEnvVar} environment variables, ` +
 							`or pass zoneId/apiToken in the cloudflareCache() config.`,
 					);
+					return;
 				}
 
 				const tags = Array.isArray(options.tags) ? options.tags : [options.tags];
diff --git a/packages/cloudflare/src/plugins/ai-search-admin.tsx b/packages/cloudflare/src/plugins/ai-search-admin.tsx
new file mode 100644
index 000000000..de8de05c7
--- /dev/null
+++ b/packages/cloudflare/src/plugins/ai-search-admin.tsx
@@ -0,0 +1,163 @@
+/**
+ * AI Search Plugin — Admin Components
+ *
+ * Settings page with a "Sync All Content" button that triggers
+ * a full reindex of all configured collections into AI Search.
+ */
+
+import { CircleNotch, ArrowsClockwise, CheckCircle, WarningCircle } from "@phosphor-icons/react";
+import type { PluginAdminExports } from "emdash";
+import { apiFetch, parseApiResponse } from "emdash/plugin-utils";
+import * as React from "react";
+
+const API_BASE = "/_emdash/api/plugins/ai-search";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+interface ReindexResult {
+	indexed: number;
+	errors: number;
+	collections: string[];
+}
+
+// =============================================================================
+// Settings Page
+// =============================================================================
+
+function SettingsPage() {
+	const [isSyncing, setIsSyncing] = React.useState(false);
+	const [result, setResult] = React.useState<ReindexResult | null>(null);
+	const [error, setError] = React.useState<string | null>(null);
+	const [collections, setCollections] = React.useState("posts,pages");
+
+	const handleSync = async () => {
+		setIsSyncing(true);
+		setResult(null);
+		setError(null);
+		try {
+			const response = await apiFetch(`${API_BASE}/reindex`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({
+					collections: collections
+						.split(",")
+						.map((c) => c.trim())
+						.filter(Boolean),
+				}),
+			});
+			const data = await parseApiResponse<ReindexResult | { error: string }>(response);
+			if ("error" in data) {
+				setError(data.error);
+			} else {
+				setResult(data);
+			}
+		} catch (err) {
+			setError(err instanceof Error ? err.message : "Sync failed");
+		} finally {
+			setIsSyncing(false);
+		}
+	};
+
+	return (
+		<div className="space-y-6">
+			<h1 className="text-2xl font-bold">AI Search</h1>
+
+			<div className="rounded-lg border bg-kumo-base p-6">
+				<h2 className="mb-1 text-lg font-semibold">Sync Content</h2>
+				<p className="mb-4 text-sm text-kumo-subtle">
+					Re-upload all content to the search index. Content is indexed automatically on save — use
+					this for a full re-sync after initial setup or to recover from issues.
+				</p>
+
+				<div className="space-y-4">
+					<div className="space-y-2">
+						<label className="text-sm font-medium" htmlFor="ai-search-collections">
+							Collections
+						</label>
+						<input
+							id="ai-search-collections"
+							type="text"
+							value={collections}
+							onChange={(e: React.ChangeEvent<HTMLInputElement>) => setCollections(e.target.value)}
+							placeholder="posts, pages"
+							className="block w-full max-w-sm rounded-md border bg-kumo-base px-3 py-2 text-sm focus:border-kumo-brand focus:outline-none focus:ring-2 focus:ring-kumo-brand/20 transition-colors"
+						/>
+						<p className="text-xs text-kumo-subtle">
+							Comma-separated collection slugs to include in the sync.
+						</p>
+					</div>
+
+					<div className="flex items-center gap-3">
+						<button
+							onClick={handleSync}
+							disabled={isSyncing || !collections.trim()}
+							className="inline-flex items-center gap-2 rounded-md bg-kumo-brand px-4 py-2 text-sm font-medium text-white hover:bg-kumo-brand/90 disabled:opacity-50 transition-colors"
+						>
+							{isSyncing ? (
+								<CircleNotch className="h-4 w-4 animate-spin" />
+							) : (
+								<ArrowsClockwise className="h-4 w-4" />
+							)}
+							{isSyncing ? "Syncing..." : "Sync All Content"}
+						</button>
+
+						{result && !error && (
+							<span className="text-sm text-kumo-subtle">
+								{result.indexed} item{result.indexed !== 1 ? "s" : ""} indexed
+							</span>
+						)}
+					</div>
+
+					{result && (
+						<div className="flex items-start gap-3 rounded-lg border border-green-200 bg-green-50 p-4 dark:border-green-800 dark:bg-green-950/30">
+							<CheckCircle
+								className="h-5 w-5 flex-shrink-0 text-green-600 dark:text-green-400"
+								weight="fill"
+							/>
+							<div>
+								<div className="text-sm font-medium text-green-800 dark:text-green-200">
+									Sync complete
+								</div>
+								<div className="mt-0.5 text-sm text-green-700 dark:text-green-300">
+									Indexed {result.indexed} item{result.indexed !== 1 ? "s" : ""} across{" "}
+									<span className="font-medium">{result.collections.join(", ")}</span>
+									{result.errors > 0 && (
+										<span className="text-amber-600 dark:text-amber-400">
+											{" "}
+											&mdash; {result.errors} error{result.errors !== 1 ? "s" : ""}
+										</span>
+									)}
+								</div>
+							</div>
+						</div>
+					)}
+
+					{error && (
+						<div className="flex items-start gap-3 rounded-lg border border-red-200 bg-red-50 p-4 dark:border-red-800 dark:bg-red-950/30">
+							<WarningCircle
+								className="h-5 w-5 flex-shrink-0 text-red-600 dark:text-red-400"
+								weight="fill"
+							/>
+							<div>
+								<div className="text-sm font-medium text-red-800 dark:text-red-200">
+									Sync failed
+								</div>
+								<div className="mt-0.5 text-sm text-red-700 dark:text-red-300">{error}</div>
+							</div>
+						</div>
+					)}
+				</div>
+			</div>
+		</div>
+	);
+}
+
+// =============================================================================
+// Exports
+// =============================================================================
+
+export const pages: PluginAdminExports["pages"] = {
+	"/settings": SettingsPage,
+};
diff --git a/packages/cloudflare/src/plugins/ai-search.ts b/packages/cloudflare/src/plugins/ai-search.ts
new file mode 100644
index 000000000..d3d093e56
--- /dev/null
+++ b/packages/cloudflare/src/plugins/ai-search.ts
@@ -0,0 +1,632 @@
+/**
+ * AI Search Plugin
+ *
+ * Semantic search using Cloudflare AI Search namespace bindings.
+ * Indexes content on save, removes on delete, exposes a search route.
+ *
+ * Requires only the `ai_search_namespaces` binding in wrangler.jsonc —
+ * no API tokens, no account IDs, no manual instance creation.
+ *
+ * @example
+ * ```typescript
+ * // astro.config.mjs
+ * import { aiSearch } from "@emdash-cms/cloudflare/plugins";
+ *
+ * export default defineConfig({
+ *   integrations: [
+ *     emdash({
+ *       plugins: [aiSearch()],
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example
+ * ```jsonc
+ * // wrangler.jsonc
+ * {
+ *   "ai_search_namespaces": [
+ *     { "binding": "AI_SEARCH", "namespace": "default" }
+ *   ]
+ * }
+ * ```
+ */
+
+import type {
+	ContentDeleteEvent,
+	ContentHookEvent,
+	ContentPublishStateChangeEvent,
+	PluginContext,
+	PluginDescriptor,
+	ResolvedPlugin,
+	RouteContext,
+} from "emdash";
+import { definePlugin, extractPlainText } from "emdash";
+
+const MD_EXT = /\.md$/;
+
+// =============================================================================
+// Configuration
+// =============================================================================
+
+export interface AISearchConfig {
+	/** AI Search instance name. @default "emdash-content" */
+	instanceName?: string;
+	/** Binding name in wrangler.jsonc. @default "AI_SEARCH" */
+	binding?: string;
+	/** Collections to index. Indexes all if omitted. */
+	collections?: string[];
+	/** Enable hybrid search (vector + keyword). @default true */
+	hybridSearch?: boolean;
+}
+
+// =============================================================================
+// Minimal types for the AI Search namespace binding
+//
+// These mirror the generated types from `wrangler types` (see
+// worker-configuration.d.ts). Remove once @cloudflare/workers-types
+// ships the AI Search binding types.
+// =============================================================================
+
+interface AiSearchSearchRequest {
+	messages: Array<{ role: string; content: string | null }>;
+	ai_search_options?: {
+		retrieval?: {
+			retrieval_type?: "vector" | "keyword" | "hybrid";
+			match_threshold?: number;
+			max_num_results?: number;
+			filters?: Record<string, unknown>;
+			context_expansion?: number;
+		};
+		query_rewrite?: { enabled?: boolean; model?: string; rewrite_prompt?: string };
+		reranking?: { enabled?: boolean; model?: string; match_threshold?: number };
+	};
+}
+
+interface AiSearchSearchResponse {
+	search_query: string;
+	chunks: Array<{
+		id: string;
+		type: string;
+		score: number;
+		text: string;
+		item: { key: string; timestamp?: number; metadata?: Record<string, unknown> };
+	}>;
+}
+
+interface AiSearchItemInfo {
+	id: string;
+	key: string;
+	status: string;
+	metadata?: Record<string, unknown>;
+}
+
+interface AiSearchConfig {
+	id: string;
+	type?: string;
+	source?: string;
+	custom_metadata?: Array<{ field_name: string; data_type: "text" | "number" | "boolean" }>;
+	[key: string]: unknown;
+}
+
+interface AiSearchInstance {
+	search(params: AiSearchSearchRequest): Promise<AiSearchSearchResponse>;
+	update(config: Partial<AiSearchConfig>): Promise<unknown>;
+	info(): Promise<{ id: string; [key: string]: unknown }>;
+	items: {
+		upload(
+			name: string,
+			content: string,
+			options?: { metadata?: Record<string, unknown> },
+		): Promise<AiSearchItemInfo>;
+		delete(itemId: string): Promise<void>;
+	};
+}
+
+interface AiSearchNamespace {
+	get(name: string): AiSearchInstance;
+	create(config: AiSearchConfig): Promise<AiSearchInstance>;
+}
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+/** Get Cloudflare runtime env via cloudflare:workers. */
+async function getCloudflareEnv(): Promise<Record<string, unknown> | null> {
+	try {
+		const { env } = await import("cloudflare:workers");
+		return env as unknown as Record<string, unknown>;
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * Keep the Worker isolate alive for the given promise.
+ * Uses cloudflare:workers waitUntil — safe to call after the response is sent.
+ * Silently no-ops outside Workers (e.g. during local dev).
+ */
+function cfWaitUntil(promise: Promise<unknown>): void {
+	import("cloudflare:workers").then(({ waitUntil }) => waitUntil(promise)).catch(() => {});
+}
+
+/** Convert a content entry to Markdown for indexing. */
+function contentToMarkdown(content: Record<string, unknown>, collection: string): string {
+	const parts: string[] = [];
+
+	if (typeof content.title === "string") parts.push(`# ${content.title}`);
+	parts.push(`Collection: ${collection}`);
+
+	for (const [key, value] of Object.entries(content)) {
+		if (key === "title" || key === "id" || key === "slug" || key === "status") continue;
+		if (key.startsWith("_")) continue;
+
+		if (typeof value === "string") {
+			const text = extractPlainText(value);
+			if (text) parts.push(text);
+		} else if (Array.isArray(value)) {
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any, typescript-eslint(no-unsafe-type-assertion) -- Portable Text arrays are untyped; extractPlainText handles validation
+			const text = extractPlainText(value as any);
+			if (text) parts.push(text);
+		}
+	}
+
+	return parts.join("\n\n");
+}
+
+/**
+ * Get the `visible_after` timestamp for a content item.
+ * Returns 0 for published content (immediately visible) or the
+ * scheduled_at unix timestamp in seconds for scheduled content.
+ */
+function getVisibleAfter(content: Record<string, unknown>): number {
+	const status = typeof content.status === "string" ? content.status : "";
+	if (status === "scheduled" && content.scheduled_at) {
+		const d = new Date(content.scheduled_at as string);
+		if (!isNaN(d.getTime())) return Math.floor(d.getTime() / 1000);
+	}
+	return 0;
+}
+
+/** Deterministic document key: `{collection}/{id}.md`. */
+function contentKey(collection: string, id: string): string {
+	return `${collection}/${id}.md`;
+}
+
+/** Parse a content key back into collection + id. */
+function parseContentKey(key: string): { collection: string; id: string } {
+	const [col, ...rest] = key.split("/");
+	return { collection: col ?? "", id: rest.join("/").replace(MD_EXT, "") };
+}
+
+// =============================================================================
+// Descriptor (for astro.config.mjs)
+// =============================================================================
+
+export function aiSearch(config: AISearchConfig = {}): PluginDescriptor<AISearchConfig> {
+	return {
+		id: "ai-search",
+		version: "1.0.0",
+		entrypoint: "@emdash-cms/cloudflare/plugins/ai-search",
+		options: config,
+		capabilities: ["read:content"],
+		adminEntry: "@emdash-cms/cloudflare/plugins/ai-search-admin",
+		adminPages: [{ path: "/settings", label: "AI Search", icon: "magnifying-glass" }],
+	};
+}
+
+// =============================================================================
+// Plugin implementation (loaded at runtime via entrypoint)
+// =============================================================================
+
+export function createPlugin(config: AISearchConfig = {}): ResolvedPlugin {
+	const instanceName = config.instanceName ?? "emdash-content";
+	const bindingName = config.binding ?? "AI_SEARCH";
+	const targetCollections = config.collections;
+	const hybridSearch = config.hybridSearch ?? true;
+
+	async function getBinding(): Promise<AiSearchNamespace | null> {
+		const env = await getCloudflareEnv();
+		if (!env?.[bindingName]) return null;
+		return env[bindingName] as AiSearchNamespace;
+	}
+
+	async function ensureInstance(ns: AiSearchNamespace): Promise<AiSearchInstance> {
+		const handle = ns.get(instanceName);
+		try {
+			await handle.info();
+			return handle;
+		} catch {
+			return ns.create({
+				id: instanceName,
+				hybrid_search_enabled: hybridSearch,
+				custom_metadata: [
+					{ field_name: "visible_after", data_type: "number" },
+					{ field_name: "published_at", data_type: "number" },
+				],
+			});
+		}
+	}
+
+	/**
+	 * Index a content item in AI Search.
+	 *
+	 * @param visibleAfter Unix timestamp (seconds) when the content becomes
+	 *   visible. Use 0 for already-published content. For scheduled content,
+	 *   pass the `scheduled_at` timestamp so the query filter
+	 *   `visible_after <= now` excludes it until the scheduled time.
+	 */
+	async function indexContent(
+		content: Record<string, unknown>,
+		collection: string,
+		ctx: PluginContext,
+		visibleAfter: number = 0,
+	): Promise<void> {
+		const ns = await getBinding();
+		if (!ns) {
+			console.warn("[ai-search] indexContent: binding not available");
+			return;
+		}
+
+		const key = contentKey(collection, String(content.id));
+		try {
+			const instance = await ensureInstance(ns);
+			const markdown = contentToMarkdown(content, collection);
+			if (!markdown.trim()) return;
+
+			const slug = typeof content.slug === "string" ? content.slug : "";
+			const title = typeof content.title === "string" ? content.title : "";
+
+			// Resolve published_at timestamp for recency boosting.
+			// Hooks provide publishedAt at top level; reindex merges item + item.data.
+			const pubRaw = content.publishedAt ?? content.published_at;
+			const pubMs = typeof pubRaw === "string" ? new Date(pubRaw).getTime() : 0;
+
+			const metadata: Record<string, string> = {
+				visible_after: String(visibleAfter),
+			};
+			if (pubMs > 0) metadata.published_at = String(pubMs);
+
+			const item = await instance.items.upload(key, markdown, { metadata });
+
+			await ctx.kv.set(`item:${key}`, item.id);
+			await ctx.kv.set(`meta:${key}`, JSON.stringify({ collection, slug, title }));
+			console.log(`[ai-search] Indexed ${key} (item: ${item.id})`);
+		} catch (error) {
+			console.error("[ai-search] Error indexing content:", error);
+		}
+	}
+
+	/** Remove a content item from the AI Search index. */
+	async function removeFromIndex(
+		collection: string,
+		id: string,
+		ctx: PluginContext,
+	): Promise<void> {
+		const ns = await getBinding();
+		if (!ns) return;
+
+		const key = contentKey(collection, id);
+		try {
+			const itemId = await ctx.kv.get<string>(`item:${key}`);
+			if (!itemId) return;
+
+			const instance = await ensureInstance(ns);
+			await instance.items.delete(itemId);
+			await ctx.kv.delete(`item:${key}`);
+			await ctx.kv.delete(`meta:${key}`);
+			console.log(`[ai-search] Removed ${key} (item: ${itemId})`);
+		} catch (error) {
+			console.error("[ai-search] Error removing content:", error);
+		}
+	}
+
+	/** Reindex the given collections. Shared by the reindex route and the install hook. */
+	async function reindexCollections(
+		collections: string[],
+		ctx: PluginContext,
+	): Promise<{ indexed: number; errors: number }> {
+		const ns = await getBinding();
+		if (!ns) {
+			console.warn("[ai-search] Reindex: binding not available");
+			return { indexed: 0, errors: 0 };
+		}
+		if (!ctx.content) {
+			console.warn("[ai-search] Reindex: content access not available");
+			return { indexed: 0, errors: 0 };
+		}
+
+		const instance = await ensureInstance(ns);
+		let indexed = 0;
+		let errors = 0;
+
+		for (const collection of collections) {
+			let cursor: string | undefined;
+			do {
+				const page = await ctx.content.list(collection, {
+					limit: 50,
+					cursor,
+				});
+
+				for (const item of page.items) {
+					try {
+						const status = typeof item.status === "string" ? item.status : "";
+						if (status !== "published" && status !== "scheduled") continue;
+
+						const record = { ...item, ...item.data };
+						const markdown = contentToMarkdown(record, collection);
+						if (!markdown.trim()) continue;
+
+						const key = contentKey(collection, item.id);
+						const slug = typeof item.slug === "string" ? item.slug : "";
+						const title = typeof item.data.title === "string" ? item.data.title : "";
+						const visibleAfter = getVisibleAfter(record);
+
+						const pubRaw = item.publishedAt;
+						const pubMs = typeof pubRaw === "string" ? new Date(pubRaw).getTime() : 0;
+
+						const metadata: Record<string, string> = {
+							visible_after: String(visibleAfter),
+						};
+						if (pubMs > 0) metadata.published_at = String(pubMs);
+
+						const uploaded = await instance.items.upload(key, markdown, {
+							metadata,
+						});
+
+						await ctx.kv.set(`item:${key}`, uploaded.id);
+						await ctx.kv.set(`meta:${key}`, JSON.stringify({ collection, slug, title }));
+						indexed++;
+					} catch (error) {
+						console.error(`[ai-search] Failed to index ${collection}/${item.id}:`, error);
+						errors++;
+					}
+				}
+
+				cursor = page.cursor;
+			} while (cursor);
+		}
+
+		return { indexed, errors };
+	}
+
+	return definePlugin({
+		id: "ai-search",
+		version: "1.0.0",
+		capabilities: ["read:content"],
+		admin: {
+			entry: "@emdash-cms/cloudflare/plugins/ai-search-admin",
+			pages: [{ path: "/settings", label: "AI Search", icon: "magnifying-glass" }],
+		},
+
+		hooks: {
+			"plugin:install": {
+				handler: async (_event: unknown, ctx: PluginContext): Promise<void> => {
+					const collections = targetCollections ?? ["posts", "pages"];
+					console.log(`[ai-search] Plugin installed, indexing: ${collections.join(", ")}`);
+					const result = await reindexCollections(collections, ctx);
+					console.log(
+						`[ai-search] Initial index complete: ${result.indexed} indexed, ${result.errors} errors`,
+					);
+				},
+			},
+
+			"content:afterSave": {
+				handler: (event: ContentHookEvent, ctx: PluginContext): Promise<void> => {
+					const { content, collection } = event;
+					if (targetCollections && !targetCollections.includes(collection))
+						return Promise.resolve();
+
+					const status = typeof content.status === "string" ? content.status : "";
+
+					// Index published and scheduled content. Published content is
+					// visible immediately (visible_after=0). Scheduled content is
+					// indexed now but filtered out at query time until its
+					// scheduled_at timestamp passes. Drafts are not indexed.
+					let work: Promise<void> | undefined;
+					if (status === "published") {
+						work = indexContent(content, collection, ctx, 0);
+					} else if (status === "scheduled") {
+						work = indexContent(content, collection, ctx, getVisibleAfter(content));
+					}
+					if (work) cfWaitUntil(work);
+					return work ?? Promise.resolve();
+				},
+			},
+
+			"content:afterPublish": {
+				handler: (event: ContentPublishStateChangeEvent, ctx: PluginContext): Promise<void> => {
+					const { content, collection } = event;
+					if (targetCollections && !targetCollections.includes(collection))
+						return Promise.resolve();
+
+					const work = indexContent(content, collection, ctx);
+					cfWaitUntil(work);
+					return work;
+				},
+			},
+
+			"content:afterUnpublish": {
+				handler: (event: ContentPublishStateChangeEvent, ctx: PluginContext): Promise<void> => {
+					const { content, collection } = event;
+					if (targetCollections && !targetCollections.includes(collection))
+						return Promise.resolve();
+
+					const work = removeFromIndex(collection, String(content.id), ctx);
+					cfWaitUntil(work);
+					return work;
+				},
+			},
+
+			"content:afterDelete": {
+				handler: (event: ContentDeleteEvent, ctx: PluginContext): Promise<void> => {
+					const { id, collection } = event;
+					if (targetCollections && !targetCollections.includes(collection))
+						return Promise.resolve();
+
+					const work = removeFromIndex(collection, id, ctx);
+					cfWaitUntil(work);
+					return work;
+				},
+			},
+		},
+
+		routes: {
+			query: {
+				public: true,
+				handler: async (ctx: RouteContext): Promise<unknown> => {
+					const start = Date.now();
+
+					// Support both JSON body input and URL query params (for GET requests)
+					const input = ctx.input as Record<string, unknown> | undefined;
+					const url = new URL(ctx.request.url);
+					const params = url.searchParams;
+
+					const ns = await getBinding();
+					if (!ns) {
+						console.warn("[ai-search] Query failed: binding not available");
+						return { error: `${bindingName} binding not available`, results: [] };
+					}
+
+					const q =
+						(typeof input?.q === "string" ? input.q : undefined) ?? params.get("q") ?? undefined;
+					if (!q) {
+						return { error: "Query parameter 'q' is required", results: [] };
+					}
+
+					const limit =
+						(typeof input?.limit === "number" ? input.limit : undefined) ??
+						(params.has("limit") ? Number(params.get("limit")) : undefined) ??
+						10;
+					const collection =
+						(typeof input?.collection === "string" ? input.collection : undefined) ??
+						params.get("collection") ??
+						undefined;
+
+					console.log(
+						`[ai-search] Query: q=${JSON.stringify(q)} limit=${limit} collection=${collection ?? "all"}`,
+					);
+
+					try {
+						const instance = await ensureInstance(ns);
+						const nowSeconds = Math.floor(Date.now() / 1000);
+
+						const response = await instance.search({
+							messages: [{ role: "user", content: q }],
+							ai_search_options: {
+								retrieval: {
+									max_num_results: limit,
+									filters: {
+										visible_after: { $lte: nowSeconds },
+									},
+								},
+							},
+						});
+
+						let chunks = response.chunks;
+						if (collection) {
+							const cols = collection.split(",").map((c) => c.trim());
+							chunks = chunks.filter((c) => cols.some((col) => c.item.key.startsWith(`${col}/`)));
+						}
+
+						// Deduplicate by item key, keeping the highest-scoring chunk per item
+						const bestByKey = new Map<string, (typeof chunks)[number]>();
+						for (const c of chunks) {
+							const existing = bestByKey.get(c.item.key);
+							if (!existing || c.score > existing.score) {
+								bestByKey.set(c.item.key, c);
+							}
+						}
+						const uniqueChunks = [...bestByKey.values()];
+
+						// Look up stored metadata (slug, title) for each result.
+						// Drafts are never indexed. Published and scheduled content
+						// are indexed with a `visible_after` metadata field and
+						// filtered at query time via `visible_after <= now`.
+						const results = await Promise.all(
+							uniqueChunks.map(async (c) => {
+								const parsed = parseContentKey(c.item.key);
+								let slug: string | null = null;
+								let title: string | null = null;
+								try {
+									const raw = await ctx.kv.get<string>(`meta:${c.item.key}`);
+									if (raw) {
+										const meta = JSON.parse(raw) as { slug?: string; title?: string };
+										slug = meta.slug || null;
+										title = meta.title || null;
+									}
+								} catch {
+									// KV lookup failed, fall back to parsed key
+								}
+								return {
+									...parsed,
+									slug,
+									title,
+									score: c.score,
+									snippet: c.text,
+								};
+							}),
+						);
+
+						const elapsed = Date.now() - start;
+						console.log(
+							`[ai-search] Query complete: ${results.length} results in ${elapsed}ms (rewritten: ${JSON.stringify(response.search_query)})`,
+						);
+						return { query: response.search_query, results };
+					} catch (error) {
+						const elapsed = Date.now() - start;
+						console.error(`[ai-search] Query failed after ${elapsed}ms:`, error);
+						return {
+							error: error instanceof Error ? error.message : "Search failed",
+							results: [],
+						};
+					}
+				},
+			},
+
+			reindex: {
+				handler: async (ctx: RouteContext): Promise<unknown> => {
+					const start = Date.now();
+
+					if (!ctx.content) {
+						return { error: "Content access not available" };
+					}
+
+					const input = ctx.input as Record<string, unknown> | undefined;
+					const requestedCollections =
+						typeof input?.collections === "string"
+							? input.collections.split(",").map((c: string) => c.trim())
+							: Array.isArray(input?.collections)
+								? (input.collections as string[])
+								: undefined;
+					const collections = targetCollections ?? requestedCollections ?? [];
+
+					if (collections.length === 0) {
+						return {
+							error: "No collections specified. Pass collections in the request or plugin config.",
+						};
+					}
+
+					try {
+						console.log(`[ai-search] Reindex started for collections: ${collections.join(", ")}`);
+						const result = await reindexCollections(collections, ctx);
+						const elapsed = Date.now() - start;
+						console.log(
+							`[ai-search] Reindex complete: ${result.indexed} indexed, ${result.errors} errors in ${elapsed}ms`,
+						);
+						return { ...result, collections };
+					} catch (error) {
+						const elapsed = Date.now() - start;
+						console.error(`[ai-search] Reindex failed after ${elapsed}ms:`, error);
+						return {
+							error: error instanceof Error ? error.message : "Reindex failed",
+						};
+					}
+				},
+			},
+		},
+	});
+}
+
+export default createPlugin;
diff --git a/packages/cloudflare/src/plugins/index.ts b/packages/cloudflare/src/plugins/index.ts
index f0eb0b9b6..a5b724d57 100644
--- a/packages/cloudflare/src/plugins/index.ts
+++ b/packages/cloudflare/src/plugins/index.ts
@@ -5,3 +5,4 @@
  */
 
 export { vectorizeSearch, type VectorizeSearchConfig } from "./vectorize-search.js";
+export { aiSearch, type AISearchConfig } from "./ai-search.js";
diff --git a/packages/cloudflare/tsdown.config.ts b/packages/cloudflare/tsdown.config.ts
index 2e524c7b4..66c3caab8 100644
--- a/packages/cloudflare/tsdown.config.ts
+++ b/packages/cloudflare/tsdown.config.ts
@@ -11,6 +11,9 @@ export default defineConfig({
 		"src/auth/index.ts",
 		"src/sandbox/index.ts",
 		"src/plugins/index.ts",
+		"src/plugins/ai-search.ts",
+		"src/plugins/ai-search-admin.tsx",
+
 		// Media provider runtimes
 		"src/media/images-runtime.ts",
 		"src/media/stream-runtime.ts",
diff --git a/packages/plugins/ai-search/package.json b/packages/plugins/ai-search/package.json
new file mode 100644
index 000000000..e661c7764
--- /dev/null
+++ b/packages/plugins/ai-search/package.json
@@ -0,0 +1,41 @@
+{
+	"name": "@emdash-cms/plugin-ai-search",
+	"version": "0.1.0",
+	"description": "AI Search plugin for EmDash CMS — semantic search via Cloudflare AI Search REST API",
+	"type": "module",
+	"main": "src/index.ts",
+	"exports": {
+		".": "./src/index.ts",
+		"./admin": "./src/admin.tsx"
+	},
+	"files": [
+		"src"
+	],
+	"keywords": [
+		"emdash",
+		"cms",
+		"plugin",
+		"ai-search",
+		"semantic-search",
+		"cloudflare"
+	],
+	"author": "Matt Kane",
+	"license": "MIT",
+	"peerDependencies": {
+		"emdash": "workspace:>=0.1.0",
+		"react": "^18.0.0 || ^19.0.0",
+		"@phosphor-icons/react": "^2.1.10",
+		"@cloudflare/kumo": "^1.0.0"
+	},
+	"devDependencies": {
+		"vite": "^6.0.0"
+	},
+	"scripts": {
+		"typecheck": "tsgo --noEmit"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/emdash-cms/emdash.git",
+		"directory": "packages/plugins/ai-search"
+	}
+}
diff --git a/packages/plugins/ai-search/src/admin.tsx b/packages/plugins/ai-search/src/admin.tsx
new file mode 100644
index 000000000..ea8aff324
--- /dev/null
+++ b/packages/plugins/ai-search/src/admin.tsx
@@ -0,0 +1,382 @@
+/**
+ * AI Search API Plugin — Admin Components
+ *
+ * Settings page with:
+ * 1. Credentials form — save Cloudflare account ID + API token (stored in plugin KV)
+ * 2. Sync button — trigger a full reindex of all configured collections
+ *
+ * IMPORTANT: Only use Tailwind utility classes that exist in the pre-compiled
+ * admin CSS (packages/admin/dist/styles.css). The admin CSS is built once and
+ * served statically — plugin sources are NOT scanned by Tailwind. Stick to
+ * kumo semantic tokens (text-kumo-*, bg-kumo-*, border-kumo-*) and common
+ * layout utilities.
+ */
+
+import { Badge, Button, Input } from "@cloudflare/kumo";
+import {
+	CircleNotch,
+	ArrowsClockwise,
+	CheckCircle,
+	WarningCircle,
+	Key,
+} from "@phosphor-icons/react";
+import type { PluginAdminExports } from "emdash";
+import { apiFetch, parseApiResponse } from "emdash/plugin-utils";
+import * as React from "react";
+
+const API_BASE = "/_emdash/api/plugins/ai-search-api";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+interface ReindexResult {
+	indexed: number;
+	errors: number;
+	collections: string[];
+}
+
+interface StatusResponse {
+	configured: boolean;
+	source: "config" | "env" | "kv" | "none";
+	accountId: string | null;
+	namespace: string;
+	instanceName: string;
+}
+
+interface CredentialsResponse {
+	valid?: boolean;
+	saved?: boolean;
+	error?: string;
+	reindex?: ReindexResult;
+}
+
+// =============================================================================
+// Shared alert component
+// =============================================================================
+
+function Alert({
+	variant,
+	title,
+	children,
+}: {
+	variant: "success" | "error";
+	title: string;
+	children: React.ReactNode;
+}) {
+	const Icon = variant === "success" ? CheckCircle : WarningCircle;
+	const colorClass = variant === "success" ? "text-kumo-success" : "text-kumo-danger";
+	const borderClass = variant === "success" ? "border-kumo-success" : "border-kumo-danger";
+	return (
+		<div className={`flex items-start gap-3 rounded-lg border ${borderClass} bg-kumo-tint p-4`}>
+			<Icon className={`h-5 w-5 flex-shrink-0 ${colorClass}`} weight="fill" />
+			<div>
+				<div className={`text-sm font-medium ${colorClass}`}>{title}</div>
+				<div className="mt-1 text-sm text-kumo-subtle">{children}</div>
+			</div>
+		</div>
+	);
+}
+
+// =============================================================================
+// Credentials Section
+// =============================================================================
+
+function CredentialsSection({
+	status,
+	onSaved,
+}: {
+	status: StatusResponse | null;
+	onSaved: () => void;
+}) {
+	const [accountId, setAccountId] = React.useState("");
+	const [apiToken, setApiToken] = React.useState("");
+	const [isSaving, setIsSaving] = React.useState(false);
+	const [result, setResult] = React.useState<CredentialsResponse | null>(null);
+
+	const handleSave = async () => {
+		setIsSaving(true);
+		setResult(null);
+		try {
+			const response = await apiFetch(`${API_BASE}/credentials`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ accountId, apiToken }),
+			});
+			const data = await parseApiResponse<CredentialsResponse>(response);
+			setResult(data);
+			if (data.saved) {
+				setApiToken("");
+				onSaved();
+			}
+		} catch (err) {
+			setResult({ error: err instanceof Error ? err.message : "Failed to save credentials" });
+		} finally {
+			setIsSaving(false);
+		}
+	};
+
+	// Config-level credentials can't be changed in the UI
+	if (status?.source === "config") {
+		return (
+			<section className="space-y-4">
+				<div>
+					<h2 className="text-lg font-semibold">Cloudflare Credentials</h2>
+					<p className="mt-1 text-sm text-kumo-subtle">
+						Credentials are configured in plugin code and cannot be changed here.
+					</p>
+				</div>
+				<div className="flex items-center gap-2">
+					<Badge color="green">Connected</Badge>
+					<span className="text-sm text-kumo-subtle">
+						Account: <code className="text-xs">{status.accountId}</code>
+					</span>
+				</div>
+			</section>
+		);
+	}
+
+	const isConfigured = status?.configured && (status.source === "kv" || status.source === "env");
+
+	return (
+		<section className="space-y-4">
+			<div>
+				<h2 className="text-lg font-semibold">Cloudflare Credentials</h2>
+				<p className="mt-1 text-sm text-kumo-subtle">
+					Enter your Cloudflare account ID and an API token with AI Search permissions. Credentials
+					saved here take priority over environment variables.
+				</p>
+			</div>
+
+			{isConfigured && (
+				<div className="flex items-center gap-2">
+					<Badge color="green">Connected</Badge>
+					<span className="text-sm text-kumo-subtle">
+						via {status!.source === "kv" ? "saved credentials" : "environment variables"}
+						{" — "}Account: <code className="text-xs">{status!.accountId}</code>
+					</span>
+				</div>
+			)}
+
+			<div className="space-y-4" style={{ maxWidth: "32rem" }}>
+				<Input
+					label="Account ID"
+					value={accountId}
+					onChange={(e: React.ChangeEvent<HTMLInputElement>) => setAccountId(e.target.value)}
+					placeholder={status?.accountId ? `Current: ${status.accountId}` : "Cloudflare account ID"}
+				/>
+
+				<Input
+					label="API Token"
+					type="password"
+					value={apiToken}
+					onChange={(e: React.ChangeEvent<HTMLInputElement>) => setApiToken(e.target.value)}
+					placeholder={isConfigured ? "••••••••" : "Cloudflare API token"}
+					description={
+						<>
+							Create a token at{" "}
+							<a
+								href="https://dash.cloudflare.com/profile/api-tokens"
+								target="_blank"
+								rel="noopener noreferrer"
+								className="text-kumo-link underline"
+							>
+								dash.cloudflare.com/profile/api-tokens
+							</a>{" "}
+							with <strong>AI Search Edit</strong> and <strong>AI Search Run</strong> permissions.
+						</>
+					}
+				/>
+
+				<Button
+					onClick={handleSave}
+					disabled={isSaving || !accountId.trim() || !apiToken.trim()}
+					loading={isSaving}
+				>
+					<Key className="h-4 w-4" />
+					{isConfigured ? "Update Credentials" : "Save & Index"}
+				</Button>
+			</div>
+
+			{result?.saved && result.reindex && (
+				<Alert variant="success" title="Credentials saved & content indexed">
+					Indexed {result.reindex.indexed} item
+					{result.reindex.indexed !== 1 ? "s" : ""}
+					{result.reindex.errors > 0 && (
+						<>
+							{" — "}
+							{result.reindex.errors} error
+							{result.reindex.errors !== 1 ? "s" : ""}
+						</>
+					)}
+				</Alert>
+			)}
+
+			{result?.error && (
+				<Alert variant="error" title="Validation failed">
+					{result.error}
+				</Alert>
+			)}
+		</section>
+	);
+}
+
+// =============================================================================
+// Sync Section
+// =============================================================================
+
+function SyncSection({ disabled }: { disabled: boolean }) {
+	const [isSyncing, setIsSyncing] = React.useState(false);
+	const [result, setResult] = React.useState<ReindexResult | null>(null);
+	const [error, setError] = React.useState<string | null>(null);
+	const [collections, setCollections] = React.useState("posts,pages");
+
+	const handleSync = async () => {
+		setIsSyncing(true);
+		setResult(null);
+		setError(null);
+		try {
+			const response = await apiFetch(`${API_BASE}/reindex`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({
+					collections: collections
+						.split(",")
+						.map((c) => c.trim())
+						.filter(Boolean),
+				}),
+			});
+			const data = await parseApiResponse<ReindexResult | { error: string }>(response);
+			if ("error" in data) {
+				setError(data.error);
+			} else {
+				setResult(data);
+			}
+		} catch (err) {
+			setError(err instanceof Error ? err.message : "Sync failed");
+		} finally {
+			setIsSyncing(false);
+		}
+	};
+
+	return (
+		<section className="space-y-4">
+			<div>
+				<h2 className="text-lg font-semibold">Sync Content</h2>
+				<p className="mt-1 text-sm text-kumo-subtle">
+					Re-upload all content to the search index. Content is indexed automatically on save — use
+					this for a full re-sync after initial setup or to recover from issues.
+				</p>
+			</div>
+
+			<div className="space-y-4" style={{ maxWidth: "32rem" }}>
+				<Input
+					label="Collections"
+					value={collections}
+					onChange={(e: React.ChangeEvent<HTMLInputElement>) => setCollections(e.target.value)}
+					placeholder="posts, pages"
+					disabled={disabled}
+					description="Comma-separated collection slugs to include in the sync."
+				/>
+
+				<div className="flex items-center gap-3">
+					<Button
+						onClick={handleSync}
+						disabled={disabled || isSyncing || !collections.trim()}
+						loading={isSyncing}
+					>
+						<ArrowsClockwise className="h-4 w-4" />
+						{isSyncing ? "Syncing..." : "Sync All Content"}
+					</Button>
+
+					{result && !error && (
+						<span className="text-sm text-kumo-subtle">
+							{result.indexed} item{result.indexed !== 1 ? "s" : ""} indexed
+						</span>
+					)}
+				</div>
+			</div>
+
+			{disabled && (
+				<p className="text-sm text-kumo-warning">Configure credentials above before syncing.</p>
+			)}
+
+			{result && (
+				<Alert variant="success" title="Sync complete">
+					Indexed {result.indexed} item
+					{result.indexed !== 1 ? "s" : ""} across <strong>{result.collections.join(", ")}</strong>
+					{result.errors > 0 && (
+						<>
+							{" — "}
+							{result.errors} error
+							{result.errors !== 1 ? "s" : ""}
+						</>
+					)}
+				</Alert>
+			)}
+
+			{error && (
+				<Alert variant="error" title="Sync failed">
+					{error}
+				</Alert>
+			)}
+		</section>
+	);
+}
+
+// =============================================================================
+// Settings Page
+// =============================================================================
+
+function SettingsPage() {
+	const [status, setStatus] = React.useState<StatusResponse | null>(null);
+	const [loading, setLoading] = React.useState(true);
+
+	const fetchStatus = React.useCallback(async () => {
+		try {
+			const response = await apiFetch(`${API_BASE}/status`);
+			const data = await parseApiResponse<StatusResponse>(response);
+			setStatus(data);
+		} catch {
+			setStatus({
+				configured: false,
+				source: "none",
+				accountId: null,
+				namespace: "",
+				instanceName: "",
+			});
+		} finally {
+			setLoading(false);
+		}
+	}, []);
+
+	React.useEffect(() => {
+		fetchStatus();
+	}, [fetchStatus]);
+
+	if (loading) {
+		return (
+			<div className="flex items-center gap-2 p-6 text-kumo-subtle">
+				<CircleNotch className="h-4 w-4 animate-spin" />
+				<span className="text-sm">Loading...</span>
+			</div>
+		);
+	}
+
+	return (
+		<div className="space-y-6">
+			<h1 className="text-2xl font-bold">AI Search</h1>
+			<CredentialsSection status={status} onSaved={fetchStatus} />
+			<hr className="border-kumo-line" />
+			<SyncSection disabled={!status?.configured} />
+		</div>
+	);
+}
+
+// =============================================================================
+// Exports
+// =============================================================================
+
+export const pages: PluginAdminExports["pages"] = {
+	"/settings": SettingsPage,
+};
diff --git a/packages/plugins/ai-search/src/index.ts b/packages/plugins/ai-search/src/index.ts
new file mode 100644
index 000000000..90e97985f
--- /dev/null
+++ b/packages/plugins/ai-search/src/index.ts
@@ -0,0 +1,872 @@
+/**
+ * AI Search API Plugin
+ *
+ * Semantic search using the Cloudflare AI Search REST API.
+ * Indexes content on save, removes on delete, exposes a search route.
+ *
+ * Unlike the binding-based `aiSearch()` plugin, this plugin uses the
+ * Cloudflare REST API (`api.cloudflare.com`) and works on any hosting
+ * platform — not just Cloudflare Workers.
+ *
+ * Requires a Cloudflare API token with AI Search permissions and an
+ * account ID. These can be passed in the plugin config or set via
+ * environment variables (`CF_ACCOUNT_ID` / `CF_API_TOKEN`).
+ *
+ * Uses the namespace-aware REST API endpoints at
+ * `/ai-search/namespaces/{ns}/instances/{id}/...`.
+ *
+ * @example
+ * ```typescript
+ * // astro.config.mjs
+ * import { aiSearchAPI } from "@emdash-cms/cloudflare/plugins";
+ *
+ * export default defineConfig({
+ *   integrations: [
+ *     emdash({
+ *       plugins: [aiSearchAPI()],
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example
+ * ```shell
+ * # .env
+ * CF_ACCOUNT_ID=your-account-id
+ * CF_API_TOKEN=your-api-token
+ * ```
+ */
+
+import type {
+	ContentDeleteEvent,
+	ContentHookEvent,
+	ContentPublishStateChangeEvent,
+	PluginContext,
+	PluginDescriptor,
+	ResolvedPlugin,
+	RouteContext,
+} from "emdash";
+import { definePlugin, extractPlainText } from "emdash";
+
+const MD_EXT = /\.md$/;
+
+const CF_API_BASE = "https://api.cloudflare.com/client/v4/accounts";
+
+// =============================================================================
+// Configuration
+// =============================================================================
+
+export interface AISearchAPIConfig {
+	/**
+	 * Cloudflare account ID.
+	 * Falls back to `EMDASH_CF_ACCOUNT_ID` or `CF_ACCOUNT_ID` env var.
+	 */
+	accountId?: string;
+	/**
+	 * Cloudflare API token with AI Search permissions.
+	 * Falls back to `EMDASH_CF_API_TOKEN` or `CF_API_TOKEN` env var.
+	 */
+	apiToken?: string;
+	/** AI Search namespace. @default "default" */
+	namespace?: string;
+	/** AI Search instance name. @default "emdash-content" */
+	instanceName?: string;
+	/** Collections to index. Indexes all if omitted. */
+	collections?: string[];
+	/** Enable hybrid search (vector + keyword). @default true */
+	hybridSearch?: boolean;
+}
+
+// =============================================================================
+// API response types
+// =============================================================================
+
+interface CfApiResponse<T> {
+	success: boolean;
+	result: T;
+	errors?: Array<{ code: number; message: string }>;
+}
+
+interface AiSearchItemInfo {
+	id: string;
+	key: string;
+	status: string;
+	metadata?: Record<string, unknown>;
+}
+
+interface AiSearchSearchResponse {
+	search_query: string;
+	chunks: Array<{
+		id: string;
+		type: string;
+		score: number;
+		text: string;
+		item: { key: string; timestamp?: number; metadata?: Record<string, unknown> };
+	}>;
+}
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+/** Convert a content entry to Markdown for indexing. */
+function contentToMarkdown(content: Record<string, unknown>, collection: string): string {
+	const parts: string[] = [];
+
+	if (typeof content.title === "string") parts.push(`# ${content.title}`);
+	parts.push(`Collection: ${collection}`);
+
+	for (const [key, value] of Object.entries(content)) {
+		if (key === "title" || key === "id" || key === "slug" || key === "status") continue;
+		if (key.startsWith("_")) continue;
+
+		if (typeof value === "string") {
+			const text = extractPlainText(value);
+			if (text) parts.push(text);
+		} else if (Array.isArray(value)) {
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any, typescript-eslint(no-unsafe-type-assertion) -- Portable Text arrays are untyped; extractPlainText handles validation
+			const text = extractPlainText(value as any);
+			if (text) parts.push(text);
+		}
+	}
+
+	return parts.join("\n\n");
+}
+
+/**
+ * Get the `visible_after` timestamp for a content item.
+ * Returns 0 for published content (immediately visible) or the
+ * scheduled_at unix timestamp in seconds for scheduled content.
+ */
+function getVisibleAfter(content: Record<string, unknown>): number {
+	const status = typeof content.status === "string" ? content.status : "";
+	if (status === "scheduled" && content.scheduled_at) {
+		const d = new Date(content.scheduled_at as string);
+		if (!isNaN(d.getTime())) return Math.floor(d.getTime() / 1000);
+	}
+	return 0;
+}
+
+/** Deterministic document key: `{collection}/{id}.md`. */
+function contentKey(collection: string, id: string): string {
+	return `${collection}/${id}.md`;
+}
+
+/** Parse a content key back into collection + id. */
+function parseContentKey(key: string): { collection: string; id: string } {
+	const [col, ...rest] = key.split("/");
+	return { collection: col ?? "", id: rest.join("/").replace(MD_EXT, "") };
+}
+
+// =============================================================================
+// API client
+// =============================================================================
+
+/**
+ * Thin wrapper around the Cloudflare AI Search REST API.
+ * Uses the namespace-aware endpoints.
+ */
+class AISearchClient {
+	private readonly baseUrl: string;
+	private readonly apiToken: string;
+
+	constructor(accountId: string, apiToken: string, namespace: string, instanceName: string) {
+		this.baseUrl = `${CF_API_BASE}/${accountId}/ai-search/namespaces/${namespace}/instances/${instanceName}`;
+		this.apiToken = apiToken;
+	}
+
+	/** Build the base URL for namespace-level operations (e.g. create instance). */
+	static namespaceUrl(accountId: string, namespace: string): string {
+		return `${CF_API_BASE}/${accountId}/ai-search/namespaces/${namespace}/instances`;
+	}
+
+	private headers(contentType?: string): Record<string, string> {
+		const h: Record<string, string> = { Authorization: `Bearer ${this.apiToken}` };
+		if (contentType) h["Content-Type"] = contentType;
+		return h;
+	}
+
+	/** Check whether the instance exists. */
+	async instanceExists(): Promise<boolean> {
+		const res = await fetch(this.baseUrl, { headers: this.headers() });
+		return res.ok;
+	}
+
+	/** Create the instance. */
+	async createInstance(
+		accountId: string,
+		namespace: string,
+		config: {
+			id: string;
+			hybrid_search_enabled?: boolean;
+			custom_metadata?: Array<{ field_name: string; data_type: string }>;
+		},
+	): Promise<void> {
+		const url = AISearchClient.namespaceUrl(accountId, namespace);
+		const res = await fetch(url, {
+			method: "POST",
+			headers: this.headers("application/json"),
+			body: JSON.stringify(config),
+		});
+		if (!res.ok) {
+			const body = await res.text();
+			throw new Error(`Failed to create AI Search instance: ${res.status} ${body}`);
+		}
+	}
+
+	/** Search the instance. */
+	async search(params: {
+		messages?: Array<{ role: string; content: string | null }>;
+		query?: string;
+		ai_search_options?: Record<string, unknown>;
+	}): Promise<AiSearchSearchResponse> {
+		const res = await fetch(`${this.baseUrl}/search`, {
+			method: "POST",
+			headers: this.headers("application/json"),
+			body: JSON.stringify(params),
+		});
+		if (!res.ok) {
+			const body = await res.text();
+			throw new Error(`AI Search query failed: ${res.status} ${body}`);
+		}
+		const json = (await res.json()) as CfApiResponse<AiSearchSearchResponse>;
+		if (!json.success) {
+			throw new Error(
+				`AI Search query failed: ${json.errors?.map((e) => e.message).join(", ") ?? "unknown error"}`,
+			);
+		}
+		return json.result;
+	}
+
+	/**
+	 * Upload an item to the index.
+	 *
+	 * Uses multipart/form-data with the content as a file attachment.
+	 * The filename becomes the item key in the index.
+	 */
+	async uploadItem(
+		key: string,
+		content: string,
+		metadata?: Record<string, string>,
+	): Promise<AiSearchItemInfo> {
+		const file = new File([content], key, { type: "text/markdown" });
+		const formData = new FormData();
+		formData.append("file", file);
+		if (metadata) {
+			formData.append("metadata", JSON.stringify(metadata));
+		}
+
+		const res = await fetch(`${this.baseUrl}/items`, {
+			method: "POST",
+			// No Content-Type header -- fetch sets multipart boundary automatically
+			headers: { Authorization: `Bearer ${this.apiToken}` },
+			body: formData,
+		});
+		if (!res.ok) {
+			const body = await res.text();
+			throw new Error(`AI Search item upload failed: ${res.status} ${body}`);
+		}
+		const json = (await res.json()) as CfApiResponse<AiSearchItemInfo>;
+		if (!json.success) {
+			throw new Error(
+				`AI Search item upload failed: ${json.errors?.map((e) => e.message).join(", ") ?? "unknown error"}`,
+			);
+		}
+		return json.result;
+	}
+
+	/** Delete an item from the index. */
+	async deleteItem(itemId: string): Promise<void> {
+		const res = await fetch(`${this.baseUrl}/items/${encodeURIComponent(itemId)}`, {
+			method: "DELETE",
+			headers: this.headers(),
+		});
+		if (!res.ok && res.status !== 404) {
+			const body = await res.text();
+			throw new Error(`AI Search item delete failed: ${res.status} ${body}`);
+		}
+	}
+}
+
+// =============================================================================
+// Credential resolution
+// =============================================================================
+
+/** KV keys for stored credentials. */
+const KV_ACCOUNT_ID = "cfg:account_id";
+const KV_API_TOKEN = "cfg:api_token";
+
+type CredentialSource = "config" | "env" | "kv" | "none";
+
+interface ResolvedCredentials {
+	accountId: string;
+	apiToken: string;
+	source: CredentialSource;
+}
+
+/** Resolve credentials from config or env vars (synchronous, no KV). */
+function resolveCredentialsSync(config: AISearchAPIConfig): ResolvedCredentials {
+	/* eslint-disable @typescript-eslint/no-unnecessary-condition */
+	if (config.accountId && config.apiToken) {
+		return { accountId: config.accountId, apiToken: config.apiToken, source: "config" };
+	}
+
+	const accountId =
+		(typeof import.meta.env !== "undefined" &&
+			(import.meta.env.EMDASH_CF_ACCOUNT_ID || import.meta.env.CF_ACCOUNT_ID)) ||
+		"";
+	const apiToken =
+		(typeof import.meta.env !== "undefined" &&
+			(import.meta.env.EMDASH_CF_API_TOKEN || import.meta.env.CF_API_TOKEN)) ||
+		"";
+	/* eslint-enable @typescript-eslint/no-unnecessary-condition */
+
+	if (accountId && apiToken) {
+		return { accountId, apiToken, source: "env" };
+	}
+	return { accountId: "", apiToken: "", source: "none" };
+}
+
+/**
+ * Resolve credentials from config, KV storage, or env vars.
+ *
+ * Priority order:
+ *   1. Plugin config (set in code — cannot be overridden)
+ *   2. KV storage (set via admin UI — user explicitly saved them)
+ *   3. Environment variables (fallback)
+ */
+async function resolveCredentials(
+	config: AISearchAPIConfig,
+	kv: PluginContext["kv"],
+): Promise<ResolvedCredentials> {
+	// 1. Plugin config (highest priority)
+	if (config.accountId && config.apiToken) {
+		return { accountId: config.accountId, apiToken: config.apiToken, source: "config" };
+	}
+
+	// 2. KV-stored credentials (set via admin UI)
+	const kvAccountId = (await kv.get<string>(KV_ACCOUNT_ID)) ?? "";
+	const kvApiToken = (await kv.get<string>(KV_API_TOKEN)) ?? "";
+	if (kvAccountId && kvApiToken) {
+		return { accountId: kvAccountId, apiToken: kvApiToken, source: "kv" };
+	}
+
+	// 3. Environment variables (fallback)
+	const sync = resolveCredentialsSync(config);
+	if (sync.source === "env") return sync;
+
+	return { accountId: "", apiToken: "", source: "none" };
+}
+
+/**
+ * Validate that credentials can reach the AI Search API.
+ * Attempts to list instances in the given namespace.
+ */
+async function validateCredentials(
+	accountId: string,
+	apiToken: string,
+): Promise<{ valid: boolean; error?: string }> {
+	try {
+		const res = await fetch(`${CF_API_BASE}/${accountId}/ai-search/instances`, {
+			headers: { Authorization: `Bearer ${apiToken}` },
+		});
+		if (res.ok) return { valid: true };
+		if (res.status === 401 || res.status === 403) {
+			return { valid: false, error: "Invalid API token or insufficient permissions" };
+		}
+		const body = await res.text();
+		return { valid: false, error: `API returned ${res.status}: ${body.slice(0, 200)}` };
+	} catch (err) {
+		return { valid: false, error: err instanceof Error ? err.message : "Connection failed" };
+	}
+}
+
+// =============================================================================
+// Descriptor (for astro.config.mjs)
+// =============================================================================
+
+export function aiSearchAPI(config: AISearchAPIConfig = {}): PluginDescriptor<AISearchAPIConfig> {
+	return {
+		id: "ai-search-api",
+		version: "1.0.0",
+		entrypoint: "@emdash-cms/plugin-ai-search",
+		options: config,
+		capabilities: ["read:content"],
+		adminEntry: "@emdash-cms/plugin-ai-search/admin",
+		adminPages: [{ path: "/settings", label: "AI Search (API)", icon: "magnifying-glass" }],
+	};
+}
+
+// =============================================================================
+// Plugin implementation (loaded at runtime via entrypoint)
+// =============================================================================
+
+export function createPlugin(config: AISearchAPIConfig = {}): ResolvedPlugin {
+	const namespace = config.namespace ?? "default";
+	const instanceName = config.instanceName ?? "emdash-content";
+	const targetCollections = config.collections;
+	const hybridSearch = config.hybridSearch ?? true;
+
+	async function getClient(kv: PluginContext["kv"]): Promise<AISearchClient | null> {
+		const { accountId, apiToken } = await resolveCredentials(config, kv);
+		if (!accountId || !apiToken) return null;
+		return new AISearchClient(accountId, apiToken, namespace, instanceName);
+	}
+
+	async function ensureInstance(client: AISearchClient, kv: PluginContext["kv"]): Promise<void> {
+		const exists = await client.instanceExists();
+		if (exists) return;
+
+		const { accountId } = await resolveCredentials(config, kv);
+		await client.createInstance(accountId, namespace, {
+			id: instanceName,
+			hybrid_search_enabled: hybridSearch,
+			custom_metadata: [
+				{ field_name: "visible_after", data_type: "number" },
+				{ field_name: "published_at", data_type: "number" },
+			],
+		});
+	}
+
+	/**
+	 * Index a content item in AI Search.
+	 *
+	 * @param visibleAfter Unix timestamp (seconds) when the content becomes
+	 *   visible. Use 0 for already-published content. For scheduled content,
+	 *   pass the `scheduled_at` timestamp so the query filter
+	 *   `visible_after <= now` excludes it until the scheduled time.
+	 */
+	async function indexContent(
+		content: Record<string, unknown>,
+		collection: string,
+		ctx: PluginContext,
+		visibleAfter: number = 0,
+	): Promise<void> {
+		const client = await getClient(ctx.kv);
+		if (!client) {
+			console.warn("[ai-search-api] indexContent: credentials not available");
+			return;
+		}
+
+		const key = contentKey(collection, String(content.id));
+		try {
+			await ensureInstance(client, ctx.kv);
+			const markdown = contentToMarkdown(content, collection);
+			if (!markdown.trim()) return;
+
+			const slug = typeof content.slug === "string" ? content.slug : "";
+			const title = typeof content.title === "string" ? content.title : "";
+
+			// Resolve published_at timestamp for recency boosting.
+			// Hooks provide publishedAt at top level; reindex merges item + item.data.
+			const pubRaw = content.publishedAt ?? content.published_at;
+			const pubMs = typeof pubRaw === "string" ? new Date(pubRaw).getTime() : 0;
+
+			const metadata: Record<string, string> = {
+				visible_after: String(visibleAfter),
+			};
+			if (pubMs > 0) metadata.published_at = String(pubMs);
+
+			const item = await client.uploadItem(key, markdown, metadata);
+
+			await ctx.kv.set(`item:${key}`, item.id);
+			await ctx.kv.set(`meta:${key}`, JSON.stringify({ collection, slug, title }));
+			console.log(`[ai-search-api] Indexed ${key} (item: ${item.id})`);
+		} catch (error) {
+			console.error("[ai-search-api] Error indexing content:", error);
+		}
+	}
+
+	/** Remove a content item from the AI Search index. */
+	async function removeFromIndex(
+		collection: string,
+		id: string,
+		ctx: PluginContext,
+	): Promise<void> {
+		const client = await getClient(ctx.kv);
+		if (!client) return;
+
+		const key = contentKey(collection, id);
+		try {
+			const itemId = await ctx.kv.get<string>(`item:${key}`);
+			if (!itemId) return;
+
+			await ensureInstance(client, ctx.kv);
+			await client.deleteItem(itemId);
+			await ctx.kv.delete(`item:${key}`);
+			await ctx.kv.delete(`meta:${key}`);
+			console.log(`[ai-search-api] Removed ${key} (item: ${itemId})`);
+		} catch (error) {
+			console.error("[ai-search-api] Error removing content:", error);
+		}
+	}
+
+	/** Reindex the given collections. Shared by the reindex route and the install hook. */
+	async function reindexCollections(
+		collections: string[],
+		ctx: PluginContext,
+	): Promise<{ indexed: number; errors: number }> {
+		const client = await getClient(ctx.kv);
+		if (!client) {
+			console.warn("[ai-search-api] Reindex: credentials not available");
+			return { indexed: 0, errors: 0 };
+		}
+		if (!ctx.content) {
+			console.warn("[ai-search-api] Reindex: content access not available");
+			return { indexed: 0, errors: 0 };
+		}
+
+		await ensureInstance(client, ctx.kv);
+		let indexed = 0;
+		let errors = 0;
+
+		for (const collection of collections) {
+			let cursor: string | undefined;
+			do {
+				const page = await ctx.content.list(collection, {
+					limit: 50,
+					cursor,
+				});
+
+				for (const item of page.items) {
+					try {
+						const status = typeof item.status === "string" ? item.status : "";
+						if (status !== "published" && status !== "scheduled") continue;
+
+						const record = { ...item, ...item.data };
+						const markdown = contentToMarkdown(record, collection);
+						if (!markdown.trim()) continue;
+
+						const key = contentKey(collection, item.id);
+						const slug = typeof item.slug === "string" ? item.slug : "";
+						const title = typeof item.data.title === "string" ? item.data.title : "";
+						const visibleAfter = getVisibleAfter(record);
+
+						const pubRaw = item.publishedAt;
+						const pubMs = typeof pubRaw === "string" ? new Date(pubRaw).getTime() : 0;
+
+						const metadata: Record<string, string> = {
+							visible_after: String(visibleAfter),
+						};
+						if (pubMs > 0) metadata.published_at = String(pubMs);
+
+						const uploaded = await client.uploadItem(key, markdown, metadata);
+
+						await ctx.kv.set(`item:${key}`, uploaded.id);
+						await ctx.kv.set(`meta:${key}`, JSON.stringify({ collection, slug, title }));
+						indexed++;
+					} catch (error) {
+						console.error(`[ai-search-api] Failed to index ${collection}/${item.id}:`, error);
+						errors++;
+					}
+				}
+
+				cursor = page.cursor;
+			} while (cursor);
+		}
+
+		return { indexed, errors };
+	}
+
+	return definePlugin({
+		id: "ai-search-api",
+		version: "1.0.0",
+		capabilities: ["read:content"],
+		admin: {
+			entry: "@emdash-cms/plugin-ai-search/admin",
+			pages: [{ path: "/settings", label: "AI Search (API)", icon: "magnifying-glass" }],
+		},
+
+		hooks: {
+			"plugin:install": {
+				handler: async (_event: unknown, ctx: PluginContext): Promise<void> => {
+					const collections = targetCollections ?? ["posts", "pages"];
+					console.log(`[ai-search-api] Plugin installed, indexing: ${collections.join(", ")}`);
+					const result = await reindexCollections(collections, ctx);
+					console.log(
+						`[ai-search-api] Initial index complete: ${result.indexed} indexed, ${result.errors} errors`,
+					);
+				},
+			},
+
+			"content:afterSave": {
+				handler: (event: ContentHookEvent, ctx: PluginContext): Promise<void> => {
+					const { content, collection } = event;
+					if (targetCollections && !targetCollections.includes(collection))
+						return Promise.resolve();
+
+					const status = typeof content.status === "string" ? content.status : "";
+
+					// Index published and scheduled content. Published content is
+					// visible immediately (visible_after=0). Scheduled content is
+					// indexed now but filtered out at query time until its
+					// scheduled_at timestamp passes. Drafts are not indexed.
+					if (status === "published") {
+						return indexContent(content, collection, ctx, 0);
+					} else if (status === "scheduled") {
+						return indexContent(content, collection, ctx, getVisibleAfter(content));
+					}
+					return Promise.resolve();
+				},
+			},
+
+			"content:afterPublish": {
+				handler: (event: ContentPublishStateChangeEvent, ctx: PluginContext): Promise<void> => {
+					const { content, collection } = event;
+					if (targetCollections && !targetCollections.includes(collection))
+						return Promise.resolve();
+
+					return indexContent(content, collection, ctx);
+				},
+			},
+
+			"content:afterUnpublish": {
+				handler: (event: ContentPublishStateChangeEvent, ctx: PluginContext): Promise<void> => {
+					const { content, collection } = event;
+					if (targetCollections && !targetCollections.includes(collection))
+						return Promise.resolve();
+
+					return removeFromIndex(collection, String(content.id), ctx);
+				},
+			},
+
+			"content:afterDelete": {
+				handler: (event: ContentDeleteEvent, ctx: PluginContext): Promise<void> => {
+					const { id, collection } = event;
+					if (targetCollections && !targetCollections.includes(collection))
+						return Promise.resolve();
+
+					return removeFromIndex(collection, id, ctx);
+				},
+			},
+		},
+
+		routes: {
+			query: {
+				public: true,
+				handler: async (ctx: RouteContext): Promise<unknown> => {
+					const start = Date.now();
+
+					// Support both JSON body input and URL query params (for GET requests)
+					const input = ctx.input as Record<string, unknown> | undefined;
+					const url = new URL(ctx.request.url);
+					const params = url.searchParams;
+
+					const client = await getClient(ctx.kv);
+					if (!client) {
+						console.warn("[ai-search-api] Query failed: credentials not available");
+						return {
+							error: "AI Search API credentials not configured",
+							results: [],
+						};
+					}
+
+					const q =
+						(typeof input?.q === "string" ? input.q : undefined) ?? params.get("q") ?? undefined;
+					if (!q) {
+						return { error: "Query parameter 'q' is required", results: [] };
+					}
+
+					const limit =
+						(typeof input?.limit === "number" ? input.limit : undefined) ??
+						(params.has("limit") ? Number(params.get("limit")) : undefined) ??
+						10;
+					const collection =
+						(typeof input?.collection === "string" ? input.collection : undefined) ??
+						params.get("collection") ??
+						undefined;
+
+					console.log(
+						`[ai-search-api] Query: q=${JSON.stringify(q)} limit=${limit} collection=${collection ?? "all"}`,
+					);
+
+					try {
+						await ensureInstance(client, ctx.kv);
+						const nowSeconds = Math.floor(Date.now() / 1000);
+
+						const response = await client.search({
+							messages: [{ role: "user", content: q }],
+							ai_search_options: {
+								retrieval: {
+									max_num_results: limit,
+									filters: {
+										visible_after: { $lte: nowSeconds },
+									},
+								},
+							},
+						});
+
+						let chunks = response.chunks;
+						if (collection) {
+							const cols = collection.split(",").map((c) => c.trim());
+							chunks = chunks.filter((c) => cols.some((col) => c.item.key.startsWith(`${col}/`)));
+						}
+
+						// Deduplicate by item key, keeping the highest-scoring chunk per item
+						const bestByKey = new Map<string, (typeof chunks)[number]>();
+						for (const c of chunks) {
+							const existing = bestByKey.get(c.item.key);
+							if (!existing || c.score > existing.score) {
+								bestByKey.set(c.item.key, c);
+							}
+						}
+						const uniqueChunks = [...bestByKey.values()];
+
+						// Look up stored metadata (slug, title) for each result.
+						const results = await Promise.all(
+							uniqueChunks.map(async (c) => {
+								const parsed = parseContentKey(c.item.key);
+								let slug: string | null = null;
+								let title: string | null = null;
+								try {
+									const raw = await ctx.kv.get<string>(`meta:${c.item.key}`);
+									if (raw) {
+										const meta = JSON.parse(raw) as {
+											slug?: string;
+											title?: string;
+										};
+										slug = meta.slug || null;
+										title = meta.title || null;
+									}
+								} catch {
+									// KV lookup failed, fall back to parsed key
+								}
+								return {
+									...parsed,
+									slug,
+									title,
+									score: c.score,
+									snippet: c.text,
+								};
+							}),
+						);
+
+						const elapsed = Date.now() - start;
+						console.log(
+							`[ai-search-api] Query complete: ${results.length} results in ${elapsed}ms (rewritten: ${JSON.stringify(response.search_query)})`,
+						);
+						return { query: response.search_query, results };
+					} catch (error) {
+						const elapsed = Date.now() - start;
+						console.error(`[ai-search-api] Query failed after ${elapsed}ms:`, error);
+						return {
+							error: error instanceof Error ? error.message : "Search failed",
+							results: [],
+						};
+					}
+				},
+			},
+
+			reindex: {
+				handler: async (ctx: RouteContext): Promise<unknown> => {
+					const start = Date.now();
+
+					if (!ctx.content) {
+						return { error: "Content access not available" };
+					}
+
+					const input = ctx.input as Record<string, unknown> | undefined;
+					const requestedCollections =
+						typeof input?.collections === "string"
+							? input.collections.split(",").map((c: string) => c.trim())
+							: Array.isArray(input?.collections)
+								? (input.collections as string[])
+								: undefined;
+					const collections = targetCollections ?? requestedCollections ?? [];
+
+					if (collections.length === 0) {
+						return {
+							error: "No collections specified. Pass collections in the request or plugin config.",
+						};
+					}
+
+					try {
+						console.log(
+							`[ai-search-api] Reindex started for collections: ${collections.join(", ")}`,
+						);
+						const result = await reindexCollections(collections, ctx);
+						const elapsed = Date.now() - start;
+						console.log(
+							`[ai-search-api] Reindex complete: ${result.indexed} indexed, ${result.errors} errors in ${elapsed}ms`,
+						);
+						return { ...result, collections };
+					} catch (error) {
+						const elapsed = Date.now() - start;
+						console.error(`[ai-search-api] Reindex failed after ${elapsed}ms:`, error);
+						return {
+							error: error instanceof Error ? error.message : "Reindex failed",
+						};
+					}
+				},
+			},
+
+			/**
+			 * Returns the current credential status without exposing secrets.
+			 * The admin UI uses this to decide whether to show the credentials form.
+			 */
+			status: {
+				handler: async (ctx: RouteContext): Promise<unknown> => {
+					const creds = await resolveCredentials(config, ctx.kv);
+					return {
+						configured: creds.source !== "none",
+						source: creds.source,
+						// Mask the account ID — show enough to identify it
+						accountId: creds.accountId
+							? `${creds.accountId.slice(0, 6)}...${creds.accountId.slice(-4)}`
+							: null,
+						namespace,
+						instanceName,
+					};
+				},
+			},
+
+			/**
+			 * Validate and save Cloudflare credentials to plugin KV.
+			 * On success, triggers a full reindex.
+			 */
+			credentials: {
+				handler: async (ctx: RouteContext): Promise<unknown> => {
+					const input = ctx.input as Record<string, unknown> | undefined;
+					const accountId = typeof input?.accountId === "string" ? input.accountId.trim() : "";
+					const apiToken = typeof input?.apiToken === "string" ? input.apiToken.trim() : "";
+
+					if (!accountId || !apiToken) {
+						return { error: "Both accountId and apiToken are required" };
+					}
+
+					// Validate credentials against the API
+					const validation = await validateCredentials(accountId, apiToken);
+					if (!validation.valid) {
+						return {
+							error: validation.error ?? "Invalid credentials",
+							valid: false,
+						};
+					}
+
+					// Save to KV
+					await ctx.kv.set(KV_ACCOUNT_ID, accountId);
+					await ctx.kv.set(KV_API_TOKEN, apiToken);
+					console.log(`[ai-search-api] Credentials saved (account: ${accountId.slice(0, 6)}...)`);
+
+					// Trigger reindex
+					const collections = targetCollections ?? ["posts", "pages"];
+					console.log(
+						`[ai-search-api] Starting reindex after credential save: ${collections.join(", ")}`,
+					);
+					const result = await reindexCollections(collections, ctx);
+					console.log(
+						`[ai-search-api] Post-save reindex: ${result.indexed} indexed, ${result.errors} errors`,
+					);
+
+					return {
+						valid: true,
+						saved: true,
+						reindex: result,
+					};
+				},
+			},
+		},
+	});
+}
+
+export default createPlugin;
diff --git a/packages/plugins/ai-search/tsconfig.json b/packages/plugins/ai-search/tsconfig.json
new file mode 100644
index 000000000..06d2c66b7
--- /dev/null
+++ b/packages/plugins/ai-search/tsconfig.json
@@ -0,0 +1,10 @@
+{
+	"extends": "../tsconfig.base.json",
+	"compilerOptions": {
+		"outDir": "./dist",
+		"rootDir": "./src",
+		"types": ["vite/client"]
+	},
+	"include": ["src/**/*"],
+	"exclude": ["node_modules", "dist", "src/admin.tsx"]
+}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index c2542f815..4ac16ebcd 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -113,7 +113,7 @@ catalogs:
       version: 6.0.1
     better-sqlite3:
       specifier: ^12.8.0
-      version: 12.8.0
+      version: 12.9.0
     publint:
       specifier: 0.3.17
       version: 0.3.17
@@ -303,7 +303,7 @@ importers:
         version: 6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@5.9.3)(yaml@2.8.2)
       better-sqlite3:
         specifier: 'catalog:'
-        version: 12.8.0
+        version: 12.9.0
       emdash:
         specifier: workspace:*
         version: link:../../packages/core
@@ -414,7 +414,44 @@ importers:
         version: 6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@6.0.0-beta)(yaml@2.8.2)
       better-sqlite3:
         specifier: 'catalog:'
-        version: 12.8.0
+        version: 12.9.0
+      emdash:
+        specifier: workspace:*
+        version: link:../../packages/core
+      react:
+        specifier: 'catalog:'
+        version: 19.2.4
+      react-dom:
+        specifier: 'catalog:'
+        version: 19.2.4(react@19.2.4)
+    devDependencies:
+      '@astrojs/check':
+        specifier: 'catalog:'
+        version: 0.9.7(prettier-plugin-astro@0.14.1)(prettier@3.8.1)(typescript@6.0.0-beta)
+
+  demos/simple-ai-search:
+    dependencies:
+      '@astrojs/node':
+        specifier: 'catalog:'
+        version: 10.0.0(astro@6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@6.0.0-beta)(yaml@2.8.2))
+      '@astrojs/react':
+        specifier: 'catalog:'
+        version: 5.0.0(@types/node@24.10.13)(@types/react-dom@19.2.3(@types/react@19.2.14))(@types/react@19.2.14)(jiti@2.6.1)(lightningcss@1.31.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(tsx@4.21.0)(yaml@2.8.2)
+      '@emdash-cms/plugin-ai-search':
+        specifier: workspace:*
+        version: link:../../packages/plugins/ai-search
+      '@emdash-cms/plugin-audit-log':
+        specifier: workspace:*
+        version: link:../../packages/plugins/audit-log
+      '@emdash-cms/plugin-color':
+        specifier: workspace:*
+        version: link:../../packages/plugins/color
+      astro:
+        specifier: 'catalog:'
+        version: 6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@6.0.0-beta)(yaml@2.8.2)
+      better-sqlite3:
+        specifier: 'catalog:'
+        version: 12.9.0
       emdash:
         specifier: workspace:*
         version: link:../../packages/core
@@ -475,7 +512,7 @@ importers:
         version: 6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@5.9.3)(yaml@2.8.2)
       better-sqlite3:
         specifier: 'catalog:'
-        version: 12.8.0
+        version: 12.9.0
       emdash:
         specifier: workspace:*
         version: link:../../packages/core
@@ -714,7 +751,7 @@ importers:
     dependencies:
       '@cloudflare/kumo':
         specifier: ^1.10.0
-        version: 1.10.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)
+        version: 1.16.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)
       '@phosphor-icons/react':
         specifier: 'catalog:'
         version: 2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
@@ -769,7 +806,7 @@ importers:
     dependencies:
       '@cloudflare/kumo':
         specifier: ^1.1.0
-        version: 1.10.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)
+        version: 1.16.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)
       '@emdash-cms/blocks':
         specifier: workspace:*
         version: link:..
@@ -835,9 +872,18 @@ importers:
       '@cloudflare/workers-types':
         specifier: 'catalog:'
         version: 4.20260305.1
+      '@phosphor-icons/react':
+        specifier: 'catalog:'
+        version: 2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
+      '@types/react':
+        specifier: 'catalog:'
+        version: 19.2.14
       publint:
         specifier: 'catalog:'
         version: 0.3.17
+      react:
+        specifier: 'catalog:'
+        version: 19.2.4
       tsdown:
         specifier: 'catalog:'
         version: 0.20.3(@arethetypeswrong/core@0.18.2)(@typescript/native-preview@7.0.0-dev.20260213.1)(oxc-resolver@11.16.4)(publint@0.3.17)(typescript@5.9.3)
@@ -924,7 +970,7 @@ importers:
         version: 0.11.4(astro@6.1.3(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@5.9.3)(yaml@2.8.2))
       better-sqlite3:
         specifier: 'catalog:'
-        version: 12.8.0
+        version: 12.9.0
       blurhash:
         specifier: ^2.0.5
         version: 2.0.5
@@ -1100,7 +1146,7 @@ importers:
         version: 24.10.13
       better-sqlite3:
         specifier: 'catalog:'
-        version: 12.8.0
+        version: 12.9.0
       typescript:
         specifier: 'catalog:'
         version: 5.9.3
@@ -1115,7 +1161,7 @@ importers:
     dependencies:
       '@cloudflare/kumo':
         specifier: ^1.0.0
-        version: 1.10.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)
+        version: 1.16.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)
       '@phosphor-icons/react':
         specifier: ^2.1.10
         version: 2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
@@ -1136,6 +1182,25 @@ importers:
         specifier: 'catalog:'
         version: 4.0.18(@types/node@24.10.13)(@vitest/browser-playwright@4.0.18)(jiti@2.6.1)(jsdom@26.1.0)(lightningcss@1.31.1)(tsx@4.21.0)(yaml@2.8.2)
 
+  packages/plugins/ai-search:
+    dependencies:
+      '@cloudflare/kumo':
+        specifier: ^1.0.0
+        version: 1.16.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)
+      '@phosphor-icons/react':
+        specifier: ^2.1.10
+        version: 2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
+      emdash:
+        specifier: workspace:>=0.1.0
+        version: link:../../core
+      react:
+        specifier: ^18.0.0 || ^19.0.0
+        version: 19.2.4
+    devDependencies:
+      vite:
+        specifier: ^6.0.0
+        version: 6.4.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)(yaml@2.8.2)
+
   packages/plugins/api-test:
     dependencies:
       '@phosphor-icons/react':
@@ -1209,7 +1274,7 @@ importers:
     dependencies:
       '@cloudflare/kumo':
         specifier: ^1.0.0
-        version: 1.10.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)
+        version: 1.16.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)
       '@phosphor-icons/react':
         specifier: ^2.1.10
         version: 2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
@@ -1310,7 +1375,7 @@ importers:
         version: 6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@6.0.0-beta)(yaml@2.8.2)
       better-sqlite3:
         specifier: 'catalog:'
-        version: 12.8.0
+        version: 12.9.0
       emdash:
         specifier: workspace:*
         version: link:../../packages/core
@@ -1341,7 +1406,7 @@ importers:
         version: 6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@6.0.0-beta)(yaml@2.8.2)
       better-sqlite3:
         specifier: 'catalog:'
-        version: 12.8.0
+        version: 12.9.0
       emdash:
         specifier: workspace:*
         version: link:../../packages/core
@@ -1409,7 +1474,7 @@ importers:
         version: 6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@6.0.0-beta)(yaml@2.8.2)
       better-sqlite3:
         specifier: 'catalog:'
-        version: 12.8.0
+        version: 12.9.0
       emdash:
         specifier: workspace:*
         version: link:../../packages/core
@@ -1471,7 +1536,7 @@ importers:
         version: 6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@6.0.0-beta)(yaml@2.8.2)
       better-sqlite3:
         specifier: 'catalog:'
-        version: 12.8.0
+        version: 12.9.0
       emdash:
         specifier: workspace:*
         version: link:../../packages/core
@@ -1533,7 +1598,7 @@ importers:
         version: 6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@6.0.0-beta)(yaml@2.8.2)
       better-sqlite3:
         specifier: 'catalog:'
-        version: 12.8.0
+        version: 12.9.0
       emdash:
         specifier: workspace:*
         version: link:../../packages/core
@@ -1884,6 +1949,10 @@ packages:
     resolution: {integrity: sha512-05WQkdpL9COIMz4LjTxGpPNCdlpyimKppYNoJ5Di5EUObifl8t4tuLuUBBZEpoLYOmfvIWrsp9fCl0HoPRVTdA==}
     engines: {node: '>=6.9.0'}
 
+  '@babel/runtime@7.29.2':
+    resolution: {integrity: sha512-JiDShH45zKHWyGe4ZNVRrCjBz8Nh9TMmZG1kh4QTK8hCBTWBi8Da+i7s1fJw7/lYpM4ccepSNfqzZ/QvABBi5g==}
+    engines: {node: '>=6.9.0'}
+
   '@babel/template@7.28.6':
     resolution: {integrity: sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==}
     engines: {node: '>=6.9.0'}
@@ -2001,19 +2070,6 @@ packages:
   '@clack/prompts@1.1.0':
     resolution: {integrity: sha512-pkqbPGtohJAvm4Dphs2M8xE29ggupihHdy1x84HNojZuMtFsHiUlRvqD24tM2+XmI+61LlfNceM3Wr7U5QES5g==}
 
-  '@cloudflare/kumo@1.10.0':
-    resolution: {integrity: sha512-6Q89+LqUsBUxEmFe6mBPruKsIFviUqkXYi5DvRaIWDgSeFjLKEISVosHeu8Ufecs9MLg6vBV3xtYjjTSddqMOg==}
-    hasBin: true
-    peerDependencies:
-      '@phosphor-icons/react': ^2.1.10
-      echarts: ^6.0.0
-      react: ^18.0.0 || ^19.0.0
-      react-dom: ^18.0.0 || ^19.0.0
-      zod: ^4.0.0
-    peerDependenciesMeta:
-      zod:
-        optional: true
-
   '@cloudflare/kumo@1.16.0':
     resolution: {integrity: sha512-uCrj7jGPvdXj8lrdQBfMGKzV3JTDi7hUBsLf4jpirD7QHvZMsGe6XuU+KKvQFqDTmj5ELXQVES4YVoducxZ7Tg==}
     hasBin: true
@@ -2049,11 +2105,11 @@ packages:
       workerd:
         optional: true
 
-  '@cloudflare/vite-plugin@1.26.1':
-    resolution: {integrity: sha512-CyebmOYAjnobU9DCn/4cUb3xipWSsqCQO+Syc0AteEl7q/A72RTvs2PHQt/O8Qj6hUutslQbmvswdL5KuDwuhw==}
+  '@cloudflare/vite-plugin@1.31.0':
+    resolution: {integrity: sha512-wkIoqOTVltHMsl8Zpt2bcndbdf+w7czICJ8SbxQq+VzvGprf8glJt5y7iyMCj9YeofkUdsR6AlyTZvZ8kpx0FQ==}
     peerDependencies:
-      vite: ^6.1.0 || ^7.0.0
-      wrangler: ^4.71.0
+      vite: ^6.1.0 || ^7.0.0 || ^8.0.0
+      wrangler: ^4.80.0
 
   '@cloudflare/workerd-darwin-64@1.20260301.1':
     resolution: {integrity: sha512-+kJvwociLrvy1JV9BAvoSVsMEIYD982CpFmo/yMEvBwxDIjltYsLTE8DLi0mCkGsQ8Ygidv2fD9wavzXeiY7OQ==}
@@ -2236,6 +2292,12 @@ packages:
     cpu: [ppc64]
     os: [aix]
 
+  '@esbuild/aix-ppc64@0.27.7':
+    resolution: {integrity: sha512-EKX3Qwmhz1eMdEJokhALr0YiD0lhQNwDqkPYyPhiSwKrh7/4KRjQc04sZ8db+5DVVnZ1LmbNDI1uAMPEUBnQPg==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
   '@esbuild/android-arm64@0.25.12':
     resolution: {integrity: sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==}
     engines: {node: '>=18'}
@@ -2248,6 +2310,12 @@ packages:
     cpu: [arm64]
     os: [android]
 
+  '@esbuild/android-arm64@0.27.7':
+    resolution: {integrity: sha512-62dPZHpIXzvChfvfLJow3q5dDtiNMkwiRzPylSCfriLvZeq0a1bWChrGx/BbUbPwOrsWKMn8idSllklzBy+dgQ==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
   '@esbuild/android-arm@0.25.12':
     resolution: {integrity: sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==}
     engines: {node: '>=18'}
@@ -2260,6 +2328,12 @@ packages:
     cpu: [arm]
     os: [android]
 
+  '@esbuild/android-arm@0.27.7':
+    resolution: {integrity: sha512-jbPXvB4Yj2yBV7HUfE2KHe4GJX51QplCN1pGbYjvsyCZbQmies29EoJbkEc+vYuU5o45AfQn37vZlyXy4YJ8RQ==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
   '@esbuild/android-x64@0.25.12':
     resolution: {integrity: sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==}
     engines: {node: '>=18'}
@@ -2272,6 +2346,12 @@ packages:
     cpu: [x64]
     os: [android]
 
+  '@esbuild/android-x64@0.27.7':
+    resolution: {integrity: sha512-x5VpMODneVDb70PYV2VQOmIUUiBtY3D3mPBG8NxVk5CogneYhkR7MmM3yR/uMdITLrC1ml/NV1rj4bMJuy9MCg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
   '@esbuild/darwin-arm64@0.25.12':
     resolution: {integrity: sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==}
     engines: {node: '>=18'}
@@ -2284,6 +2364,12 @@ packages:
     cpu: [arm64]
     os: [darwin]
 
+  '@esbuild/darwin-arm64@0.27.7':
+    resolution: {integrity: sha512-5lckdqeuBPlKUwvoCXIgI2D9/ABmPq3Rdp7IfL70393YgaASt7tbju3Ac+ePVi3KDH6N2RqePfHnXkaDtY9fkw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
   '@esbuild/darwin-x64@0.25.12':
     resolution: {integrity: sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==}
     engines: {node: '>=18'}
@@ -2296,6 +2382,12 @@ packages:
     cpu: [x64]
     os: [darwin]
 
+  '@esbuild/darwin-x64@0.27.7':
+    resolution: {integrity: sha512-rYnXrKcXuT7Z+WL5K980jVFdvVKhCHhUwid+dDYQpH+qu+TefcomiMAJpIiC2EM3Rjtq0sO3StMV/+3w3MyyqQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
   '@esbuild/freebsd-arm64@0.25.12':
     resolution: {integrity: sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==}
     engines: {node: '>=18'}
@@ -2308,6 +2400,12 @@ packages:
     cpu: [arm64]
     os: [freebsd]
 
+  '@esbuild/freebsd-arm64@0.27.7':
+    resolution: {integrity: sha512-B48PqeCsEgOtzME2GbNM2roU29AMTuOIN91dsMO30t+Ydis3z/3Ngoj5hhnsOSSwNzS+6JppqWsuhTp6E82l2w==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
   '@esbuild/freebsd-x64@0.25.12':
     resolution: {integrity: sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==}
     engines: {node: '>=18'}
@@ -2320,6 +2418,12 @@ packages:
     cpu: [x64]
     os: [freebsd]
 
+  '@esbuild/freebsd-x64@0.27.7':
+    resolution: {integrity: sha512-jOBDK5XEjA4m5IJK3bpAQF9/Lelu/Z9ZcdhTRLf4cajlB+8VEhFFRjWgfy3M1O4rO2GQ/b2dLwCUGpiF/eATNQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
   '@esbuild/linux-arm64@0.25.12':
     resolution: {integrity: sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==}
     engines: {node: '>=18'}
@@ -2332,6 +2436,12 @@ packages:
     cpu: [arm64]
     os: [linux]
 
+  '@esbuild/linux-arm64@0.27.7':
+    resolution: {integrity: sha512-RZPHBoxXuNnPQO9rvjh5jdkRmVizktkT7TCDkDmQ0W2SwHInKCAV95GRuvdSvA7w4VMwfCjUiPwDi0ZO6Nfe9A==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
   '@esbuild/linux-arm@0.25.12':
     resolution: {integrity: sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==}
     engines: {node: '>=18'}
@@ -2344,6 +2454,12 @@ packages:
     cpu: [arm]
     os: [linux]
 
+  '@esbuild/linux-arm@0.27.7':
+    resolution: {integrity: sha512-RkT/YXYBTSULo3+af8Ib0ykH8u2MBh57o7q/DAs3lTJlyVQkgQvlrPTnjIzzRPQyavxtPtfg0EopvDyIt0j1rA==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
   '@esbuild/linux-ia32@0.25.12':
     resolution: {integrity: sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==}
     engines: {node: '>=18'}
@@ -2356,6 +2472,12 @@ packages:
     cpu: [ia32]
     os: [linux]
 
+  '@esbuild/linux-ia32@0.27.7':
+    resolution: {integrity: sha512-GA48aKNkyQDbd3KtkplYWT102C5sn/EZTY4XROkxONgruHPU72l+gW+FfF8tf2cFjeHaRbWpOYa/uRBz/Xq1Pg==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
   '@esbuild/linux-loong64@0.25.12':
     resolution: {integrity: sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==}
     engines: {node: '>=18'}
@@ -2368,6 +2490,12 @@ packages:
     cpu: [loong64]
     os: [linux]
 
+  '@esbuild/linux-loong64@0.27.7':
+    resolution: {integrity: sha512-a4POruNM2oWsD4WKvBSEKGIiWQF8fZOAsycHOt6JBpZ+JN2n2JH9WAv56SOyu9X5IqAjqSIPTaJkqN8F7XOQ5Q==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
   '@esbuild/linux-mips64el@0.25.12':
     resolution: {integrity: sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==}
     engines: {node: '>=18'}
@@ -2380,6 +2508,12 @@ packages:
     cpu: [mips64el]
     os: [linux]
 
+  '@esbuild/linux-mips64el@0.27.7':
+    resolution: {integrity: sha512-KabT5I6StirGfIz0FMgl1I+R1H73Gp0ofL9A3nG3i/cYFJzKHhouBV5VWK1CSgKvVaG4q1RNpCTR2LuTVB3fIw==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
   '@esbuild/linux-ppc64@0.25.12':
     resolution: {integrity: sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==}
     engines: {node: '>=18'}
@@ -2392,6 +2526,12 @@ packages:
     cpu: [ppc64]
     os: [linux]
 
+  '@esbuild/linux-ppc64@0.27.7':
+    resolution: {integrity: sha512-gRsL4x6wsGHGRqhtI+ifpN/vpOFTQtnbsupUF5R5YTAg+y/lKelYR1hXbnBdzDjGbMYjVJLJTd2OFmMewAgwlQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
   '@esbuild/linux-riscv64@0.25.12':
     resolution: {integrity: sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==}
     engines: {node: '>=18'}
@@ -2404,6 +2544,12 @@ packages:
     cpu: [riscv64]
     os: [linux]
 
+  '@esbuild/linux-riscv64@0.27.7':
+    resolution: {integrity: sha512-hL25LbxO1QOngGzu2U5xeXtxXcW+/GvMN3ejANqXkxZ/opySAZMrc+9LY/WyjAan41unrR3YrmtTsUpwT66InQ==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
   '@esbuild/linux-s390x@0.25.12':
     resolution: {integrity: sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==}
     engines: {node: '>=18'}
@@ -2416,6 +2562,12 @@ packages:
     cpu: [s390x]
     os: [linux]
 
+  '@esbuild/linux-s390x@0.27.7':
+    resolution: {integrity: sha512-2k8go8Ycu1Kb46vEelhu1vqEP+UeRVj2zY1pSuPdgvbd5ykAw82Lrro28vXUrRmzEsUV0NzCf54yARIK8r0fdw==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
   '@esbuild/linux-x64@0.25.12':
     resolution: {integrity: sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==}
     engines: {node: '>=18'}
@@ -2428,6 +2580,12 @@ packages:
     cpu: [x64]
     os: [linux]
 
+  '@esbuild/linux-x64@0.27.7':
+    resolution: {integrity: sha512-hzznmADPt+OmsYzw1EE33ccA+HPdIqiCRq7cQeL1Jlq2gb1+OyWBkMCrYGBJ+sxVzve2ZJEVeePbLM2iEIZSxA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
   '@esbuild/netbsd-arm64@0.25.12':
     resolution: {integrity: sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==}
     engines: {node: '>=18'}
@@ -2440,6 +2598,12 @@ packages:
     cpu: [arm64]
     os: [netbsd]
 
+  '@esbuild/netbsd-arm64@0.27.7':
+    resolution: {integrity: sha512-b6pqtrQdigZBwZxAn1UpazEisvwaIDvdbMbmrly7cDTMFnw/+3lVxxCTGOrkPVnsYIosJJXAsILG9XcQS+Yu6w==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [netbsd]
+
   '@esbuild/netbsd-x64@0.25.12':
     resolution: {integrity: sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==}
     engines: {node: '>=18'}
@@ -2452,6 +2616,12 @@ packages:
     cpu: [x64]
     os: [netbsd]
 
+  '@esbuild/netbsd-x64@0.27.7':
+    resolution: {integrity: sha512-OfatkLojr6U+WN5EDYuoQhtM+1xco+/6FSzJJnuWiUw5eVcicbyK3dq5EeV/QHT1uy6GoDhGbFpprUiHUYggrw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
   '@esbuild/openbsd-arm64@0.25.12':
     resolution: {integrity: sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==}
     engines: {node: '>=18'}
@@ -2464,6 +2634,12 @@ packages:
     cpu: [arm64]
     os: [openbsd]
 
+  '@esbuild/openbsd-arm64@0.27.7':
+    resolution: {integrity: sha512-AFuojMQTxAz75Fo8idVcqoQWEHIXFRbOc1TrVcFSgCZtQfSdc1RXgB3tjOn/krRHENUB4j00bfGjyl2mJrU37A==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
   '@esbuild/openbsd-x64@0.25.12':
     resolution: {integrity: sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==}
     engines: {node: '>=18'}
@@ -2476,6 +2652,12 @@ packages:
     cpu: [x64]
     os: [openbsd]
 
+  '@esbuild/openbsd-x64@0.27.7':
+    resolution: {integrity: sha512-+A1NJmfM8WNDv5CLVQYJ5PshuRm/4cI6WMZRg1by1GwPIQPCTs1GLEUHwiiQGT5zDdyLiRM/l1G0Pv54gvtKIg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
   '@esbuild/openharmony-arm64@0.25.12':
     resolution: {integrity: sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==}
     engines: {node: '>=18'}
@@ -2488,6 +2670,12 @@ packages:
     cpu: [arm64]
     os: [openharmony]
 
+  '@esbuild/openharmony-arm64@0.27.7':
+    resolution: {integrity: sha512-+KrvYb/C8zA9CU/g0sR6w2RBw7IGc5J2BPnc3dYc5VJxHCSF1yNMxTV5LQ7GuKteQXZtspjFbiuW5/dOj7H4Yw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openharmony]
+
   '@esbuild/sunos-x64@0.25.12':
     resolution: {integrity: sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==}
     engines: {node: '>=18'}
@@ -2500,6 +2688,12 @@ packages:
     cpu: [x64]
     os: [sunos]
 
+  '@esbuild/sunos-x64@0.27.7':
+    resolution: {integrity: sha512-ikktIhFBzQNt/QDyOL580ti9+5mL/YZeUPKU2ivGtGjdTYoqz6jObj6nOMfhASpS4GU4Q/Clh1QtxWAvcYKamA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
   '@esbuild/win32-arm64@0.25.12':
     resolution: {integrity: sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==}
     engines: {node: '>=18'}
@@ -2512,6 +2706,12 @@ packages:
     cpu: [arm64]
     os: [win32]
 
+  '@esbuild/win32-arm64@0.27.7':
+    resolution: {integrity: sha512-7yRhbHvPqSpRUV7Q20VuDwbjW5kIMwTHpptuUzV+AA46kiPze5Z7qgt6CLCK3pWFrHeNfDd1VKgyP4O+ng17CA==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
   '@esbuild/win32-ia32@0.25.12':
     resolution: {integrity: sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==}
     engines: {node: '>=18'}
@@ -2524,6 +2724,12 @@ packages:
     cpu: [ia32]
     os: [win32]
 
+  '@esbuild/win32-ia32@0.27.7':
+    resolution: {integrity: sha512-SmwKXe6VHIyZYbBLJrhOoCJRB/Z1tckzmgTLfFYOfpMAx63BJEaL9ExI8x7v0oAO3Zh6D/Oi1gVxEYr5oUCFhw==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
   '@esbuild/win32-x64@0.25.12':
     resolution: {integrity: sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==}
     engines: {node: '>=18'}
@@ -2536,6 +2742,12 @@ packages:
     cpu: [x64]
     os: [win32]
 
+  '@esbuild/win32-x64@0.27.7':
+    resolution: {integrity: sha512-56hiAJPhwQ1R4i+21FVF7V8kSD5zZTdHcVuRFMW0hn753vVfQN8xlx4uOPT4xoGH0Z/oVATuR82AiqSTDIpaHg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
   '@expressive-code/core@0.41.6':
     resolution: {integrity: sha512-FvJQP+hG0jWi/FLBSmvHInDqWR7jNANp9PUDjdMqSshHb0y7sxx3vHuoOr6SgXjWw+MGLqorZyPQ0aAlHEok6g==}
 
@@ -2885,7 +3097,7 @@ packages:
     resolution: {integrity: sha512-yTCCjuQapvRz6S30B8DyqHu1WYsbYRCww6uNsmbQU4GQVf5gJzJSB60qUHj+qBSxReLtRL/mhmhYhrIc9jVFTw==}
 
   '@lunariajs/core@https://pkg.pr.new/lunariajs/lunaria/@lunariajs/core@83617cc':
-    resolution: {tarball: https://pkg.pr.new/lunariajs/lunaria/@lunariajs/core@83617cc}
+    resolution: {integrity: sha512-k8sHBM7S10HBa39fxsJcOGYMGrbru5UZ9vMS4kmCa9o6dJTUP6rt3zKVEs7uEsHAYasoXyiC6wre2Jiqs3X+zQ==, tarball: https://pkg.pr.new/lunariajs/lunaria/@lunariajs/core@83617cc}
     version: 0.1.1
     engines: {node: '>=18.17.0'}
 
@@ -3888,11 +4100,11 @@ packages:
   '@shikijs/vscode-textmate@10.0.2':
     resolution: {integrity: sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==}
 
-  '@simple-git/args-pathspec@1.0.2':
-    resolution: {integrity: sha512-nEFVejViHUoL8wU8GTcwqrvqfUG40S5ts6S4fr1u1Ki5CklXlRDYThPVA/qurTmCYFGnaX3XpVUmICLHdvhLaA==}
+  '@simple-git/args-pathspec@1.0.3':
+    resolution: {integrity: sha512-ngJMaHlsWDTfjyq9F3VIQ8b7NXbBLq5j9i5bJ6XLYtD6qlDXT7fdKY2KscWWUF8t18xx052Y/PUO1K1TRc9yKA==}
 
-  '@simple-git/argv-parser@1.0.3':
-    resolution: {integrity: sha512-NMKv9sJcSN2VvnPT9Ja7eKfGy8Q8mMFLwPTCcuZMtv3+mYcLIZflg31S/tp2XCCyiY7YAx6cgBHQ0fwA2fWHpQ==}
+  '@simple-git/argv-parser@1.1.0':
+    resolution: {integrity: sha512-sUKOu2lb5vGIWADNNLpscyj07DAeQZU3KLbnE2Tj53tW6BbDQKMly2CCfnR4oYzqtRELCPWfwaPg+Q0T8qfKBg==}
 
   '@sinclair/typebox@0.27.10':
     resolution: {integrity: sha512-MTBk/3jGLNB2tVxv6uLlFh1iu64iYOQ2PbdOSK3NW8JZsmlaOh2q6sdtKowBhfw8QFLmYNzTW4/oK4uATIi6ZA==}
@@ -5208,8 +5420,8 @@ packages:
     resolution: {integrity: sha512-pbnl5XzGBdrFU/wT4jqmJVPn2B6UHPBOhzMQkY/SPUPB6QtUXtmBHBIwCbXJol93mOpGMnQyP/+BB19q04xj7g==}
     engines: {node: '>=4'}
 
-  better-sqlite3@12.8.0:
-    resolution: {integrity: sha512-RxD2Vd96sQDjQr20kdP+F+dK/1OUNiVOl200vKBZY8u0vTwysfolF6Hq+3ZK2+h8My9YvZhHsF+RSGZW2VYrPQ==}
+  better-sqlite3@12.9.0:
+    resolution: {integrity: sha512-wqUv4Gm3toFpHDQmaKD4QhZm3g1DjUBI0yzS4UBl6lElUmXFYdTQmmEDpAFa5o8FiFiymURypEnfVHzILKaxqQ==}
     engines: {node: 20.x || 22.x || 23.x || 24.x || 25.x}
 
   binary-extensions@2.3.0:
@@ -5750,6 +5962,11 @@ packages:
     engines: {node: '>=18'}
     hasBin: true
 
+  esbuild@0.27.7:
+    resolution: {integrity: sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==}
+    engines: {node: '>=18'}
+    hasBin: true
+
   escalade@3.2.0:
     resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==}
     engines: {node: '>=6'}
@@ -5993,6 +6210,9 @@ packages:
   get-tsconfig@4.13.6:
     resolution: {integrity: sha512-shZT/QMiSHc/YBLxxOkMtgSid5HFoauqCE3/exfsEcwg1WkeqjG+V40yBbBrsD+jW2HDXcs28xOfcbm2jI8Ddw==}
 
+  get-tsconfig@4.13.7:
+    resolution: {integrity: sha512-7tN6rFgBlMgpBML5j8typ92BKFi2sFQvIdpAqLA2beia5avZDrMs0FLZiM5etShWq5irVyGcGMEA1jcDaK7A/Q==}
+
   gettext-parser@9.0.2:
     resolution: {integrity: sha512-dGvq3S1gpS6e9KzNkwgPED5xxfWk7mNYzzdi/fPdJF5qS7B+yo8El2ZQyyhJ79PyzTtHbwiqYOFsqBdzbQ0GPg==}
     engines: {node: '>=20'}
@@ -7828,8 +8048,8 @@ packages:
   simple-get@4.0.1:
     resolution: {integrity: sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==}
 
-  simple-git@3.35.2:
-    resolution: {integrity: sha512-ZMjl06lzTm1EScxEGuM6+mEX+NQd14h/B3x0vWU+YOXAMF8sicyi1K4cjTfj5is+35ChJEHDl1EjypzYFWH2FA==}
+  simple-git@3.36.0:
+    resolution: {integrity: sha512-cGQjLjK8bxJw4QuYT7gxHw3/IouVESbhahSsHrX97MzCL1gu2u7oy38W6L2ZIGECEfIBG4BabsWDPjBxJENv9Q==}
 
   sirv@3.0.2:
     resolution: {integrity: sha512-2wcC/oGxHis/BoHkkPwldgiPSYcpZK3JU28WoMVv55yHJgcZ8rlXvuG9iZggz+sU1d4bRgIGASwyWqjxu3FM0g==}
@@ -8182,8 +8402,8 @@ packages:
   undici-types@7.16.0:
     resolution: {integrity: sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==}
 
-  undici-types@7.24.6:
-    resolution: {integrity: sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==}
+  undici-types@7.24.7:
+    resolution: {integrity: sha512-XA+gOBkzYD3C74sZowtCLTpgtaCdqZhqCvR6y9LXvrKTt/IVU6bz49T4D+BPi475scshCCkb0IklJRw6T1ZlgQ==}
 
   undici@7.18.2:
     resolution: {integrity: sha512-y+8YjDFzWdQlSE9N5nzKMT3g4a5UBX1HKowfdXh0uvAnTaqqwqB92Jt4UXBAeKekDs5IaDKyJFR4X1gYVCgXcw==}
@@ -8723,6 +8943,18 @@ packages:
       utf-8-validate:
         optional: true
 
+  ws@8.20.0:
+    resolution: {integrity: sha512-sAt8BhgNbzCtgGbt2OxmpuryO63ZoDk/sqaB/znQm94T4fCEsy/yV+7CdC1kJhOU9lboAEU7R3kquuycDoibVA==}
+    engines: {node: '>=10.0.0'}
+    peerDependencies:
+      bufferutil: ^4.0.1
+      utf-8-validate: '>=5.0.2'
+    peerDependenciesMeta:
+      bufferutil:
+        optional: true
+      utf-8-validate:
+        optional: true
+
   xml-name-validator@5.0.0:
     resolution: {integrity: sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==}
     engines: {node: '>=18'}
@@ -8943,7 +9175,7 @@ snapshots:
     dependencies:
       '@astrojs/internal-helpers': 0.8.0
       '@astrojs/underscore-redirects': 1.0.3
-      '@cloudflare/vite-plugin': 1.26.1(vite@7.3.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)(yaml@2.8.2))(workerd@1.20260401.1)(wrangler@4.80.0)
+      '@cloudflare/vite-plugin': 1.31.0(vite@7.3.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)(yaml@2.8.2))(workerd@1.20260401.1)(wrangler@4.80.0)
       astro: 6.0.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@6.0.0-beta)(yaml@2.8.2)
       piccolore: 0.1.3
       tinyglobby: 0.2.15
@@ -8969,7 +9201,7 @@ snapshots:
     dependencies:
       '@astrojs/internal-helpers': 0.8.0
       '@astrojs/underscore-redirects': 1.0.3
-      '@cloudflare/vite-plugin': 1.26.1(vite@7.3.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)(yaml@2.8.2))(workerd@1.20260401.1)(wrangler@4.80.0)
+      '@cloudflare/vite-plugin': 1.31.0(vite@7.3.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)(yaml@2.8.2))(workerd@1.20260401.1)(wrangler@4.80.0)
       astro: 6.1.3(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(rollup@4.55.2)(tsx@4.21.0)(typescript@5.9.3)(yaml@2.8.2)
       piccolore: 0.1.3
       tinyglobby: 0.2.15
@@ -9429,6 +9661,8 @@ snapshots:
 
   '@babel/runtime@7.28.6': {}
 
+  '@babel/runtime@7.29.2': {}
+
   '@babel/template@7.28.6':
     dependencies:
       '@babel/code-frame': 7.29.0
@@ -9459,7 +9693,7 @@ snapshots:
 
   '@base-ui/react@1.2.0(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)':
     dependencies:
-      '@babel/runtime': 7.28.6
+      '@babel/runtime': 7.29.2
       '@base-ui/utils': 0.2.5(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
       '@floating-ui/react-dom': 2.1.8(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
       '@floating-ui/utils': 0.2.11
@@ -9472,7 +9706,7 @@ snapshots:
 
   '@base-ui/utils@0.2.5(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)':
     dependencies:
-      '@babel/runtime': 7.28.6
+      '@babel/runtime': 7.29.2
       '@floating-ui/utils': 0.2.11
       react: 19.2.4
       react-dom: 19.2.4(react@19.2.4)
@@ -9666,24 +9900,6 @@ snapshots:
       '@clack/core': 1.1.0
       sisteransi: 1.0.5
 
-  '@cloudflare/kumo@1.10.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)':
-    dependencies:
-      '@base-ui/react': 1.2.0(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
-      '@phosphor-icons/react': 2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
-      clsx: 2.1.1
-      echarts: 6.0.0
-      motion: 12.35.0(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
-      react: 19.2.4
-      react-day-picker: 9.14.0(react@19.2.4)
-      react-dom: 19.2.4(react@19.2.4)
-      shiki: 4.0.1
-      tailwind-merge: 3.4.0
-    optionalDependencies:
-      zod: 4.3.6
-    transitivePeerDependencies:
-      - '@emotion/is-prop-valid'
-      - '@types/react'
-
   '@cloudflare/kumo@1.16.0(@phosphor-icons/react@2.1.10(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(@types/react@19.2.14)(echarts@6.0.0)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@4.3.6)':
     dependencies:
       '@base-ui/react': 1.2.0(@types/react@19.2.14)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
@@ -9712,22 +9928,16 @@ snapshots:
     optionalDependencies:
       workerd: 1.20260301.1
 
-  '@cloudflare/unenv-preset@2.15.0(unenv@2.0.0-rc.24)(workerd@1.20260401.1)':
-    dependencies:
-      unenv: 2.0.0-rc.24
-    optionalDependencies:
-      workerd: 1.20260401.1
-
   '@cloudflare/unenv-preset@2.16.0(unenv@2.0.0-rc.24)(workerd@1.20260401.1)':
     dependencies:
       unenv: 2.0.0-rc.24
     optionalDependencies:
       workerd: 1.20260401.1
 
-  '@cloudflare/vite-plugin@1.26.1(vite@7.3.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)(yaml@2.8.2))(workerd@1.20260401.1)(wrangler@4.80.0)':
+  '@cloudflare/vite-plugin@1.31.0(vite@7.3.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)(yaml@2.8.2))(workerd@1.20260401.1)(wrangler@4.80.0)':
     dependencies:
-      '@cloudflare/unenv-preset': 2.15.0(unenv@2.0.0-rc.24)(workerd@1.20260401.1)
-      miniflare: 4.20260301.1
+      '@cloudflare/unenv-preset': 2.16.0(unenv@2.0.0-rc.24)(workerd@1.20260401.1)
+      miniflare: 4.20260401.0
       unenv: 2.0.0-rc.24
       vite: 7.3.1(@types/node@24.10.13)(jiti@2.6.1)(lightningcss@1.31.1)(tsx@4.21.0)(yaml@2.8.2)
       wrangler: 4.80.0(@cloudflare/workers-types@4.20260305.1)
@@ -9876,156 +10086,234 @@ snapshots:
   '@esbuild/aix-ppc64@0.27.3':
     optional: true
 
+  '@esbuild/aix-ppc64@0.27.7':
+    optional: true
+
   '@esbuild/android-arm64@0.25.12':
     optional: true
 
   '@esbuild/android-arm64@0.27.3':
     optional: true
 
+  '@esbuild/android-arm64@0.27.7':
+    optional: true
+
   '@esbuild/android-arm@0.25.12':
     optional: true
 
   '@esbuild/android-arm@0.27.3':
     optional: true
 
+  '@esbuild/android-arm@0.27.7':
+    optional: true
+
   '@esbuild/android-x64@0.25.12':
     optional: true
 
   '@esbuild/android-x64@0.27.3':
     optional: true
 
+  '@esbuild/android-x64@0.27.7':
+    optional: true
+
   '@esbuild/darwin-arm64@0.25.12':
     optional: true
 
   '@esbuild/darwin-arm64@0.27.3':
     optional: true
 
+  '@esbuild/darwin-arm64@0.27.7':
+    optional: true
+
   '@esbuild/darwin-x64@0.25.12':
     optional: true
 
   '@esbuild/darwin-x64@0.27.3':
     optional: true
 
+  '@esbuild/darwin-x64@0.27.7':
+    optional: true
+
   '@esbuild/freebsd-arm64@0.25.12':
     optional: true
 
   '@esbuild/freebsd-arm64@0.27.3':
     optional: true
 
+  '@esbuild/freebsd-arm64@0.27.7':
+    optional: true
+
   '@esbuild/freebsd-x64@0.25.12':
     optional: true
 
   '@esbuild/freebsd-x64@0.27.3':
     optional: true
 
+  '@esbuild/freebsd-x64@0.27.7':
+    optional: true
+
   '@esbuild/linux-arm64@0.25.12':
     optional: true
 
   '@esbuild/linux-arm64@0.27.3':
     optional: true
 
+  '@esbuild/linux-arm64@0.27.7':
+    optional: true
+
   '@esbuild/linux-arm@0.25.12':
     optional: true
 
   '@esbuild/linux-arm@0.27.3':
     optional: true
 
+  '@esbuild/linux-arm@0.27.7':
+    optional: true
+
   '@esbuild/linux-ia32@0.25.12':
     optional: true
 
   '@esbuild/linux-ia32@0.27.3':
     optional: true
 
+  '@esbuild/linux-ia32@0.27.7':
+    optional: true
+
   '@esbuild/linux-loong64@0.25.12':
     optional: true
 
   '@esbuild/linux-loong64@0.27.3':
     optional: true
 
+  '@esbuild/linux-loong64@0.27.7':
+    optional: true
+
   '@esbuild/linux-mips64el@0.25.12':
     optional: true
 
   '@esbuild/linux-mips64el@0.27.3':
     optional: true
 
+  '@esbuild/linux-mips64el@0.27.7':
+    optional: true
+
   '@esbuild/linux-ppc64@0.25.12':
     optional: true
 
   '@esbuild/linux-ppc64@0.27.3':
     optional: true
 
+  '@esbuild/linux-ppc64@0.27.7':
+    optional: true
+
   '@esbuild/linux-riscv64@0.25.12':
     optional: true
 
   '@esbuild/linux-riscv64@0.27.3':
     optional: true
 
+  '@esbuild/linux-riscv64@0.27.7':
+    optional: true
+
   '@esbuild/linux-s390x@0.25.12':
     optional: true
 
   '@esbuild/linux-s390x@0.27.3':
     optional: true
 
+  '@esbuild/linux-s390x@0.27.7':
+    optional: true
+
   '@esbuild/linux-x64@0.25.12':
     optional: true
 
   '@esbuild/linux-x64@0.27.3':
     optional: true
 
+  '@esbuild/linux-x64@0.27.7':
+    optional: true
+
   '@esbuild/netbsd-arm64@0.25.12':
     optional: true
 
   '@esbuild/netbsd-arm64@0.27.3':
     optional: true
 
+  '@esbuild/netbsd-arm64@0.27.7':
+    optional: true
+
   '@esbuild/netbsd-x64@0.25.12':
     optional: true
 
   '@esbuild/netbsd-x64@0.27.3':
     optional: true
 
+  '@esbuild/netbsd-x64@0.27.7':
+    optional: true
+
   '@esbuild/openbsd-arm64@0.25.12':
     optional: true
 
   '@esbuild/openbsd-arm64@0.27.3':
     optional: true
 
+  '@esbuild/openbsd-arm64@0.27.7':
+    optional: true
+
   '@esbuild/openbsd-x64@0.25.12':
     optional: true
 
   '@esbuild/openbsd-x64@0.27.3':
     optional: true
 
+  '@esbuild/openbsd-x64@0.27.7':
+    optional: true
+
   '@esbuild/openharmony-arm64@0.25.12':
     optional: true
 
   '@esbuild/openharmony-arm64@0.27.3':
     optional: true
 
+  '@esbuild/openharmony-arm64@0.27.7':
+    optional: true
+
   '@esbuild/sunos-x64@0.25.12':
     optional: true
 
   '@esbuild/sunos-x64@0.27.3':
     optional: true
 
+  '@esbuild/sunos-x64@0.27.7':
+    optional: true
+
   '@esbuild/win32-arm64@0.25.12':
     optional: true
 
   '@esbuild/win32-arm64@0.27.3':
     optional: true
 
+  '@esbuild/win32-arm64@0.27.7':
+    optional: true
+
   '@esbuild/win32-ia32@0.25.12':
     optional: true
 
   '@esbuild/win32-ia32@0.27.3':
     optional: true
 
+  '@esbuild/win32-ia32@0.27.7':
+    optional: true
+
   '@esbuild/win32-x64@0.25.12':
     optional: true
 
   '@esbuild/win32-x64@0.27.3':
     optional: true
 
+  '@esbuild/win32-x64@0.27.7':
+    optional: true
+
   '@expressive-code/core@0.41.6':
     dependencies:
       '@ctrl/tinycolor': 4.2.0
@@ -10410,7 +10698,7 @@ snapshots:
       p-all: 5.0.1
       path-to-regexp: 6.3.0
       picomatch: 4.0.3
-      simple-git: 3.35.2
+      simple-git: 3.36.0
       tinyglobby: 0.2.15
       ultramatter: 0.0.4
       zod: 3.25.76
@@ -11175,11 +11463,11 @@ snapshots:
 
   '@shikijs/vscode-textmate@10.0.2': {}
 
-  '@simple-git/args-pathspec@1.0.2': {}
+  '@simple-git/args-pathspec@1.0.3': {}
 
-  '@simple-git/argv-parser@1.0.3':
+  '@simple-git/argv-parser@1.1.0':
     dependencies:
-      '@simple-git/args-pathspec': 1.0.2
+      '@simple-git/args-pathspec': 1.0.3
 
   '@sinclair/typebox@0.27.10': {}
 
@@ -11480,7 +11768,7 @@ snapshots:
       '@solana/functional': 5.5.1(typescript@5.9.3)
       '@solana/rpc-subscriptions-spec': 5.5.1(typescript@5.9.3)
       '@solana/subscribable': 5.5.1(typescript@5.9.3)
-      ws: 8.19.0
+      ws: 8.20.0
     optionalDependencies:
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -11537,7 +11825,7 @@ snapshots:
       '@solana/errors': 5.5.1(typescript@5.9.3)
       '@solana/rpc-spec': 5.5.1(typescript@5.9.3)
       '@solana/rpc-spec-types': 5.5.1(typescript@5.9.3)
-      undici-types: 7.24.6
+      undici-types: 7.24.7
     optionalDependencies:
       typescript: 5.9.3
     optional: true
@@ -11858,7 +12146,7 @@ snapshots:
   '@testing-library/dom@10.4.1':
     dependencies:
       '@babel/code-frame': 7.29.0
-      '@babel/runtime': 7.28.6
+      '@babel/runtime': 7.29.2
       '@types/aria-query': 5.0.4
       aria-query: 5.3.0
       dom-accessibility-api: 0.5.16
@@ -12958,7 +13246,7 @@ snapshots:
       dlv: 1.1.3
       dset: 3.1.4
       es-module-lexer: 2.0.0
-      esbuild: 0.27.3
+      esbuild: 0.27.7
       flattie: 1.1.1
       fontace: 0.4.1
       github-slugger: 2.0.0
@@ -13057,7 +13345,7 @@ snapshots:
     dependencies:
       is-windows: 1.0.2
 
-  better-sqlite3@12.8.0:
+  better-sqlite3@12.9.0:
     dependencies:
       bindings: 1.5.0
       prebuild-install: 7.1.3
@@ -13588,6 +13876,35 @@ snapshots:
       '@esbuild/win32-ia32': 0.27.3
       '@esbuild/win32-x64': 0.27.3
 
+  esbuild@0.27.7:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.27.7
+      '@esbuild/android-arm': 0.27.7
+      '@esbuild/android-arm64': 0.27.7
+      '@esbuild/android-x64': 0.27.7
+      '@esbuild/darwin-arm64': 0.27.7
+      '@esbuild/darwin-x64': 0.27.7
+      '@esbuild/freebsd-arm64': 0.27.7
+      '@esbuild/freebsd-x64': 0.27.7
+      '@esbuild/linux-arm': 0.27.7
+      '@esbuild/linux-arm64': 0.27.7
+      '@esbuild/linux-ia32': 0.27.7
+      '@esbuild/linux-loong64': 0.27.7
+      '@esbuild/linux-mips64el': 0.27.7
+      '@esbuild/linux-ppc64': 0.27.7
+      '@esbuild/linux-riscv64': 0.27.7
+      '@esbuild/linux-s390x': 0.27.7
+      '@esbuild/linux-x64': 0.27.7
+      '@esbuild/netbsd-arm64': 0.27.7
+      '@esbuild/netbsd-x64': 0.27.7
+      '@esbuild/openbsd-arm64': 0.27.7
+      '@esbuild/openbsd-x64': 0.27.7
+      '@esbuild/openharmony-arm64': 0.27.7
+      '@esbuild/sunos-x64': 0.27.7
+      '@esbuild/win32-arm64': 0.27.7
+      '@esbuild/win32-ia32': 0.27.7
+      '@esbuild/win32-x64': 0.27.7
+
   escalade@3.2.0: {}
 
   escape-html@1.0.3: {}
@@ -13854,6 +14171,11 @@ snapshots:
     dependencies:
       resolve-pkg-maps: 1.0.0
 
+  get-tsconfig@4.13.7:
+    dependencies:
+      resolve-pkg-maps: 1.0.0
+    optional: true
+
   gettext-parser@9.0.2:
     dependencies:
       content-type: 1.0.5
@@ -14161,7 +14483,7 @@ snapshots:
 
   i18next@23.16.8:
     dependencies:
-      '@babel/runtime': 7.28.6
+      '@babel/runtime': 7.29.2
 
   iconv-lite@0.6.3:
     dependencies:
@@ -16307,12 +16629,12 @@ snapshots:
       once: 1.4.0
       simple-concat: 1.0.1
 
-  simple-git@3.35.2:
+  simple-git@3.36.0:
     dependencies:
       '@kwsites/file-exists': 1.1.1
       '@kwsites/promise-deferred': 1.1.1
-      '@simple-git/args-pathspec': 1.0.2
-      '@simple-git/argv-parser': 1.0.3
+      '@simple-git/args-pathspec': 1.0.3
+      '@simple-git/argv-parser': 1.1.0
       debug: 4.4.3
     transitivePeerDependencies:
       - supports-color
@@ -16595,8 +16917,8 @@ snapshots:
 
   tsx@4.21.0:
     dependencies:
-      esbuild: 0.27.3
-      get-tsconfig: 4.13.6
+      esbuild: 0.27.7
+      get-tsconfig: 4.13.7
     optionalDependencies:
       fsevents: 2.3.3
     optional: true
@@ -16648,7 +16970,7 @@ snapshots:
 
   undici-types@7.16.0: {}
 
-  undici-types@7.24.6:
+  undici-types@7.24.7:
     optional: true
 
   undici@7.18.2: {}
@@ -17137,6 +17459,9 @@ snapshots:
 
   ws@8.19.0: {}
 
+  ws@8.20.0:
+    optional: true
+
   xml-name-validator@5.0.0: {}
 
   xmlchars@2.2.0: {}