@promptbook/cli 0.114.0-0 → 0.114.0-10

package/apps/agents-server/src/app/superadmin/servers/ServersRegistryTable.tsx

@@ -2,10 +2,10 @@
 
 import { Fragment } from 'react';
 import { ArrowRightLeft, Bot, ExternalLink, Loader2, Mail, RefreshCcw, Save } from 'lucide-react';
-import { AgentProjectDnsInstructions } from '../../../components/AgentProjectDnsInstructions/AgentProjectDnsInstructions';
 import { DnsRecordsInstructions } from '../../../components/DnsRecordsInstructions/DnsRecordsInstructions';
 import { useServerLanguage } from '../../../components/ServerLanguage/ServerLanguageProvider';
 import type { ServerLanguageCode } from '../../../languages/ServerLanguageRegistry';
+import { createServerDnsRecordsSections } from '../../../utils/dnsRecords/createServerDnsRecordsSections';
 import { formatServerLanguageHumanReadableDate } from '../../../utils/localization/formatServerLanguageHumanReadableDate';
 import { AdminSortableTableHeaderCell } from '../../admin/_components/AdminSortableTableHeaderCell';
 import { useAdminTableSorting } from '../../admin/_components/adminTableSorting';
@@ -244,6 +244,7 @@ function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
     const hasProjectDnsIssue = projectDomains.some((projectDomain) =>
         isManagedServerDnsDiagnosticIssue(projectDomain.dnsDiagnostic),
     );
