birdclaw 0.8.3 → 0.8.5

package/dist/server/assets/client-stream-contracts-Bq6kMmhh.js

@@ -0,0 +1,769 @@
+import { hn as tweetLinkClass, m as cx, vn as tweetMentionClass } from "./ui-qbmcMSSX.js";
+import { r as formatCompactNumber, t as AvatarChip } from "./AvatarChip-zUDAEmjL.js";
+import { m as renderTweetPlainText, n as useFloatingPreview, r as useAvatarPreload, s as safeHttpUrl, t as ProfilePreview } from "./ProfilePreview-Cg-AOHBE.js";
+import { t as SmartTimestamp } from "./SmartTimestamp-DfwE1NGf.js";
+import { Fragment, useCallback, useEffect, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { z } from "zod";
+//#region src/components/MarkdownCitations.tsx
+function normalizeTweetReference(value) {
+	return value.trim().replace(/^\(/, "").replace(/\)$/, "").replace(/^tweet_/, "");
+}
+function isNumericTweetReference(value) {
+	return /^\d{12,25}$/.test(normalizeTweetReference(value));
+}
+function tweetReferencesFromToken(token) {
+	return Array.from(token.matchAll(/\b(?:tweet_)?[A-Za-z0-9_:-]{3,}\b/g)).map((match) => match[0]).filter((value) => value.startsWith("tweet_") || /^\d{12,25}$/.test(value));
+}
+function adjacentParenthesizedTweetReferences(value, cursor) {
+	const references = [];
+	let nextCursor = cursor;
+	while (nextCursor < value.length) {
+		const match = /^\s+\((?:\s*(?:tweet_[A-Za-z0-9_:-]+|\d{12,25})\s*,?)+\)/.exec(value.slice(nextCursor));
+		if (!match) break;
+		references.push(...tweetReferencesFromToken(match[0]));
+		nextCursor += match[0].length;
+	}
+	return {
+		references,
+		cursor: nextCursor
+	};
+}
+function trailingReadableBounds(value, options = {}) {
+	let start = 0;
+	for (const separator of [
+		". ",
+		"? ",
+		"! ",
+		"; ",
+		": "
+	]) {
+		const index = value.lastIndexOf(separator);
+		if (index >= 0) start = Math.max(start, index + separator.length);
+	}
+	let end = value.length;
+	while (start < end && /\s/.test(value[start] ?? "")) start += 1;
+	while (end > start && /\s/.test(value[end - 1] ?? "")) end -= 1;
+	let clauseStart = start;
+	for (const separator of [
+		", with ",
+		", while ",
+		", and "
+	]) {
+		const index = value.lastIndexOf(separator, end);
+		if (index >= start) {
+			clauseStart = index + 2;
+			break;
+		}
+	}
+	if (options.preferClause !== false && (clauseStart > start || end - start > 140)) {
+		while (clauseStart < end && /\s/.test(value[clauseStart] ?? "")) clauseStart += 1;
+		if (end > clauseStart) start = clauseStart;
+	}
+	return end > start ? {
+		start,
+		end
+	} : null;
+}
+function trimBullet(value) {
+	return value.replace(/^[-*]\s+/, "");
+}
+function skipRedundantSourceWords(value, cursor) {
+	const match = /^((?:\s+source\b)+)(?=\s*(?:[.,;:!?)]|$))/i.exec(value.slice(cursor));
+	return match ? cursor + match[0].length : cursor;
+}
+function getTweetUrl(tweet) {
+	return tweet.url || `https://x.com/${tweet.author}/status/${tweet.id}`;
+}
+function getFallbackTweetUrl(tweetId) {
+	return `https://x.com/i/status/${normalizeTweetReference(tweetId)}`;
+}
+function TweetSourceLink({ children, href, onClick, describedBy }) {
+	return /* @__PURE__ */ jsx("a", {
+		"aria-describedby": describedBy,
+		className: "rounded-sm px-0.5 text-[var(--accent)] hover:bg-[var(--accent-soft)] hover:no-underline",
+		href,
+		onClick,
+		rel: "noreferrer",
+		target: "_blank",
+		children
+	});
+}
+function TweetPreviewToken({ tweet, children }) {
+	const preview = useFloatingPreview();
+	useAvatarPreload(preview.referenceRef, tweet.authorProfile.id, tweet.authorProfile.avatarUrl);
+	const article = tweet.entities?.article;
+	const renderedText = renderTweetPlainText(tweet.text, tweet.entities ?? {});
+	const previewText = article ? [article.title, article.previewText].filter((value, index, values) => Boolean(value) && values.indexOf(value) === index).join("\n\n") : renderedText;
+	return /* @__PURE__ */ jsxs("span", {
+		ref: preview.referenceRef,
+		className: "inline align-baseline",
+		...preview.referenceProps,
+		children: [/* @__PURE__ */ jsx(TweetSourceLink, {
+			describedBy: preview.open ? preview.floatingId : void 0,
+			href: getTweetUrl(tweet),
+			onClick: (event) => {
+				preview.closePreview();
+				event.currentTarget.blur();
+			},
+			children
+		}), preview.open ? /* @__PURE__ */ jsx("span", {
+			id: preview.floatingId,
+			ref: preview.floatingRef,
+			className: "fixed z-40 w-[360px] overflow-y-auto rounded-2xl border border-[var(--line)] bg-[var(--bg-elevated)] p-3 text-left text-[14px] leading-[1.4] text-[var(--ink)] shadow-[0_14px_40px_var(--shadow-strong)]",
+			role: "tooltip",
+			style: preview.floatingStyle,
+			...preview.floatingProps,
+			children: /* @__PURE__ */ jsxs("span", {
+				className: "block",
+				"data-floating-preview-content": true,
+				children: [
+					/* @__PURE__ */ jsxs("span", {
+						className: "mb-2 flex items-center gap-2",
+						children: [/* @__PURE__ */ jsx(AvatarChip, {
+							avatarUrl: tweet.authorProfile.avatarUrl,
+							hue: tweet.authorProfile.avatarHue,
+							name: tweet.name,
+							profileId: tweet.authorProfile.id,
+							size: "small"
+						}), /* @__PURE__ */ jsxs("span", {
+							className: "min-w-0",
+							children: [/* @__PURE__ */ jsx("span", {
+								className: "block truncate font-bold",
+								children: tweet.name
+							}), /* @__PURE__ */ jsxs("span", {
+								className: "block truncate text-[12px] text-[var(--ink-soft)]",
+								children: [
+									"@",
+									tweet.author,
+									" · ",
+									/* @__PURE__ */ jsx(SmartTimestamp, { value: tweet.createdAt })
+								]
+							})]
+						})]
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: "line-clamp-6 whitespace-pre-wrap [overflow-wrap:anywhere]",
+						children: previewText
+					}),
+					/* @__PURE__ */ jsxs("span", {
+						className: "mt-2 flex gap-3 text-[12px] text-[var(--ink-soft)]",
+						children: [
+							/* @__PURE__ */ jsx("span", { children: tweet.source }),
+							tweet.likeCount > 0 ? /* @__PURE__ */ jsxs("span", { children: [formatCompactNumber(tweet.likeCount), " likes"] }) : null,
+							tweet.needsReply ? /* @__PURE__ */ jsx("span", { children: "reply open" }) : null
+						]
+					})
+				]
+			})
+		}) : null]
+	});
+}
+function additionalDirectCitationLinks(references, key) {
+	return references.slice(1).flatMap((reference, index) => [index === 0 ? " " : ", ", /* @__PURE__ */ jsx(TweetSourceLink, {
+		href: getFallbackTweetUrl(reference),
+		children: `source ${String(index + 2)}`
+	}, `${key}-direct-source-${String(index + 2)}`)]);
+}
+function splitReadableForSourceLinks(value, count) {
+	if (count < 2) return null;
+	const separators = Array.from(value.matchAll(/,\s+and\s+|,\s+or\s+|;\s+|,\s+|\s+and\s+|\s+or\s+/g));
+	if (separators.length < count - 1) return null;
+	const selected = separators.slice(-(count - 1));
+	const parts = [];
+	let cursor = 0;
+	for (const separator of selected) {
+		const index = separator.index;
+		if (index === void 0) return null;
+		const text = value.slice(cursor, index);
+		if (!text.trim()) return null;
+		parts.push({
+			text,
+			separatorAfter: separator[0]
+		});
+		cursor = index + separator[0].length;
+	}
+	const lastText = value.slice(cursor);
+	if (!lastText.trim()) return null;
+	parts.push({
+		text: lastText,
+		separatorAfter: ""
+	});
+	return parts.length === count ? parts : null;
+}
+function linkedCitationParts(readable, tweets, key) {
+	const parts = splitReadableForSourceLinks(readable, tweets.length);
+	if (!parts) {
+		const tweet = tweets[0];
+		if (!tweet) return [];
+		return [/* @__PURE__ */ jsx(TweetPreviewToken, {
+			tweet,
+			children: readable
+		}, key), ...additionalCitationLinks(tweets, key)];
+	}
+	return parts.flatMap((part, index) => {
+		const tweet = tweets[index];
+		if (!tweet) return [];
+		return [/* @__PURE__ */ jsx(TweetPreviewToken, {
+			tweet,
+			children: part.text
+		}, `${key}-part-${String(index)}`), part.separatorAfter];
+	});
+}
+function linkedDirectCitationParts(readable, references, key) {
+	const parts = splitReadableForSourceLinks(readable, references.length);
+	if (!parts) {
+		const reference = references[0];
+		if (!reference) return [];
+		return [/* @__PURE__ */ jsx(TweetSourceLink, {
+			href: getFallbackTweetUrl(reference),
+			children: readable
+		}, key), ...additionalDirectCitationLinks(references, key)];
+	}
+	return parts.flatMap((part, index) => {
+		const reference = references[index];
+		if (!reference) return [];
+		return [/* @__PURE__ */ jsx(TweetSourceLink, {
+			href: getFallbackTweetUrl(reference),
+			children: part.text
+		}, `${key}-direct-part-${String(index)}`), part.separatorAfter];
+	});
+}
+function additionalCitationLinks(tweets, key) {
+	return tweets.slice(1).flatMap((tweet, index) => [index === 0 ? " " : ", ", /* @__PURE__ */ jsx(TweetPreviewToken, {
+		tweet,
+		children: `source ${String(index + 2)}`
+	}, `${key}-source-${String(index + 2)}`)]);
+}
+function fallbackCitationLinks(tweets, key) {
+	return tweets.flatMap((tweet, index) => [index === 0 ? "" : ", ", /* @__PURE__ */ jsx(TweetPreviewToken, {
+		tweet,
+		children: tweets.length === 1 ? "source" : `source ${String(index + 1)}`
+	}, `${key}-fallback-${String(index + 1)}`)]);
+}
+function linkTrailingCitationText(nodes, tweets, key) {
+	const tweet = tweets[0];
+	if (!tweet) return false;
+	const last = nodes.at(-1);
+	if (typeof last !== "string") return false;
+	const match = /(["“][^"”]+["”])(\s*)$/.exec(last);
+	if (match) {
+		const quoted = match[1];
+		const trailing = match[2] ?? "";
+		const before = last.slice(0, match.index);
+		nodes[nodes.length - 1] = before;
+		nodes.push(/* @__PURE__ */ jsx(TweetPreviewToken, {
+			tweet,
+			children: quoted
+		}, key), ...additionalCitationLinks(tweets, key), /^\s*$/.test(trailing) ? "" : trailing);
+		return true;
+	}
+	const bounds = trailingReadableBounds(last, { preferClause: tweets.length === 1 });
+	if (!bounds) return false;
+	const before = last.slice(0, bounds.start);
+	const readable = last.slice(bounds.start, bounds.end);
+	const trailing = last.slice(bounds.end);
+	nodes[nodes.length - 1] = before;
+	nodes.push(...linkedCitationParts(readable, tweets, key), /^\s*$/.test(trailing) ? "" : trailing);
+	return true;
+}
+function linkTrailingDirectCitationText(nodes, references, key) {
+	if (!references[0]) return false;
+	const last = nodes.at(-1);
+	if (typeof last !== "string") return false;
+	const bounds = trailingReadableBounds(last, { preferClause: references.length === 1 });
+	if (!bounds) return false;
+	const before = last.slice(0, bounds.start);
+	const readable = last.slice(bounds.start, bounds.end);
+	const trailing = last.slice(bounds.end);
+	nodes[nodes.length - 1] = before;
+	nodes.push(...linkedDirectCitationParts(readable, references, key), /^\s*$/.test(trailing) ? "" : trailing);
+	return true;
+}
+function renderInline(text, lookup) {
+	const pattern = /(\[[^\]\n]+\]\s*\(https?:\/\/[^\s)]+\)|\*\*[^*]+\*\*|@[A-Za-z0-9_]{1,20}|\((?:\s*(?:tweet_[A-Za-z0-9_:-]+|\d{12,25})\s*,?)+\)|\btweet_[A-Za-z0-9_:-]+\b|\b\d{12,25}\b)/g;
+	const nodes = [];
+	let cursor = 0;
+	let match;
+	while (match = pattern.exec(text)) {
+		const token = match[0];
+		const tokenKey = `${token}-${String(match.index)}`;
+		if (match.index > cursor) nodes.push(text.slice(cursor, match.index));
+		cursor = match.index + token.length;
+		if (token.startsWith("**") && token.endsWith("**")) {
+			nodes.push(/* @__PURE__ */ jsx("strong", { children: token.slice(2, -2) }, tokenKey));
+			continue;
+		}
+		const markdownLink = /^\[([^\]\n]+)\]\s*\((https?:\/\/[^\s)]+)\)$/.exec(token);
+		if (markdownLink) {
+			const href = safeHttpUrl(markdownLink[2]);
+			nodes.push(href ? /* @__PURE__ */ jsx("a", {
+				className: tweetLinkClass,
+				href,
+				rel: "noreferrer",
+				target: "_blank",
+				children: markdownLink[1]
+			}, tokenKey) : markdownLink[1]);
+			continue;
+		}
+		if (token.startsWith("@")) {
+			const profile = lookup.profilesByHandle.get(token.slice(1).toLowerCase());
+			nodes.push(profile ? /* @__PURE__ */ jsx(ProfilePreview, {
+				profile,
+				children: /* @__PURE__ */ jsx("span", {
+					className: tweetMentionClass,
+					children: token
+				})
+			}, tokenKey) : /* @__PURE__ */ jsx("a", {
+				className: tweetMentionClass,
+				href: `/profiles/${encodeURIComponent(token.slice(1))}`,
+				children: token
+			}, tokenKey));
+			continue;
+		}
+		const isParenthesizedTweetRef = token.startsWith("(") && token.endsWith(")");
+		let references = tweetReferencesFromToken(token);
+		if (isParenthesizedTweetRef) {
+			const adjacent = adjacentParenthesizedTweetReferences(text, cursor);
+			const groupedReferences = [...references, ...adjacent.references];
+			if (adjacent.references.length > 0 && groupedReferences.every(isNumericTweetReference)) {
+				references = groupedReferences;
+				cursor = adjacent.cursor;
+				pattern.lastIndex = cursor;
+			}
+		}
+		const resolvedTweets = references.map((reference) => lookup.tweetsById.get(normalizeTweetReference(reference)));
+		const allReferencesResolved = references.length > 0 && resolvedTweets.every(Boolean);
+		const tweets = resolvedTweets.filter((tweet) => Boolean(tweet));
+		const tweet = tweets[0];
+		if (isParenthesizedTweetRef && references.length > 1 && !allReferencesResolved) {
+			if (references.every(isNumericTweetReference)) {
+				const cursorAfterSourceWords = skipRedundantSourceWords(text, cursor);
+				if (linkTrailingDirectCitationText(nodes, references, tokenKey)) {
+					cursor = cursorAfterSourceWords;
+					continue;
+				}
+				nodes.push(...references.flatMap((reference, index) => [index === 0 ? "" : ", ", /* @__PURE__ */ jsx(TweetSourceLink, {
+					href: getFallbackTweetUrl(reference),
+					children: `source ${String(index + 1)}`
+				}, `${tokenKey}-direct-${String(index)}`)]));
+				cursor = cursorAfterSourceWords;
+				continue;
+			}
+			nodes.push(token);
+			continue;
+		}
+		if (tweet && isParenthesizedTweetRef && allReferencesResolved && linkTrailingCitationText(nodes, tweets, tokenKey)) {
+			cursor = skipRedundantSourceWords(text, cursor);
+			continue;
+		}
+		if (tweet && isParenthesizedTweetRef && allReferencesResolved) {
+			nodes.push(...fallbackCitationLinks(tweets, tokenKey));
+			cursor = skipRedundantSourceWords(text, cursor);
+			continue;
+		}
+		if (tweet) nodes.push(/* @__PURE__ */ jsx(TweetPreviewToken, {
+			tweet,
+			children: isParenthesizedTweetRef ? "source" : token
+		}, tokenKey));
+		else if (isParenthesizedTweetRef && references.length === 1 && isNumericTweetReference(references[0] ?? "")) {
+			const cursorAfterSourceWords = skipRedundantSourceWords(text, cursor);
+			if (linkTrailingDirectCitationText(nodes, references, tokenKey)) {
+				cursor = cursorAfterSourceWords;
+				continue;
+			}
+			nodes.push(/* @__PURE__ */ jsx(TweetSourceLink, {
+				href: getFallbackTweetUrl(references[0]),
+				children: "source"
+			}, `${tokenKey}-direct`));
+			cursor = cursorAfterSourceWords;
+			continue;
+		} else nodes.push(token);
+	}
+	if (cursor < text.length) nodes.push(text.slice(cursor));
+	return nodes.map((node, index) => /* @__PURE__ */ jsx(Fragment, { children: node }, typeof node === "string" ? `${node}-${String(index)}` : index));
+}
+function isProfileAnalysisContext(context) {
+	return "conversations" in context && "profile" in context;
+}
+function addLookupTweet(tweetsById, profilesByHandle, tweet) {
+	const normalized = normalizeTweetReference(tweet.id);
+	tweetsById.set(normalized, tweet);
+	tweetsById.set(`tweet_${normalized}`, tweet);
+	profilesByHandle.set(tweet.author.toLowerCase(), tweet.authorProfile);
+}
+function syntheticProfileForConversationTweet(tweet) {
+	return {
+		id: tweet.profileId,
+		handle: tweet.author,
+		displayName: tweet.name || tweet.author,
+		bio: tweet.bio,
+		followersCount: tweet.followersCount,
+		avatarHue: 210,
+		avatarUrl: tweet.avatarUrl,
+		createdAt: tweet.createdAt
+	};
+}
+function profileAnalysisTweetToCitation(tweet, profile) {
+	return {
+		id: tweet.id,
+		url: tweet.url,
+		source: "authored",
+		author: profile.handle,
+		name: profile.displayName,
+		authorProfile: profile,
+		createdAt: tweet.createdAt,
+		text: tweet.text,
+		entities: tweet.entities,
+		likeCount: tweet.likeCount,
+		liked: false,
+		bookmarked: false,
+		needsReply: false
+	};
+}
+function conversationTweetToCitation(tweet) {
+	const authorProfile = syntheticProfileForConversationTweet(tweet);
+	return {
+		id: tweet.id,
+		url: tweet.url,
+		source: "mentions",
+		author: tweet.author,
+		name: tweet.name || tweet.author,
+		authorProfile,
+		createdAt: tweet.createdAt,
+		text: tweet.text,
+		entities: tweet.entities,
+		likeCount: tweet.likeCount,
+		liked: false,
+		bookmarked: false,
+		needsReply: false
+	};
+}
+function buildLookup(context) {
+	const tweetsById = /* @__PURE__ */ new Map();
+	const profilesByHandle = /* @__PURE__ */ new Map();
+	if (!context) return {
+		tweetsById,
+		profilesByHandle
+	};
+	if (isProfileAnalysisContext(context)) {
+		profilesByHandle.set(context.profile.handle.toLowerCase(), context.profile);
+		for (const profile of context.profiles ?? []) profilesByHandle.set(profile.handle.toLowerCase(), profile);
+		for (const tweet of context.tweets) addLookupTweet(tweetsById, profilesByHandle, profileAnalysisTweetToCitation(tweet, context.profile));
+		for (const tweet of context.conversations) addLookupTweet(tweetsById, profilesByHandle, conversationTweetToCitation(tweet));
+		return {
+			tweetsById,
+			profilesByHandle
+		};
+	}
+	for (const tweet of context.tweets) addLookupTweet(tweetsById, profilesByHandle, tweet);
+	return {
+		tweetsById,
+		profilesByHandle
+	};
+}
+//#endregion
+//#region src/components/MarkdownViewer.tsx
+function MarkdownViewer({ markdown, context, className }) {
+	const lookup = buildLookup(context);
+	const lines = markdown.replace(/\]\s*\r?\n\s*\((https?:\/\/[^\s)]+)\)/g, "]($1)").split(/\r?\n/);
+	const nodes = [];
+	let listItems = [];
+	const flushList = () => {
+		if (listItems.length === 0) return;
+		nodes.push(/* @__PURE__ */ jsx("ul", {
+			className: "my-2.5 flex list-disc flex-col gap-1.5 pl-5 first:mt-0 marker:text-[var(--ink-soft)]",
+			children: listItems.map((item, index) => /* @__PURE__ */ jsx("li", { children: item }, String(index)))
+		}, `list-${String(nodes.length)}`));
+		listItems = [];
+	};
+	for (const line of lines) {
+		const trimmed = line.trim();
+		if (!trimmed) {
+			flushList();
+			continue;
+		}
+		if (trimmed.startsWith("### ")) {
+			flushList();
+			nodes.push(/* @__PURE__ */ jsx("h3", {
+				className: "mt-5 mb-1.5 text-[14px] font-bold uppercase tracking-wide text-[var(--ink-soft)] first:mt-0",
+				children: renderInline(trimmed.slice(4), lookup)
+			}, `h3-${String(nodes.length)}`));
+			continue;
+		}
+		if (trimmed.startsWith("## ")) {
+			flushList();
+			nodes.push(/* @__PURE__ */ jsx("h2", {
+				className: "mt-6 mb-2 text-[18px] font-bold text-[var(--ink)] first:mt-0",
+				children: renderInline(trimmed.slice(3), lookup)
+			}, `h2-${String(nodes.length)}`));
+			continue;
+		}
+		if (trimmed.startsWith("# ")) {
+			flushList();
+			nodes.push(/* @__PURE__ */ jsx("h1", {
+				className: "mt-0 mb-2.5 text-[20px] font-bold text-[var(--ink)]",
+				children: renderInline(trimmed.slice(2), lookup)
+			}, `h1-${String(nodes.length)}`));
+			continue;
+		}
+		if (/^[-*]\s+/.test(trimmed)) {
+			listItems.push(renderInline(trimBullet(trimmed), lookup));
+			continue;
+		}
+		flushList();
+		nodes.push(/* @__PURE__ */ jsx("p", {
+			className: "my-2.5 whitespace-pre-wrap first:mt-0 [overflow-wrap:anywhere]",
+			children: renderInline(trimmed, lookup)
+		}, `p-${String(nodes.length)}`));
+	}
+	flushList();
+	return /* @__PURE__ */ jsx("article", {
+		className: cx("max-w-none px-4 py-3 text-[15px] leading-[1.55] text-[var(--ink)]", className),
+		children: nodes
+	});
+}
+//#endregion
+//#region src/lib/client-http.ts
+/** Build a useful error from JSON or plain-text non-OK responses. */
+async function responseError(response, { label, statusMessages }) {
+	const specialMessage = statusMessages?.[response.status];
+	if (specialMessage) return new Error(specialMessage);
+	const status = `${String(response.status)}${response.statusText ? ` ${response.statusText}` : ""}`;
+	let detail = "";
+	try {
+		if ((response.headers.get("content-type") ?? "").includes("application/json")) {
+			const payload = await response.json();
+			if (payload && typeof payload === "object") {
+				const record = payload;
+				if (typeof record.message === "string") detail = record.message;
+				else if (typeof record.error === "string") detail = record.error;
+			}
+		} else detail = (await response.text()).trim();
+	} catch {
+		detail = "";
+	}
+	return /* @__PURE__ */ new Error(detail ? `${label} (${status}): ${detail}` : `${label} (${status})`);
+}
+//#endregion
+//#region src/lib/client-ndjson.ts
+function abortError(signal) {
+	return signal.reason instanceof Error ? signal.reason : new DOMException("The operation was aborted", "AbortError");
+}
+async function readWithAbort(reader, signal) {
+	if (!signal) return reader.read();
+	if (signal.aborted) throw abortError(signal);
+	return new Promise((resolve, reject) => {
+		const onAbort = () => {
+			reader.cancel(signal.reason).catch(() => void 0);
+			reject(abortError(signal));
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		reader.read().then(resolve, reject).finally(() => {
+			signal.removeEventListener("abort", onAbort);
+		});
+	});
+}
+/** Consume and validate a newline-delimited JSON response body. */
+async function consumeNdjson({ body, schema, onEvent, isTerminal = () => false, signal, prematureEofError = () => /* @__PURE__ */ new Error("Stream closed before a terminal event was received") }) {
+	const reader = body.getReader();
+	const decoder = new TextDecoder();
+	let buffer = "";
+	let terminal = false;
+	const consumeLine = async (line) => {
+		const trimmed = line.trim();
+		if (!trimmed) return;
+		const event = schema.parse(JSON.parse(trimmed));
+		await onEvent(event);
+		if (isTerminal(event)) terminal = true;
+	};
+	try {
+		for (;;) {
+			const { done, value } = await readWithAbort(reader, signal);
+			if (done) break;
+			buffer += decoder.decode(value, { stream: true });
+			let newline = buffer.indexOf("\n");
+			while (newline >= 0) {
+				await consumeLine(buffer.slice(0, newline));
+				buffer = buffer.slice(newline + 1);
+				newline = buffer.indexOf("\n");
+			}
+		}
+		buffer += decoder.decode();
+		await consumeLine(buffer);
+		if (!terminal) throw prematureEofError();
+	} finally {
+		reader.releaseLock();
+	}
+}
+//#endregion
+//#region src/components/useNdjsonRun.ts
+function defaultErrorMessage(cause) {
+	return cause instanceof Error ? cause.message : String(cause);
+}
+function useNdjsonRun({ schema, request, onStart, onEvent, onError, isTerminal, errorLabel, emptyBodyMessage, prematureEofError, formatError = defaultErrorMessage, statusMessages }) {
+	const [error, setError] = useState(null);
+	const [loading, setLoading] = useState(false);
+	const abortRef = useRef(null);
+	const requestIdRef = useRef(0);
+	const run = useCallback((...args) => {
+		abortRef.current?.abort();
+		const controller = new AbortController();
+		const requestId = requestIdRef.current + 1;
+		requestIdRef.current = requestId;
+		abortRef.current = controller;
+		const isActive = () => abortRef.current === controller && requestIdRef.current === requestId && !controller.signal.aborted;
+		const context = {
+			signal: controller.signal,
+			isActive
+		};
+		setError(null);
+		setLoading(true);
+		onStart?.(context, ...args);
+		request(controller.signal, ...args).then(async (response) => {
+			if (!isActive()) return;
+			if (!response.ok) throw await responseError(response, {
+				label: errorLabel,
+				statusMessages
+			});
+			if (!response.body) throw new Error(emptyBodyMessage);
+			await consumeNdjson({
+				body: response.body,
+				schema,
+				signal: controller.signal,
+				isTerminal,
+				prematureEofError,
+				onEvent: async (event) => {
+					if (isActive()) await onEvent(event, context);
+				}
+			});
+		}).catch((cause) => {
+			if (isActive()) {
+				onError?.(cause);
+				setError(formatError(cause));
+			}
+		}).finally(() => {
+			if (isActive()) setLoading(false);
+		});
+	}, [
+		emptyBodyMessage,
+		errorLabel,
+		formatError,
+		isTerminal,
+		onEvent,
+		onError,
+		onStart,
+		prematureEofError,
+		request,
+		schema,
+		statusMessages
+	]);
+	useEffect(() => () => abortRef.current?.abort(), []);
+	return {
+		error,
+		loading,
+		run,
+		setError
+	};
+}
+//#endregion
+//#region src/lib/client-stream-contracts.ts
+var statusEventSchema = z.object({
+	type: z.literal("status"),
+	label: z.string(),
+	detail: z.string().optional()
+});
+var deltaEventSchema = z.object({
+	type: z.literal("delta"),
+	delta: z.string()
+});
+var errorEventSchema = z.object({
+	type: z.literal("error"),
+	error: z.string()
+});
+var periodContextSchema = z.looseObject({
+	includeDms: z.boolean(),
+	counts: z.looseObject({
+		home: z.number(),
+		mentions: z.number(),
+		links: z.number(),
+		dms: z.number()
+	}),
+	tweets: z.array(z.unknown())
+});
+var discussionContextSchema = z.looseObject({
+	includeDms: z.boolean(),
+	counts: z.looseObject({
+		search: z.number(),
+		home: z.number(),
+		mentions: z.number(),
+		authored: z.number(),
+		likes: z.number(),
+		bookmarks: z.number(),
+		dms: z.number()
+	}),
+	tweets: z.array(z.unknown())
+});
+var profileContextSchema = z.looseObject({
+	handle: z.string(),
+	profile: z.looseObject({ handle: z.string() }),
+	profiles: z.array(z.unknown()).optional(),
+	tweets: z.array(z.unknown()),
+	conversations: z.array(z.unknown()),
+	counts: z.looseObject({
+		tweets: z.number(),
+		conversationTweets: z.number(),
+		conversationsScanned: z.number()
+	})
+});
+var runResultSchema = (context) => z.looseObject({
+	context,
+	markdown: z.string(),
+	cached: z.boolean()
+});
+var periodDigestStreamEventSchema = z.discriminatedUnion("type", [
+	statusEventSchema,
+	z.object({
+		type: z.literal("start"),
+		context: periodContextSchema,
+		cached: z.boolean()
+	}),
+	deltaEventSchema,
+	z.object({
+		type: z.literal("done"),
+		result: runResultSchema(periodContextSchema)
+	}),
+	errorEventSchema
+]);
+var searchDiscussionStreamEventSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("start"),
+		context: discussionContextSchema,
+		cached: z.boolean()
+	}),
+	deltaEventSchema,
+	z.object({
+		type: z.literal("done"),
+		result: runResultSchema(discussionContextSchema)
+	}),
+	errorEventSchema
+]);
+var profileAnalysisStreamEventSchema = z.discriminatedUnion("type", [
+	statusEventSchema,
+	z.object({
+		type: z.literal("start"),
+		context: profileContextSchema,
+		cached: z.boolean()
+	}),
+	deltaEventSchema,
+	z.object({
+		type: z.literal("done"),
+		result: runResultSchema(profileContextSchema)
+	}),
+	errorEventSchema
+]);
+function isTerminalStreamEvent(event) {
+	return event.type === "done" || event.type === "error";
+}
+//#endregion
+export { useNdjsonRun as a, searchDiscussionStreamEventSchema as i, periodDigestStreamEventSchema as n, MarkdownViewer as o, profileAnalysisStreamEventSchema as r, isTerminalStreamEvent as t };