birdclaw 0.8.3 → 0.8.4

package/src/components/MarkdownViewer.tsx

@@ -1,111 +0,0 @@
-import type { ReactNode } from "react";
-import { cx } from "#/lib/ui";
-import {
-	buildLookup,
-	type CitationContext,
-	renderInline,
-	trimBullet,
-} from "./MarkdownCitations";
-
-export function MarkdownViewer({
-	markdown,
-	context,
-	className,
-}: {
-	markdown: string;
-	context?: CitationContext | null;
-	className?: string;
-}) {
-	const lookup = buildLookup(context);
-	const normalizedMarkdown = markdown.replace(
-		/\]\s*\r?\n\s*\((https?:\/\/[^\s)]+)\)/g,
-		"]($1)",
-	);
-	const lines = normalizedMarkdown.split(/\r?\n/);
-	const nodes: ReactNode[] = [];
-	let listItems: ReactNode[][] = [];
-
-	const flushList = () => {
-		if (listItems.length === 0) return;
-		nodes.push(
-			<ul
-				className="my-2.5 flex list-disc flex-col gap-1.5 pl-5 first:mt-0 marker:text-[var(--ink-soft)]"
-				key={`list-${String(nodes.length)}`}
-			>
-				{listItems.map((item, index) => (
-					<li key={String(index)}>{item}</li>
-				))}
-			</ul>,
-		);
-		listItems = [];
-	};
-
-	for (const line of lines) {
-		const trimmed = line.trim();
-		if (!trimmed) {
-			flushList();
-			continue;
-		}
-		if (trimmed.startsWith("### ")) {
-			flushList();
-			nodes.push(
-				<h3
-					className="mt-5 mb-1.5 text-[14px] font-bold uppercase tracking-wide text-[var(--ink-soft)] first:mt-0"
-					key={`h3-${String(nodes.length)}`}
-				>
-					{renderInline(trimmed.slice(4), lookup)}
-				</h3>,
-			);
-			continue;
-		}
-		if (trimmed.startsWith("## ")) {
-			flushList();
-			nodes.push(
-				<h2
-					className="mt-6 mb-2 text-[18px] font-bold text-[var(--ink)] first:mt-0"
-					key={`h2-${String(nodes.length)}`}
-				>
-					{renderInline(trimmed.slice(3), lookup)}
-				</h2>,
-			);
-			continue;
-		}
-		if (trimmed.startsWith("# ")) {
-			flushList();
-			nodes.push(
-				<h1
-					className="mt-0 mb-2.5 text-[20px] font-bold text-[var(--ink)]"
-					key={`h1-${String(nodes.length)}`}
-				>
-					{renderInline(trimmed.slice(2), lookup)}
-				</h1>,
-			);
-			continue;
-		}
-		if (/^[-*]\s+/.test(trimmed)) {
-			listItems.push(renderInline(trimBullet(trimmed), lookup));
-			continue;
-		}
-		flushList();
-		nodes.push(
-			<p
-				className="my-2.5 whitespace-pre-wrap first:mt-0 [overflow-wrap:anywhere]"
-				key={`p-${String(nodes.length)}`}
-			>
-				{renderInline(trimmed, lookup)}
-			</p>,
-		);
-	}
-	flushList();
-
-	return (
-		<article
-			className={cx(
-				"max-w-none px-4 py-3 text-[15px] leading-[1.55] text-[var(--ink)]",
-				className,
-			)}
-		>
-			{nodes}
-		</article>
-	);
-}

package/src/components/ProfileAnalysisClient.ts