+    const generatedProjectDomain = projectDomains.find((projectDomain) => !projectDomain.customDomain)?.domain ?? null;
     const columnCount = isStandaloneVps ? 6 : 8;
 
     return (
@@ -341,10 +342,10 @@ function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
                         <a
                             href={`https://${server.domain}/admin/email-server`}
                             className={`${SECONDARY_BUTTON_CLASS_NAME} px-2 py-1 text-xs`}
-                            title={`MX, SPF, DKIM, and DMARC instructions for ${server.domain}`}
+                            title={`Agent addresses and the generated DKIM zone of ${server.domain}`}
                         >
                             <Mail className="h-3.5 w-3.5" />
-                            Mail DNS
+                            Email server
                         </a>
                         <button
                             type="button"
@@ -388,156 +389,150 @@ function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
                     </div>
                 </td>
             </tr>
-            {isProjectDomainAssigned ? (
-                <tr className="bg-sky-50/50">
-                    <td colSpan={columnCount} className="px-4 py-4">
-                        <ProjectDomainsPanel
-                            projectDomains={projectDomains}
-                            publicIpAddress={dnsDiagnostic?.publicIpAddress}
-                            serverDomain={server.domain}
-                        />
-                    </td>
-                </tr>
-            ) : null}
-            {hasDnsIssue && dnsDiagnostic ? (
-                <tr className="bg-amber-50/70">
-                    <td colSpan={columnCount} className="px-4 py-4">
-                        <DnsRecordsInstructions
-                            description={dnsDiagnostic.summary}
-                            domain={server.domain}
-                            recordSelection="one"
-                            records={dnsDiagnostic.expectedRecords}
-                            providerGuides={dnsDiagnostic.providerGuides}
-                            resolvedAddresses={dnsDiagnostic.resolvedAddresses}
-                            title={
+            <tr className="bg-sky-50/50">
+                <td colSpan={columnCount} className="px-4 py-4">
+                    <ProjectDomainsPanel projectDomains={projectDomains} />
+                </td>
+            </tr>
+            <tr className="bg-amber-50/70">
+                <td colSpan={columnCount} className="px-4 py-4">
+                    <DnsRecordsInstructions
+                        description="Everything this server needs at its DNS provider - its own domain, the generated project domains, and its email. Add all of them at once with the Cloudflare wizard below."
+                        domain={server.domain}
+                        providerGuides={dnsDiagnostic?.providerGuides}
+                        sections={createServerDnsRecordsSections({
+                            serverDomain: server.domain,
+                            dnsDiagnostic,
+                            isProjectDnsIssue: hasProjectDnsIssue,
+                            projectDomain: generatedProjectDomain,
+                        })}
+                        title={
+                            hasDnsIssue || hasProjectDnsIssue ? (
                                 <>
                                     DNS setup needs attention for <span className="font-mono">{server.domain}</span>
                                 </>
-                            }
-                        />
-                    </td>
-                </tr>
-            ) : null}
+                            ) : (
+                                <>
+                                    DNS setup for <span className="font-mono">{server.domain}</span>
+                                </>
+                            )
+                        }
+                    />
+                </td>
+            </tr>
         </>
     );
 }
 
 /**
- * Renders project domains owned by one server.
+ * Renders the project domains assigned to one server.
+ *
+ * Their DNS setup intentionally lives in the one shared DNS manual of the server instead of in this listing.
  */
 function ProjectDomainsPanel({
-    publicIpAddress,
     projectDomains,
-    serverDomain,
 }: {
-    readonly publicIpAddress: string | null | undefined;
     readonly projectDomains: NonNullable<ManagedServerRow['projectDomains']>;
-    readonly serverDomain: string;
 }) {
     const projectDomainSorting = useAdminTableSorting<ProjectDomainRow, ProjectDomainsTableSortField>({
         rows: projectDomains,
         defaultSortBy: 'projectName',
         resolveSortValue: resolveProjectDomainSortValue,
     });
-    const generatedProjectDomain = projectDomains.find((projectDomain) => !projectDomain.customDomain)?.domain ?? null;
-    const hasProjectDnsIssue = projectDomains.some((projectDomain) =>
-        isManagedServerDnsDiagnosticIssue(projectDomain.dnsDiagnostic),
-    );
 
     return (
         <div className="space-y-3 rounded-lg border border-sky-200 bg-sky-50 px-4 py-4 text-sm text-sky-950">
             <p className="font-semibold">Project domains</p>
-            <div className="overflow-x-auto rounded-md border border-sky-100 bg-white">
-                <table className="min-w-full divide-y divide-sky-100 text-xs">
-                    <thead className="bg-sky-50 text-sky-900">
-                        <tr>
-                            <AdminSortableTableHeaderCell
-                                className="px-3 py-2 text-left font-semibold"
-                                label="project"
-                                sortBy="projectName"
-                                activeSortBy={projectDomainSorting.sortBy}
-                                sortOrder={projectDomainSorting.sortOrder}
-                                onSortChange={projectDomainSorting.handleSortChange}
-                            >
-                                Project
-                            </AdminSortableTableHeaderCell>
-                            <AdminSortableTableHeaderCell
-                                className="px-3 py-2 text-left font-semibold"
-                                label="domain"
-                                sortBy="domain"
-                                activeSortBy={projectDomainSorting.sortBy}
-                                sortOrder={projectDomainSorting.sortOrder}
-                                onSortChange={projectDomainSorting.handleSortChange}
-                            >
-                                Domain
-                            </AdminSortableTableHeaderCell>
-                            <AdminSortableTableHeaderCell
-                                className="px-3 py-2 text-left font-semibold"
-                                label="agent"
-                                sortBy="agentPermanentId"
-                                activeSortBy={projectDomainSorting.sortBy}
-                                sortOrder={projectDomainSorting.sortOrder}
-                                onSortChange={projectDomainSorting.handleSortChange}
-                            >
-                                Agent
-                            </AdminSortableTableHeaderCell>
-                        </tr>
-                    </thead>
-                    <tbody className="divide-y divide-sky-100">
-                        {projectDomainSorting.sortedRows.map((projectDomain) => (
-                            <tr key={`${projectDomain.agentPermanentId}-${projectDomain.projectName}`}>
-                                <td className="px-3 py-2">
-                                    <a
-                                        href={projectDomain.projectHref}
-                                        className="font-semibold text-sky-800 hover:text-sky-950 hover:underline"
-                                    >
-                                        {projectDomain.projectName}
-                                    </a>
-                                </td>
-                                <td className="px-3 py-2">
-                                    <a
-                                        href={projectDomain.publicUrl}
-                                        target="_blank"
-                                        rel="noreferrer"
-                                        className="inline-flex items-center gap-1 font-mono text-sky-800 hover:text-sky-950 hover:underline"
-                                    >
-                                        {projectDomain.domain}
-                                        <ExternalLink className="h-3.5 w-3.5" aria-hidden />
-                                    </a>
-                                    {projectDomain.customDomain ? (
-                                        <span className="ml-2 rounded-full border border-emerald-200 bg-emerald-50 px-2 py-0.5 font-sans text-[0.7rem] font-semibold text-emerald-700">
-                                            Custom
-                                        </span>
-                                    ) : null}
-                                    {isManagedServerDnsDiagnosticIssue(projectDomain.dnsDiagnostic) ? (
-                                        <span className="ml-2 rounded-full border border-amber-200 bg-amber-50 px-2 py-0.5 font-sans text-[0.7rem] font-semibold text-amber-700">
-                                            DNS setup needed
-                                        </span>
-                                    ) : null}
-                                </td>
-                                <td className="px-3 py-2">
-                                    <a
-                                        href={projectDomain.agentProjectsHref}
-                                        title="Open agent projects"
-                                        className="inline-flex max-w-full items-center gap-1.5 rounded-full border border-sky-200 bg-sky-50 px-2 py-1 font-sans text-xs font-semibold text-sky-800 hover:border-sky-300 hover:bg-sky-100 hover:text-sky-950"
-                                    >
-                                        <Bot className="h-3.5 w-3.5 shrink-0" aria-hidden />
-                                        <span className="truncate">{projectDomain.agentName || 'Agent'}</span>
-                                    </a>
-                                </td>
+            {projectDomains.length === 0 ? (
+                <p className="text-sky-800">
+                    No project domains are assigned yet. Configure the wildcard record below before the first project is
+                    published.
+                </p>
+            ) : (
+                <div className="overflow-x-auto rounded-md border border-sky-100 bg-white">
+                    <table className="min-w-full divide-y divide-sky-100 text-xs">
+                        <thead className="bg-sky-50 text-sky-900">
+                            <tr>
+                                <AdminSortableTableHeaderCell
+                                    className="px-3 py-2 text-left font-semibold"
+                                    label="project"
+                                    sortBy="projectName"
+                                    activeSortBy={projectDomainSorting.sortBy}
+                                    sortOrder={projectDomainSorting.sortOrder}
+                                    onSortChange={projectDomainSorting.handleSortChange}
+                                >
+                                    Project
+                                </AdminSortableTableHeaderCell>
+                                <AdminSortableTableHeaderCell
+                                    className="px-3 py-2 text-left font-semibold"
+                                    label="domain"
+                                    sortBy="domain"
+                                    activeSortBy={projectDomainSorting.sortBy}
+                                    sortOrder={projectDomainSorting.sortOrder}
+                                    onSortChange={projectDomainSorting.handleSortChange}
+                                >
+                                    Domain
+                                </AdminSortableTableHeaderCell>
+                                <AdminSortableTableHeaderCell
+                                    className="px-3 py-2 text-left font-semibold"
+                                    label="agent"
+                                    sortBy="agentPermanentId"
+                                    activeSortBy={projectDomainSorting.sortBy}
+                                    sortOrder={projectDomainSorting.sortOrder}
+                                    onSortChange={projectDomainSorting.handleSortChange}
+                                >
+                                    Agent
+                                </AdminSortableTableHeaderCell>
                             </tr>
-                        ))}
-                    </tbody>
-                </table>
-            </div>
-            {generatedProjectDomain ? (
-                <AgentProjectDnsInstructions
-                    isDnsIssue={hasProjectDnsIssue}
-                    projectDomain={generatedProjectDomain}
-                    publicIpAddress={publicIpAddress}
-                    serverDomain={serverDomain}
-                />
-            ) : null}
+                        </thead>
+                        <tbody className="divide-y divide-sky-100">
+                            {projectDomainSorting.sortedRows.map((projectDomain) => (
+                                <tr key={`${projectDomain.agentPermanentId}-${projectDomain.projectName}`}>
+                                    <td className="px-3 py-2">
+                                        <a
+                                            href={projectDomain.projectHref}
+                                            className="font-semibold text-sky-800 hover:text-sky-950 hover:underline"
+                                        >
+                                            {projectDomain.projectName}
+                                        </a>
+                                    </td>
+                                    <td className="px-3 py-2">
+                                        <a
+                                            href={projectDomain.publicUrl}
+                                            target="_blank"
+                                            rel="noreferrer"
+                                            className="inline-flex items-center gap-1 font-mono text-sky-800 hover:text-sky-950 hover:underline"
+                                        >
+                                            {projectDomain.domain}
+                                            <ExternalLink className="h-3.5 w-3.5" aria-hidden />
+                                        </a>
+                                        {projectDomain.customDomain ? (
+                                            <span className="ml-2 rounded-full border border-emerald-200 bg-emerald-50 px-2 py-0.5 font-sans text-[0.7rem] font-semibold text-emerald-700">
+                                                Custom
+                                            </span>
+                                        ) : null}
+                                        {isManagedServerDnsDiagnosticIssue(projectDomain.dnsDiagnostic) ? (
+                                            <span className="ml-2 rounded-full border border-amber-200 bg-amber-50 px-2 py-0.5 font-sans text-[0.7rem] font-semibold text-amber-700">
+                                                DNS setup needed
+                                            </span>
+                                        ) : null}
+                                    </td>
+                                    <td className="px-3 py-2">
+                                        <a
+                                            href={projectDomain.agentProjectsHref}
+                                            title="Open agent projects"
+                                            className="inline-flex max-w-full items-center gap-1.5 rounded-full border border-sky-200 bg-sky-50 px-2 py-1 font-sans text-xs font-semibold text-sky-800 hover:border-sky-300 hover:bg-sky-100 hover:text-sky-950"
+                                        >
+                                            <Bot className="h-3.5 w-3.5 shrink-0" aria-hidden />
+                                            <span className="truncate">{projectDomain.agentName || 'Agent'}</span>
+                                        </a>
+                                    </td>
+                                </tr>
+                            ))}
+                        </tbody>
+                    </table>
+                </div>
+            )}
         </div>
     );
 }

