Skip to content

armgit / alook

Public Imported from GitHub
0

Multi-Agent Collaboration for Team and Friends

feat(app): add message flagging, improve chat sheet UX, fix inbox read timing

Guscd3c23356e81
diff --git a/src/shared/src/db/queries-index.ts b/src/shared/src/db/queries-index.ts
index 402ebdd76..99b57067d 100644
--- a/src/shared/src/db/queries-index.ts
+++ b/src/shared/src/db/queries-index.ts
@@ -28,3 +28,4 @@ export * as agentLink from "./queries/agent-link";
export * as inbox from "./queries/inbox";
export * as issue from "./queries/issue";
export * as issueComment from "./queries/issue-comment";
+export * as messageFlag from "./queries/message-flag";
diff --git a/src/shared/src/db/queries/message-flag.ts b/src/shared/src/db/queries/message-flag.ts
new file mode 100644
index 000000000..c2e01e6ae
--- /dev/null
+++ b/src/shared/src/db/queries/message-flag.ts
@@ -0,0 +1,137 @@
+import { eq, and, sql } from "drizzle-orm";
+import { messageFlag, message, conversation } from "../schema";
+import type { Database } from "../index";
+
+export async function getMessageWorkspaceId(
+ db: Database,
+ messageId: string
+): Promise<string | null> {
+ const rows = await db
+ .select({ workspaceId: conversation.workspaceId })
+ .from(message)
+ .innerJoin(conversation, eq(conversation.id, message.conversationId))
+ .where(eq(message.id, messageId))
+ .limit(1);
+ return rows[0]?.workspaceId ?? null;
+}
+
+export async function flagMessage(
+ db: Database,
+ data: { messageId: string; userId: string; workspaceId: string }
+) {
+ const rows = await db
+ .insert(messageFlag)
+ .values(data)
+ .onConflictDoNothing()
+ .returning();
+ return rows[0] ?? null;
+}
+
+export async function unflagMessage(
+ db: Database,
+ messageId: string,
+ userId: string,
+ workspaceId: string
+) {
+ const rows = await db
+ .delete(messageFlag)
+ .where(
+ and(
+ eq(messageFlag.messageId, messageId),
+ eq(messageFlag.userId, userId),
+ eq(messageFlag.workspaceId, workspaceId)
+ )
+ )
+ .returning();
+ return rows[0] ?? null;
+}
+
+export async function listFlaggedMessages(
+ db: Database,
+ userId: string,
+ workspaceId: string,
+ opts?: { limit?: number; before?: string }
+) {
+ const limit = opts?.limit ?? 30;
+ const beforeClause = opts?.before
+ ? sql`AND mf.created_at < ${opts.before}`
+ : sql``;
+
+ const rows = await db.all<{
+ id: string;
+ message_id: string;
+ message_content: string;
+ message_role: string;
+ message_created_at: string;
+ conversation_id: string;
+ conversation_title: string;
+ agent_id: string;
+ agent_name: string | null;
+ agent_avatar_url: string | null;
+ flagged_at: string;
+ }>(sql`
+ SELECT
+ mf.id,
+ mf.message_id,
+ m.content AS message_content,
+ m.role AS message_role,
+ m.created_at AS message_created_at,
+ c.id AS conversation_id,
+ c.title AS conversation_title,
+ c.agent_id,
+ a.name AS agent_name,
+ a.avatar_url AS agent_avatar_url,
+ mf.created_at AS flagged_at
+ FROM message_flag mf
+ INNER JOIN message m ON m.id = mf.message_id
+ INNER JOIN conversation c ON c.id = m.conversation_id
+ LEFT JOIN agent a ON a.id = c.agent_id AND a.workspace_id = c.workspace_id
+ WHERE mf.user_id = ${userId}
+ AND mf.workspace_id = ${workspaceId}
+ ${beforeClause}
+ ORDER BY mf.created_at DESC
+ LIMIT ${limit + 1}
+ `);
+
+ const hasMore = rows.length > limit;
+ const items = rows.slice(0, limit);
+
+ return { items, hasMore };
+}
+
+export async function getFlaggedCount(
+ db: Database,
+ userId: string,
+ workspaceId: string
+) {
+ const rows = await db
+ .select({ count: sql<number>`COUNT(*)` })
+ .from(messageFlag)
+ .where(
+ and(
+ eq(messageFlag.userId, userId),
+ eq(messageFlag.workspaceId, workspaceId)
+ )
+ );
+ return rows[0]?.count ?? 0;
+}
+
+export async function listFlaggedMessageIds(
+ db: Database,
+ userId: string,
+ workspaceId: string,
+ conversationId: string
+) {
+ const rows = await db
+ .select({ messageId: messageFlag.messageId })
+ .from(messageFlag)
+ .innerJoin(message, eq(message.id, messageFlag.messageId))
+ .where(
+ and(
+ eq(messageFlag.userId, userId),
+ eq(messageFlag.workspaceId, workspaceId),
+ eq(message.conversationId, conversationId)
+ )
+ );
+ return rows.map((r) => r.messageId);
+}
diff --git a/src/shared/src/db/schema.ts b/src/shared/src/db/schema.ts
index d86312cfc..15d379c44 100644
--- a/src/shared/src/db/schema.ts
+++ b/src/shared/src/db/schema.ts
@@ -640,6 +640,28 @@ export const machineToken = sqliteTable(
(t) => [index("idx_machine_token").on(t.token)]
);
+export const messageFlag = sqliteTable(
+ "message_flag",
+ {
+ id: text("id").primaryKey().$defaultFn(() => nanoid()),
+ messageId: text("message_id")
+ .notNull()
+ .references(() => message.id, { onDelete: "cascade" }),
+ userId: text("user_id")
+ .notNull()
+ .references(() => user.id, { onDelete: "cascade" }),
+ workspaceId: text("workspace_id")
+ .notNull()
+ .references(() => workspace.id, { onDelete: "cascade" }),
+ createdAt: text("created_at").notNull().$defaultFn(() => new Date().toISOString()),
+ },
+ (t) => [
+ unique("message_flag_message_user").on(t.messageId, t.userId),
+ index("idx_message_flag_ws_user_created").on(t.workspaceId, t.userId, t.createdAt),
+ index("idx_message_flag_message_user").on(t.messageId, t.userId),
+ ]
+);
+
// ---------------------------------------------------------------------------
// Workspace file request (ephemeral queue for file browsing)
// ---------------------------------------------------------------------------
diff --git a/src/web/migrations/0027_message_flag.sql b/src/web/migrations/0027_message_flag.sql
new file mode 100644
index 000000000..b2f1ec49b
--- /dev/null
+++ b/src/web/migrations/0027_message_flag.sql
@@ -0,0 +1,11 @@
+CREATE TABLE message_flag (
+ id TEXT PRIMARY KEY,
+ message_id TEXT NOT NULL REFERENCES message(id) ON DELETE CASCADE,
+ user_id TEXT NOT NULL REFERENCES user(id) ON DELETE CASCADE,
+ workspace_id TEXT NOT NULL REFERENCES workspace(id) ON DELETE CASCADE,
+ created_at TEXT NOT NULL,
+ UNIQUE(message_id, user_id)
+);
+
+CREATE INDEX idx_message_flag_ws_user_created ON message_flag(workspace_id, user_id, created_at);
+CREATE INDEX idx_message_flag_message_user ON message_flag(message_id, user_id);
diff --git a/src/web/src/app/(app)/w/[slug]/flags/page.tsx b/src/web/src/app/(app)/w/[slug]/flags/page.tsx
new file mode 100644
index 000000000..483e90735
--- /dev/null
+++ b/src/web/src/app/(app)/w/[slug]/flags/page.tsx
@@ -0,0 +1,214 @@
+"use client";
+
+import { useState, useEffect, useCallback, useRef } from "react";
+import { useWorkspace } from "@/contexts/workspace-context";
+import { listFlaggedItems, unflagMessage as apiUnflagMessage, type FlaggedItem } from "@/lib/api";
+import { useFlagCount } from "@/contexts/flag-count-context";
+import { useAgentChatSheet } from "@/contexts/agent-chat-sheet-context";
+import { Skeleton } from "@/components/ui/skeleton";
+import { Flag, X } from "lucide-react";
+import { AgentAvatar } from "@/components/avatar";
+import { relativeTime } from "@/lib/time";
+
+const FLAG_LIMIT = 30;
+
+function FlagRow({
+ item,
+ slug,
+ onClick,
+ onUnflag,
+}: {
+ item: FlaggedItem;
+ slug: string;
+ onClick?: (e: React.MouseEvent) => void;
+ onUnflag: () => void;
+}) {
+ return (
+ <a
+ href={`/w/${slug}/agents/${item.agent_id}?conv=${item.conversation_id}`}
+ onClick={onClick}
+ className="block px-4 py-3 border-b border-border/30 hover:bg-accent/30 transition-colors duration-150 cursor-pointer"
+ >
+ <div className="flex items-center gap-2">
+ <AgentAvatar name={item.agent_name} avatarUrl={item.agent_avatar_url} />
+ <div className="flex-1 min-w-0">
+ <div className="flex items-center gap-2 min-w-0">
+ <span className="text-sm text-foreground truncate flex-1 min-w-0">
+ {item.message_content}
+ </span>
+ <span className="text-xs text-muted-foreground shrink-0 ml-2" title={new Date(item.flagged_at).toLocaleString()}>
+ {relativeTime(item.flagged_at)}
+ </span>
+ </div>
+ <div className="flex items-center gap-1.5 mt-0.5">
+ {item.agent_name && (
+ <span className="text-xs font-medium text-muted-foreground">{item.agent_name}</span>
+ )}
+ {item.conversation_title && (
+ <>
+ <span className="text-muted-foreground/40">&middot;</span>
+ <span className="text-xs text-muted-foreground">{item.conversation_title}</span>
+ </>
+ )}
+ </div>
+ </div>
+ <button
+ type="button"
+ onClick={(e) => {
+ e.preventDefault();
+ e.stopPropagation();
+ onUnflag();
+ }}
+ className="flex items-center justify-center size-7 rounded-md text-muted-foreground hover:text-foreground hover:bg-muted transition-colors shrink-0 cursor-pointer"
+ title="Unflag"
+ >
+ <X className="size-3.5" />
+ </button>
+ </div>
+ </a>
+ );
+}
+
+function SkeletonRow({ promptWidth }: { promptWidth: string }) {
+ return (
+ <div className="px-4 py-3 border-b border-border/30">
+ <div className="flex items-center gap-2">
+ <Skeleton className="size-8 rounded-full shrink-0" />
+ <div className="flex-1">
+ <Skeleton className="h-3.5 rounded" style={{ width: promptWidth }} />
+ <div className="flex items-center gap-1.5 mt-1.5">
+ <Skeleton className="h-2.5 w-16 rounded" />
+ <Skeleton className="h-2.5 w-8 rounded" />
+ </div>
+ </div>
+ </div>
+ </div>
+ );
+}
+
+export default function FlagsPage() {
+ const { slug, workspaceId } = useWorkspace();
+ const { decrement, increment } = useFlagCount();
+ const { openAgentChat } = useAgentChatSheet();
+
+ const [items, setItems] = useState<FlaggedItem[]>([]);
+ const [loading, setLoading] = useState(true);
+ const [hasMore, setHasMore] = useState(false);
+ const [loadingMore, setLoadingMore] = useState(false);
+
+ const scrollRef = useRef<HTMLDivElement>(null);
+ const isFetchingRef = useRef(false);
+
+ const loadInitial = useCallback(async () => {
+ setLoading(true);
+ try {
+ const result = await listFlaggedItems(workspaceId, { limit: FLAG_LIMIT });
+ setItems(result.items);
+ setHasMore(result.has_more);
+ } catch {
+ // silently fail
+ } finally {
+ setLoading(false);
+ }
+ }, [workspaceId]);
+
+ useEffect(() => {
+ loadInitial();
+ }, [loadInitial]);
+
+ const loadMore = useCallback(async () => {
+ if (isFetchingRef.current || !hasMore || items.length === 0) return;
+ isFetchingRef.current = true;
+ setLoadingMore(true);
+ try {
+ const oldest = items[items.length - 1];
+ const result = await listFlaggedItems(workspaceId, {
+ limit: FLAG_LIMIT,
+ before: oldest.flagged_at,
+ });
+ if (result.items.length === 0) {
+ setHasMore(false);
+ return;
+ }
+ setHasMore(result.has_more);
+ setItems((prev) => {
+ const existingIds = new Set(prev.map((i) => i.id));
+ const unique = result.items.filter((i) => !existingIds.has(i.id));
+ return [...prev, ...unique];
+ });
+ } finally {
+ isFetchingRef.current = false;
+ setLoadingMore(false);
+ }
+ }, [workspaceId, items, hasMore]);
+
+ const handleScroll = useCallback(() => {
+ const el = scrollRef.current;
+ if (!el) return;
+ const nearBottom = el.scrollHeight - el.scrollTop - el.clientHeight < 200;
+ if (!loadingMore && hasMore && nearBottom) {
+ loadMore();
+ }
+ }, [loadMore, loadingMore, hasMore]);
+
+ const handleUnflag = useCallback(async (item: FlaggedItem) => {
+ setItems((prev) => prev.filter((i) => i.id !== item.id));
+ decrement();
+ try {
+ await apiUnflagMessage(workspaceId, item.message_id);
+ } catch {
+ setItems((prev) => [...prev, item].sort((a, b) => b.flagged_at.localeCompare(a.flagged_at)));
+ increment();
+ }
+ }, [workspaceId, decrement, increment]);
+
+ return (
+ <div className="flex flex-col h-full">
+ <div className="flex items-center justify-between border-b border-border/50 px-3 md:px-5 py-2.5 gap-3">
+ <div className="flex items-center gap-3 min-w-0">
+ <h1 className="text-sm font-medium">Flagged</h1>
+ <p className="text-xs text-muted-foreground hidden md:block">
+ Messages you flagged for later.
+ </p>
+ </div>
+ </div>
+
+ <div
+ ref={scrollRef}
+ onScroll={handleScroll}
+ className="flex-1 overflow-y-auto thin-scrollbar"
+ >
+ {loading ? (
+ <>
+ <SkeletonRow promptWidth="60%" />
+ <SkeletonRow promptWidth="45%" />
+ <SkeletonRow promptWidth="70%" />
+ <SkeletonRow promptWidth="55%" />
+ </>
+ ) : items.length === 0 ? (
+ <div className="flex flex-col items-center justify-center h-full text-muted-foreground gap-3 py-20">
+ <Flag className="size-10 opacity-30" />
+ <p className="text-sm">No flagged messages</p>
+ </div>
+ ) : (
+ <>
+ {items.map((item) => (
+ <FlagRow
+ key={item.id}
+ item={item}
+ slug={slug}
+ onClick={(e) => {
+ if (e.metaKey || e.ctrlKey || e.shiftKey || e.button !== 0) return;
+ e.preventDefault();
+ openAgentChat(item.agent_id, { conversationId: item.conversation_id });
+ }}
+ onUnflag={() => handleUnflag(item)}
+ />
+ ))}
+ {loadingMore && <SkeletonRow promptWidth="50%" />}
+ </>
+ )}
+ </div>
+ </div>
+ );
+}
diff --git a/src/web/src/app/(app)/w/[slug]/layout.tsx b/src/web/src/app/(app)/w/[slug]/layout.tsx
index af96d7c20..18b31e078 100644
--- a/src/web/src/app/(app)/w/[slug]/layout.tsx
+++ b/src/web/src/app/(app)/w/[slug]/layout.tsx
@@ -8,6 +8,7 @@ import { WorkspaceProvider } from "@/contexts/workspace-context"
import { AgentProvider } from "@/contexts/agent-context"
import { ChannelProvider } from "@/contexts/channel-context"
import { InboxCountProvider } from "@/contexts/inbox-count-context"
+import { FlagCountProvider } from "@/contexts/flag-count-context"
import { WorkspaceShell } from "@/components/workspace-shell"
export default async function WorkspaceLayout({
@@ -53,9 +54,11 @@ export default async function WorkspaceLayout({
<WorkspaceProvider workspaceId={ws.id} slug={slug}>
<AgentProvider workspaceId={ws.id}>
<InboxCountProvider>
- <ChannelProvider workspaceId={ws.id}>
- <WorkspaceShell>{children}</WorkspaceShell>
- </ChannelProvider>
+ <FlagCountProvider>
+ <ChannelProvider workspaceId={ws.id}>
+ <WorkspaceShell>{children}</WorkspaceShell>
+ </ChannelProvider>
+ </FlagCountProvider>
</InboxCountProvider>
</AgentProvider>
</WorkspaceProvider>
diff --git a/src/web/src/app/api/flags/[messageId]/route.ts b/src/web/src/app/api/flags/[messageId]/route.ts
new file mode 100644
index 000000000..4c576165d
--- /dev/null
+++ b/src/web/src/app/api/flags/[messageId]/route.ts
@@ -0,0 +1,22 @@
+import { NextRequest } from "next/server";
+import { getCloudflareContext } from "@opennextjs/cloudflare";
+import { queries } from "@alook/shared";
+import { getDb } from "@/lib/db";
+import { withAuth } from "@/lib/middleware/auth";
+import { withWorkspaceMember } from "@/lib/middleware/workspace";
+
+export const DELETE = withAuth(async (req: NextRequest, ctx) => {
+ const ws = await withWorkspaceMember(req, ctx);
+ if (ws instanceof Response) return ws;
+
+ const messageId = ctx.params?.messageId;
+ if (!messageId) {
+ return new Response(null, { status: 400 });
+ }
+
+ const { env } = getCloudflareContext();
+ const db = getDb((env as Env).DB);
+
+ await queries.messageFlag.unflagMessage(db, messageId, ctx.userId, ws.workspaceId);
+ return new Response(null, { status: 204 });
+});
diff --git a/src/web/src/app/api/flags/count/route.ts b/src/web/src/app/api/flags/count/route.ts
new file mode 100644
index 000000000..ded5199c7
--- /dev/null
+++ b/src/web/src/app/api/flags/count/route.ts
@@ -0,0 +1,19 @@
+import { NextRequest } from "next/server";
+import { getCloudflareContext } from "@opennextjs/cloudflare";
+import { queries } from "@alook/shared";
+import { getDb } from "@/lib/db";
+import { withAuth } from "@/lib/middleware/auth";
+import { withWorkspaceMember } from "@/lib/middleware/workspace";
+import { writeJSON } from "@/lib/middleware/helpers";
+
+export const GET = withAuth(async (req: NextRequest, ctx) => {
+ const ws = await withWorkspaceMember(req, ctx);
+ if (ws instanceof Response) return ws;
+
+ const { env } = getCloudflareContext();
+ const db = getDb((env as Env).DB);
+
+ const count = await queries.messageFlag.getFlaggedCount(db, ctx.userId, ws.workspaceId);
+
+ return writeJSON({ count });
+});
diff --git a/src/web/src/app/api/flags/route.ts b/src/web/src/app/api/flags/route.ts
new file mode 100644
index 000000000..885df6d5f
--- /dev/null
+++ b/src/web/src/app/api/flags/route.ts
@@ -0,0 +1,68 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getCloudflareContext } from "@opennextjs/cloudflare";
+import { queries } from "@alook/shared";
+import { getDb } from "@/lib/db";
+import { withAuth } from "@/lib/middleware/auth";
+import { withWorkspaceMember } from "@/lib/middleware/workspace";
+import { writeJSON, writeError } from "@/lib/middleware/helpers";
+
+export const GET = withAuth(async (req: NextRequest, ctx) => {
+ const ws = await withWorkspaceMember(req, ctx);
+ if (ws instanceof Response) return ws;
+
+ const { env } = getCloudflareContext();
+ const db = getDb((env as Env).DB);
+
+ const idsOnly = req.nextUrl.searchParams.get("ids_only") === "true";
+ const conversationId = req.nextUrl.searchParams.get("conversation_id");
+
+ if (idsOnly) {
+ if (!conversationId) {
+ return NextResponse.json({ error: "conversation_id is required when ids_only=true" }, { status: 400 });
+ }
+ const messageIds = await queries.messageFlag.listFlaggedMessageIds(db, ctx.userId, ws.workspaceId, conversationId);
+ return writeJSON({ message_ids: messageIds });
+ }
+
+ const limitParam = req.nextUrl.searchParams.get("limit");
+ const limit = limitParam ? Math.min(Math.max(parseInt(limitParam, 10) || 30, 1), 100) : 30;
+ const before = req.nextUrl.searchParams.get("before") ?? undefined;
+
+ if (before && isNaN(Date.parse(before))) {
+ return NextResponse.json({ error: "invalid before timestamp" }, { status: 400 });
+ }
+
+ const result = await queries.messageFlag.listFlaggedMessages(db, ctx.userId, ws.workspaceId, { limit, before });
+
+ return writeJSON({ items: result.items, has_more: result.hasMore });
+});
+
+export const POST = withAuth(async (req: NextRequest, ctx) => {
+ const ws = await withWorkspaceMember(req, ctx);
+ if (ws instanceof Response) return ws;
+
+ const body = await req.json().catch(() => null) as { messageId?: string } | null;
+ if (!body?.messageId) {
+ return NextResponse.json({ error: "messageId is required" }, { status: 400 });
+ }
+
+ const { env } = getCloudflareContext();
+ const db = getDb((env as Env).DB);
+
+ const msgWorkspaceId = await queries.messageFlag.getMessageWorkspaceId(db, body.messageId);
+
+ if (!msgWorkspaceId) {
+ return writeError("message not found", 404);
+ }
+ if (msgWorkspaceId !== ws.workspaceId) {
+ return writeError("message not found", 404);
+ }
+
+ const flag = await queries.messageFlag.flagMessage(db, {
+ messageId: body.messageId,
+ userId: ctx.userId,
+ workspaceId: ws.workspaceId,
+ });
+
+ return writeJSON({ flagged: true }, flag ? 201 : 200);
+});
diff --git a/src/web/src/components/agent-chat/agent-chat-view.tsx b/src/web/src/components/agent-chat/agent-chat-view.tsx
index 52b0c07d4..7b4d07c5d 100644
--- a/src/web/src/components/agent-chat/agent-chat-view.tsx
+++ b/src/web/src/components/agent-chat/agent-chat-view.tsx
@@ -28,11 +28,15 @@ import {
getIssue,
getTrace,
updateIssue,
+ listFlaggedMessageIds,
+ flagMessage as apiFlagMessage,
+ unflagMessage as apiUnflagMessage,
} from "@/lib/api";
import type { PreviousConversation, TraceTask } from "@/lib/api";
import type { Artifact, Conversation, Issue, IssueComment, Message, TaskApi as Task, TaskMessage, WsMessage } from "@alook/shared";
import { useAgentContext } from "@/contexts/agent-context";
import { useInboxCount } from "@/contexts/inbox-count-context";
+import { useFlagCount } from "@/contexts/flag-count-context";
import { useChannel } from "@/contexts/channel-context";
import { toast } from "sonner";
import { cn } from "@/lib/utils";
@@ -311,8 +315,8 @@ export function AgentChatView({
const { refresh: refreshInboxCount } = useInboxCount();
const { activeChannel, loading: channelLoading, setAgentId: setChannelAgentId } = useChannel();
const agentId = propAgentId ?? (params.id as string);
- const scrollToTaskId = propScrollToTaskId ?? searchParams.get("task");
- const targetConvId = propTargetConvId ?? searchParams.get("conv");
+ const scrollToTaskId = propScrollToTaskId !== undefined ? propScrollToTaskId : searchParams.get("task");
+ const targetConvId = propTargetConvId !== undefined ? propTargetConvId : searchParams.get("conv");
const [conversation, setConversation] = useState<Conversation | null>(null);
const [messages, setMessages] = useState<Message[]>([]);
@@ -357,6 +361,11 @@ export function AgentChatView({
const [pendingFilesByMessage, setPendingFilesByMessage] = useState<Map<string, File[]>>(() => new Map());
const [quotedText, setQuotedText] = useState<string | null>(null);
const [selectionPopup, setSelectionPopup] = useState<{ text: string; x: number; y: number } | null>(null);
+ const [flaggedIds, setFlaggedIds] = useState<Set<string>>(new Set());
+ const flaggedIdsRef = useRef(flaggedIds);
+ flaggedIdsRef.current = flaggedIds;
+
+ const { increment: flagIncrement, decrement: flagDecrement } = useFlagCount();
useEffect(() => {
setChannelAgentId(agentId);
@@ -399,6 +408,7 @@ export function AgentChatView({
const scrollRef = useRef<HTMLDivElement>(null);
const pollRef = useRef<ReturnType<typeof setInterval> | null>(null);
+ const markReadTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
const pollTaskIdRef = useRef<string | null>(null);
const lastSeqRef = useRef(0);
const pollFailures = useRef(0);
@@ -493,6 +503,9 @@ export function AgentChatView({
.then((counts) => { if (!ignore) setStepCounts(counts); })
.catch(() => {});
}
+ listFlaggedMessageIds(workspaceId, targetConvId)
+ .then((r) => { if (!ignore) setFlaggedIds(new Set(r.message_ids)); })
+ .catch(() => {});
if (scrollToTaskId) {
const task = await getTask(scrollToTaskId, workspaceId).catch(() => null);
if (ignore) return;
@@ -548,15 +561,24 @@ export function AgentChatView({
return () => { ignore = true; };
}, [agentId, workspaceId, targetConvId, scrollToTaskId, activeChannel, channelLoading]);
+ const refreshInboxCountRef = useRef(refreshInboxCount);
+ useEffect(() => { refreshInboxCountRef.current = refreshInboxCount; }, [refreshInboxCount]);
+
const markedReadRef = useRef<string | null>(null);
useEffect(() => {
if (!conversation?.id || !workspaceId) return;
if (markedReadRef.current === conversation.id) return;
markedReadRef.current = conversation.id;
- markInboxRead(conversation.id, workspaceId)
- .then(() => refreshInboxCount())
- .catch(() => {});
- }, [conversation?.id, workspaceId, refreshInboxCount]);
+ const timer = setTimeout(() => {
+ markInboxRead(conversation.id, workspaceId)
+ .then(() => refreshInboxCountRef.current())
+ .catch(() => {});
+ }, 5000);
+ return () => {
+ markedReadRef.current = null;
+ clearTimeout(timer);
+ };
+ }, [conversation?.id, workspaceId]);
// Scroll to bottom on initial load (skip if scroll-to-task is active)
useEffect(() => {
@@ -856,9 +878,12 @@ export function AgentChatView({
if (pollRef.current) clearInterval(pollRef.current);
pollRef.current = null;
- markInboxRead(conversationId, workspaceId)
- .then(() => refreshInboxCount())
- .catch(() => {});
+ if (markReadTimerRef.current) clearTimeout(markReadTimerRef.current);
+ markReadTimerRef.current = setTimeout(() => {
+ markInboxRead(conversationId, workspaceId)
+ .then(() => refreshInboxCountRef.current())
+ .catch(() => {});
+ }, 5000);
const shouldScroll = isNearBottom.current;
try {
@@ -928,6 +953,7 @@ export function AgentChatView({
useEffect(() => {
return () => {
if (pollRef.current) clearInterval(pollRef.current);
+ if (markReadTimerRef.current) clearTimeout(markReadTimerRef.current);
};
}, []);
@@ -1294,6 +1320,33 @@ export function AgentChatView({
startPolling(newTask.id, conversation.id);
}, [activeTask, conversation, workspaceId, startPolling]);
+ const handleToggleFlag = useCallback(async (messageId: string) => {
+ const wasFlagged = flaggedIdsRef.current.has(messageId);
+ setFlaggedIds((prev) => {
+ const next = new Set(prev);
+ if (wasFlagged) next.delete(messageId);
+ else next.add(messageId);
+ return next;
+ });
+ if (wasFlagged) {
+ flagDecrement();
+ apiUnflagMessage(workspaceId, messageId).catch(() => {
+ setFlaggedIds((prev) => new Set(prev).add(messageId));
+ flagIncrement();
+ });
+ } else {
+ flagIncrement();
+ apiFlagMessage(workspaceId, messageId).catch(() => {
+ setFlaggedIds((prev) => {
+ const next = new Set(prev);
+ next.delete(messageId);
+ return next;
+ });
+ flagDecrement();
+ });
+ }
+ }, [workspaceId, flagIncrement, flagDecrement]);
+
const openIssue = useCallback(async (issueId: string) => {
setSelectedIssueId(issueId);
setIssueSheetOpen(true);
@@ -1578,12 +1631,14 @@ export function AgentChatView({
onIssueClick={(issueId) => openIssue(issueId)}
onRetry={handleRetryTask}
mentionComponents={MENTION_COMPONENTS}
+ isFlagged={flaggedIds.has(msg.id)}
+ onToggleFlag={msg.role === "assistant" ? handleToggleFlag : undefined}
/>
);
})}
{/* Show trace while task is in progress (no assistant message yet) */}
- {activeTask && !["completed", "failed", "cancelled", "superseded"].includes(activeTask.status) && (
+ {activeTask && activeTask.conversation_id === conversation?.id && !["completed", "failed", "cancelled", "superseded"].includes(activeTask.status) && (
<TaskStream
task={activeTask}
messages={taskMessages}
diff --git a/src/web/src/components/agent-chat/message-list.tsx b/src/web/src/components/agent-chat/message-list.tsx
index 5e7c69035..e19b1baff 100644
--- a/src/web/src/components/agent-chat/message-list.tsx
+++ b/src/web/src/components/agent-chat/message-list.tsx
@@ -6,7 +6,7 @@ import { Streamdown } from "streamdown";
import { highlightMentions } from "@/lib/highlight-mentions";
import { TaskStream } from "@/components/task-stream";
import { HistoricalTaskSteps } from "@/components/agent-chat/historical-task-steps";
-import { FileText, Calendar, CircleDot, Mail } from "lucide-react";
+import { FileText, Calendar, CircleDot, Mail, Flag } from "lucide-react";
import { getEventIconType } from "@/components/agent-chat/agent-chat-view";
@@ -31,6 +31,8 @@ export interface MessageItemProps {
onIssueClick: (issueId: string) => void;
onRetry?: () => void;
mentionComponents: Record<string, React.ComponentType<Record<string, unknown> & { children?: React.ReactNode }>>;
+ isFlagged?: boolean;
+ onToggleFlag?: (messageId: string) => void;
}
function EventMessageIcon({ content, conversationType }: { content: string; conversationType?: string | null }) {
@@ -117,11 +119,14 @@ export const MessageItem = memo(function MessageItem({
onIssueClick,
onRetry,
mentionComponents,
+ isFlagged,
+ onToggleFlag,
}: MessageItemProps) {
const hasTaskStream =
activeTask &&
msg.role === "assistant" &&
msg.task_id === activeTask.id &&
+ msg.conversation_id === activeTask.conversation_id &&
taskMessages.length > 0;
const historicalStepCount =
@@ -191,10 +196,28 @@ export const MessageItem = memo(function MessageItem({
</div>
);
})() : !hasTaskStream ? (
- <div className="flex justify-start" data-quote-source {...(msg.task_id ? { "data-task-id": msg.task_id } : {})}>
+ <div className={cn(
+ "group/msg flex flex-col justify-start",
+ isFlagged && "bg-muted/30 rounded-lg px-2 -mx-2"
+ )} data-quote-source {...(msg.task_id ? { "data-task-id": msg.task_id } : {})}>
<div className="markdown max-w-full min-w-0 px-1 py-1 text-base text-foreground">
<Streamdown controls={{ code: { copy: true, download: false }, table: { copy: true, download: false, fullscreen: true } }} linkSafety={{ enabled: false }} allowedTags={MENTION_ALLOWED_TAGS} literalTagContent={MENTION_LITERAL_TAGS} components={mentionComponents}>{highlightMentions(msg.content, agents)}</Streamdown>
</div>
+ {onToggleFlag && (
+ <button
+ type="button"
+ onClick={() => onToggleFlag(msg.id)}
+ className={cn(
+ "self-start mb-1 flex items-center justify-center size-6 rounded-md transition-all duration-150 cursor-pointer shrink-0",
+ isFlagged
+ ? "text-primary opacity-100"
+ : "text-muted-foreground opacity-0 group-hover/msg:opacity-100 hover:text-foreground hover:bg-muted"
+ )}
+ title={isFlagged ? "Unflag" : "Flag"}
+ >
+ <Flag className={cn("size-3.5", isFlagged && "fill-current")} />
+ </button>
+ )}
</div>
) : null}
</React.Fragment>
diff --git a/src/web/src/components/app-sidebar.tsx b/src/web/src/components/app-sidebar.tsx
index 956e9e56b..f0571262f 100644
--- a/src/web/src/components/app-sidebar.tsx
+++ b/src/web/src/components/app-sidebar.tsx
@@ -6,6 +6,7 @@ import { useAgentContext } from "@/contexts/agent-context";
import { useWorkspace } from "@/contexts/workspace-context";
import type { Agent } from "@alook/shared";
import { InboxPopover } from "@/components/inbox-popover";
+import { FlagPopover } from "@/components/flag-popover";
import { Logo } from "@/components/logo";
import { cn } from "@/lib/utils";
import { Monitor, SunMoon, Plus, CalendarDays, Settings, ArrowLeftRight, Home, CircleDot, Folder, Ungroup, ArrowRightToLine } from "lucide-react";
@@ -247,6 +248,7 @@ export function AppSidebar({ onNavigate }: { onNavigate?: () => void } = {}) {
const isRuntimes = pathname === `${prefix}/runtimes`;
const isCalendar = pathname === `${prefix}/calendar`;
const isInbox = pathname.startsWith(`${prefix}/unread`);
+ const isFlags = pathname.startsWith(`${prefix}/flags`);
const isIssues = pathname.startsWith(`${prefix}/issues`);
const isSettings = pathname === `${prefix}/settings`;
const isCreateAgent = pathname === `${prefix}/agents/new`;
@@ -410,6 +412,8 @@ export function AppSidebar({ onNavigate }: { onNavigate?: () => void } = {}) {
<InboxPopover isActive={isInbox} onNavigate={onNavigate} />
+ <FlagPopover isActive={isFlags} onNavigate={onNavigate} />
+
<Tooltip>
<TooltipTrigger render={
<button
diff --git a/src/web/src/components/canvas/agent-chat-sheet.tsx b/src/web/src/components/canvas/agent-chat-sheet.tsx
index 51f31ce96..6c38fe8d9 100644
--- a/src/web/src/components/canvas/agent-chat-sheet.tsx
+++ b/src/web/src/components/canvas/agent-chat-sheet.tsx
@@ -4,6 +4,7 @@ import React, { useState, useRef, useCallback } from "react";
import { useRouter } from "next/navigation";
import {
Sheet,
+ SheetClose,
SheetContent,
SheetHeader,
SheetTitle,
@@ -14,7 +15,8 @@ import { useAgentContext } from "@/contexts/agent-context";
import { useWorkspace } from "@/contexts/workspace-context";
import { ChannelBar } from "@/components/channel-bar";
import { AgentChatView } from "@/components/agent-chat/agent-chat-view";
-import { ArrowUpRight } from "lucide-react";
+import { ArrowUpRight, XIcon } from "lucide-react";
+import { Button, buttonVariants } from "@/components/ui/button";
interface AgentChatSheetProps {
open: boolean;
@@ -55,7 +57,7 @@ export function AgentChatSheet({ open, onOpenChange, agent, targetConvId, scroll
<Sheet open={open} onOpenChange={onOpenChange}>
<SheetContent
side="right"
- showCloseButton
+ showCloseButton={false}
style={{ width: `min(${width}px, 100vw)`, maxWidth: "none" }}
className="data-[side=right]:sm:inset-y-2 data-[side=right]:sm:right-2 data-[side=right]:sm:h-auto data-[side=right]:sm:rounded-xl data-[side=right]:sm:border flex flex-col"
>
@@ -67,8 +69,40 @@ export function AgentChatSheet({ open, onOpenChange, agent, targetConvId, scroll
className="hidden sm:block absolute left-0 top-0 bottom-0 w-1.5 cursor-col-resize z-10 hover:bg-primary/20 active:bg-primary/30 transition-colors rounded-l-xl"
/>
+ {/* Top-right action buttons */}
+ <div className="absolute top-3 right-3 z-10 flex items-center gap-1">
+ {agent && (() => {
+ const params = new URLSearchParams();
+ if (scrollToTaskId) params.set("task", scrollToTaskId);
+ if (targetConvId) params.set("conv", targetConvId);
+ const qs = params.toString();
+ const fullPageUrl = `/w/${slug}/agents/${agent.id}${qs ? `?${qs}` : ""}`;
+ return (
+ <Button
+ variant="ghost"
+ size="icon-sm"
+ render={<a href={fullPageUrl} title="Open full page" />}
+ onClick={(e: React.MouseEvent) => {
+ if (e.metaKey || e.ctrlKey || e.shiftKey) return;
+ e.preventDefault();
+ onOpenChange(false);
+ router.push(fullPageUrl);
+ }}
+ >
+ <ArrowUpRight />
+ </Button>
+ );
+ })()}
+ <SheetClose
+ render={<Button variant="ghost" size="icon-sm" />}
+ >
+ <XIcon />
+ <span className="sr-only">Close</span>
+ </SheetClose>
+ </div>
+
<SheetHeader>
- <div className="flex items-center gap-3">
+ <div className="flex items-center gap-3 pr-16">
{agent && (() => {
const avatarConfig = parseAvatarUrl(agent.avatar_url);
const rt = runtimes.find((r) => r.id === agent.runtime_id);
@@ -86,28 +120,6 @@ export function AgentChatSheet({ open, onOpenChange, agent, targetConvId, scroll
<span className="text-xs text-muted-foreground truncate">{agent.email_handle}@alook.ai</span>
)}
</div>
- {agent && (() => {
- const params = new URLSearchParams();
- if (scrollToTaskId) params.set("task", scrollToTaskId);
- if (targetConvId) params.set("conv", targetConvId);
- const qs = params.toString();
- const fullPageUrl = `/w/${slug}/agents/${agent.id}${qs ? `?${qs}` : ""}`;
- return (
- <a
- href={fullPageUrl}
- onClick={(e) => {
- if (e.metaKey || e.ctrlKey || e.shiftKey) return;
- e.preventDefault();
- onOpenChange(false);
- router.push(fullPageUrl);
- }}
- className="shrink-0 flex items-center justify-center size-7 rounded-md text-muted-foreground hover:text-foreground hover:bg-accent transition-colors"
- title="Open full page"
- >
- <ArrowUpRight className="size-4" />
- </a>
- );
- })()}
</div>
</SheetHeader>
diff --git a/src/web/src/components/flag-popover.tsx b/src/web/src/components/flag-popover.tsx
new file mode 100644
index 000000000..7c48e72c1
--- /dev/null
+++ b/src/web/src/components/flag-popover.tsx
@@ -0,0 +1,165 @@
+"use client";
+
+import { useState, useCallback } from "react";
+import { Popover, PopoverTrigger, PopoverContent } from "@/components/ui/popover";
+import { Skeleton } from "@/components/ui/skeleton";
+import { cn } from "@/lib/utils";
+import { listFlaggedItems, type FlaggedItem } from "@/lib/api";
+import { useWorkspace } from "@/contexts/workspace-context";
+import { useFlagCount } from "@/contexts/flag-count-context";
+import { useAgentChatSheet } from "@/contexts/agent-chat-sheet-context";
+import { AgentAvatar } from "@/components/avatar";
+import { relativeTime } from "@/lib/time";
+import { Flag, ArrowUpRight } from "lucide-react";
+import Link from "next/link";
+
+function FlagPopoverRow({
+ item,
+ slug,
+ onClick,
+}: {
+ item: FlaggedItem;
+ slug: string;
+ onClick: (e: React.MouseEvent) => void;
+}) {
+ return (
+ <a
+ href={`/w/${slug}/agents/${item.agent_id}?conv=${item.conversation_id}`}
+ onClick={onClick}
+ className="block w-full py-1.5 px-2 hover:bg-muted rounded-md transition-colors cursor-pointer"
+ >
+ <div className="flex items-center gap-2">
+ <AgentAvatar name={item.agent_name} avatarUrl={item.agent_avatar_url} size={24} />
+ <div className="flex-1 min-w-0">
+ <div className="flex items-center gap-2">
+ <span className="text-xs font-medium truncate flex-1 min-w-0">
+ {item.agent_name}
+ </span>
+ <span className="text-[10px] text-muted-foreground whitespace-nowrap shrink-0">
+ {relativeTime(item.flagged_at)}
+ </span>
+ </div>
+ <p className="text-xs text-muted-foreground truncate mt-0.5">
+ {item.message_content}
+ </p>
+ </div>
+ </div>
+ </a>
+ );
+}
+
+const POPOVER_LIMIT = 30;
+
+export function FlagPopover({
+ isActive,
+ onNavigate,
+}: {
+ isActive?: boolean;
+ onNavigate?: () => void;
+}) {
+ const { slug, workspaceId } = useWorkspace();
+ const { count: flagCount } = useFlagCount();
+ const { openAgentChat } = useAgentChatSheet();
+ const [items, setItems] = useState<FlaggedItem[] | null>(null);
+ const [loading, setLoading] = useState(false);
+ const [open, setOpen] = useState(false);
+
+ const fetchItems = useCallback(async () => {
+ setItems(null);
+ setLoading(true);
+ try {
+ const result = await listFlaggedItems(workspaceId, { limit: POPOVER_LIMIT });
+ setItems(result.items);
+ } catch {
+ setItems([]);
+ } finally {
+ setLoading(false);
+ }
+ }, [workspaceId]);
+
+ const handleRowClick = useCallback((item: FlaggedItem, e: React.MouseEvent) => {
+ if (e.metaKey || e.ctrlKey || e.shiftKey || e.button !== 0) return;
+ e.preventDefault();
+ setOpen(false);
+ onNavigate?.();
+ openAgentChat(item.agent_id, { conversationId: item.conversation_id });
+ }, [onNavigate, openAgentChat]);
+
+ return (
+ <Popover
+ open={open}
+ onOpenChange={(nextOpen) => {
+ setOpen(nextOpen);
+ if (nextOpen) fetchItems();
+ }}
+ >
+ <PopoverTrigger
+ render={
+ <button
+ type="button"
+ className={cn(
+ "relative flex items-center justify-center size-10 rounded-xl transition-colors duration-200 cursor-pointer",
+ "text-muted-foreground hover:text-foreground hover:bg-accent",
+ isActive && "bg-accent text-foreground"
+ )}
+ />
+ }
+ >
+ <Flag className="size-4" />
+ {flagCount > 0 && (
+ <span className="absolute top-1 right-1 flex items-center justify-center min-w-3.5 h-3.5 rounded-full bg-primary text-primary-foreground text-[9px] font-bold px-0.5">
+ {flagCount > 99 ? "99+" : flagCount}
+ </span>
+ )}
+ </PopoverTrigger>
+ <PopoverContent side="right" className="w-80 p-0">
+ <div className="flex items-center justify-between px-3 py-2 border-b border-border/50">
+ <span className="text-xs font-medium">Flagged</span>
+ <Link
+ href={`/w/${slug}/flags`}
+ onClick={() => {
+ setOpen(false);
+ onNavigate?.();
+ }}
+ className="flex items-center justify-center size-6 rounded-md text-muted-foreground hover:text-foreground hover:bg-muted transition-colors"
+ >
+ <ArrowUpRight className="size-3.5" />
+ </Link>
+ </div>
+ <div className="p-1">
+ {loading ? (
+ <div className="space-y-1">
+ {Array.from({ length: 3 }).map((_, i) => (
+ <div key={i} className="py-1.5 px-2">
+ <div className="flex items-center gap-2">
+ <Skeleton className="size-6 rounded-full shrink-0" />
+ <Skeleton className="h-3 w-20" />
+ <div className="flex-1" />
+ <Skeleton className="h-2.5 w-8" />
+ </div>
+ <Skeleton className="h-3 w-3/4 mt-1.5 ml-8" />
+ </div>
+ ))}
+ </div>
+ ) : !items || items.length === 0 ? (
+ <div className="flex flex-col items-center gap-2 py-6 text-muted-foreground">
+ <Flag className="size-6 opacity-30" />
+ <p className="text-xs">No flagged messages</p>
+ </div>
+ ) : (
+ <div className="max-h-96 overflow-y-auto thin-scrollbar">
+ {items.map((item) => (
+ <FlagPopoverRow
+ key={item.id}
+ item={item}
+ slug={slug}
+ onClick={(e) => handleRowClick(item, e)}
+ />
+ ))}
+ </div>
+ )}
+ </div>
+ </PopoverContent>
+ </Popover>
+ );
+}
diff --git a/src/web/src/components/inbox-popover.tsx b/src/web/src/components/inbox-popover.tsx
index 9386e3797..777741612 100644
--- a/src/web/src/components/inbox-popover.tsx
+++ b/src/web/src/components/inbox-popover.tsx
@@ -31,16 +31,20 @@ function InboxPopoverRow({
>
<div className="flex items-center gap-2">
<AgentAvatar name={item.agent_name} avatarUrl={item.agent_avatar_url} size={24} />
- <span className="text-xs font-medium truncate flex-1 min-w-0">
- {item.agent_name}
- </span>
- <span className="text-[10px] text-muted-foreground whitespace-nowrap shrink-0">
- {relativeTime(item.latest_response_at)}
- </span>
+ <div className="flex-1 min-w-0">
+ <div className="flex items-center gap-2">
+ <span className="text-xs font-medium truncate flex-1 min-w-0">
+ {item.agent_name}
+ </span>
+ <span className="text-[10px] text-muted-foreground whitespace-nowrap shrink-0">
+ {relativeTime(item.latest_response_at)}
+ </span>
+ </div>
+ <p className="text-xs text-muted-foreground truncate mt-0.5">
+ {item.root_prompt ?? item.title}
+ </p>
+ </div>
</div>
- <p className="text-xs text-muted-foreground truncate mt-0.5 pl-8">
- {item.root_prompt ?? item.title}
- </p>
</a>
);
}
@@ -55,7 +59,7 @@ export function InboxPopover({
onNavigate?: () => void;
}) {
const { slug, workspaceId } = useWorkspace();
- const { count: inboxCount, decrement } = useInboxCount();
+ const { count: inboxCount, decrement, refresh } = useInboxCount();
const { openAgentChat } = useAgentChatSheet();
const [items, setItems] = useState<InboxItem[] | null>(null);
const [loading, setLoading] = useState(false);
@@ -91,7 +95,10 @@ export function InboxPopover({
open={open}
onOpenChange={(nextOpen) => {
setOpen(nextOpen);
- if (nextOpen) fetchItems();
+ if (nextOpen) {
+ fetchItems();
+ refresh();
+ }
}}
>
<PopoverTrigger
diff --git a/src/web/src/components/ui/dialog.tsx b/src/web/src/components/ui/dialog.tsx
index 014f5aa3b..ca39d8744 100644
--- a/src/web/src/components/ui/dialog.tsx
+++ b/src/web/src/components/ui/dialog.tsx
@@ -49,7 +49,7 @@ function DialogContent({
}) {
return (
<DialogPortal>
- <DialogOverlay />
+ <DialogOverlay forceRender />
<DialogPrimitive.Popup
data-slot="dialog-content"
className={cn(
diff --git a/src/web/src/components/ui/sheet.tsx b/src/web/src/components/ui/sheet.tsx
index 33d799151..1139af778 100644
--- a/src/web/src/components/ui/sheet.tsx
+++ b/src/web/src/components/ui/sheet.tsx
@@ -48,7 +48,7 @@ function SheetContent({
}) {
return (
<SheetPortal>
- <SheetOverlay />
+ <SheetOverlay forceRender />
<SheetPrimitive.Popup
data-slot="sheet-content"
data-side={side}
diff --git a/src/web/src/contexts/flag-count-context.tsx b/src/web/src/contexts/flag-count-context.tsx
new file mode 100644
index 000000000..34ed1cb06
--- /dev/null
+++ b/src/web/src/contexts/flag-count-context.tsx
@@ -0,0 +1,56 @@
+"use client";
+
+import {
+ createContext,
+ useContext,
+ useState,
+ useEffect,
+ useCallback,
+ type ReactNode,
+} from "react";
+import { getFlaggedCount } from "@/lib/api";
+import { useWorkspace } from "@/contexts/workspace-context";
+
+interface FlagCountContextValue {
+ count: number;
+ refresh: () => void;
+ increment: () => void;
+ decrement: () => void;
+}
+
+const FlagCountContext = createContext<FlagCountContextValue | null>(null);
+
+export function useFlagCount() {
+ const ctx = useContext(FlagCountContext);
+ if (!ctx) throw new Error("useFlagCount must be used within FlagCountProvider");
+ return ctx;
+}
+
+export function FlagCountProvider({ children }: { children: ReactNode }) {
+ const { workspaceId } = useWorkspace();
+ const [count, setCount] = useState(0);
+
+ const refresh = useCallback(() => {
+ getFlaggedCount(workspaceId)
+ .then((r) => setCount(r.count))
+ .catch(() => {});
+ }, [workspaceId]);
+
+ const increment = useCallback(() => {
+ setCount((c) => c + 1);
+ }, []);
+
+ const decrement = useCallback(() => {
+ setCount((c) => Math.max(0, c - 1));
+ }, []);
+
+ useEffect(() => {
+ refresh();
+ }, [refresh]);
+
+ return (
+ <FlagCountContext.Provider value={{ count, refresh, increment, decrement }}>
+ {children}
+ </FlagCountContext.Provider>
+ );
+}
diff --git a/src/web/src/lib/api.ts b/src/web/src/lib/api.ts
index 423ee1f41..9139e64e0 100644
--- a/src/web/src/lib/api.ts
+++ b/src/web/src/lib/api.ts
@@ -1089,6 +1089,52 @@ export const markAllInboxRead = (workspaceId: string) =>
method: "POST",
});
+// Flags
+export interface FlaggedItem {
+ id: string;
+ message_id: string;
+ message_content: string;
+ message_role: string;
+ message_created_at: string;
+ conversation_id: string;
+ conversation_title: string;
+ agent_id: string;
+ agent_name: string | null;
+ agent_avatar_url: string | null;
+ flagged_at: string;
+}
+
+export const listFlaggedItems = (
+ workspaceId: string,
+ opts?: { limit?: number; before?: string }
+) => {
+ const extra: Record<string, string> = {};
+ if (opts?.limit) extra.limit = String(opts.limit);
+ if (opts?.before) extra.before = opts.before;
+ return apiFetch<{ items: FlaggedItem[]; has_more: boolean }>(
+ `/api/flags${wsQuery(workspaceId, extra)}`
+ );
+};
+
+export const getFlaggedCount = (workspaceId: string) =>
+ apiFetch<{ count: number }>(`/api/flags/count${wsQuery(workspaceId)}`);
+
+export const flagMessage = (workspaceId: string, messageId: string) =>
+ apiFetch<{ flagged: boolean }>(`/api/flags${wsQuery(workspaceId)}`, {
+ method: "POST",
+ body: JSON.stringify({ messageId }),
+ });
+
+export const unflagMessage = (workspaceId: string, messageId: string) =>
+ apiFetch<void>(`/api/flags/${messageId}${wsQuery(workspaceId)}`, {
+ method: "DELETE",
+ });
+
+export const listFlaggedMessageIds = (workspaceId: string, conversationId: string) =>
+ apiFetch<{ message_ids: string[] }>(
+ `/api/flags${wsQuery(workspaceId, { conversation_id: conversationId, ids_only: "true" })}`
+ );
+
// Traces
export interface TraceListItem {
trace_id: string;