@@ -1,191 +0,0 @@
-import type {
-	ProfileAnalysisContext,
-	ProfileAnalysisRunResult,
-} from "#/lib/profile-analysis";
-import type { ProfileRecord } from "#/lib/types";
-
-export interface ProfileAnalysisRequestOptions {
-	refresh: boolean;
-	maxTweets: number;
-	maxPages: number;
-	maxConversations: number;
-	maxConversationPages: number;
-}
-
-export const DEFAULT_PROFILE_ANALYSIS_LIMITS = {
-	maxTweets: 10000,
-	maxPages: 100,
-	maxConversations: 80,
-	maxConversationPages: 3,
-} as const;
-
-const PROFILE_HYDRATION_LIMIT = 50;
-const PROFILE_MENTION_RE = /(^|[^\w@./])@([A-Za-z0-9_]{1,15})\b/g;
-
-export function normalizeProfileHandle(value: string) {
-	return value.trim().replace(/^@/, "").toLowerCase();
-}
-
-export function handlesFromText(value: string) {
-	return Array.from(value.matchAll(PROFILE_MENTION_RE)).map(
-		(match) => match[2],
-	);
-}
-
-export function knownProfileHandles(context: ProfileAnalysisContext) {
-	const handles = new Set<string>();
-	handles.add(normalizeProfileHandle(context.profile.handle));
-	for (const profile of context.profiles ?? []) {
-		handles.add(normalizeProfileHandle(profile.handle));
-	}
-	for (const tweet of context.conversations) {
-		handles.add(normalizeProfileHandle(tweet.author));
-	}
-	return handles;
-}
-
-export function collectProfileAnalysisHydrationHandles({
-	context,
-	analysis,
-	markdown,
-}: {
-	context: ProfileAnalysisContext;
-	analysis?: ProfileAnalysisRunResult["analysis"];
-	markdown?: string;
-}) {
-	const handles = new Set<string>();
-	const known = knownProfileHandles(context);
-	const add = (value: string | undefined) => {
-		if (!value) return;
-		const handle = normalizeProfileHandle(value);
-		if (!/^[a-z0-9_]{1,15}$/.test(handle) || known.has(handle)) return;
-		handles.add(handle);
-	};
-
-	for (const handle of analysis?.sourceHandles ?? []) add(handle);
-	for (const theme of analysis?.themes ?? []) {
-		for (const handle of theme.handles) add(handle);
-	}
-	if (markdown) {
-		for (const handle of handlesFromText(markdown)) add(handle);
-	}
-	for (const handle of handlesFromText(context.profile.bio)) add(handle);
-	for (const tweet of context.tweets) {
-		for (const handle of handlesFromText(tweet.text)) add(handle);
-	}
-	for (const tweet of context.conversations) {
-		for (const handle of handlesFromText(tweet.text)) add(handle);
-		for (const handle of handlesFromText(tweet.bio)) add(handle);
-	}
-
-	return [...handles].slice(0, PROFILE_HYDRATION_LIMIT);
-}
-
-export function applyHydratedProfilesToProfileAnalysisContext(
-	context: ProfileAnalysisContext,
-	profiles: ProfileRecord[],
-) {
-	const existing = new Map<string, ProfileRecord>();
-	for (const profile of context.profiles ?? []) {
-		existing.set(normalizeProfileHandle(profile.handle), profile);
-	}
-	for (const profile of profiles) {
-		existing.set(normalizeProfileHandle(profile.handle), profile);
-	}
-	return {
-		...context,
-		profiles: [...existing.values()],
-	};
-}
-
-export async function hydrateProfileAnalysisContext({
-	context,
-	analysis,
-	markdown,
-	requestedHandles,
-}: {
-	context: ProfileAnalysisContext;
-	analysis?: ProfileAnalysisRunResult["analysis"];
-	markdown?: string;
-	requestedHandles?: Set<string>;
-}) {
-	const handles = collectProfileAnalysisHydrationHandles({
-		context,
-		analysis,
-		markdown,
-	}).filter((handle) => !requestedHandles?.has(handle));
-	if (handles.length === 0) return context;
-	for (const handle of handles) {
-		requestedHandles?.add(handle);
-	}
-	const url = new URL("/api/profile-hydrate", window.location.origin);
-	url.searchParams.set("handles", handles.join(","));
-	const response = await fetch(url);
-	if (!response.ok) return context;
-	const payload = (await response.json()) as {
-		results?: Array<{ status?: string; profile?: ProfileRecord }>;
-	};
-	const profiles = (payload.results ?? [])
-		.filter((item) => item.status === "hit" && item.profile)
-		.map((item) => item.profile as ProfileRecord);
-	return profiles.length > 0
-		? applyHydratedProfilesToProfileAnalysisContext(context, profiles)
-		: context;
-}
-
-export function profileAnalysisUrl(
-	handle: string,
-	options: ProfileAnalysisRequestOptions,
-) {
-	const params = new URLSearchParams();
-	params.set("handle", handle);
-	params.set("maxTweets", String(options.maxTweets));
-	params.set("maxPages", String(options.maxPages));
-	params.set("maxConversations", String(options.maxConversations));
-	params.set("maxConversationPages", String(options.maxConversationPages));
-	if (options.refresh) {
-		params.set("refresh", "true");
-	}
-	return `/api/profile-analysis?${params.toString()}`;
-}
-
-export async function profileAnalysisRequestError(response: Response) {
-	const status = `${String(response.status)}${response.statusText ? ` ${response.statusText}` : ""}`;
-	let detail = "";
-	try {
-		const contentType = response.headers.get("content-type") ?? "";
-		if (contentType.includes("application/json")) {
-			const payload = (await response.json()) as {
-				error?: unknown;
-				message?: unknown;
-			};
-			if (typeof payload.message === "string") detail = payload.message;
-			else if (typeof payload.error === "string") detail = payload.error;
-		} else {
-			detail = (await response.text()).trim();
-		}
-	} catch {
-		detail = "";
-	}
-	return new Error(
-		detail
-			? `Profile analysis failed (${status}): ${detail}`
-			: `Profile analysis failed (${status})`,
-	);
-}
-
-export function formatProfileAnalysisCounts(
-	context: ProfileAnalysisContext | null,
-) {
-	if (!context) return "xurl profile backfill with cached AI analysis.";
-	return [
-		context.fetchCached ? "cached backfill" : "fresh xurl backfill",
-		`${String(context.counts.tweets)} tweets`,
-		`${String(context.counts.conversationTweets)} conversation tweets`,
-		`${String(context.counts.conversationsScanned)} conversations`,
-	].join(" · ");
-}
-
-export function cleanProfileHandle(value: string) {
-	return value.trim().replace(/^@/, "");
-}

