birdclaw 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # CHANGELOG
 
+## 0.8.1 - 2026-06-13
+
+### Changed
+
+- Refresh dependency backstop updates for `@steipete/sweet-cookie`, `@types/node`, the adopted TypeScript native-preview toolchain, and the pnpm 10 package-manager pin.
+- Remove the separate public read-only web profile; deployments can expose the full private app behind an external authentication boundary.
+- Show recent web timestamps as live relative time, then switch to calendar dates with exact local time on hover.
+
+### Fixed
+
+- Open long-running AI streams immediately, keep the Today digest within proxy limits by using the locally synchronized archive, and show actionable retry errors when a connection is interrupted.
+- Reuse freshly generated Today reports across reloads while background sync updates the archive, and hydrate locally stored cited tweets so source hovercards remain available outside the selected time window.
+
 ## 0.8.0 - 2026-06-10
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "birdclaw",
-	"version": "0.8.0",
+	"version": "0.8.1",
 	"description": "Local Twitter memory in SQLite for archives, DMs, likes, bookmarks, and moderation",
 	"homepage": "https://github.com/steipete/birdclaw#readme",
 	"license": "MIT",
@@ -52,7 +52,7 @@
 		"docs:site": "node scripts/build-docs-site.mjs"
 	},
 	"dependencies": {
-		"@steipete/sweet-cookie": "^0.3.0",
+		"@steipete/sweet-cookie": "^0.4.0",
 		"@tailwindcss/vite": "^4.3.0",
 		"@tanstack/devtools-vite": "0.7.0",
 		"@tanstack/react-devtools": "0.10.5",
@@ -83,11 +83,11 @@
 		"@testing-library/jest-dom": "^6.9.1",
 		"@testing-library/react": "^16.3.2",
 		"@types/geojson": "^7946.0.16",
-		"@types/node": "^25.9.2",
+		"@types/node": "^25.9.3",
 		"@types/react": "^19.2.17",
 		"@types/react-dom": "^19.2.3",
 		"@types/supercluster": "^7.1.3",
-		"@typescript/native-preview": "7.0.0-dev.20260609.1",
+		"@typescript/native-preview": "7.0.0-dev.20260611.2",
 		"@vitest/coverage-v8": "^4.1.8",
 		"jsdom": "^29.1.1",
 		"oxfmt": "^0.54.0",
@@ -98,5 +98,5 @@
 	"engines": {
 		"node": ">=25.8.1 <27"
 	},
-	"packageManager": "pnpm@10.31.0"
+	"packageManager": "pnpm@10.34.3"
 }

package/src/components/ConversationThread.tsx

@@ -1,5 +1,4 @@
 import { MessageCircle } from "lucide-react";
