@promptbook/cli 0.103.0-54 → 0.103.0-56

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

@@ -0,0 +1,159 @@
+'use client';
+
+import { Loader2, Lock } from 'lucide-react';
+import { useState } from 'react';
+
+type ChangePasswordFormProps = {
+    onSuccess?: () => void;
+    className?: string;
+};
+
+export function ChangePasswordForm(props: ChangePasswordFormProps) {
+    const { onSuccess, className } = props;
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState<string | null>(null);
+    const [successMessage, setSuccessMessage] = useState<string | null>(null);
+
+    const handleSubmit = async (event: React.FormEvent<HTMLFormElement>) => {
+        event.preventDefault();
+        setIsLoading(true);
+        setError(null);
+        setSuccessMessage(null);
+
+        const formData = new FormData(event.currentTarget);
+        const currentPassword = formData.get('currentPassword') as string;
+        const newPassword = formData.get('newPassword') as string;
+        const confirmNewPassword = formData.get('confirmNewPassword') as string;
+
+        if (newPassword !== confirmNewPassword) {
+            setError('New passwords do not match');
+            setIsLoading(false);
+            return;
+        }
+
+        try {
+            const response = await fetch('/api/auth/change-password', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ currentPassword, newPassword }),
+            });
+
+            const result = await response.json();
+
+            if (response.ok) {
+                setSuccessMessage('Password changed successfully');
+                // Reset form
+                event.currentTarget.reset();
+                if (onSuccess) {
+                    setTimeout(onSuccess, 1500);
+                }
+            } else {
+                setError(result.error || 'An error occurred');
+            }
+        } catch (error) {
+            setError('An unexpected error occurred');
+            console.error(error);
+        } finally {
+            setIsLoading(false);
+        }
+    };
+
+    return (
+        <form onSubmit={handleSubmit} className={`space-y-4 ${className || ''}`}>
+            <div className="space-y-2">
+                <label
+                    htmlFor="currentPassword"
+                    className="text-sm font-medium text-gray-700 block"
+                >
+                    Current Password
+                </label>
+                <div className="relative">
+                    <div className="absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none text-gray-400">
+                        <Lock className="w-4 h-4" />
+                    </div>
+                    <input
+                        id="currentPassword"
+                        name="currentPassword"
+                        type="password"
+                        required
+                        className="block w-full pl-10 h-10 rounded-md border border-gray-300 bg-white px-3 py-2 text-sm placeholder-gray-400 focus:outline-none focus:ring-2 focus:ring-promptbook-blue focus:border-transparent disabled:opacity-50"
+                        placeholder="Enter current password"
+                    />
+                </div>
+            </div>
+
+            <div className="space-y-2">
+                <label
+                    htmlFor="newPassword"
+                    className="text-sm font-medium text-gray-700 block"
+                >
+                    New Password
+                </label>
+                <div className="relative">
+                    <div className="absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none text-gray-400">
+                        <Lock className="w-4 h-4" />
+                    </div>
+                    <input
+                        id="newPassword"
+                        name="newPassword"
+                        type="password"
+                        required
+                        className="block w-full pl-10 h-10 rounded-md border border-gray-300 bg-white px-3 py-2 text-sm placeholder-gray-400 focus:outline-none focus:ring-2 focus:ring-promptbook-blue focus:border-transparent disabled:opacity-50"
+                        placeholder="Enter new password"
+                    />
+                </div>
+            </div>
+
+            <div className="space-y-2">
+                <label
+                    htmlFor="confirmNewPassword"
+                    className="text-sm font-medium text-gray-700 block"
+                >
+                    Confirm New Password
+                </label>
+                <div className="relative">
+                    <div className="absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none text-gray-400">
+                        <Lock className="w-4 h-4" />
+                    </div>
+                    <input
+                        id="confirmNewPassword"
+                        name="confirmNewPassword"
+                        type="password"
+                        required
+                        className="block w-full pl-10 h-10 rounded-md border border-gray-300 bg-white px-3 py-2 text-sm placeholder-gray-400 focus:outline-none focus:ring-2 focus:ring-promptbook-blue focus:border-transparent disabled:opacity-50"
+                        placeholder="Confirm new password"
+                    />
+                </div>
+            </div>
+
+            {error && (
+                <div className="p-3 text-sm text-red-500 bg-red-50 border border-red-200 rounded-md">
+                    {error}
+                </div>
+            )}
+
+            {successMessage && (
+                <div className="p-3 text-sm text-green-500 bg-green-50 border border-green-200 rounded-md">
+                    {successMessage}
+                </div>
+            )}
+
+            <button
+                type="submit"
+                disabled={isLoading}
+                className="w-full inline-flex items-center justify-center rounded-md text-sm font-medium h-10 px-4 py-2 bg-promptbook-blue-dark text-white hover:bg-promptbook-blue-dark/90 focus:outline-none focus:ring-2 focus:ring-promptbook-blue focus:ring-offset-2 disabled:opacity-50 disabled:pointer-events-none transition-colors"
+            >
+                {isLoading ? (
+                    <>
+                        <Loader2 className="mr-2 w-4 h-4 animate-spin" />
+                        Changing Password...
+                    </>
+                ) : (
+                    'Change Password'
+                )}
+            </button>
+        </form>
+    );
+}

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

