@promptbook/cli 0.103.0-48 → 0.103.0-49

package/apps/agents-server/README.md

@@ -1,3 +1,3 @@
 # 🔠 Promptbook Agents server
 
--   TODO: !!! Search for [🔠] to find all places where new app should be registered
+-   TODO: [🐱‍🚀] Search for [🔠] to find all places where new app should be registered

package/apps/agents-server/TODO.txt

@@ -1,6 +1,7 @@
-TODO: !!!! Tests of the agents server should be in main testing pipeline
-TODO: !!!! Make the agents live here and act here
-TODO: !!!! Publish `agents-server` this as Docker container
-TODO: !!!! Publish `@promptbook/agents-server` to npm
-TODO: !!!! Work `ptbk start-pipelines-server` / `ptbk start-agents-server` CLI command to start this server
+TODO: [🐱‍🚀] Theese are TODOs connected with the agents and Agents server
+TODO: [🐱‍🚀] Tests of the agents server should be in main testing pipeline
+TODO: [🐱‍🚀] Make the agents live here and act here
+TODO: [🐱‍🚀] Publish `agents-server` this as Docker container
+TODO: [🐱‍🚀] Publish `@promptbook/agents-server` to npm
+TODO: [🐱‍🚀] Work `ptbk start-pipelines-server` / `ptbk start-agents-server` CLI command to start this server
 TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention

package/apps/agents-server/config.ts

@@ -0,0 +1,130 @@
+import { ConfigChecker } from 'configchecker';
+
+const config = ConfigChecker.from({
+    ...process.env,
+
+    // Note: To expose env variables to the browser, using this seemingly strange syntax:
+    //       @see https://nextjs.org/docs/pages/building-your-application/configuring/environment-variables#exposing-environment-variables-to-the-browser
+    NEXT_PUBLIC_URL: process.env.NEXT_PUBLIC_URL,
+
+    // Note: [🌇] Defa
+    NEXT_PUBLIC_VERCEL_ENV: process.env.NEXT_PUBLIC_VERCEL_ENV,
+    NEXT_PUBLIC_VERCEL_TARGET_ENV: process.env.NEXT_PUBLIC_VERCEL_TARGET_ENV,
+    NEXT_PUBLIC_VERCEL_URL: process.env.NEXT_PUBLIC_VERCEL_URL,
+    NEXT_PUBLIC_VERCEL_BRANCH_URL: process.env.NEXT_PUBLIC_VERCEL_BRANCH_URL,
+    NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL: process.env.NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL,
+    NEXT_PUBLIC_VERCEL_GIT_PROVIDER: process.env.NEXT_PUBLIC_VERCEL_GIT_PROVIDER,
+    NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER: process.env.NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER,
+    NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG: process.env.NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG,
+    NEXT_PUBLIC_VERCEL_GIT_REPO_ID: process.env.NEXT_PUBLIC_VERCEL_GIT_REPO_ID,
+    NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA,
+    NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE,
+    NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF,
+    NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME,
+    NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN,
+    NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA: process.env.NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA,
+    NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID: process.env.NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID,
+});
+
+/**
+ * Public URL of the deployment, e.g. "https://my-app.vercel.app"
+ *
+ * Note: When `SERVERS` are used, this URL will be overridden by the server URL.
+ */
+export const NEXT_PUBLIC_URL = config.get('NEXT_PUBLIC_URL').url().value;
+
+/**
+ * [♐️] Vercel environment: "development" | "preview" | "production"
+ */
+export const NEXT_PUBLIC_VERCEL_ENV = config.get('NEXT_PUBLIC_VERCEL_ENV').value;
+
+/**
+ * [♐️] Target environment – can be system or custom
+ */
+export const NEXT_PUBLIC_VERCEL_TARGET_ENV = config.get('NEXT_PUBLIC_VERCEL_TARGET_ENV').value;
+
+/**
+ * [♐️] Deployment URL (without https://), e.g. "my-app-abc123.vercel.app"
+ */
+export const NEXT_PUBLIC_VERCEL_URL = config.get('NEXT_PUBLIC_VERCEL_URL').value;
+
+/**
+ * [♐️] Branch URL (without https://), only for branch deployments
+ */
+export const NEXT_PUBLIC_VERCEL_BRANCH_URL = config.get('NEXT_PUBLIC_VERCEL_BRANCH_URL').value;
+
+/**
+ * [♐️] Production domain of the project
+ */
+export const NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL = config.get('NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL').value;
+
+/**
+ * [♐️] Git provider (github | gitlab | bitbucket)
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_PROVIDER = config.get('NEXT_PUBLIC_VERCEL_GIT_PROVIDER').value;
+
+/**
+ * [♐️] Repository owner (e.g. "hejny")
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER = config.get('NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER').value;
+
+/**
+ * [♐️] Repository slug (e.g. "my-project")
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG = config.get('NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG').value;
+
+/**
+ * [♐️] Repository internal ID
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_REPO_ID = config.get('NEXT_PUBLIC_VERCEL_GIT_REPO_ID').value;
+
+/**
+ * [♐️] Git commit SHA (short or long)
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA = config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA').value;
+
+/**
+ * [♐️] Commit message used for this deployment
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE = config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE').value;
+
+/**
+ * [♐️] Branch name (ref), e.g. "main"
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF = config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF').value;
+
+/**
+ * Author name of the commit
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME = config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME').value;
+
+/**
+ * [♐️] Author login/username
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN = config.get(
+    'NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN',
+).value;
+
+/**
+ * [♐️] Previous deployment commit SHA (if exists)
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA = config.get('NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA').value;
+
+/**
+ * [♐️] Pull Request ID for PR-based deployments
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID = config.get('NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID').value;
+
+/**
+ * List of servers where agents can be hosted
+ *
+ * List of domains where the agents-server is deployed, this overrides the `NEXT_PUBLIC_URL` and `SUPABASE_TABLE_PREFIX` for each server.
+ */
+export const SERVERS = config.get('SERVERS').list().value;
+
+/**
+ * Supabase table prefix
+ *
+ * Note: When `SERVERS` are used, this prefix will be overridden by the server `server_<server_id>_`.
+ */
+export const SUPABASE_TABLE_PREFIX = config.get('SUPABASE_TABLE_PREFIX').default('').value;

