Presentation coherence screen and ai panel

.github/workflows/deploy-preview.yml

@@ -77,8 +77,10 @@ jobs:
 
       - name: Run Migrations
         if: needs.detect-changes.outputs.has_migrations == 'true'
+        env:
+          BRANCH_DB_URL: ${{ steps.create-branch.outputs.db_url_with_pooler }}
         run: |
-          echo "BRANCH_DB_URL: ${{ steps.create-branch.outputs.db_url_with_pooler }}" >> apps/web/.env
+          vercel env pull --environment=preview --token=${{ env.VERCEL_TOKEN }}
           pnpm run migrate
 
       - name: Post Schema Diff Comment to PR
@@ -90,11 +92,17 @@ jobs:
           api_key: ${{ secrets.NEON_API_KEY }}
 
       - name: Build Project Artifacts
-        run: vercel build --token=${{ env.VERCEL_TOKEN }}
+        env:
+          BRANCH_DB_URL: ${{ steps.create-branch.outputs.db_url_with_pooler }}
+        run: |
+          vercel env pull --environment=preview --token=${{ env.VERCEL_TOKEN }}
+          vercel build --token=${{ env.VERCEL_TOKEN }}
 
       - name: Deploy Preview to Vercel
         id: deploy
-        run: echo preview_url=$(vercel deploy --prebuilt --token=${{ env.VERCEL_TOKEN }}) >> $GITHUB_OUTPUT
+        env:
+          BRANCH_DB_URL: ${{ steps.create-branch.outputs.db_url_with_pooler }}
+        run: echo preview_url=$(vercel deploy --prebuilt --token=${{ env.VERCEL_TOKEN }} --env BRANCH_DB_URL=${{ env.BRANCH_DB_URL }}) >> $GITHUB_OUTPUT
 
   main:
     needs: [detect-changes]

apps/web/.env.template

@@ -13,10 +13,14 @@ NEXT_PUBLIC_CONNECT_SOURCES="https://*.uploadthing.com, https://auth.privy.io"
 
 # Privy
 NEXT_PUBLIC_PRIVY_APP_ID=cm5y07p2z02napk1cutzzx7o6
+PRIVY_APP_SECRET=
 
 # Web3Auth
 NEXT_PUBLIC_WEB3AUTH_CLIENT_ID=BBKg7QjLogP_fTLATXrdCIiyTguXFTKJkCLYIr51c_-P0y7EyLBIABEHW6psI2qm919Zk8broitgD66hZ2EySKY
 
+# Hypha AI panel (Google Gemini)
+GOOGLE_GENERATIVE_AI_API_KEY=
+
 # Alchemy
 ALCHEMY_API_KEY=
 
@@ -58,3 +62,17 @@ DISABLE_IMAGE_OPTIMIZATION=false
 # SOCKS5 Proxy
 SOCKS5_PROXY_HOST=
 SOCKS5_PROXY_PORT=
+
+# Matrix
+NEXT_PUBLIC_ELEMENT_URL=https://threads.hypha.earth
+NEXT_PUBLIC_MATRIX_HOMESERVER_URL=https://matrix.hypha.earth
+MATRIX_DOMAIN=matrix.hypha.earth
+MATRIX_ADMIN_TOKEN=
+DEFAULT_ROOM_ID=
+MATRIX_REGISTRATION_SHARED_SECRET=
+# 32-byte in hex format
+MATRIX_PASSWORD_SECRET=
+
+# reCAPTCHA
+RECAPTCHA_SITE_KEY=
+RECAPTCHA_SECRET_KEY=

apps/web/package.json