@@ -0,0 +1,87 @@
+import ReactMarkdown from 'react-markdown';
+import remarkGfm from 'remark-gfm';
+import { string_book } from '../../../../../src/book-2.0/agent-source/string_book';
+import { BookEditor } from '../../../../../src/book-components/BookEditor/BookEditor';
+import { OpenMojiIcon } from '../OpenMojiIcon/OpenMojiIcon';
+
+type DocumentationContentProps = {
+    primary: {
+        type: string;
+        icon: string;
+        description?: string;
+        documentation: string;
+    };
+    aliases?: string[];
+    isPrintOnly?: boolean;
+};
+
+export function DocumentationContent({ primary, aliases = [], isPrintOnly = false }: DocumentationContentProps) {
+    return (
+        <div className={`bg-white rounded-xl shadow-lg border border-gray-200 overflow-hidden ${isPrintOnly ? 'shadow-none border-none' : ''}`}>
+            <div className={`p-8 border-b border-gray-100 bg-gray-50/50 ${isPrintOnly ? 'border-none bg-white p-0 mb-4' : ''}`}>
+                <div className="flex items-center gap-4 mb-4">
+                    <h1 className="text-4xl font-bold text-gray-900 tracking-tight">
+                        <OpenMojiIcon icon={primary.icon} className="mr-3" />
+                        {primary.type}
+                        {aliases.length > 0 && (
+                            <span className="text-gray-400 font-normal ml-4 text-2xl">
+                                / {aliases.join(' / ')}
+                            </span>
+                        )}
+                    </h1>
+                    {!isPrintOnly && (
+                        <span className="px-3 py-1 rounded-full text-xs font-medium bg-blue-100 text-blue-700">
+                            Commitment
+                        </span>
+                    )}
+                </div>
+                {primary.description && (
+                    <p className="text-xl text-gray-600 leading-relaxed max-w-3xl">
+                        {primary.description}
+                    </p>
+                )}
+            </div>
+            
+            <div className={`p-8 ${isPrintOnly ? 'p-0' : ''}`}>
+                <article className="prose prose-lg prose-slate max-w-none prose-headings:font-bold prose-headings:tracking-tight prose-headings:text-gray-900 prose-h1:text-4xl prose-h1:mb-8 prose-h2:text-2xl prose-h2:mt-12 prose-h2:mb-6 prose-h2:pb-2 prose-h2:border-b prose-h2:border-gray-200 prose-h3:text-xl prose-h3:mt-8 prose-h3:mb-4 prose-h3:text-gray-800 prose-p:text-gray-600 prose-p:leading-relaxed prose-p:mb-6 prose-a:text-blue-600 prose-a:no-underline hover:prose-a:text-blue-700 hover:prose-a:underline prose-a:transition-colors prose-strong:font-bold prose-strong:text-gray-900 prose-code:text-blue-600 prose-code:bg-blue-50 prose-code:px-1.5 prose-code:py-0.5 prose-code:rounded-md prose-code:before:content-none prose-code:after:content-none prose-code:font-medium prose-pre:bg-gray-900 prose-pre:text-gray-100 prose-pre:shadow-lg prose-pre:rounded-xl prose-pre:p-6 prose-ul:list-disc prose-ul:pl-6 prose-li:marker:text-gray-400 prose-li:mb-2 prose-ol:list-decimal prose-ol:pl-6 prose-li:mb-2 prose-blockquote:border-l-4 prose-blockquote:border-blue-500 prose-blockquote:bg-blue-50/50 prose-blockquote:py-2 prose-blockquote:px-4 prose-blockquote:rounded-r-lg prose-blockquote:not-italic prose-blockquote:text-gray-700 prose-blockquote:my-8 prose-img:rounded-xl prose-img:shadow-md prose-img:my-8 prose-hr:border-gray-200 prose-hr:my-10 prose-table:w-full prose-th:text-left prose-th:py-2 prose-th:px-3 prose-th:bg-gray-100 prose-th:font-semibold prose-th:text-gray-900 prose-td:py-2 prose-td:px-3 prose-td:border-b prose-td:border-gray-200 prose-tr:hover:bg-gray-50">
+                    <ReactMarkdown
+                        remarkPlugins={[remarkGfm]}
+                        components={{
+                            code(props) {
+                                const { children, className, node, ...rest } = props;
+                                const match = /language-(\w+)/.exec(className || '');
+                                if (match && match[1] === 'book') {
+                                    const value = String(children).replace(/\n$/, '');
+                                    // Estimate height: lines * 30px + padding
+                                    const lineCount = value.split('\n').length;
+                                    const height = lineCount * 30 + 40; // 30px per line + 40px buffer
+
+                                    return (
+                                        <div className="not-prose my-6 rounded-lg overflow-hidden border border-gray-200 shadow-sm print:border-gray-300">
+                                            <BookEditor
+                                                value={value as string_book}
+                                                isReadonly={true}
+                                                isVerbose={false}
+                                                height={`${height}px`}
+                                                isDownloadButtonShown={false}
+                                                isAboutButtonShown={false}
+                                                isFullscreenButtonShown={true}
+                                            />
+                                        </div>
+                                    );
+                                }
+                                return (
+                                    <code className={className} {...rest}>
+                                        {children}
+                                    </code>
+                                );
+                            },
+                        }}
+                    >
+                        {primary.documentation}
+                    </ReactMarkdown>
+                </article>
+            </div>
+        </div>
+    );
+}

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