package/apps/agents-server/src/app/superadmin/servers/useServersRegistryState.ts

@@ -474,13 +474,21 @@ function useServersRegistryDraftState(servers: ReadonlyArray<ManagedServerRow>)
     }, []);
 
     const updateServerDraft = useCallback<UpdateServerDraft>((serverId, fieldName, value) => {
-        setServerDrafts((previousServerDrafts) => ({
-            ...previousServerDrafts,
-            [serverId]: {
-                ...previousServerDrafts[serverId],
-                [fieldName]: value,
-            },
-        }));
+        setServerDrafts((previousServerDrafts) => {
+            const serverDraft = previousServerDrafts[serverId];
+
+            if (!serverDraft) {
+                return previousServerDrafts;
+            }
+
+            return {
+                ...previousServerDrafts,
+                [serverId]: {
+                    ...serverDraft,
+                    [fieldName]: value,
+                },
+            };
+        });
     }, []);
 
     const isServerDraftDirty = useCallback(

package/apps/agents-server/src/app/system/user-wallet/UserWalletDraft.ts

@@ -56,7 +56,7 @@ type UserWalletRecordRequestPayload = Omit<CreateUserWalletRecordOptions, 'userI
 const USE_EMAIL_SMTP_WALLET_SCHEMA_TEXT = formatWalletJsonSchemaForTextarea(USE_EMAIL_SMTP_WALLET_SECRET_JSON_SCHEMA);
 
 /**
- * Returns true when record identity matches USE EMAIL SMTP credentials.
+ * Returns true when record identity matches the agent email SMTP credentials.
  *
  * @private function of UserWalletClient
  */
@@ -219,7 +219,7 @@ export function clearSensitiveUserWalletDraftFields(draft: UserWalletDraft): Use
 }
 
 /**
- * Applies SMTP defaults to simplify USE EMAIL setup.
+ * Applies SMTP defaults to simplify agent email setup.
  *
  * @private function of UserWalletClient
  */

