@promptbook/cli 0.104.0-2 → 0.104.0-4

package/apps/agents-server/src/app/agents/[agentName]/code/page.tsx

@@ -3,7 +3,7 @@
 import Editor from '@monaco-editor/react';
 import { ArrowLeftIcon, ChevronDownIcon, CodeIcon } from 'lucide-react';
 import Link from 'next/link';
-import { useEffect, useState } from 'react';
+import { useCallback, useEffect, useState } from 'react';
 
 type Transpiler = {
     name: string;
@@ -61,39 +61,42 @@ export default function AgentCodePage({ params }: { params: Promise<{ agentName:
             .catch((err) => console.error('Error fetching transpilers:', err));
     }, [agentName]);
 
+    const transpileCode = useCallback(
+        async (transpilerName: string) => {
+            setLoading(true);
+            setError('');
+
+            try {
+                const response = await fetch(`/agents/${encodeURIComponent(agentName)}/code/api`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify({ transpilerName }),
+                });
+
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || 'Failed to transpile code');
+                }
+
+                const result: TranspilationResult = await response.json();
+                setTranspiledCode(result.code);
+            } catch (err) {
+                setError(err instanceof Error ? err.message : 'Failed to transpile code');
+                setTranspiledCode('');
+            } finally {
+                setLoading(false);
+            }
+        },
+        [agentName],
+    );
+
     useEffect(() => {
         if (selectedTranspiler && agentName) {
             transpileCode(selectedTranspiler.name);
         }
-    }, [selectedTranspiler, agentName]);
-
-    const transpileCode = async (transpilerName: string) => {
-        setLoading(true);
-        setError('');
-
-        try {
-            const response = await fetch(`/agents/${encodeURIComponent(agentName)}/code/api`, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({ transpilerName }),
-            });
-
-            if (!response.ok) {
-                const errorData = await response.json();
-                throw new Error(errorData.error || 'Failed to transpile code');
-            }
-
-            const result: TranspilationResult = await response.json();
-            setTranspiledCode(result.code);
-        } catch (err) {
-            setError(err instanceof Error ? err.message : 'Failed to transpile code');
-            setTranspiledCode('');
-        } finally {
-            setLoading(false);
-        }
-    };
+    }, [selectedTranspiler, agentName, transpileCode]);
 
     if (!agentProfile) {
         return (

package/apps/agents-server/src/app/api/agents/[agentName]/clone/route.ts

@@ -1,9 +1,7 @@
-// POST /api/agents/[agentName]/clone
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
-import { AgentBasicInformation } from '../../../../../../../../src/book-2.0/agent-source/AgentBasicInformation';
-import { string_book } from '../../../../../../../../src/book-2.0/agent-source/string_book';
 import { TODO_any } from '@promptbook-local/types';
 import { NextResponse } from 'next/server';
+import { string_book } from '../../../../../../../../src/book-2.0/agent-source/string_book';
 
 export async function POST(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
     const { agentName } = await params;
@@ -21,14 +19,14 @@ export async function POST(request: Request, { params }: { params: Promise<{ age
         while (true) {
             try {
                 await collection.getAgentSource(newAgentName);
-                 // If success, it means it exists, so we try next one
-                 counter++;
-                 newAgentName = `${agentName} (Copy ${counter})`;
-             } catch (error) {
-                 // If error, it likely means it does not exist (NotFoundError), so we can use it
-                 // TODO: [🧠] Check if it is really NotFoundError
-                 break;
-             }
+                // If success, it means it exists, so we try next one
+                counter++;
+                newAgentName = `${agentName} (Copy ${counter})`;
+            } catch (error) {
+                // If error, it likely means it does not exist (NotFoundError), so we can use it
+                // TODO: [🧠] Check if it is really NotFoundError
+                break;
+            }
         }
 
         const lines = source.split('\n');
@@ -36,7 +34,7 @@ export async function POST(request: Request, { params }: { params: Promise<{ age
         const newSource = lines.join('\n') as string_book;
 
         const newAgent = await collection.createAgent(newSource);
-        
+
         return NextResponse.json(newAgent);
     } catch (error) {
         return NextResponse.json(

package/apps/agents-server/src/app/api/agents/[agentName]/route.ts

@@ -4,7 +4,6 @@
 import { $getTableName } from '@/src/database/$getTableName';
 import { $provideSupabaseForServer } from '@/src/database/$provideSupabaseForServer';
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
-import { $provideServer } from '@/src/tools/$provideServer';
 import { TODO_any } from '@promptbook-local/types';
 import { NextResponse } from 'next/server';
 
@@ -23,7 +22,7 @@ export async function PATCH(request: Request, { params }: { params: Promise<{ ag
         }
 
         const supabase = $provideSupabaseForServer();
-        const { tablePrefix } = await $provideServer();
+        // const { tablePrefix } = await $provideServer();
 
         const updateResult = await supabase
             .from(await $getTableName(`Agent`))

package/apps/agents-server/src/app/api/agents/route.ts

@@ -12,7 +12,7 @@ export async function GET() {
         const collection = await $provideAgentCollectionForServer();
         const allAgents = await collection.listAgents();
         const federatedServers = await getFederatedServersFromMetadata();
-        const { publicUrl, tablePrefix } = await $provideServer();
+        const { publicUrl } = await $provideServer();
 
         // Filter to only include PUBLIC agents for federated API
         const supabase = $provideSupabaseForServer();

package/apps/agents-server/src/app/api/api-tokens/route.ts

@@ -1,10 +1,13 @@
+import { randomUUID } from 'crypto';
+import { NextRequest, NextResponse } from 'next/server';
+import { keepUnused } from '../../../../../../src/utils/organization/keepUnused';
 import { $getTableName } from '../../../database/$getTableName';
 import { $provideSupabase } from '../../../database/$provideSupabase';
 import { isUserAdmin } from '../../../utils/isUserAdmin';
-import { randomUUID } from 'crypto';
-import { NextRequest, NextResponse } from 'next/server';
 
 export async function GET(request: NextRequest) {
+    keepUnused(request);
+
     if (!(await isUserAdmin())) {
         return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
     }
@@ -35,11 +38,7 @@ export async function POST(request: NextRequest) {
         const supabase = $provideSupabase();
         const table = await $getTableName('ApiTokens');
 
-        const { data, error } = await supabase
-            .from(table)
-            .insert({ token, note })
-            .select()
-            .single();
+        const { data, error } = await supabase.from(table).insert({ token, note }).select().single();
 
         if (error) {
             return NextResponse.json({ error: error.message }, { status: 500 });

package/apps/agents-server/src/app/api/docs/book.md/route.ts

@@ -1,10 +1,13 @@
 import { NextRequest, NextResponse } from 'next/server';
 import spaceTrim from 'spacetrim';
 import { getGroupedCommitmentDefinitions } from '../../../../../../../src/commitments';
+import { keepUnused } from '../../../../../../../src/utils/organization/keepUnused';
 
 export const dynamic = 'force-static';
 
 export async function GET(request: NextRequest) {
+    keepUnused(request);
+
     const groupedCommitments = getGroupedCommitmentDefinitions();
 
     const content = spaceTrim(

package/apps/agents-server/src/app/api/metadata/route.ts

@@ -1,9 +1,12 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { keepUnused } from '../../../../../../src/utils/organization/keepUnused';
 import { $getTableName } from '../../../database/$getTableName';
 import { $provideSupabase } from '../../../database/$provideSupabase';
 import { isUserAdmin } from '../../../utils/isUserAdmin';
-import { NextRequest, NextResponse } from 'next/server';
 
 export async function GET(request: NextRequest) {
+    keepUnused(request);
+
     if (!(await isUserAdmin())) {
         return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
     }
@@ -36,11 +39,7 @@ export async function POST(request: NextRequest) {
         const supabase = $provideSupabase();
         const table = await $getTableName('Metadata');
 
-        const { data, error } = await supabase
-            .from(table)
-            .insert({ key, value, note })
-            .select()
-            .single();
+        const { data, error } = await supabase.from(table).insert({ key, value, note }).select().single();
 
         if (error) {
             return NextResponse.json({ error: error.message }, { status: 500 });

package/apps/agents-server/src/app/api/upload/route.ts

@@ -155,3 +155,12 @@ export async function POST(request: NextRequest) {
         );
     }
 }
+
+/**
+ * TODO: !!!! Change uploaded URLs from `storageUrl` to `shortUrl`
+ * TODO: !!!! Record both `storageUrl` (actual storage location) and `shortUrl` in `File` table
+ * TODO: !!!! Record `purpose` in `File` table
+ * TODO: !!!! Record `userId` in `File` table
+ * TODO: !!!! Record all things into `File` table
+ * TODO: !!!! File type (mime type) of `.book` files should be `application/book` <- [🧠] !!!! Best mime type?!
+ */

package/apps/agents-server/src/app/page.tsx

@@ -42,7 +42,7 @@ export default async function HomePage() {
 
     // Filter agents based on visibility and user authentication
     const supabase = $provideSupabaseForServer();
-    const { tablePrefix } = await $provideServer();
+    // const { tablePrefix } = await $provideServer();
 
     // Get visibility for all agents
     const visibilityResult = await supabase

package/apps/agents-server/src/app/swagger/page.tsx

@@ -0,0 +1,14 @@
+'use client';
+
+import dynamic from 'next/dynamic';
+import 'swagger-ui-react/swagger-ui.css';
+
+const SwaggerUI = dynamic(() => import('swagger-ui-react'), { ssr: false });
+
+export default function SwaggerPage() {
+  return (
+    <div className="swagger-container bg-white min-h-screen">
+      <SwaggerUI url="/swagger.json" />
+    </div>
+  );
+}

package/apps/agents-server/src/components/AgentProfile/AgentProfile.tsx

@@ -78,7 +78,7 @@ export function AgentProfile(props: AgentProfileProps) {
 
     if (fontString) {
         // [🧠] TODO: Properly parse font string to get family name
-        const primaryFont = fontString.split(',')[0].trim().replace(/['"]/g, '');
+        // const primaryFont = fontString.split(',')[0].trim().replace(/['"]/g, '');
         fontStyle = {
             fontFamily: fontString,
         };
@@ -139,8 +139,10 @@ export function AgentProfile(props: AgentProfileProps) {
                                     backfaceVisibility: 'hidden',
                                     backgroundColor: brandColorDarkHex,
                                     boxShadow: `0 25px 50px -12px rgba(0, 0, 0, 0.25), 0 0 0 1px ${brandColorLightHex}40`,
+
+                                    // Note: Make it squircle
                                     // borderRadius: '50%',
-                                    // ['cornerShape' as really_any]: 'squircle ',
+                                    // ['cornerShape' as really_any /* <- Note: `cornerShape` is non standard CSS property */]: 'squircle ',
                                 }}
                             >
                                 {imageUrl ? (

package/apps/agents-server/src/components/AgentProfile/QrCodeModal.tsx

@@ -24,7 +24,6 @@ export function QrCodeModal({
     personaDescription,
     agentUrl,
     agentEmail,
-    brandColorHex,
 }: QrCodeModalProps) {
     useEffect(() => {
         if (isOpen) {

package/apps/agents-server/src/components/Auth/AuthControls.tsx

@@ -1,15 +1,14 @@
 'use client';
 
 import { useState } from 'react';
-import { useRouter } from 'next/navigation';
 
 type AuthControlsProps = {
     initialUser: { username: string; isAdmin: boolean } | null;
 };
 
 export function AuthControls({ initialUser }: AuthControlsProps) {
-    const router = useRouter();
-    const [user, setUser] = useState(initialUser);
+    // const router = useRouter();
+    const [user] = useState(initialUser);
     const [isLoginOpen, setIsLoginOpen] = useState(false);
     const [username, setUsername] = useState('');
     const [password, setPassword] = useState('');
@@ -52,7 +51,9 @@ export function AuthControls({ initialUser }: AuthControlsProps) {
             <div className="flex items-center space-x-4">
                 <span className="text-gray-600">
                     Logged in as <strong>{user.username}</strong>
-                    {user.isAdmin && <span className="ml-2 bg-blue-100 text-blue-800 text-xs px-2 py-1 rounded">Admin</span>}
+                    {user.isAdmin && (
+                        <span className="ml-2 bg-blue-100 text-blue-800 text-xs px-2 py-1 rounded">Admin</span>
+                    )}
                 </span>
                 <button
                     onClick={handleLogout}

package/apps/agents-server/src/components/Header/Header.tsx

@@ -4,7 +4,6 @@ import promptbookLogoBlueTransparent from '@/public/logo-blue-white-256.png';
 import { $createAgentAction, logoutAction } from '@/src/app/actions';
 import { ArrowRight, ChevronDown, Lock, LogIn, LogOut, User } from 'lucide-react';
 import Image from 'next/image';
-import { HeadlessLink, useIsHeadless, pushWithHeadless } from '../_utils/headlessParam';
 import { useRouter } from 'next/navigation';
 import { ReactNode, useState } from 'react';
 import { AgentBasicInformation } from '../../../../../src/book-2.0/agent-source/AgentBasicInformation';
@@ -13,6 +12,7 @@ import { useMenuHoisting } from '../../../../../src/book-components/_common/Menu
 import { just } from '../../../../../src/utils/organization/just';
 import type { UserInfo } from '../../utils/getCurrentUser';
 import { getVisibleCommitmentDefinitions } from '../../utils/getVisibleCommitmentDefinitions';
+import { HeadlessLink, pushWithHeadless, useIsHeadless } from '../_utils/headlessParam';
 import { ChangePasswordDialog } from '../ChangePasswordDialog/ChangePasswordDialog';
 import { LoginDialog } from '../LoginDialog/LoginDialog';
 import { useUsersAdmin } from '../UsersList/useUsersAdmin';
@@ -119,16 +119,22 @@ export function Header(props: HeaderProps) {
 
     // Federated servers dropdown items (respect logo, only current is not clickable)
     const [isFederatedOpen, setIsFederatedOpen] = useState(false);
-    const [isMobileFederatedOpen, setIsMobileFederatedOpen] = useState(false);
+    // const [isMobileFederatedOpen, setIsMobileFederatedOpen] = useState(false);
 
-    const federatedDropdownItems: SubMenuItem[] = federatedServers.map(server => {
+    const federatedDropdownItems: SubMenuItem[] = federatedServers.map((server) => {
         const isCurrent = server.url === (typeof window !== 'undefined' ? window.location.origin : '');
         return isCurrent
             ? {
                   label: (
                       <span className="flex items-center gap-2">
                           {/* eslint-disable-next-line @next/next/no-img-element */}
-                          <img src={server.logoUrl || serverLogoUrl || promptbookLogoBlueTransparent.src} alt={server.title} width={20} height={20} className="w-5 h-5 object-contain rounded-full" />
+                          <img
+                              src={server.logoUrl || serverLogoUrl || promptbookLogoBlueTransparent.src}
+                              alt={server.title}
+                              width={20}
+                              height={20}
+                              className="w-5 h-5 object-contain rounded-full"
+                          />
                           <span className="font-semibold">{server.title.replace(/^Federated: /, '')}</span>
                           <span className="ml-1 text-xs text-blue-600">(current)</span>
                       </span>
@@ -140,7 +146,13 @@ export function Header(props: HeaderProps) {
                   label: (
                       <span className="flex items-center gap-2">
                           {/* eslint-disable-next-line @next/next/no-img-element */}
-                          <img src={server.logoUrl || promptbookLogoBlueTransparent.src} alt={server.title} width={20} height={20} className="w-5 h-5 object-contain rounded-full" />
+                          <img
+                              src={server.logoUrl || promptbookLogoBlueTransparent.src}
+                              alt={server.title}
+                              width={20}
+                              height={20}
+                              className="w-5 h-5 object-contain rounded-full"
+                          />
                           <span>{server.title.replace(/^Federated: /, '')}</span>
                       </span>
                   ),
@@ -169,6 +181,12 @@ export function Header(props: HeaderProps) {
                     isBold: true,
                     isBordered: true,
                 } as SubMenuItem,
+                {
+                    label: 'API Reference',
+                    href: '/swagger',
+                    isBold: true,
+                    isBordered: true,
+                } as SubMenuItem,
                 ...getVisibleCommitmentDefinitions().map(
                     ({ primary, aliases }) =>
                         ({
@@ -263,6 +281,10 @@ export function Header(props: HeaderProps) {
                       isMobileOpen: isMobileSystemOpen,
                       setIsMobileOpen: setIsMobileSystemOpen,
                       items: [
+                          {
+                              label: 'OpenAPI Documentation',
+                              href: '/swagger',
+                          },
                           {
                               label: 'API Tokens',
                               href: '/admin/api-tokens',

package/apps/agents-server/src/components/Homepage/AgentCard.tsx

@@ -1,5 +1,6 @@
 'use client';
 
+import { really_any } from '@promptbook-local/types';
 import { EyeIcon, EyeOffIcon, RotateCcwIcon } from 'lucide-react';
 import Link from 'next/link';
 import { AgentBasicInformation } from '../../../../../src/book-2.0/agent-source/AgentBasicInformation';
@@ -19,7 +20,16 @@ type AgentCardProps = {
 const ACTION_BUTTON_CLASSES =
     'text-white px-3 py-1 rounded shadow text-xs font-medium transition-colors uppercase tracking-wider opacity-80 hover:opacity-100';
 
-export function AgentCard({ agent, href, isAdmin, onDelete, onClone, onToggleVisibility, onRestore, visibility }: AgentCardProps) {
+export function AgentCard({
+    agent,
+    href,
+    isAdmin,
+    onDelete,
+    onClone,
+    onToggleVisibility,
+    onRestore,
+    visibility,
+}: AgentCardProps) {
     const { meta, agentName } = agent;
     const fullname = (meta.fullname as string) || agentName || 'Agent';
     const imageUrl = (meta.image as string) || null;
@@ -41,9 +51,14 @@ export function AgentCard({ agent, href, isAdmin, onDelete, onClone, onToggleVis
                     <div className="p-6 flex flex-col items-center flex-grow backdrop-blur-[2px]">
                         {/* Image container */}
                         <div
-                            className="w-32 h-32 mb-4 rounded-xl shadow-lg overflow-hidden flex-shrink-0 bg-black/20"
+                            className="w-32 h-32 mb-4 shadow-lg overflow-hidden flex-shrink-0 bg-black/20"
                             style={{
                                 boxShadow: `0 10px 20px -5px rgba(0, 0, 0, 0.2), 0 0 0 1px ${brandColorLightHex}40`,
+
+                                // Note: Make it squircle
+                                borderRadius: '50%',
+                                ['cornerShape' as really_any /* <- Note: `cornerShape` is non standard CSS property */]:
+                                    'squircle ',
                             }}
                         >
                             {imageUrl ? (
@@ -89,7 +104,11 @@ export function AgentCard({ agent, href, isAdmin, onDelete, onClone, onToggleVis
             {isAdmin && !onRestore && (
                 <div className="absolute top-2 right-2 flex gap-2 opacity-0 group-hover:opacity-100 transition-opacity z-10">
                     <button
-                        className={`${visibility === 'PUBLIC' ? 'bg-green-500 hover:bg-green-600' : 'bg-gray-500 hover:bg-gray-600'} ${ACTION_BUTTON_CLASSES}`}
+                        className={`${
+                            visibility === 'PUBLIC'
+                                ? 'bg-green-500 hover:bg-green-600'
+                                : 'bg-gray-500 hover:bg-gray-600'
+                        } ${ACTION_BUTTON_CLASSES}`}
                         onClick={(e) => {
                             e.preventDefault();
                             onToggleVisibility?.(agent.permanentId || agent.agentName);

package/apps/agents-server/src/components/_utils/headlessParam.tsx

@@ -1,6 +1,6 @@
 // Utility to append ?headless param if present in current URL
-import { usePathname, useSearchParams } from 'next/navigation';
 import Link, { LinkProps } from 'next/link';
+import { useSearchParams } from 'next/navigation';
 import { useMemo } from 'react';
 
 // Returns true if ?headless is present in current search params
@@ -18,7 +18,11 @@ export function appendHeadlessParam(href: string, isHeadless: boolean): string {
 }
 
 // Custom Link that preserves headless param
-export function HeadlessLink({ href, children, ...rest }: LinkProps & { children: React.ReactNode } & React.AnchorHTMLAttributes<HTMLAnchorElement>) {
+export function HeadlessLink({
+    href,
+    children,
+    ...rest
+}: LinkProps & { children: React.ReactNode } & React.AnchorHTMLAttributes<HTMLAnchorElement>) {
     const isHeadless = useIsHeadless();
     const finalHref = useMemo(() => appendHeadlessParam(String(href), isHeadless), [href, isHeadless]);
     return (
@@ -28,7 +32,7 @@ export function HeadlessLink({ href, children, ...rest }: LinkProps & { children
     );
 }
 
-import { useRouter } from "next/navigation";
+import { useRouter } from 'next/navigation';
 
 // Helper for router.push
 export function pushWithHeadless(router: ReturnType<typeof useRouter>, href: string, isHeadless: boolean) {

package/apps/agents-server/src/database/migrate.ts

@@ -8,13 +8,34 @@ dotenv.config();
 async function migrate() {
     console.info('🚀 Starting database migration');
 
+    // Parse CLI arguments for --only flag
+    const args = process.argv.slice(2);
+    let onlyPrefixes: string[] | null = null;
+
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--only' && args[i + 1]) {
+            onlyPrefixes = args[i + 1]
+                .split(',')
+                .map((p) => p.trim())
+                .filter((p) => p !== '');
+            break;
+        } else if (args[i]?.startsWith('--only=')) {
+            onlyPrefixes = args[i]
+                .substring('--only='.length)
+                .split(',')
+                .map((p) => p.trim())
+                .filter((p) => p !== '');
+            break;
+        }
+    }
+
     // 1. Get configuration
     const prefixesEnv = process.env.SUPABASE_MIGRATION_PREFIXES;
     if (!prefixesEnv) {
         console.warn('⚠️ SUPABASE_MIGRATION_PREFIXES is not defined. Skipping migration.');
         return;
     }
-    const prefixes = prefixesEnv
+    let prefixes = prefixesEnv
         .split(',')
         .map((p) => p.trim())
         .filter((p) => p !== '');
@@ -24,6 +45,18 @@ async function migrate() {
         return;
     }
 
+    // Filter prefixes if --only flag is provided
+    if (onlyPrefixes !== null) {
+        const invalidPrefixes = onlyPrefixes.filter((p) => !prefixes.includes(p));
+        if (invalidPrefixes.length > 0) {
+            console.error(`❌ Invalid prefixes specified in --only: ${invalidPrefixes.join(', ')}`);
+            console.error(`   Available prefixes: ${prefixes.join(', ')}`);
+            process.exit(1);
+        }
+        prefixes = onlyPrefixes;
+        console.info(`🎯 Running migrations only for: ${prefixes.join(', ')}`);
+    }
+
     const connectionString = process.env.POSTGRES_URL || process.env.DATABASE_URL;
     if (!connectionString) {
         console.error('❌ POSTGRES_URL or DATABASE_URL is not defined.');

package/apps/agents-server/src/database/migrations/2025-12-0402-message-table.sql

@@ -0,0 +1,42 @@
+
+-- Table: Message
+CREATE TABLE IF NOT EXISTS "prefix_Message" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+    "channel" TEXT NOT NULL,
+    "direction" TEXT NOT NULL,
+    "sender" JSONB NOT NULL,
+    "recipients" JSONB,
+    "content" TEXT NOT NULL,
+    "threadId" TEXT,
+    "metadata" JSONB
+);
+
+COMMENT ON TABLE "prefix_Message" IS 'A generic message structure for various communication channels';
+COMMENT ON COLUMN "prefix_Message"."channel" IS 'The communication channel of the message (e.g. EMAIL, PROMPTBOOK_CHAT)';
+COMMENT ON COLUMN "prefix_Message"."direction" IS 'Is the message send from the Promptbook or to the Promptbook';
+COMMENT ON COLUMN "prefix_Message"."sender" IS 'Who sent the message';
+COMMENT ON COLUMN "prefix_Message"."recipients" IS 'Who are the recipients of the message';
+COMMENT ON COLUMN "prefix_Message"."content" IS 'The content of the message as markdown';
+COMMENT ON COLUMN "prefix_Message"."threadId" IS 'The thread identifier the message belongs to';
+
+
+-- Table: MessageSendAttempt
+CREATE TABLE IF NOT EXISTS "prefix_MessageSendAttempt" (
+    "id" BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+    "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(),
+    
+    "messageId" BIGINT NOT NULL REFERENCES "prefix_Message"("id") ON DELETE CASCADE,
+    "providerName" TEXT NOT NULL,
+    "isSuccessful" BOOLEAN NOT NULL,
+    "raw" JSONB
+);
+
+COMMENT ON TABLE "prefix_MessageSendAttempt" IS 'Stores each attempt to send the message';
+COMMENT ON COLUMN "prefix_MessageSendAttempt"."messageId" IS 'The message that was attempted to be sent';
+COMMENT ON COLUMN "prefix_MessageSendAttempt"."providerName" IS 'The name of the provider used for sending';
+COMMENT ON COLUMN "prefix_MessageSendAttempt"."isSuccessful" IS 'Whether the attempt was successful';
+COMMENT ON COLUMN "prefix_MessageSendAttempt"."raw" IS 'Raw response or error from the provider';
+
+ALTER TABLE "prefix_Message" ENABLE ROW LEVEL SECURITY;
+ALTER TABLE "prefix_MessageSendAttempt" ENABLE ROW LEVEL SECURITY;

package/apps/agents-server/src/generated/reservedPaths.ts

@@ -4,7 +4,8 @@
  *
  * ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
  *
- * @see /apps/agents-server/src/app - source directory
+ * @see /apps/agents-server/src/app - source directory for routes
+ * @see /apps/agents-server/public - source directory for static files
  * @see /apps/agents-server/src/middleware.ts - where this is used
  */
 export const RESERVED_PATHS: readonly string[] = [
@@ -15,7 +16,9 @@ export const RESERVED_PATHS: readonly string[] = [
     "docs",
     "embed",
     "favicon.ico",
+    "fonts",
     "humans.txt",
+    "logo-blue-white-256.png",
     "manifest.webmanifest",
     "recycle-bin",
     "restricted",
@@ -23,5 +26,7 @@ export const RESERVED_PATHS: readonly string[] = [
     "security.txt",
     "sitemap.xml",
     "sw.js",
+    "swagger",
+    "swagger.json",
     "test"
 ] as const;