package/src/components/ProfileAnalysisStream.tsx

@@ -1,259 +0,0 @@
-import { CheckCircle2, Loader2, Sparkles } from "lucide-react";
-import { useCallback, useEffect, useRef, useState } from "react";
-import { MarkdownViewer } from "#/components/MarkdownViewer";
-import type {
-	ProfileAnalysisContext,
-	ProfileAnalysisRunResult,
-	ProfileAnalysisStreamEvent,
-} from "#/lib/profile-analysis";
-import type { ProfileRecord } from "#/lib/types";
-import { errorCopyClass } from "#/lib/ui";
-
-import {
-	DEFAULT_PROFILE_ANALYSIS_LIMITS,
-	applyHydratedProfilesToProfileAnalysisContext,
-	cleanProfileHandle,
-	hydrateProfileAnalysisContext,
-	normalizeProfileHandle,
-	profileAnalysisRequestError,
-	profileAnalysisUrl,
-} from "#/components/ProfileAnalysisClient";
-export {
-	DEFAULT_PROFILE_ANALYSIS_LIMITS,
-	cleanProfileHandle,
-	formatProfileAnalysisCounts,
-	profileAnalysisRequestError,
-	profileAnalysisUrl,
-} from "#/components/ProfileAnalysisClient";
-
-export interface ProfileAnalysisState {
-	context: ProfileAnalysisContext | null;
-	error: string | null;
-	loading: boolean;
-	markdown: string;
-	result: ProfileAnalysisRunResult | null;
-	run: (refresh?: boolean, overrideHandle?: string) => void;
-	status: string;
-}
-
-export function useProfileAnalysisStream(handle: string): ProfileAnalysisState {
-	const [markdown, setMarkdown] = useState("");
-	const [context, setContext] = useState<ProfileAnalysisContext | null>(null);
-	const [result, setResult] = useState<ProfileAnalysisRunResult | null>(null);
-	const [status, setStatus] = useState("Ready");
-	const [error, setError] = useState<string | null>(null);
-	const [loading, setLoading] = useState(false);
-	const abortRef = useRef<AbortController | null>(null);
-	const requestIdRef = useRef(0);
-
-	const run = useCallback(
-		(refresh = false, overrideHandle?: string) => {
-			const trimmed = cleanProfileHandle(overrideHandle ?? handle);
-			if (!trimmed) return;
-			abortRef.current?.abort();
-			const controller = new AbortController();
-			const requestId = requestIdRef.current + 1;
-			requestIdRef.current = requestId;
-			abortRef.current = controller;
-			const isActiveRequest = () =>
-				abortRef.current === controller &&
-				requestIdRef.current === requestId &&
-				!controller.signal.aborted;
-			const requestedHydrationHandles = new Set<string>();
-			const hydratedProfilesByHandle = new Map<string, ProfileRecord>();
-			const rememberHydratedProfiles = (
-				nextContext: ProfileAnalysisContext,
-			) => {
-				for (const profile of nextContext.profiles ?? []) {
-					hydratedProfilesByHandle.set(
-						normalizeProfileHandle(profile.handle),
-						profile,
-					);
-				}
-			};
-			const mergeKnownHydratedProfiles = (
-				nextContext: ProfileAnalysisContext,
-			) =>
-				hydratedProfilesByHandle.size > 0
-					? applyHydratedProfilesToProfileAnalysisContext(nextContext, [
-							...hydratedProfilesByHandle.values(),
-						])
-					: nextContext;
-			const hydrateContext = (
-				nextContext: ProfileAnalysisContext,
-				nextResult?: ProfileAnalysisRunResult,
-			) => {
-				void hydrateProfileAnalysisContext({
-					context: nextContext,
-					analysis: nextResult?.analysis,
-					markdown: nextResult?.markdown,
-					requestedHandles: requestedHydrationHandles,
-				})
-					.then((hydratedContext) => {
-						if (!isActiveRequest()) return;
-						if (hydratedContext === nextContext) return;
-						rememberHydratedProfiles(hydratedContext);
-						const mergedContext = mergeKnownHydratedProfiles(hydratedContext);
-						setContext(mergedContext);
-						if (nextResult) {
-							setResult({
-								...nextResult,
-								context: mergedContext,
-							});
-						}
-					})
-					.catch(() => {
-						// Profile hover hydration is best-effort; analysis remains usable.
-					});
-			};
-			setMarkdown("");
-			setContext(null);
-			setResult(null);
-			setError(null);
-			setLoading(true);
-			setStatus("Starting profile analysis");
-
-			fetch(
-				profileAnalysisUrl(trimmed, {
-					refresh,
-					...DEFAULT_PROFILE_ANALYSIS_LIMITS,
-				}),
-				{ signal: controller.signal },
-			)
-				.then(async (response) => {
-					if (!response.ok) {
-						throw await profileAnalysisRequestError(response);
-					}
-					if (!response.body) {
-						throw new Error("Profile analysis failed: empty response body");
-					}
-					const reader = response.body.getReader();
-					const decoder = new TextDecoder();
-					let buffer = "";
-					const pump = (): Promise<void> =>
-						reader.read().then(({ done, value }) => {
-							if (!isActiveRequest()) return;
-							if (done) return;
-							buffer += decoder.decode(value, { stream: true });
-							let newline = buffer.indexOf("\n");
-							while (newline >= 0) {
-								const line = buffer.slice(0, newline).trim();
-								buffer = buffer.slice(newline + 1);
-								if (line) {
-									const event = JSON.parse(line) as ProfileAnalysisStreamEvent;
-									if (!isActiveRequest()) return;
-									if (event.type === "status") {
-										setStatus(
-											event.detail
-												? `${event.label} · ${event.detail}`
-												: event.label,
-										);
-									} else if (event.type === "start") {
-										setContext(event.context);
-										setStatus(
-											event.cached
-												? "Loading cached analysis"
-												: "Summarizing profile",
-										);
-										hydrateContext(event.context);
-									} else if (event.type === "delta") {
-										setMarkdown((current) => current + event.delta);
-									} else if (event.type === "done") {
-										const mergedContext = mergeKnownHydratedProfiles(
-											event.result.context,
-										);
-										const mergedResult =
-											mergedContext === event.result.context
-												? event.result
-												: {
-														...event.result,
-														context: mergedContext,
-													};
-										setResult(mergedResult);
-										setContext(mergedContext);
-										setMarkdown(event.result.markdown);
-										setStatus(event.result.cached ? "Cached" : "Complete");
-										hydrateContext(mergedContext, mergedResult);
-									} else if (event.type === "error") {
-										setError(event.error);
-									}
-								}
-								newline = buffer.indexOf("\n");
-							}
-							return pump();
-						});
-					return pump();
-				})
-				.catch((cause: unknown) => {
-					if (!isActiveRequest()) return;
-					setError(cause instanceof Error ? cause.message : "Analysis failed");
-				})
-				.finally(() => {
-					if (!isActiveRequest()) return;
-					setLoading(false);
-				});
-		},
-		[handle],
-	);
-
-	useEffect(
-		() => () => {
-			abortRef.current?.abort();
-		},
-		[],
-	);
-
-	return { context, error, loading, markdown, result, run, status };
-}
-
-export function ProfileAnalysisStatusLine({
-	analysis,
-	className = "",
-}: {
-	analysis: ProfileAnalysisState;
-	className?: string;
-}) {
-	return (
-		<div
-			className={`flex items-center gap-2 text-[13px] font-medium text-[var(--ink-soft)] ${className}`}
-		>
-			{analysis.loading ? (
-				<Loader2 className="size-4 animate-spin" strokeWidth={1.8} />
-			) : analysis.result ? (
-				<CheckCircle2 className="size-4" strokeWidth={1.8} />
-			) : (
-				<Sparkles className="size-4" strokeWidth={1.8} />
-			)}
-			<span>{analysis.status}</span>
-		</div>
-	);
-}
-
-export function ProfileAnalysisOutput({
-	analysis,
-	emptyLabel = "No profile selected.",
-}: {
-	analysis: ProfileAnalysisState;
-	emptyLabel?: string;
-}) {
-	return (
-		<>
-			{analysis.error ? (
-				<div className={errorCopyClass}>{analysis.error}</div>
-			) : null}
-
-			{analysis.markdown ? (
-				<div className="max-w-3xl">
-					<MarkdownViewer
-						context={analysis.context}
-						markdown={analysis.markdown}
-					/>
-				</div>
-			) : (
-				<div className="rounded-[8px] border border-[var(--line)] bg-[var(--panel)] p-6 text-[14px] text-[var(--ink-soft)]">
-					{emptyLabel}
-				</div>
-			)}
-		</>
-	);
-}