package/apps/agents-server/src/components/AgentNaming/legacyAgentTextTranslations.cs.yaml

@@ -479,9 +479,16 @@
 "Loading messages…": "Načítám zprávy…"
 "No messages found.": "Nebyly nalezeny žádné zprávy."
 "Sender/Recipients": "Odesílatel/Příjemci"
+"Sender": "Odesílatel"
+"Recipients": "Příjemci"
+"From": "Od"
+"To": "Komu"
 "Content": "Obsah"
 "Pending": "Čeká"
 "Sent": "Odesláno"
+"Received": "Přijato"
+"Failed": "Selhalo"
+"Complete log": "Kompletní log"
 "Error simulation": "Simulace chyb"
 "Unhandled API throw": "Nezachycený pád API"
 "Handled API 500 response": "Zachycená API odpověď 500"

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

@@ -3,13 +3,10 @@ import {
     Book,
     Calendar,
     Code,
-    Clock8Icon,
     ExternalLink,
     FileText,
-    Globe,
     Link,
     MapPin,
-    Search,
     Shield,
     ShieldAlert,
     ShieldQuestionMarkIcon,
@@ -33,11 +30,6 @@ export const HOMEPAGE_CAPABILITY_CHIPS_LIMIT = 3;
  */
 export const AGENT_PROFILE_CAPABILITY_CHIPS_LIMIT = 7;
 
-/**
- * Capability types omitted from homepage agent cards.
- */
-export const AGENT_CARD_HIDDEN_CAPABILITY_TYPES: ReadonlyArray<AgentCapability['type']> = ['time'];
-
 /**
  * Constant for max individual knowledge chips.
  */
@@ -49,19 +41,7 @@ const MAX_INDIVIDUAL_KNOWLEDGE_CHIPS = 2;
 const CAPABILITY_PRIORITY_BUCKETS: ReadonlyArray<ReadonlyArray<AgentCapability['type']>> = [
     ['team'],
     ['inheritance', 'import'],
-    [
-        'browser',
-        'search-engine',
-        'timeout',
-        'time',
-        'user-location',
-        'image-generator',
-        'email',
-        'privacy',
-        'project',
-        'calendar',
-        'wallet',
-    ],
+    ['user-location', 'image-generator', 'privacy', 'project', 'calendar'],
     ['knowledge'],
 ];
 
@@ -188,11 +168,8 @@ export function AgentCapabilityChips({
 
                 const Icon =
                     {
-                        Globe,
-                        Search,
                         Book,
                         FileText,
-                        Clock: Clock8Icon,
                         SquareArrowOutUpRight,
                         SquareArrowUpRight,
                         ShieldAlert,

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

@@ -1,4 +1,6 @@
 'use client';
+import { spaceTrim } from 'spacetrim';
+
 
 import { colorToDataUrl } from '@promptbook-local/color';
 import { AgentBasicInformation, string_agent_permanent_id, string_url } from '@promptbook-local/types';
@@ -104,6 +106,13 @@ export function AgentProfile(props: AgentProfileProps) {
     // Dynamic Font Loading
     const fontString = meta.font;
     const primaryFontFamily = fontString ? (fontString.split(',')[0] || '').trim().replace(/['"]/g, '') : '';
+    const PRIMARY_FONT_IMPORT_STYLES = primaryFontFamily
+        ? spaceTrim(
+              (block) => `
+                  @import url('https://fonts.googleapis.com/css2?family=${block(encodeURIComponent(primaryFontFamily))}:wght@400;600;700&display=swap');
+              `,
+          )
+        : '';
     let fontStyle: React.CSSProperties = {};
 
     if (fontString) {
@@ -120,9 +129,7 @@ export function AgentProfile(props: AgentProfileProps) {
     return (
         <>
             {primaryFontFamily && (
-                <style jsx global>{`
-                    @import url('https://fonts.googleapis.com/css2?family=${encodeURIComponent(primaryFontFamily)}:wght@400;600;700&display=swap');
-                `}</style>
+                <style jsx global>{PRIMARY_FONT_IMPORT_STYLES}</style>
             )}
 
             {/* Full-screen background with agent color */}

package/apps/agents-server/src/components/AgentProjects/AgentProjectIcon.tsx

@@ -0,0 +1,137 @@
+'use client';
+
+import { useEffect, useRef, useState } from 'react';
+import type { AgentProjectReferenceInfo } from '../../utils/agentProjects/AgentProjectReferenceInfo';
+import { buildAgentProjectFileHrefForServer } from '../../utils/agentProjects/agentProjectHrefs';
+import { createAgentProjectInitials } from '../../utils/agentProjects/createAgentProjectInitials';
+
+/**
+ * Sizes at which one project icon is shown.
+ */
+export type AgentProjectIconSize = 'small' | 'card' | 'header';
+
+/**
+ * Project fields required to render the icon of one project.
+ */
+export type AgentProjectIconInfo = Pick<AgentProjectReferenceInfo, 'projectName' | 'faviconRelativePath'>;
+
+/**
+ * Classes of the icon container, of the favicon and of the initials per icon size.
+ */
+const AGENT_PROJECT_ICON_CLASS_NAMES_BY_SIZE: Record<
+    AgentProjectIconSize,
+    {
+        /**
+         * Classes of the icon container.
+         */
+        readonly container: string;
+
+        /**
+         * Classes of the rendered favicon.
+         */
+        readonly favicon: string;
+
+        /**
+         * Classes of the rendered initials.
+         */
+        readonly initials: string;
+    }
+> = {
+    small: { container: 'h-5 w-5 rounded-md', favicon: 'p-0.5', initials: 'text-[0.5rem] tracking-tight' },
+    card: { container: 'h-11 w-11 rounded-lg', favicon: 'p-1.5', initials: 'text-sm' },
+    header: { container: 'h-9 w-9 rounded-lg', favicon: 'p-1', initials: 'text-xs' },
+};
+
+/**
+ * Props for one project icon.
+ */
+type AgentProjectIconProps = {
+    /**
+     * Permanent id of the agent owning the project.
+     */
+    readonly agentPermanentId: string;
+
+    /**
+     * Project the icon belongs to.
+     */
+    readonly project: AgentProjectIconInfo;
+
+    /**
+     * Public domain of the server owning the project, when known.
+     */
+    readonly serverDomain?: string | null;
+
+    /**
+     * Public domain serving the current page, when known.
+     */
+    readonly currentServerDomain?: string | null;
+
+    /**
+     * Size at which the icon is shown.
+     */
+    readonly size: AgentProjectIconSize;
+
+    /**
+     * Optional CSS class overrides.
+     */
+    readonly className?: string;
+};
+
+/**
+ * Renders the visual identity of one project — its favicon, or its initials as the fallback.
+ *
+ * The favicon is served from the project folder, which requires a signed-in visitor, so the
+ * initials are shown whenever the favicon is missing or cannot be loaded.
+ *
+ * @private component of Agent Projects dashboards
+ */
+export function AgentProjectIcon({
+    agentPermanentId,
+    project,
+    serverDomain = null,
+    currentServerDomain = null,
+    size,
+    className = '',
+}: AgentProjectIconProps) {
+    const [isFaviconBroken, setIsFaviconBroken] = useState(false);
+    const faviconImageRef = useRef<HTMLImageElement | null>(null);
+    const iconClassNames = AGENT_PROJECT_ICON_CLASS_NAMES_BY_SIZE[size];
+    const faviconHref = !project.faviconRelativePath
+        ? null
+        : buildAgentProjectFileHrefForServer({
+              agentPermanentId,
+              projectName: project.projectName,
+              fileRelativePath: project.faviconRelativePath,
+              serverDomain,
+              currentServerDomain,
+          });
+
+    useEffect(() => {
+        // Note: A favicon rendered on the server can already fail before this component is hydrated,
+        //       which loses its `error` event — an image which finished loading with no pixels is broken.
+        const faviconImage = faviconImageRef.current;
+        setIsFaviconBroken(faviconImage?.complete === true && faviconImage.naturalWidth === 0);
+    }, [faviconHref]);
+
+    return (
+        <span
+            className={`flex shrink-0 items-center justify-center overflow-hidden border border-blue-100 bg-blue-50 text-blue-700 ${iconClassNames.container} ${className}`}
+            aria-hidden
+        >
+            {faviconHref !== null && !isFaviconBroken ? (
+                // eslint-disable-next-line @next/next/no-img-element
+                <img
+                    ref={faviconImageRef}
+                    src={faviconHref}
+                    alt=""
+                    className={`h-full w-full object-contain ${iconClassNames.favicon}`}
+                    onError={() => setIsFaviconBroken(true)}
+                />
+            ) : (
+                <span className={`font-bold leading-none ${iconClassNames.initials}`}>
+                    {createAgentProjectInitials(project.projectName)}
+                </span>
+            )}
+        </span>
+    );
+}