package/apps/agents-server/next.config.ts

@@ -3,7 +3,7 @@ import path from 'path';
 
 const nextConfig: NextConfig = {
     output: 'standalone',
-    // <- TODO: !!!! How to propperly build Next.js app
+    // <- TODO: [🐱‍🚀] How to propperly build Next.js app
 
     experimental: {
         externalDir: true,

package/apps/agents-server/public/fonts/download-font.js

@@ -0,0 +1,22 @@
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+
+const dir = path.join('apps', 'agents-server', 'public', 'fonts');
+const filePath = path.join(dir, 'OpenMoji-black-glyf.woff2');
+
+if (!fs.existsSync(dir)){
+    fs.mkdirSync(dir, { recursive: true });
+}
+
+const file = fs.createWriteStream(filePath);
+https.get('https://raw.githubusercontent.com/hfg-gmuend/openmoji/master/font/OpenMoji-black-glyf/OpenMoji-black-glyf.woff2', function(response) {
+  response.pipe(file);
+  file.on('finish', function() {
+    file.close();
+    console.log('Download completed');
+  });
+}).on('error', function(err) { 
+  fs.unlink(filePath); 
+  console.error('Error downloading file:', err.message);
+});

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

@@ -0,0 +1,6 @@
+import { redirect } from 'next/navigation';
+
+export default async function RedirectPage({ params }: { params: Promise<{ agentName: string; rest: string[] }> }) {
+    const { agentName, rest } = await params;
+    redirect(`/agents/${agentName}/${rest.join('/')}`);
+}

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

@@ -0,0 +1 @@
+export { generateMetadata, default } from '../agents/[agentName]/page';

package/apps/agents-server/src/app/actions.ts

@@ -1,14 +1,49 @@
 'use server';
 
 import { $generateBookBoilerplate } from '@promptbook-local/core';
+import { revalidatePath } from 'next/cache';
+import { cookies } from 'next/headers';
 import { $provideAgentCollectionForServer } from '../tools/$provideAgentCollectionForServer';
+import { isUserAdmin } from '../utils/isUserAdmin';
 
 export async function $createAgentAction() {
+    // TODO: [👹] Check permissions here
+    if (!(await isUserAdmin())) {
+        throw new Error('You are not authorized to create agents');
+    }
+
     const collection = await $provideAgentCollectionForServer();
     await collection.createAgent($generateBookBoilerplate());
 }
 
+export async function loginAction(formData: FormData) {
+    const username = formData.get('username') as string;
+    const password = formData.get('password') as string;
+
+    console.info(`Login attempt for user: ${username}`);
+
+    if (password === process.env.ADMIN_PASSWORD) {
+        const cookieStore = await cookies();
+        cookieStore.set('adminToken', password, {
+            httpOnly: true,
+            secure: process.env.NODE_ENV === 'production',
+            path: '/',
+            maxAge: 60 * 60 * 24 * 30, // 30 days
+        });
+        revalidatePath('/', 'layout');
+        return { success: true };
+    } else {
+        return { success: false, message: 'Invalid password' };
+    }
+}
+
+export async function logoutAction() {
+    const cookieStore = await cookies();
+    cookieStore.delete('adminToken');
+    revalidatePath('/', 'layout');
+}
+
 /**
- * TODO: !!!! Reorganize actions.ts files
- * TODO: !!! [🧠] Study how Next.js actions work
+ * TODO: [🐱‍🚀] Reorganize actions.ts files
+ * TODO: [🐱‍🚀] [🧠] Study how Next.js actions work
  */

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

@@ -0,0 +1,68 @@
+'use client';
+
+import { usePromise } from '@common/hooks/usePromise';
+import { AgentChat } from '@promptbook-local/components';
+import { RemoteAgent } from '@promptbook-local/core';
+import { useCallback, useMemo } from 'react';
+import { string_agent_url } from '../../../../../../src/types/typeAliases';
+
+type AgentChatWrapperProps = {
+    agentUrl: string_agent_url;
+};
+
+// TODO: [🐱‍🚀] Rename to AgentChatSomethingWrapper
+
+export function AgentChatWrapper(props: AgentChatWrapperProps) {
+    const { agentUrl } = props;
+
+    const agentPromise = useMemo(
+        () =>
+            RemoteAgent.connect({
+                agentUrl,
+                isVerbose: true,
+            }),
+        [agentUrl],
+    );
+
+    const { value: agent } = usePromise(agentPromise, [agentPromise]);
+
+    const handleFeedback = useCallback(
+        async (feedback: {
+            rating: number;
+            textRating?: string;
+            chatThread?: string;
+            userNote?: string;
+            expectedAnswer?: string | null;
+        }) => {
+            if (!agent) {
+                return;
+            }
+
+            await fetch(`${agentUrl}/api/feedback`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    rating: feedback.rating.toString(),
+                    textRating: feedback.textRating,
+                    chatThread: feedback.chatThread,
+                    userNote: feedback.textRating, // Mapping textRating to userNote as well if needed, or just textRating
+                    expectedAnswer: feedback.expectedAnswer,
+                    agentHash: agent.agentHash,
+                }),
+            });
+        },
+        [agent, agentUrl],
+    );
+
+    if (!agent) {
+        return <>{/* <- TODO: [🐱‍🚀] <PromptbookLoading /> */}</>;
+    }
+
+    return <AgentChat className={`w-full h-full`} agent={agent} onFeedback={handleFeedback} />;
+}
+
+/**
+ * TODO: [🚗] Transfer the saving logic to `<BookEditor/>` be aware of CRDT / yjs approach to be implementable in future
+ */

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

