);
+ // Map moderation severity → design-system tone (reuse aiTone with a
+ // severity→status projection so "none" reads as clean/signal).
+ const severityTone =
+ a.severity == null
+ ? null
+ : aiTone(
+ a.severity === "none"
+ ? "clean"
+ : a.severity === "low" || a.severity === "medium"
+ ? "warn"
+ : "flagged",
+ );
return (
“{a.reason}”
)}
+ {severityTone && a.severity && (
+
+ {a.severity}
+ {a.confidence != null && (
+
+ conf {(a.confidence * 100).toFixed(0)}%
+
+ )}
+
+ )}
+ {a.flags?.length ? (
+
+ {a.flags.slice(0, 6).map((f) => (
+
+ {f}
+
+ ))}
+
+ ) : null}
+ {a.evidence?.length ? (
+
+ “{a.evidence[0]}”
+
+ ) : null}
{a.executed_by && (
by {a.executed_by}
diff --git a/services/frontend/src/hooks/index.ts b/services/frontend/src/hooks/index.ts
index 5f29fe5..1a21407 100644
--- a/services/frontend/src/hooks/index.ts
+++ b/services/frontend/src/hooks/index.ts
@@ -28,6 +28,7 @@ export {
useMessagesStream,
useMessagesWsSync,
useReview,
+ useSemanticSearch,
useTextChannels,
} from "./use-messages";
export {
diff --git a/services/frontend/src/hooks/use-messages.ts b/services/frontend/src/hooks/use-messages.ts
index 8569dbf..2cced71 100644
--- a/services/frontend/src/hooks/use-messages.ts
+++ b/services/frontend/src/hooks/use-messages.ts
@@ -2,7 +2,12 @@ import { useEffect, useState } from "react";
import useSWR, { useSWRConfig } from "swr";
import { useAction } from "@/hooks/use-action";
import { messagesApi, voiceApi } from "@/lib/api";
-import type { AttachmentRecord, Channel, MessageRecord } from "@/lib/types";
+import type {
+ AttachmentRecord,
+ Channel,
+ MessageRecord,
+ SemanticSearchResult,
+} from "@/lib/types";
import type { WsHook } from "@/lib/ws-hook";
// ── Query keys factory ───────────────────────────
@@ -177,6 +182,21 @@ export function useMessageSearch(query: string, enabled: boolean) {
);
}
+// ── Semantic Search (public archive, Qdrant) ──────
+
+export function useSemanticSearch(query: string, enabled: boolean) {
+ return useSWR(
+ enabled && query.trim().length >= 2
+ ? ["semantic-search", query.trim()]
+ : null,
+ async () => {
+ const res = await messagesApi.semanticSearch(query.trim(), 10);
+ return res.results;
+ },
+ { keepPreviousData: true },
+ );
+}
+
// ── WS sync helpers ──────────────────────────────
export function useMessagesWsSync(ws: WsHook, guildId: string) {
diff --git a/services/frontend/src/lib/api/messages.ts b/services/frontend/src/lib/api/messages.ts
index 454f0c1..0eb52fb 100644
--- a/services/frontend/src/lib/api/messages.ts
+++ b/services/frontend/src/lib/api/messages.ts
@@ -1,5 +1,9 @@
import { orpc } from "@/lib/orpc/client";
-import type { AttachmentRecord, MessageRecord } from "@/lib/types";
+import type {
+ AttachmentRecord,
+ MessageRecord,
+ SemanticSearchResult,
+} from "@/lib/types";
export const messagesApi = {
list: (
@@ -62,4 +66,11 @@ export const messagesApi = {
orpc.analysis.search({ q, limit }) as unknown as Promise<{
results: MessageRecord[];
}>,
+
+ // Public semantic search over the persistent message archive (Qdrant).
+ semanticSearch: (query: string, limit?: number) =>
+ orpc.messages.semanticSearch({ query, limit }) as unknown as Promise<{
+ results: SemanticSearchResult[];
+ nextCursor: null;
+ }>,
};
diff --git a/services/frontend/src/lib/types/message.ts b/services/frontend/src/lib/types/message.ts
index aa88338..5e6846a 100644
--- a/services/frontend/src/lib/types/message.ts
+++ b/services/frontend/src/lib/types/message.ts
@@ -163,3 +163,17 @@ export interface AttachmentRecord {
created_at: number;
uploaded_at?: number | null;
}
+
+// ── Semantic Search (read-only public archive search) ──────────
+
+export interface SemanticSearchResult {
+ message_id: string | null;
+ content: string;
+ score: number;
+ created_at: number;
+}
+
+export interface SemanticSearchResponse {
+ results: SemanticSearchResult[];
+ nextCursor: null;
+}
diff --git a/services/frontend/src/lib/types/moderation.ts b/services/frontend/src/lib/types/moderation.ts
index 3c4d050..3946dfb 100644
--- a/services/frontend/src/lib/types/moderation.ts
+++ b/services/frontend/src/lib/types/moderation.ts
@@ -21,6 +21,14 @@ export interface ModerationAction {
executed_at: number | null;
username: string | null;
content: string | null;
+ // ── Explainability (structured verdict, surfaced read-only to public web) ──
+ flags: string[] | null;
+ categories: string[] | null;
+ severity: "none" | "low" | "medium" | "high" | "critical" | null;
+ confidence: number | null;
+ score: number | null;
+ evidence: string[] | null;
+ policy_version: string | null;
}
export interface ModerationStats {