-import { formatShortTimestamp } from "#/lib/present";
 import type { EmbeddedTweet } from "#/lib/types";
 import {
 	cx,
@@ -11,6 +10,7 @@ import {
 import { AvatarChip } from "./AvatarChip";
 import { BirdclawEmpty, BirdclawLoading } from "./BrandMark";
 import { ProfilePreview } from "./ProfilePreview";
+import { SmartTimestamp } from "./SmartTimestamp";
 import { TweetMediaGrid } from "./TweetMediaGrid";
 import { TweetRichText } from "./TweetRichText";
 
@@ -101,9 +101,10 @@ export function ConversationThread({
 										</span>
 									</ProfilePreview>
 									<span className="text-[var(--ink-soft)]">·</span>
-									<span className={feedRowTimestampClass}>
-										{formatShortTimestamp(tweet.createdAt)}
-									</span>
+									<SmartTimestamp
+										className={feedRowTimestampClass}
+										value={tweet.createdAt}
+									/>
 									{isAnchor ? (
 										<span className="ml-auto rounded-full bg-[var(--accent)] px-2 py-0.5 text-[11px] font-bold text-white">
 											selected

package/src/components/DmWorkspace.tsx

@@ -1,5 +1,5 @@
 import { CheckCircle2, Circle } from "lucide-react";
-import { formatCompactNumber, formatShortTimestamp } from "#/lib/present";
+import { formatCompactNumber } from "#/lib/present";
 import type { DmConversationItem, DmMessageItem } from "#/lib/types";
 import {
 	composerBarClass,
@@ -39,6 +39,7 @@ import {
 } from "#/lib/ui";
 import { AvatarChip } from "./AvatarChip";
 import { BirdclawEmpty } from "./BrandMark";
+import { SmartTimestamp } from "./SmartTimestamp";
 
 function MessageBubble({ message }: { message: DmMessageItem }) {
 	const outbound = message.direction === "outbound";
@@ -57,7 +58,7 @@ function MessageBubble({ message }: { message: DmMessageItem }) {
 			<div className={dmMessageMetaClass}>
 				<span>{message.sender.displayName}</span>
 				<span>·</span>
-				<span>{formatShortTimestamp(message.createdAt)}</span>
+				<SmartTimestamp value={message.createdAt} />
 			</div>
 		</div>
 	);
@@ -81,9 +82,13 @@ export function DmWorkspace({
 	onReplySend: (conversationId: string) => void;
 }) {
 	const participant = selectedConversation?.participant ?? null;
-	const subtitle = selectedConversation
-		? `${selectedConversation.isMessageRequest ? "Message request" : selectedConversation.needsReply ? "Reply open" : "We replied"} · last message ${formatShortTimestamp(selectedConversation.lastMessageAt)}`
-		: "No conversation selected";
+	const selectedStatus = selectedConversation
+		? selectedConversation.isMessageRequest
+			? "Message request"
+			: selectedConversation.needsReply
+				? "Reply open"
+				: "We replied"
+		: null;
 
 	return (
 		<section aria-label="DM workspace" className={dmShellClass}>
@@ -119,9 +124,10 @@ export function DmWorkspace({
 											@{conversation.participant.handle}
 										</span>
 									</div>
-									<span className={dmListTimestampClass}>
-										{formatShortTimestamp(conversation.lastMessageAt)}
-									</span>
+									<SmartTimestamp
+										className={dmListTimestampClass}
+										value={conversation.lastMessageAt}
+									/>
 								</div>
 								<p className={dmListPreviewClass}>
 									{conversation.lastMessagePreview}
@@ -176,7 +182,18 @@ export function DmWorkspace({
 									<div className={dmThreadNameClass}>
 										{selectedConversation.participant.displayName}
 									</div>
-									<div className={dmThreadSubtitleClass}>{subtitle}</div>
+									<div className={dmThreadSubtitleClass}>
+										{selectedStatus && selectedConversation ? (
+											<>
+												{selectedStatus} · last message{" "}
+												<SmartTimestamp
+													value={selectedConversation.lastMessageAt}
+												/>
+											</>
+										) : (
+											"No conversation selected"
+										)}
+									</div>
 								</div>
 							</div>
 							<button

package/src/components/EmbeddedTweetCard.tsx

@@ -1,4 +1,3 @@
-import { formatShortTimestamp } from "#/lib/present";
 import type { EmbeddedTweet } from "#/lib/types";
 import {
 	embeddedCardBodyClass,
@@ -10,6 +9,7 @@ import {
 	feedRowTimestampClass,
 } from "#/lib/ui";
 import { ProfilePreview } from "./ProfilePreview";
+import { SmartTimestamp } from "./SmartTimestamp";
 import { TweetMediaGrid } from "./TweetMediaGrid";
 import { TweetRichText } from "./TweetRichText";
 
@@ -35,9 +35,10 @@ export function EmbeddedTweetCard({
 					</span>
 				</ProfilePreview>
 				<span className="text-[var(--ink-soft)]">·</span>
-				<span className={feedRowTimestampClass}>
-					{formatShortTimestamp(item.createdAt)}
-				</span>
+				<SmartTimestamp
+					className={feedRowTimestampClass}
+					value={item.createdAt}
+				/>
 			</header>
 			<TweetRichText
 				className={embeddedCardCopyClass}

package/src/components/InboxCard.tsx

@@ -5,7 +5,7 @@ import {
 	ExternalLink,
 	MessageCircle,
 } from "lucide-react";
-import { formatCompactNumber, formatShortTimestamp } from "#/lib/present";
+import { formatCompactNumber } from "#/lib/present";
 import type { InboxItem } from "#/lib/types";
 import {
 	composerBarClass,
@@ -30,6 +30,7 @@ import {
 	timestampClass,
 } from "#/lib/ui";
 import { AvatarChip } from "./AvatarChip";
+import { SmartTimestamp } from "./SmartTimestamp";
 
 export function InboxCard({
 	item,
@@ -65,9 +66,10 @@ export function InboxCard({
 						</span>
 					</span>
 					<span className={feedRowDotClass}>·</span>
-					<span className={feedRowTimestampClass}>
-						{formatShortTimestamp(item.createdAt)}
-					</span>
+					<SmartTimestamp
+						className={feedRowTimestampClass}
+						value={item.createdAt}
+					/>
 					<span className="ml-auto flex items-center gap-1.5">
 						<span className={cx(pillClass, pillSoftClass)}>
 							{item.entityKind}

package/src/components/MarkdownViewer.tsx

@@ -6,7 +6,7 @@ import {
 	useRef,
 	useState,
 } from "react";
-import { formatCompactNumber, formatShortTimestamp } from "#/lib/present";
+import { formatCompactNumber } from "#/lib/present";
 import type { PeriodDigestContext } from "#/lib/period-digest";
 import type { ProfileAnalysisContext } from "#/lib/profile-analysis";
 import { renderTweetPlainText } from "#/lib/tweet-render";
@@ -15,6 +15,7 @@ import { cx, tweetLinkClass, tweetMentionClass } from "#/lib/ui";
 import { safeHttpUrl } from "#/lib/url-safety";
 import { AvatarChip } from "./AvatarChip";
 import { ProfilePreview } from "./ProfilePreview";
+import { SmartTimestamp } from "./SmartTimestamp";
 
 type CitationTweet = PeriodDigestContext["tweets"][number];
 type CitationContext = PeriodDigestContext | ProfileAnalysisContext;
@@ -231,7 +232,7 @@ function TweetPreviewToken({
 					<span className="min-w-0">
 						<span className="block truncate font-bold">{tweet.name}</span>
 						<span className="block truncate text-[12px] text-[var(--ink-soft)]">
-							@{tweet.author} · {formatShortTimestamp(tweet.createdAt)}
+							@{tweet.author} · <SmartTimestamp value={tweet.createdAt} />
 						</span>
 					</span>
 				</span>

package/src/components/SmartTimestamp.tsx

@@ -0,0 +1,72 @@
+import { useSyncExternalStore } from "react";
+import {
+	formatExactTimestamp,
+	formatShortTimestamp,
+	formatSmartTimestamp,
+} from "#/lib/present";
+
+const CLOCK_INTERVAL_MS = 30_000;
+
+type ClockSnapshot = number | null;
+
+const listeners = new Set<() => void>();
+let currentNow = Date.now();
+let clockInterval: ReturnType<typeof setInterval> | null = null;
+
+function updateClock() {
+	currentNow = Date.now();
+	for (const listener of listeners) listener();
+}
+
+function subscribeToClock(listener: () => void) {
+	listeners.add(listener);
+
+	if (clockInterval === null) {
+		currentNow = Date.now();
+		clockInterval = setInterval(updateClock, CLOCK_INTERVAL_MS);
+	}
+
+	return () => {
+		listeners.delete(listener);
+		if (listeners.size === 0 && clockInterval !== null) {
+			clearInterval(clockInterval);
+			clockInterval = null;
+		}
+	};
+}
+
+function getClockSnapshot(): ClockSnapshot {
+	return currentNow;
+}
+
+function getServerClockSnapshot(): ClockSnapshot {
+	return null;
+}
+
+export function SmartTimestamp({
+	className,
+	value,
+}: {
+	className?: string;
+	value: string;
+}) {
+	const now = useSyncExternalStore(
+		subscribeToClock,
+		getClockSnapshot,
+		getServerClockSnapshot,
+	);
+	const exactTimestamp = formatExactTimestamp(value);
+
+	return (
+		<time
+			aria-label={exactTimestamp}
+			className={className}
+			dateTime={value}
+			title={exactTimestamp}
+		>
+			{now === null
+				? formatShortTimestamp(value)
+				: formatSmartTimestamp(value, now)}
+		</time>
+	);
+}

package/src/components/TimelineCard.tsx

@@ -8,7 +8,7 @@ import {
 	Repeat2,
 	UserSearch,
 } from "lucide-react";
-import { formatCompactNumber, formatShortTimestamp } from "#/lib/present";
+import { formatCompactNumber } from "#/lib/present";
 import { normalizeTweetUrlEntityRangeForText } from "#/lib/tweet-render";
 import type {
 	TimelineItem,
@@ -41,6 +41,7 @@ import { ConversationThread } from "./ConversationThread";
 import { EmbeddedTweetCard } from "./EmbeddedTweetCard";
 import { LinkPreviewCard } from "./LinkPreviewCard";
 import { ProfilePreview } from "./ProfilePreview";
+import { SmartTimestamp } from "./SmartTimestamp";
 import { TweetMediaGrid } from "./TweetMediaGrid";
 import { TweetRichText } from "./TweetRichText";
 
@@ -312,9 +313,10 @@ export function TimelineCard({
 						</span>
 					</ProfilePreview>
 					<span className={feedRowDotClass}>·</span>
-					<span className={feedRowTimestampClass}>
-						{formatShortTimestamp(displayTweet.createdAt)}
-					</span>
+					<SmartTimestamp
+						className={feedRowTimestampClass}
+						value={displayTweet.createdAt}
+					/>
 					{canReply || hasConversation ? (
 						<span className="ml-auto inline-flex items-center gap-1">
 							{hasConversation ? (

package/src/lib/ndjson-stream.ts

@@ -0,0 +1,106 @@
+import { Effect } from "effect";
+import { runEffectBackground } from "./effect-runtime";
+
+const encoder = new TextEncoder();
+const HEARTBEAT_INTERVAL_MS = 15_000;
+const STREAM_START_DELAY_MS = 25;
+const FLUSH_PADDING = `${" ".repeat(16_384)}\n`;
+
+export function createEffectNdjsonResponse<Event>({
+	request,
+	initialEvents = [],
+	run,
+	errorEvent,
+}: {
+	request: Request;
+	initialEvents?: Event[];
+	run: (context: {
+		signal: AbortSignal;
+		emit: (event: Event) => void;
+	}) => Effect.Effect<unknown, unknown>;
+	errorEvent: (error: unknown) => Event;
+}) {
+	let abortStream: (() => void) | undefined;
+
+	return new Response(
+		new ReadableStream<Uint8Array>({
+			cancel() {
+				abortStream?.();
+			},
+			start(controller) {
+				const abortController = new AbortController();
+				let closed = false;
+				let heartbeat: ReturnType<typeof setInterval> | undefined;
+				let startTimer: ReturnType<typeof setTimeout> | undefined;
+
+				const cleanup = () => {
+					request.signal.removeEventListener("abort", abort);
+					if (heartbeat !== undefined) clearInterval(heartbeat);
+					if (startTimer !== undefined) clearTimeout(startTimer);
+				};
+				const abort = () => {
+					if (closed) return;
+					closed = true;
+					cleanup();
+					abortController.abort();
+				};
+				const close = () => {
+					if (closed) return;
+					closed = true;
+					cleanup();
+					abortController.abort();
+					controller.close();
+				};
+				const enqueue = (value: string) => {
+					if (closed) return;
+					try {
+						controller.enqueue(encoder.encode(value));
+					} catch {
+						abort();
+					}
+				};
+				const emit = (event: Event) => {
+					enqueue(`${JSON.stringify(event)}\n`);
+				};
+
+				request.signal.addEventListener("abort", abort, { once: true });
+				abortStream = abort;
+				if (request.signal.aborted) {
+					abort();
+					controller.close();
+					return;
+				}
+				for (const event of initialEvents) emit(event);
+				enqueue(FLUSH_PADDING);
+				heartbeat = setInterval(
+					() => enqueue(FLUSH_PADDING),
+					HEARTBEAT_INTERVAL_MS,
+				);
+
+				startTimer = setTimeout(() => {
+					if (closed) return;
+					try {
+						runEffectBackground(run({ signal: abortController.signal, emit }), {
+							onSuccess: close,
+							onFailure: (error) => {
+								emit(errorEvent(error));
+								close();
+							},
+						});
+					} catch (error) {
+						emit(errorEvent(error));
+						close();
+					}
+				}, STREAM_START_DELAY_MS);
+			},
+		}),
+		{
+			headers: {
+				"cache-control": "no-store, no-transform",
+				"content-encoding": "identity",
+				"content-type": "application/x-ndjson; charset=utf-8",
+				"x-accel-buffering": "no",
+			},
+		},
+	);
+}