@promptbook/cli 0.104.0-5 → 0.104.0-6

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

@@ -1,6 +1,6 @@
 'use client';
 
-import { AgentBasicInformation } from '@promptbook-local/types';
+import { AgentBasicInformation, string_agent_name } from '@promptbook-local/types';
 import { AgentProfile } from '../../../components/AgentProfile/AgentProfile';
 import { AgentOptionsMenu } from './AgentOptionsMenu';
 
@@ -8,7 +8,7 @@ type AgentProfileWrapperProps = {
     agent: AgentBasicInformation;
     agentUrl: string;
     agentEmail: string;
-    agentName: string;
+    agentName: string_agent_name;
     brandColorHex: string;
     isAdmin: boolean;
     isHeadless: boolean;
@@ -27,6 +27,7 @@ export function AgentProfileWrapper(props: AgentProfileWrapperProps) {
         <AgentProfile
             agent={agent}
             agentUrl={agentUrl}
+            permanentId={permanentId || agentName}
             agentEmail={agentEmail}
             isHeadless={isHeadless}
             renderMenu={({ onShowQrCode }) => (

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

@@ -13,7 +13,11 @@ export async function getAgentName(params: Promise<{ agentName: string }>) {
 export async function getAgentProfile(agentName: string) {
     const collection = await $provideAgentCollectionForServer();
     const agentSource = await collection.getAgentSource(agentName);
-    return parseAgentSource(agentSource);
+    const agentProfile = parseAgentSource(agentSource);
+
+    console.log('!!!!', { agentSource, agentProfile });
+
+    return agentProfile;
 }
 
 export async function isAgentDeleted(agentName: string): Promise<boolean> {
@@ -33,5 +37,5 @@ export async function isAgentDeleted(agentName: string): Promise<boolean> {
 }
 
 /**
- * TODO: Split to multiple files
+ * TODO: Split to multiple files, refactor
  */

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

@@ -1,6 +1,8 @@
 'use client';
 
 import Editor from '@monaco-editor/react';
+import { generatePlaceholderAgentProfileImageUrl } from '@promptbook-local/core';
+import { AgentBasicInformation } from '@promptbook-local/types';
 import { ArrowLeftIcon, ChevronDownIcon, CodeIcon } from 'lucide-react';
 import Link from 'next/link';
 import { useCallback, useEffect, useState } from 'react';
@@ -29,7 +31,7 @@ function getLanguageFromTranspiler(transpilerName?: string): string {
 
 export default function AgentCodePage({ params }: { params: Promise<{ agentName: string }> }) {
     const [agentName, setAgentName] = useState<string>('');
-    const [agentProfile, setAgentProfile] = useState<unknown>(null);
+    const [agentProfile, setAgentProfile] = useState<AgentBasicInformation | null>(null);
     const [transpilers, setTranspilers] = useState<Transpiler[]>([]);
     const [selectedTranspiler, setSelectedTranspiler] = useState<Transpiler | null>(null);
     const [transpiledCode, setTranspiledCode] = useState<string>('');
@@ -114,13 +116,17 @@ export default function AgentCodePage({ params }: { params: Promise<{ agentName:
                 {/* Header */}
                 <div className="p-6 border-b border-gray-200 flex items-center gap-4">
                     {/* eslint-disable @typescript-eslint/no-explicit-any, @next/next/no-img-element */}
-                    {(agentProfile as any)?.meta?.image && (
-                        <img
-                            src={(agentProfile as any).meta.image as string}
-                            alt={(agentProfile as any).meta.fullname || agentName}
-                            className="w-16 h-16 rounded-full object-cover border-2 border-gray-200"
-                        />
-                    )}
+
+                    <img
+                        src={
+                            agentProfile.meta.image ||
+                            agentProfile.permanentId ||
+                            generatePlaceholderAgentProfileImageUrl(agentName)
+                        }
+                        alt={agentProfile.meta.fullname || agentName}
+                        className="w-16 h-16 rounded-full object-cover border-2 border-gray-200"
+                    />
+
                     <div className="flex-1">
                         {/* eslint-disable-next-line @typescript-eslint/no-explicit-any */}
                         <h1 className="text-2xl font-bold text-gray-900">

package/apps/agents-server/src/app/agents/[agentName]/images/icon-256.png/route.tsx

@@ -1,4 +1,4 @@
-import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { generatePlaceholderAgentProfileImageUrl, PROMPTBOOK_COLOR } from '@promptbook-local/core';
 import { serializeError } from '@promptbook-local/utils';
 import { ImageResponse } from 'next/og';
 import { assertsError } from '../../../../../../../../src/errors/assertsError';
@@ -45,7 +45,10 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
                     >
                         {/* Note: `next/image` is not working propperly with `next/og` */}
                         {/* eslint-disable-next-line @next/next/no-img-element */}
-                        <img src={agentProfile.meta.image!} alt="Agent Icon" />
+                        <img
+                            src={agentProfile.meta.image ||  agentProfile.permanentId ||generatePlaceholderAgentProfileImageUrl(agentName)}
+                            alt="Agent Icon"
+                        />
                     </div>
                 </div>
             ),

package/apps/agents-server/src/app/agents/[agentName]/images/screenshot-fullhd.png/route.tsx

@@ -1,4 +1,4 @@
-import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { generatePlaceholderAgentProfileImageUrl, PROMPTBOOK_COLOR } from '@promptbook-local/core';
 import { serializeError } from '@promptbook-local/utils';
 import { ImageResponse } from 'next/og';
 import { assertsError } from '../../../../../../../../src/errors/assertsError';
@@ -51,7 +51,7 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
                                 backgroundColor: agentColor.toHex(),
                                 borderRadius: '50%',
                             }}
-                            src={agentProfile.meta.image!}
+                            src={agentProfile.meta.image ||  agentProfile.permanentId ||generatePlaceholderAgentProfileImageUrl(agentName)}
                             alt="Agent Icon"
                         />
                     </div>

package/apps/agents-server/src/app/agents/[agentName]/images/screenshot-phone.png/route.tsx

@@ -1,4 +1,4 @@
-import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { generatePlaceholderAgentProfileImageUrl, PROMPTBOOK_COLOR } from '@promptbook-local/core';
 import { serializeError } from '@promptbook-local/utils';
 import { ImageResponse } from 'next/og';
 import { assertsError } from '../../../../../../../../src/errors/assertsError';
@@ -51,7 +51,7 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
                                 backgroundColor: agentColor.toHex(),
                                 borderRadius: '50%',
                             }}
-                            src={agentProfile.meta.image!}
+                            src={agentProfile.meta.image ||  agentProfile.permanentId ||generatePlaceholderAgentProfileImageUrl(agentName)}
                             alt="Agent Icon"
                         />
                     </div>

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

@@ -4,7 +4,7 @@ import { $getTableName } from '@/src/database/$getTableName';
 import { $provideSupabase } from '@/src/database/$provideSupabase';
 import { $provideServer } from '@/src/tools/$provideServer';
 import { isUserAdmin } from '@/src/utils/isUserAdmin';
-import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { generatePlaceholderAgentProfileImageUrl, PROMPTBOOK_COLOR } from '@promptbook-local/core';
 import { ArrowLeftIcon, BoxIcon, CodeIcon, GlobeIcon, ServerIcon, TerminalIcon } from 'lucide-react';
 import { headers } from 'next/headers';
 import Link from 'next/link';
@@ -187,7 +187,7 @@ export default async function AgentIntegrationPage({ params }: { params: Promise
                     {agentProfile.meta.image && (
                         // eslint-disable-next-line @next/next/no-img-element
                         <img
-                            src={agentProfile.meta.image as string}
+                            src={agentProfile.meta.image ||  agentProfile.permanentId ||generatePlaceholderAgentProfileImageUrl(agentName)}
                             alt={agentProfile.meta.fullname || agentName}
                             className="w-16 h-16 rounded-full object-cover border-2"
                             style={{ borderColor: primaryColor }}

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

@@ -1,7 +1,7 @@
 'use server';
 
 import { $provideServer } from '@/src/tools/$provideServer';
-import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { generatePlaceholderAgentProfileImageUrl, PROMPTBOOK_COLOR } from '@promptbook-local/core';
 import { ArrowLeftIcon, CodeIcon, HomeIcon, LinkIcon, ShareIcon } from 'lucide-react';
 import { headers } from 'next/headers';
 import Link from 'next/link';
@@ -56,7 +56,7 @@ export default async function AgentLinksPage({ params }: { params: Promise<{ age
                     {agentProfile.meta.image && (
                         // eslint-disable-next-line @next/next/no-img-element
                         <img
-                            src={agentProfile.meta.image as string}
+                            src={agentProfile.meta.image || agentProfile.permanentId || generatePlaceholderAgentProfileImageUrl(agentName)}
                             alt={agentProfile.meta.fullname || agentName}
                             className="w-16 h-16 rounded-full object-cover border-2"
                             style={{ borderColor: primaryColor }}

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

@@ -1,4 +1,4 @@
-import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { generatePlaceholderAgentProfileImageUrl, PROMPTBOOK_COLOR } from '@promptbook-local/core';
 import { serializeError } from '@promptbook-local/utils';
 import { ImageResponse } from 'next/og';
 import { assertsError } from '../../../../../../src/errors/assertsError';
@@ -54,7 +54,11 @@ export default async function Image({ params }: { params: Promise<{ agentName: s
                                 backgroundColor: agentColor.toHex(),
                                 borderRadius: '50%',
                             }}
-                            src={agentProfile.meta.image!}
+                            src={
+                                agentProfile.meta.image ||
+                                agentProfile.permanentId ||
+                                generatePlaceholderAgentProfileImageUrl(agentProfile.permanentId || agentName)
+                            }
                             alt="Agent Icon"
                         />
                     </div>

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

@@ -3,17 +3,16 @@
 import { $provideServer } from '@/src/tools/$provideServer';
 import { isUserAdmin } from '@/src/utils/isUserAdmin';
 import { saturate } from '@promptbook-local/color';
-import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
-import { NotFoundError } from '@promptbook-local/core';
+import { generatePlaceholderAgentProfileImageUrl, NotFoundError, PROMPTBOOK_COLOR } from '@promptbook-local/core';
 import { notFound } from 'next/navigation';
 import { Color } from '../../../../../../src/utils/color/Color';
+import { DeletedAgentBanner } from '../../../components/DeletedAgentBanner';
 import { getAgentName, getAgentProfile, isAgentDeleted } from './_utils';
 import { getAgentLinks } from './agentLinks';
 import { AgentProfileChat } from './AgentProfileChat';
 import { AgentProfileWrapper } from './AgentProfileWrapper';
 import { generateAgentMetadata } from './generateAgentMetadata';
 import { ServiceWorkerRegister } from './ServiceWorkerRegister';
-import { DeletedAgentBanner } from '../../../components/DeletedAgentBanner';
 
 export const generateMetadata = generateAgentMetadata;
 
@@ -96,7 +95,11 @@ export default async function AgentPage({
                     agentName={agentName}
                     fullname={fullname}
                     brandColorHex={brandColorHex}
-                    avatarSrc={agentProfile.meta.image!}
+                    avatarSrc={
+                        agentProfile.meta.image ||
+                        agentProfile.permanentId ||
+                        generatePlaceholderAgentProfileImageUrl(agentName)
+                    }
                     isDeleted={isDeleted}
                 />
             </AgentProfileWrapper>

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

@@ -8,6 +8,7 @@ import { notFound } from 'next/navigation';
 import { $sideEffect } from '../../../../../../../src/utils/organization/$sideEffect';
 import { getAgentName, getAgentProfile } from '../_utils';
 import { generateAgentMetadata } from '../generateAgentMetadata';
+import { generatePlaceholderAgentProfileImageUrl } from '@promptbook-local/core';
 
 export const generateMetadata = generateAgentMetadata;
 
@@ -44,7 +45,7 @@ export default async function AgentSystemMessagePage({ params }: { params: Promi
                     {agentProfile.meta.image && (
                         // eslint-disable-next-line @next/next/no-img-element
                         <img
-                            src={agentProfile.meta.image as string}
+                            src={agentProfile.meta.image||  agentProfile.permanentId ||generatePlaceholderAgentProfileImageUrl(agentName)}
                             alt={agentProfile.meta.fullname || agentName}
                             className="w-16 h-16 rounded-full object-cover border-2 border-gray-200"
                         />

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

@@ -0,0 +1,48 @@
+import { $getTableName } from '../../../../../database/$getTableName';
+import { $provideSupabaseForServer } from '../../../../../database/$provideSupabaseForServer';
+import { parseInboundSendgridEmail } from '../../../../../message-providers/email/sendgrid/parseInboundSendgridEmail';
+import { NextRequest, NextResponse } from 'next/server';
+
+export async function POST(request: NextRequest) {
+    try {
+        const formData = await request.formData();
+        const rawEmail = formData.get('email');
+
+        if (typeof rawEmail !== 'string') {
+            return NextResponse.json({ error: 'Missing email field' }, { status: 400 });
+        }
+
+        const email = await parseInboundSendgridEmail(rawEmail);
+
+        const supabase = await $provideSupabaseForServer();
+        const { error } = await supabase
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            .from(await $getTableName('Message'))
+            .insert({
+                channel: 'EMAIL',
+                direction: 'INBOUND',
+                sender: email.sender,
+                recipients: email.recipients,
+                content: email.content,
+                metadata: {
+                    subject: email.subject,
+                    cc: email.cc,
+                    ...email.metadata,
+                },
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            } as any);
+
+        if (error) {
+            console.error('Failed to insert message', error);
+            return NextResponse.json({ error: error.message }, { status: 500 });
+        }
+
+        return NextResponse.json({ success: true });
+    } catch (error) {
+        console.error('Error processing inbound email', error);
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Unknown error' },
+            { status: 500 },
+        );
+    }
+}

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

@@ -1,6 +1,7 @@
 'use client';
 
-import { AgentBasicInformation } from '@promptbook-local/types';
+import { generatePlaceholderAgentProfileImageUrl } from '@promptbook-local/core';
+import { AgentBasicInformation, string_agent_permanent_id } from '@promptbook-local/types';
 import { RepeatIcon } from 'lucide-react';
 import { useState } from 'react';
 import { AgentQrCode } from './AgentQrCode';
@@ -13,6 +14,11 @@ type AgentProfileProps = {
      */
     readonly agent: AgentBasicInformation;
 
+    /**
+     * The permanent ID of the agent
+     */
+    readonly permanentId: string_agent_permanent_id;
+
     /**
      * URL of the agent page
      *
@@ -58,16 +64,18 @@ export function AgentProfile(props: AgentProfileProps) {
         agent,
         agentUrl = '',
         agentEmail = '',
+        permanentId,
         renderMenu,
         children,
         actions,
         isHeadless = false,
         className,
     } = props;
+    console.log('!!!!', { agent });
     const { meta, agentName } = agent;
     const fullname = (meta.fullname as string) || agentName || 'Agent';
     const personaDescription = agent.personaDescription || '';
-    const imageUrl = (meta.image as string) || null;
+    const imageUrl = meta.image || generatePlaceholderAgentProfileImageUrl(permanentId);
 
     const [isQrModalOpen, setIsQrModalOpen] = useState(false);
     const [isFlipped, setIsFlipped] = useState(false);

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

@@ -1,5 +1,6 @@
 'use client';
 
+import { generatePlaceholderAgentProfileImageUrl } from '@promptbook-local/core';
 import { really_any } from '@promptbook-local/types';
 import { EyeIcon, EyeOffIcon, RotateCcwIcon } from 'lucide-react';
 import Link from 'next/link';
@@ -32,7 +33,7 @@ export function AgentCard({
 }: AgentCardProps) {
     const { meta, agentName } = agent;
     const fullname = (meta.fullname as string) || agentName || 'Agent';
-    const imageUrl = (meta.image as string) || null;
+    const imageUrl = meta.image || generatePlaceholderAgentProfileImageUrl(agentName);
     const personaDescription = agent.personaDescription || '';
 
     const { brandColorLightHex, brandColorDarkHex, backgroundImage } = useAgentBackground(meta.color);

package/apps/agents-server/src/message-providers/email/sendgrid/parseInboundSendgridEmail.ts

@@ -0,0 +1,49 @@
+import { string_markdown } from '@promptbook-local/types';
+import { simpleParser } from 'mailparser';
+import TurndownService from 'turndown';
+import { extractBodyContentFromHtml } from '../../../utils/content/extractBodyContentFromHtml';
+import type { InboundEmail } from '../_common/Email';
+import { parseEmailAddress } from '../_common/utils/parseEmailAddress';
+import { parseEmailAddresses } from '../_common/utils/parseEmailAddresses';
+
+/**
+ * Function parseInboundSendgridEmail will parse raw inbound email from Sendgrid and return Email object
+ */
+export async function parseInboundSendgridEmail(rawEmail: string): Promise<InboundEmail> {
+    const parsedEmail = await simpleParser(rawEmail);
+
+    const toArray = !Array.isArray(parsedEmail.to)
+        ? parsedEmail.to === undefined
+            ? []
+            : [parsedEmail.to]
+        : parsedEmail.to;
+    const to = toArray.flatMap((_) => parseEmailAddresses(_.text));
+
+    const ccArray = !Array.isArray(parsedEmail.cc)
+        ? parsedEmail.cc === undefined
+            ? []
+            : [parsedEmail.cc]
+        : parsedEmail.cc;
+    const cc = ccArray.flatMap((_) => parseEmailAddresses(_.text));
+
+    const turndownService = new TurndownService();
+
+    const content = (parsedEmail.html
+        ? turndownService.turndown(extractBodyContentFromHtml(parsedEmail.html))
+        : parsedEmail.text || '') as string_markdown;
+
+    const email: InboundEmail = {
+        channel: 'EMAIL',
+        direction: 'INBOUND',
+        sender: parseEmailAddress(parsedEmail.from?.text || '').fullEmail,
+        recipients: to.map((_) => _.fullEmail),
+        cc,
+        subject: parsedEmail.subject || '',
+        content,
+        attachments: [
+            /* <- TODO: [📯] Parse attachments */
+        ],
+    };
+
+    return email;
+}

package/apps/agents-server/src/utils/content/extractBodyContentFromHtml.ts

@@ -0,0 +1,19 @@
+import type { string_html } from '@promptbook-local/types';
+
+/**
+ * Extract the first heading from HTML
+ *
+ * @param contentText HTML
+ * @returns heading
+ */
+export function extractBodyContentFromHtml(html: string_html): string_html {
+    // Note: Not using DOMParser, because it's overkill for this simple task
+
+    const match = html.match(/<body[^>]*>(?<bodyContent>[\s\S]*)<\/body>/s);
+
+    if (!match) {
+        return html;
+    }
+
+    return match.groups!.bodyContent!;
+}

package/esm/index.es.js

@@ -47,7 +47,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.104.0-5';
+const PROMPTBOOK_ENGINE_VERSION = '0.104.0-6';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -26463,44 +26463,6 @@ async function createAgentModelRequirementsWithCommitments(agentSource, modelNam
     };
 }
 
-/**
- * Generates a gravatar URL based on agent name for fallback avatar
- *
- * @param agentName The agent name to generate avatar for
- * @returns Gravatar URL
- *
- * @private - [🤹] The fact that profile image is Gravatar is just implementation detail which should be hidden for consumer
- */
-function generateGravatarUrl(agentName) {
-    // Use a default name if none provided
-    const safeName = agentName || 'Anonymous Agent';
-    // Create a simple hash from the name for consistent avatar
-    let hash = 0;
-    for (let i = 0; i < safeName.length; i++) {
-        const char = safeName.charCodeAt(i);
-        hash = (hash << 5) - hash + char;
-        hash = hash & hash; // Convert to 32bit integer
-    }
-    const avatarId = Math.abs(hash).toString();
-    return `https://www.gravatar.com/avatar/${avatarId}?default=robohash&size=200&rating=x`;
-}
-
-/**
- * Generates an image for the agent to use as profile image
- *
- * @param agentName The agent name to generate avatar for
- * @returns The placeholder profile image URL for the agent
- *
- * @public exported from `@promptbook/core`
- */
-function generatePlaceholderAgentProfileImageUrl(agentName) {
-    // Note: [🤹] The fact that profile image is Gravatar is just implementation detail which should be hidden for consumer
-    return generateGravatarUrl(agentName);
-}
-/**
- * TODO: [🤹] Figure out best placeholder image generator https://i.pravatar.cc/1000?u=568
- */
-
 /**
  * Computes SHA-256 hash of the agent source
  *
@@ -26598,10 +26560,6 @@ function parseAgentSource(agentSource) {
         const metaType = normalizeTo_camelCase(metaTypeRaw);
         meta[metaType] = spaceTrim$2(commitment.content.substring(metaTypeRaw.length));
     }
-    // Generate gravatar fallback if no meta image specified
-    if (!meta.image) {
-        meta.image = generatePlaceholderAgentProfileImageUrl(parseResult.agentName || '!!');
-    }
     // Generate fullname fallback if no meta fullname specified
     if (!meta.fullname) {
         meta.fullname = parseResult.agentName || createDefaultAgentName(agentSource);