@@ -0,0 +1,55 @@
+'use client';
+
+import { PromptbookQrCode } from '@promptbook-local/components';
+import { AgentBasicInformation } from '@promptbook-local/types';
+import { useState } from 'react';
+import spaceTrim from 'spacetrim';
+
+type AgentQrCodeProps = Pick<AgentBasicInformation, 'agentName' | 'personaDescription'> & {
+    agentUrl: string;
+    agentEmail: string;
+};
+
+export function AgentQrCode({ agentName, agentUrl, agentEmail, personaDescription }: AgentQrCodeProps) {
+    const [mode, setMode] = useState<'contact' | 'link'>('contact');
+
+    // TODO: [🧠] Should we include more info in VCARD?
+    const vcard = spaceTrim(`
+        BEGIN:VCARD
+        VERSION:3.0
+        FN:${agentName}
+        URL:${agentUrl}
+        EMAIL:${agentEmail}
+        NOTE:${personaDescription}
+        END:VCARD
+    `);
+
+    const qrValue = mode === 'contact' ? vcard : agentUrl;
+    const label = mode === 'contact' ? 'Scan to add contact' : 'Scan to open agent';
+
+    return (
+        <div className="flex flex-col items-center">
+            <div className="flex bg-gray-100 p-1 rounded-lg mb-4">
+                <button
+                    onClick={() => setMode('contact')}
+                    className={`px-3 py-1 text-xs font-medium rounded-md transition-all ${
+                        mode === 'contact' ? 'bg-white text-gray-900 shadow-sm' : 'text-gray-500 hover:text-gray-700'
+                    }`}
+                >
+                    Contact
+                </button>
+                <button
+                    onClick={() => setMode('link')}
+                    className={`px-3 py-1 text-xs font-medium rounded-md transition-all ${
+                        mode === 'link' ? 'bg-white text-gray-900 shadow-sm' : 'text-gray-500 hover:text-gray-700'
+                    }`}
+                >
+                    Link
+                </button>
+            </div>
+
+            <PromptbookQrCode value={qrValue} className="" size={250} />
+            <span className="mt-2 text-xs text-gray-500">{label}</span>
+        </div>
+    );
+}

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