@@ -12,6 +12,8 @@
     "postinstall": "if [ ! -f .env ]; then cp .env.template .env; fi"
   },
   "dependencies": {
+    "@ai-sdk/google": "^2.0.0",
+    "@ai-sdk/react": "^3.0.107",
     "@hypha-platform/authentication": "workspace:*",
     "@hypha-platform/cookie": "workspace:*",
     "@hypha-platform/core": "workspace:*",
@@ -23,6 +25,7 @@
     "@hypha-platform/storage-postgres": "workspace:*",
     "@hypha-platform/ui": "workspace:*",
     "@hypha-platform/ui-utils": "workspace:*",
+    "ai": "^6.0.105",
     "d3": "^7.9.0",
     "fetch-socks": "^1.3.2",
     "next": "^15.4.8",

apps/web/src/app/[lang]/dho/[id]/@aside/[tab]/chat/[chatId]/page.tsx

@@ -0,0 +1,47 @@
+'use client';
+
+import {
+  ChatDetail,
+  ChatPageParams,
+  SidePanel,
+  useConversation,
+} from '@hypha-platform/epics';
+import { useParams } from 'next/navigation';
+import { getDhoPathCoherence } from '../../../../@tab/coherence/constants';
+import { usePersonById } from '@hypha-platform/core/client';
+
+export default function ChatPage() {
+  const { lang, id: spaceId, chatId } = useParams<ChatPageParams>();
+  const {
+    conversation,
+    isLoading: isConversationLoading,
+    error,
+  } = useConversation({
+    chatId,
+  });
+  const { isLoading: isPersonLoading, person: creator } = usePersonById({
+    id: conversation?.creatorId,
+  });
+
+  const closeUrl = getDhoPathCoherence(lang, spaceId);
+
+  return (
+    <SidePanel>
+      {error ? (
+        <div className="text-error">{error}</div>
+      ) : (
+        <ChatDetail
+          creator={{
+            avatar: creator?.avatarUrl || '',
+            name: creator?.name || '',
+            surname: creator?.surname || '',
+            address: creator?.address || '',
+          }}
+          isLoading={isConversationLoading || isPersonLoading}
+          conversation={conversation}
+          closeUrl={closeUrl}
+        />
+      )}
+    </SidePanel>
+  );
+}

apps/web/src/app/[lang]/dho/[id]/@aside/[tab]/new-signal/page.tsx

@@ -0,0 +1,29 @@
+import { CreateSignalForm, SidePanel } from '@hypha-platform/epics';
+import { getDhoPathCoherence } from '../../../@tab/coherence/constants';
+import { Locale } from '@hypha-platform/i18n';
+import { findSpaceBySlug } from '@hypha-platform/core/server';
+import { db } from '@hypha-platform/storage-postgres';
+import { notFound } from 'next/navigation';
+
+type PageProps = {
+  params: Promise<{ lang: Locale; id: string; tab: string }>;
+};
+
+export default async function NewSignalPage({ params }: PageProps) {
+  const { lang, id } = await params;
+
+  const spaceFromDb = await findSpaceBySlug({ slug: id }, { db });
+
+  if (!spaceFromDb) notFound();
+
+  const successfulUrl = getDhoPathCoherence(lang, id);
+  return (
+    <SidePanel>
+      <CreateSignalForm
+        successfulUrl={successfulUrl}
+        closeUrl={successfulUrl}
+        spaceId={spaceFromDb.id}
+      />
+    </SidePanel>
+  );
+}

apps/web/src/app/[lang]/dho/[id]/@aside/coherence/default.tsx

@@ -0,0 +1,2 @@
+import Page from './page';
+export default Page;

apps/web/src/app/[lang]/dho/[id]/@aside/coherence/page.tsx

@@ -0,0 +1,3 @@
+export default async function Index() {
+  return null;
+}

apps/web/src/app/[lang]/dho/[id]/@tab/coherence/constants.ts

@@ -0,0 +1,5 @@
+import { Locale } from '@hypha-platform/i18n';
+
+export const getDhoPathCoherence = (lang: Locale, id: string) => {
+  return `/${lang}/dho/${id}/coherence`;
+};

apps/web/src/app/[lang]/dho/[id]/@tab/coherence/default.tsx

@@ -0,0 +1,2 @@
+import Page from './page';
+export default Page;

apps/web/src/app/[lang]/dho/[id]/@tab/coherence/error.tsx

@@ -0,0 +1,19 @@
+'use client'; // Error boundaries must be Client Components
+
+import { ErrorComponent } from '@web/components/error';
+
+export default function ErrorBoundary({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  return (
+    <ErrorComponent
+      message="Oops, something went wrong. Couldn't load coherence tab."
+      error={error}
+      reset={reset}
+    />
+  );
+}

apps/web/src/app/[lang]/dho/[id]/@tab/coherence/page.tsx

@@ -0,0 +1,29 @@
+import {
+  COHERENCE_ORDERS,
+  CoherenceBlock,
+  CoherenceOrder,
+} from '@hypha-platform/epics';
+import { Locale } from '@hypha-platform/i18n';
+
+type PageProps = {
+  params: Promise<{ lang: Locale; id: string }>;
+  searchParams?: Promise<{
+    order?: string;
+    type?: string;
+  }>;
+};
+
+export default async function CoherencePage(props: PageProps) {
+  const params = await props.params;
+  const searchParams = await props.searchParams;
+
+  const { lang, id } = params;
+
+  const orderRaw = searchParams?.order;
+  const order: CoherenceOrder =
+    orderRaw && COHERENCE_ORDERS.includes(orderRaw as CoherenceOrder)
+      ? (orderRaw as CoherenceOrder)
+      : 'mostrecent';
+
+  return <CoherenceBlock lang={lang} spaceSlug={id} order={order} />;
+}

apps/web/src/app/[lang]/dho/[id]/_components/navigation-tabs.tsx

@@ -10,6 +10,7 @@ import { getDhoPathTreasury } from '../@tab/treasury/constants';
 // import { getDhoPathOverview } from '../@tab/overview/constants'; // Overview tab removed
 import { ScrollArea, ScrollBar } from '@hypha-platform/ui';
 import { getActiveTabFromPath } from '@hypha-platform/epics';
+import { getDhoPathCoherence } from '../@tab/coherence/constants';
 
 export function NavigationTabs({ lang, id }: { lang: Locale; id: string }) {
   const pathname = usePathname();
@@ -22,6 +23,11 @@ export function NavigationTabs({ lang, id }: { lang: Locale; id: string }) {
     //   name: 'overview',
     //   href: getDhoPathOverview(lang, id),
     // },
+    {
+      title: 'Coherence',
+      name: 'coherence',
+      href: getDhoPathCoherence(lang, id),
+    },
     {
       title: 'Agreements',
       name: 'agreements',

apps/web/src/app/api/chat/route.ts

@@ -0,0 +1,42 @@
+import { convertToModelMessages, streamText } from 'ai';
+import { google } from '@ai-sdk/google';
+import type { UIMessage } from 'ai';
+import { headers } from 'next/headers';
+import { NextResponse } from 'next/server';
+
+export const maxDuration = 30;
+
+const SYSTEM_PROMPT =
+  'You are Hypha AI, a helpful assistant for the Hypha DAO platform. You help users analyze signals, draft proposals, understand community dynamics, and coordinate across spaces. Be concise and helpful.';
+
+function getModel(modelId: string) {
+  switch (modelId) {
+    case 'gemini-2.5-flash':
+      return google('gemini-2.5-flash');
+    default:
+      return google('gemini-2.5-flash');
+  }
+}
+
+export async function POST(req: Request) {
+  const headersList = await headers();
+  const authToken = headersList.get('Authorization')?.split(' ')[1] || '';
+  if (!authToken) {
+    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+  }
+
+  const {
+    messages,
+    modelId = 'gemini-2.5-flash',
+  }: { messages: UIMessage[]; modelId?: string } = await req.json();
+
+  const model = getModel(modelId);
+
+  const result = streamText({
+    model,
+    system: SYSTEM_PROMPT,
+    messages: await convertToModelMessages(messages),
+  });
+
+  return result.toUIMessageStreamResponse();
+}