package/src/components/ProfilePreview.tsx

@@ -1,131 +0,0 @@
-import { Fragment, type ReactNode } from "react";
-import { formatCompactNumber } from "#/lib/present";
-import {
-	collectTweetSegmentsForText,
-	profileDescriptionEntitiesFromXurl,
-} from "#/lib/tweet-render";
-import type { ProfileRecord } from "#/lib/types";
-import {
-	cx,
-	profilePreviewBioClass,
-	profilePreviewCardClass,
-	profilePreviewClass,
-	profilePreviewHandleClass,
-	profilePreviewHeaderClass,
-	profilePreviewMetaClass,
-	profilePreviewNameClass,
-	profilePreviewTriggerClass,
-	tweetLinkClass,
-} from "#/lib/ui";
-import { safeHttpUrl } from "#/lib/url-safety";
-import { AvatarChip } from "./AvatarChip";
-import { useAvatarPreload } from "./AvatarPreload";
-import { useFloatingPreview } from "./FloatingPreview";
-
-function ProfilePreviewBio({ profile }: { profile: ProfileRecord }) {
-	const segments = collectTweetSegmentsForText(
-		profile.bio,
-		profileDescriptionEntitiesFromXurl(profile.entities),
-	);
-	let cursor = 0;
-
-	return (
-		<span className={profilePreviewBioClass}>
-			{segments.map((segment, index) => {
-				if (
-					segment.kind !== "url" ||
-					segment.start < cursor ||
-					segment.end <= segment.start ||
-					segment.end > profile.bio.length
-				) {
-					return null;
-				}
-				const prefix = profile.bio.slice(cursor, segment.start);
-				cursor = segment.end;
-				const href = safeHttpUrl(segment.expandedUrl);
-				return (
-					<Fragment key={`${segment.url}-${String(index)}`}>
-						{prefix}
-						{href ? (
-							<a
-								className={tweetLinkClass}
-								href={href}
-								rel="noreferrer"
-								target="_blank"
-							>
-								{segment.expandedUrl}
-							</a>
-						) : (
-							profile.bio.slice(segment.start, segment.end)
-						)}
-					</Fragment>
-				);
-			})}
-			{profile.bio.slice(cursor)}
-		</span>
-	);
-}
-
-export function ProfilePreview({
-	profile,
-	children,
-	className = "",
-}: {
-	profile: ProfileRecord;
-	children: ReactNode;
-	className?: string;
-}) {
-	const preview = useFloatingPreview();
-	useAvatarPreload(preview.referenceRef, profile.id, profile.avatarUrl);
-
-	return (
-		<span
-			ref={preview.referenceRef}
-			className={cx(profilePreviewClass, className)}
-			{...preview.referenceProps}
-		>
-			<a
-				aria-controls={preview.open ? preview.floatingId : undefined}
-				aria-expanded={preview.open}
-				className={profilePreviewTriggerClass}
-				href={`/profiles/${encodeURIComponent(profile.handle)}`}
-			>
-				{children}
-			</a>
-			{preview.open ? (
-				<span
-					aria-label={`${profile.displayName} profile preview`}
-					id={preview.floatingId}
-					ref={preview.floatingRef}
-					className={profilePreviewCardClass}
-					role="group"
-					style={preview.floatingStyle}
-					{...preview.floatingProps}
-				>
-					<span className="grid gap-2" data-floating-preview-content>
-						<span className={profilePreviewHeaderClass}>
-							<AvatarChip
-								avatarUrl={profile.avatarUrl}
-								hue={profile.avatarHue}
-								name={profile.displayName}
-								profileId={profile.id}
-							/>
-							<span className="flex min-w-0 flex-col">
-								<span className={profilePreviewNameClass}>
-									{profile.displayName}
-								</span>
-								<span className={profilePreviewHandleClass}>
-									@{profile.handle}
-								</span>
-							</span>
-						</span>
-						{profile.bio ? <ProfilePreviewBio profile={profile} /> : null}
-						<span className={profilePreviewMetaClass}>
-							{formatCompactNumber(profile.followersCount)} followers
-						</span>
-					</span>
-				</span>
-			) : null}
-		</span>
-	);
-}