@@ -1,14 +1,14 @@
 'use client';
 
+import { string_agent_url } from '@promptbook-local/types';
 import { useState } from 'react';
 
-export function AgentUrlCopy({ url }: { url: string; }) {
+export function AgentUrlCopy({ agentUrl }: { agentUrl: string_agent_url }) {
     const [copied, setCopied] = useState(false);
 
-
     const handleCopy = async () => {
         try {
-            await navigator.clipboard.writeText(url);
+            await navigator.clipboard.writeText(agentUrl);
             setCopied(true);
             setTimeout(() => setCopied(false), 2000);
         } catch (err) {
@@ -22,7 +22,7 @@ export function AgentUrlCopy({ url }: { url: string; }) {
             <div className="flex gap-2 items-center">
                 <input
                     type="text"
-                    value={url}
+                    value={agentUrl}
                     readOnly
                     className="flex-1 px-2 py-1 border rounded text-sm bg-gray-50 text-gray-700"
                     onFocus={(e) => e.target.select()}
@@ -30,7 +30,6 @@ export function AgentUrlCopy({ url }: { url: string; }) {
                 <button
                     type="button"
                     className="px-2 py-1 text-white rounded text-xs font-semibold transition hover:opacity-90"
-                 
                     onClick={handleCopy}
                 >
                     {copied ? '✓ Copied' : 'Copy'}

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

@@ -0,0 +1,44 @@
+'use client';
+
+import { useState } from 'react';
+
+type CopyFieldProps = {
+    label: string;
+    value: string;
+};
+
+export function CopyField({ label, value }: CopyFieldProps) {
+    const [copied, setCopied] = useState(false);
+
+    const handleCopy = async () => {
+        try {
+            await navigator.clipboard.writeText(value);
+            setCopied(true);
+            setTimeout(() => setCopied(false), 2000);
+        } catch (err) {
+            console.error('Failed to copy:', err);
+        }
+    };
+
+    return (
+        <div className="w-full">
+            <label className="block text-xs text-gray-500 font-semibold mb-1">{label}</label>
+            <div className="flex gap-2 items-center">
+                <input
+                    type="text"
+                    value={value}
+                    readOnly
+                    className="flex-1 px-2 py-1 border rounded text-sm bg-gray-50 text-gray-700 focus:outline-none focus:ring-1 focus:ring-blue-500"
+                    onFocus={(e) => e.target.select()}
+                />
+                <button
+                    type="button"
+                    className="px-3 py-1 bg-gray-800 text-white rounded text-xs font-semibold transition hover:bg-gray-700 active:bg-gray-900"
+                    onClick={handleCopy}
+                >
+                    {copied ? '✓ Copied' : 'Copy'}
+                </button>
+            </div>
+        </div>
+    );
+}

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

@@ -26,13 +26,13 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
         return new Response(
             JSON.stringify(
                 serializeError(error),
-                // <- TODO: !!! Rename `serializeError` to `errorToJson`
+                // <- TODO: [🐱‍🚀] Rename `serializeError` to `errorToJson`
                 null,
                 4,
-                // <- TODO: !!! Allow to configure pretty print for agent server
+                // <- TODO: [🐱‍🚀] Allow to configure pretty print for agent server
             ),
             {
-                status: 400, // <- TODO: !!! Make `errorToHttpStatusCode`
+                status: 400, // <- TODO: [🐱‍🚀] Make `errorToHttpStatusCode`
                 headers: { 'Content-Type': 'application/json' },
             },
         );
@@ -51,13 +51,13 @@ export async function PUT(request: Request, { params }: { params: Promise<{ agen
         agentSource = padBook(agentSource);
 
         await collection.updateAgentSource(agentName, agentSource);
-        // <- TODO: !!! Properly type as string_book
+        // <- TODO: [🐱‍🚀] Properly type as string_book
 
         return new Response(
             JSON.stringify({
                 isSuccessful: true,
                 message: `Agent "${agentName}" updated successfully`,
-                agentSource, // <- TODO: !!! Remove from response
+                agentSource, // <- TODO: [🐱‍🚀] Remove from response
             }),
             {
                 status: 200,
@@ -72,13 +72,13 @@ export async function PUT(request: Request, { params }: { params: Promise<{ agen
         return new Response(
             JSON.stringify(
                 serializeError(error),
-                // <- TODO: !!! Rename `serializeError` to `errorToJson`
+                // <- TODO: [🐱‍🚀] Rename `serializeError` to `errorToJson`
                 null,
                 4,
-                // <- TODO: !!! Allow to configure pretty print for agent server
+                // <- TODO: [🐱‍🚀] Allow to configure pretty print for agent server
             ),
             {
-                status: 400, // <- TODO: !!! Make `errorToHttpStatusCode`
+                status: 400, // <- TODO: [🐱‍🚀] Make `errorToHttpStatusCode`
                 headers: { 'Content-Type': 'application/json' },
             },
         );

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

@@ -1,15 +1,23 @@
+import { $getTableName } from '@/src/database/$getTableName';
+import { $provideSupabaseForServer } from '@/src/database/$provideSupabaseForServer';
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
 import { $provideOpenAiAssistantExecutionToolsForServer } from '@/src/tools/$provideOpenAiAssistantExecutionToolsForServer';
-import { Agent } from '@promptbook-local/core';
-import { serializeError } from '@promptbook-local/utils';
+import { Agent, computeAgentHash, PROMPTBOOK_ENGINE_VERSION } from '@promptbook-local/core';
+import { computeHash, serializeError } from '@promptbook-local/utils';
 import { assertsError } from '../../../../../../../../src/errors/assertsError';
 
-export async function GET(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
+/**
+ * Allow long-running streams: set to platform maximum (seconds)
+ */
+export const maxDuration = 300;
+
+export async function POST(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
     let { agentName } = await params;
     agentName = decodeURIComponent(agentName);
-    const { searchParams } = new URL(request.url);
-    const message = searchParams.get('message') || 'Tell me more about yourself.';
-    //                                               <- TODO: !!!! To configuration DEFAULT_INITIAL_HIDDEN_MESSAGE
+
+    const body = await request.json();
+    const { message = 'Tell me more about yourself.', thread } = body;
+    //      <- TODO: [🐱‍🚀] To configuration DEFAULT_INITIAL_HIDDEN_MESSAGE
 
     try {
         const collection = await $provideAgentCollectionForServer();
@@ -17,7 +25,7 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
         const openAiAssistantExecutionTools = await $provideOpenAiAssistantExecutionToolsForServer();
         const agentSource = await collection.getAgentSource(agentName);
         const agent = new Agent({
-            isVerbose: true, // <- TODO: !!! From environment variable
+            isVerbose: true, // <- TODO: [🐱‍🚀] From environment variable
             executionTools: {
                 // [▶️] ...executionTools,
                 llm: openAiAssistantExecutionTools, // Note: Providing the OpenAI Assistant LLM tools to the Agent to be able to create its own Assistants GPTs
@@ -25,18 +33,92 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
             agentSource,
         });
 
-        const response = await agent.callChatModel!({
-            title: `Chat with agent ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */}`,
-            parameters: {},
-            modelRequirements: {
-                modelVariant: 'CHAT',
-            },
+        const agentHash = computeAgentHash(agentSource);
+        const userAgent = request.headers.get('user-agent');
+        const ip =
+            request.headers.get('x-forwarded-for') ||
+            request.headers.get('x-real-ip') ||
+            request.headers.get('x-client-ip');
+
+        // Note: Capture language and platform information
+        const language = request.headers.get('accept-language');
+        // Simple platform extraction from userAgent parentheses content (e.g., Windows NT 10.0; Win64; x64)
+        const platform = userAgent ? userAgent.match(/\(([^)]+)\)/)?.[1] : undefined; // <- TODO: [🧠] Improve platform parsing
+
+        // Note: Identify the user message
+        const userMessageContent = {
+            role: 'USER',
             content: message,
+        };
+
+        // Record the user message
+        const supabase = $provideSupabaseForServer();
+        await supabase.from(await $getTableName('ChatHistory')).insert({
+            createdAt: new Date().toISOString(),
+            messageHash: computeHash(userMessageContent),
+            previousMessageHash: null, // <- TODO: [🧠] How to handle previous message hash?
+            agentName,
+            agentHash,
+            message: userMessageContent,
+            promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+            url: request.url,
+            ip,
+            userAgent,
+            language,
+            platform,
         });
 
-        // TODO: [🐚] Implement streaming
+        const encoder = new TextEncoder();
+        const readableStream = new ReadableStream({
+            start(controller) {
+                agent.callChatModelStream!(
+                    {
+                        title: `Chat with agent ${
+                            agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */
+                        }`,
+                        parameters: {},
+                        modelRequirements: {
+                            modelVariant: 'CHAT',
+                        },
+                        content: message,
+                        thread,
+                    },
+                    (chunk) => {
+                        controller.enqueue(encoder.encode(chunk.content));
+                    },
+                )
+                    .then(async (response) => {
+                        // Note: Identify the agent message
+                        const agentMessageContent = {
+                            role: 'MODEL',
+                            content: response.content,
+                        };
 
-        return new Response(response.content, {
+                        // Record the agent message
+                        await supabase.from(await $getTableName('ChatHistory')).insert({
+                            createdAt: new Date().toISOString(),
+                            messageHash: computeHash(agentMessageContent),
+                            previousMessageHash: computeHash(userMessageContent),
+                            agentName,
+                            agentHash,
+                            message: agentMessageContent,
+                            promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+                            url: request.url,
+                            ip,
+                            userAgent,
+                            language,
+                            platform,
+                        });
+
+                        controller.close();
+                    })
+                    .catch((error) => {
+                        controller.error(error);
+                    });
+            },
+        });
+
+        return new Response(readableStream, {
             status: 200,
             headers: { 'Content-Type': 'text/markdown' },
         });
@@ -48,21 +130,15 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
         return new Response(
             JSON.stringify(
                 serializeError(error),
-                // <- TODO: !!! Rename `serializeError` to `errorToJson`
+                // <- TODO: [🐱‍🚀] Rename `serializeError` to `errorToJson`
                 null,
                 4,
-                // <- TODO: !!! Allow to configure pretty print for agent server
+                // <- TODO: [🐱‍🚀] Allow to configure pretty print for agent server
             ),
             {
-                status: 400, // <- TODO: !!! Make `errorToHttpStatusCode`
+                status: 400, // <- TODO: [🐱‍🚀] Make `errorToHttpStatusCode`
                 headers: { 'Content-Type': 'application/json' },
             },
         );
     }
 }
-
-
-/**
- * TODO: !!!!!! Record conversations to `ChatHistory`
- * TODO: !!!!!! Make api endpoint for feedback on agent responses `/apps/agents-server/src/app/agents/[agentName]/api/feedback/route.ts` and record to `ChatFeedback`
- */