@@ -2,7 +2,7 @@
 
 import promptbookLogoBlueTransparent from '@/public/logo-blue-white-256.png';
 import { $createAgentAction, logoutAction } from '@/src/app/actions';
-import { ArrowRight, ChevronDown, LogIn, LogOut } from 'lucide-react';
+import { ArrowRight, ChevronDown, Lock, LogIn, LogOut, User } from 'lucide-react';
 import Image from 'next/image';
 import Link from 'next/link';
 import { useRouter } from 'next/navigation';
@@ -12,6 +12,7 @@ import { HamburgerMenu } from '../../../../../src/book-components/_common/Hambur
 import { just } from '../../../../../src/utils/organization/just';
 import type { UserInfo } from '../../utils/getCurrentUser';
 import { getVisibleCommitmentDefinitions } from '../../utils/getVisibleCommitmentDefinitions';
+import { ChangePasswordDialog } from '../ChangePasswordDialog/ChangePasswordDialog';
 import { LoginDialog } from '../LoginDialog/LoginDialog';
 import { useUsersAdmin } from '../UsersList/useUsersAdmin';
 
@@ -73,12 +74,16 @@ export function Header(props: HeaderProps) {
 
     const [isMenuOpen, setIsMenuOpen] = useState(false);
     const [isLoginOpen, setIsLoginOpen] = useState(false);
+    const [isChangePasswordOpen, setIsChangePasswordOpen] = useState(false);
     const [isAgentsOpen, setIsAgentsOpen] = useState(false);
     const [isDocsOpen, setIsDocsOpen] = useState(false);
     const [isUsersOpen, setIsUsersOpen] = useState(false);
+    const [isSystemOpen, setIsSystemOpen] = useState(false);
+    const [isProfileOpen, setIsProfileOpen] = useState(false);
     const [isMobileAgentsOpen, setIsMobileAgentsOpen] = useState(false);
     const [isMobileDocsOpen, setIsMobileDocsOpen] = useState(false);
     const [isMobileUsersOpen, setIsMobileUsersOpen] = useState(false);
+    const [isMobileSystemOpen, setIsMobileSystemOpen] = useState(false);
     const [isCreatingAgent, setIsCreatingAgent] = useState(false);
     const router = useRouter();
 
@@ -131,7 +136,9 @@ export function Header(props: HeaderProps) {
                             label: (
                                 <>
                                     {primary.type}
-                                    {aliases.length > 0 && <span className="text-gray-400 font-normal"> / {aliases.join(' / ')}</span>}
+                                    {aliases.length > 0 && (
+                                        <span className="text-gray-400 font-normal"> / {aliases.join(' / ')}</span>
+                                    )}
                                 </>
                             ),
                             href: `/docs/${primary.type}`,
@@ -210,24 +217,30 @@ export function Header(props: HeaderProps) {
                       ],
                   },
                   {
-                      type: 'link' as const,
-                      label: 'API Tokens',
-                      href: '/admin/api-tokens',
-                  },
-                  {
-                      type: 'link' as const,
-                      label: 'Metadata',
-                      href: '/admin/metadata',
-                  },
-                  {
-                      type: 'link' as const,
-                      label: 'Chat history',
-                      href: '/admin/chat-history',
-                  },
-                  {
-                      type: 'link' as const,
-                      label: 'Chat feedback',
-                      href: '/admin/chat-feedback',
+                      type: 'dropdown' as const,
+                      label: 'System',
+                      isOpen: isSystemOpen,
+                      setIsOpen: setIsSystemOpen,
+                      isMobileOpen: isMobileSystemOpen,
+                      setIsMobileOpen: setIsMobileSystemOpen,
+                      items: [
+                          {
+                              label: 'API Tokens',
+                              href: '/admin/api-tokens',
+                          },
+                          {
+                              label: 'Metadata',
+                              href: '/admin/metadata',
+                          },
+                          {
+                              label: 'Chat history',
+                              href: '/admin/chat-history',
+                          },
+                          {
+                              label: 'Chat feedback',
+                              href: '/admin/chat-feedback',
+                          },
+                      ],
                   },
                   {
                       type: 'link' as const,
@@ -241,6 +254,7 @@ export function Header(props: HeaderProps) {
     return (
         <header className="fixed top-0 left-0 right-0 z-50 bg-white/80 backdrop-blur-md border-b border-gray-200 h-16">
             <LoginDialog isOpen={isLoginOpen} onClose={() => setIsLoginOpen(false)} />
+            <ChangePasswordDialog isOpen={isChangePasswordOpen} onClose={() => setIsChangePasswordOpen(false)} />
             <div className="container mx-auto px-4 h-full">
                 <div className="flex items-center justify-between h-full">
                     {/* Logo */}
@@ -370,24 +384,56 @@ export function Header(props: HeaderProps) {
 
                         {(currentUser || isAdmin) && (
                             <div className="hidden lg:flex items-center gap-3">
-                                <span className="inline text-sm text-gray-600">
-                                    Logged in as <strong>{currentUser?.username || 'Admin'}</strong>
-                                    {(currentUser?.isAdmin || isAdmin) && (
-                                        <span className="ml-2 bg-blue-100 text-blue-800 text-xs px-2 py-1 rounded">
-                                            Admin
-                                        </span>
+                                <div className="relative">
+                                    <button
+                                        onClick={() => setIsProfileOpen(!isProfileOpen)}
+                                        onBlur={() => setTimeout(() => setIsProfileOpen(false), 200)}
+                                        className="flex items-center gap-2 text-sm font-medium text-gray-600 hover:text-gray-900 transition-colors px-3 py-2 rounded-md hover:bg-gray-50"
+                                    >
+                                        <div className="w-8 h-8 rounded-full bg-blue-100 flex items-center justify-center text-blue-600">
+                                            <User className="w-4 h-4" />
+                                        </div>
+                                        <div className="flex flex-col items-start">
+                                            <span className="leading-none">{currentUser?.username || 'Admin'}</span>
+                                            {(currentUser?.isAdmin || isAdmin) && (
+                                                <span className="text-xs text-blue-600">Admin</span>
+                                            )}
+                                        </div>
+                                        <ChevronDown className="w-4 h-4 ml-1 opacity-50" />
+                                    </button>
+
+                                    {isProfileOpen && (
+                                        <div className="absolute top-full right-0 mt-2 w-56 bg-white rounded-md shadow-lg border border-gray-100 py-1 z-50 animate-in fade-in zoom-in-95 duration-200">
+                                            <div className="px-4 py-3 border-b border-gray-100">
+                                                <p className="text-sm font-medium text-gray-900">
+                                                    {currentUser?.username || 'Admin'}
+                                                </p>
+                                                {(currentUser?.isAdmin || isAdmin) && (
+                                                    <p className="text-xs text-blue-600 mt-1">Administrator</p>
+                                                )}
+                                            </div>
+
+                                            <button
+                                                onClick={() => setIsChangePasswordOpen(true)}
+                                                className="w-full text-left px-4 py-2 text-sm text-gray-700 hover:bg-gray-50 hover:text-gray-900 flex items-center gap-2"
+                                            >
+                                                <Lock className="w-4 h-4" />
+                                                Change Password
+                                            </button>
+
+                                            <button
+                                                onClick={() => {
+                                                    handleLogout();
+                                                    setIsMenuOpen(false);
+                                                }}
+                                                className="w-full text-left px-4 py-2 text-sm text-red-600 hover:bg-red-50 hover:text-red-700 flex items-center gap-2"
+                                            >
+                                                <LogOut className="w-4 h-4" />
+                                                Log out
+                                            </button>
+                                        </div>
                                     )}
-                                </span>
-                                <button
-                                    onClick={() => {
-                                        handleLogout();
-                                        setIsMenuOpen(false);
-                                    }}
-                                    className="inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium h-10 px-4 py-2 text-gray-600 hover:text-gray-900 hover:bg-gray-100 transition-colors"
-                                >
-                                    Log out
-                                    <LogOut className="ml-2 w-4 h-4" />
-                                </button>
+                                </div>
                             </div>
                         )}
 
@@ -403,7 +449,7 @@ export function Header(props: HeaderProps) {
                 {/* Mobile Navigation */}
                 {isMenuOpen && (
                     <div
-                        className="lg:hidden absolute top-16 left-0 right-0 z-50 bg-white/80 shadow-xl py-4 border-t border-gray-100 animate-in slide-in-from-top-2 h-[calc(100vh-4rem)] overflow-y-auto"
+                        className="lg:hidden absolute top-16 left-0 right-0 z-50 bg-white shadow-xl py-4 border-t border-gray-100 animate-in slide-in-from-top-2 h-[calc(100vh-4rem)] overflow-y-auto"
                         style={{
                             backdropFilter: 'blur(20px)',
                             WebkitBackdropFilter: 'blur(20px)',
@@ -435,6 +481,16 @@ export function Header(props: HeaderProps) {
                                                 </span>
                                             )}
                                         </div>
+                                        <button
+                                            onClick={() => {
+                                                setIsChangePasswordOpen(true);
+                                                setIsMenuOpen(false);
+                                            }}
+                                            className="flex items-center gap-2 text-base font-medium text-gray-600 hover:text-gray-900 w-full"
+                                        >
+                                            <Lock className="w-4 h-4" />
+                                            Change Password
+                                        </button>
                                         <button
                                             onClick={() => {
                                                 handleLogout();

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

@@ -0,0 +1,20 @@
+import { DetailedHTMLProps, HTMLAttributes } from 'react';
+
+type OpenMojiIconProps = DetailedHTMLProps<HTMLAttributes<HTMLSpanElement>, HTMLSpanElement> & {
+    icon: string;
+};
+
+/**
+ * Renders an emoji using the OpenMoji black and white font
+ */
+export function OpenMojiIcon({ icon, className, style, ...rest }: OpenMojiIconProps) {
+    return (
+        <span
+            className={className}
+            style={{ ...style, fontFamily: '"OpenMojiBlack", sans-serif' }}
+            {...rest}
+        >
+            {icon}
+        </span>
+    );
+}

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

@@ -0,0 +1,18 @@
+'use client';
+
+import { OpenMojiIcon } from '../OpenMojiIcon/OpenMojiIcon';
+
+export function PrintButton() {
+    return (
+        <button
+            onClick={() => window.print()}
+            className="fixed bottom-8 right-8 bg-blue-600 hover:bg-blue-700 text-white rounded-full p-4 shadow-lg transition-all hover:scale-105 print:hidden z-50 flex items-center justify-center gap-2 group"
+            title="Print documentation"
+        >
+            <OpenMojiIcon icon="🖨️" className="text-2xl" />
+            <span className="max-w-0 overflow-hidden group-hover:max-w-xs transition-all duration-300 ease-in-out whitespace-nowrap">
+                Print
+            </span>
+        </button>
+    );
+}

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

@@ -0,0 +1,18 @@
+export function PrintHeader({ title }: { title?: string }) {
+    return (
+        <div className="hidden print:block mb-8 border-b-2 border-blue-600 pb-4">
+            <div className="flex justify-between items-end">
+                <div>
+                    <h1 className="text-3xl font-bold text-gray-900 font-poppins">Agents Server</h1>
+                    <div className="text-sm text-gray-500 mt-1 flex items-center gap-1">
+                        Powered by <span className="font-semibold text-blue-600">Promptbook</span>
+                    </div>
+                </div>
+                {title && <h2 className="text-xl font-semibold text-gray-700">{title}</h2>}
+            </div>
+            <div className="text-xs text-gray-400 mt-2 text-right">
+                {new Date().toLocaleDateString()}
+            </div>
+        </div>
+    );
+}

package/apps/agents-server/src/database/migrations/2025-12-0070-chat-history-source.sql

@@ -0,0 +1,2 @@
+ALTER TABLE "ChatHistory" ADD COLUMN "source" TEXT CHECK ("source" IN ('AGENT_PAGE_CHAT', 'OPENAI_API_COMPATIBILITY'));
+ALTER TABLE "ChatHistory" ADD COLUMN "apiKey" TEXT;

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

@@ -128,6 +128,8 @@ export type AgentsServerDatabase = {
                     userAgent: string | null;
                     language: string | null;
                     platform: string | null;
+                    source: 'AGENT_PAGE_CHAT' | 'OPENAI_API_COMPATIBILITY' | null;
+                    apiKey: string | null;
                 };
                 Insert: {
                     id?: number;
@@ -143,6 +145,8 @@ export type AgentsServerDatabase = {
                     userAgent?: string | null;
                     language?: string | null;
                     platform?: string | null;
+                    source?: 'AGENT_PAGE_CHAT' | 'OPENAI_API_COMPATIBILITY' | null;
+                    apiKey?: string | null;
                 };
                 Update: {
                     id?: number;
@@ -158,6 +162,8 @@ export type AgentsServerDatabase = {
                     userAgent?: string | null;
                     language?: string | null;
                     platform?: string | null;
+                    source?: 'AGENT_PAGE_CHAT' | 'OPENAI_API_COMPATIBILITY' | null;
+                    apiKey?: string | null;
                 };
                 Relationships: [];
             };

package/apps/agents-server/src/middleware.ts

@@ -134,7 +134,7 @@ export async function middleware(req: NextRequest) {
             headers: {
                 'Access-Control-Allow-Origin': '*',
                 'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
-                'Access-Control-Allow-Headers': 'Content-Type',
+                'Access-Control-Allow-Headers': 'Content-Type, Authorization',
             },
         });
     }

package/apps/agents-server/src/utils/convertToCsv.ts

@@ -0,0 +1,31 @@
+/**
+ * Converts an array of objects to a CSV string
+ */
+export function convertToCsv(data: Array<Record<string, unknown>>): string {
+    if (data.length === 0) {
+        return '';
+    }
+
+    const headers = Object.keys(data[0]);
+    const csvRows = [headers.join(',')];
+
+    for (const row of data) {
+        const values = headers.map((header) => {
+            let value = row[header];
+
+            if (value === null || value === undefined) {
+                value = '';
+            } else if (typeof value === 'object') {
+                value = JSON.stringify(value);
+            } else {
+                value = String(value);
+            }
+
+            const escaped = (value as string).replace(/"/g, '""');
+            return `"${escaped}"`;
+        });
+        csvRows.push(values.join(','));
+    }
+
+    return csvRows.join('\n');
+}