$forbiddenTokens
*/
public function generate(
PromptLandingPageBrief $brief,
?string $previousHtml = null,
?string $revisionNotes = null,
array $forbiddenTokens = [],
): GeneratedLandingPageHtml {
$prompt = $this->buildPrompt($brief, $previousHtml, $revisionNotes, $forbiddenTokens);
$response = agent(
// instructions: 'You write a single conversion-focused promotional landing page from a marketing brief. The page must be fully responsive: it has to look correct on phones, tablets, and desktops. When the brief lists hex colors, the accent color is the theme: use it for buttons, links, header highlights, and CTAs. Use background and text colors for the page/body. Primary and secondary are supporting only. Do not invent a conflicting palette. If a logo is present, redraw it as a simple inline SVG from the logo description — never embed or hotlink uploaded files. Return HTML markup, a complete stylesheet, and JavaScript as separate fields. Do not use external CSS frameworks or markdown. Never embed, hotlink, or reference uploaded user files, local disk paths, storage URLs, or original attachment filenames. Other visuals must be CSS, inline SVG, or generic public placeholder images such as https://placehold.co. Do not invent product catalog URLs that were not in the brief.',
instructions: 'You write a single conversion-focused promotional landing page from a marketing brief. The page must be fully responsive: it has to look correct on phones, tablets, and desktops. The accent color is the theme: use that exact hex for filled buttons, links, header highlights, and CTAs. Use background and text colors for the page/body. Do not invent a dark palette when the background color is light. Primary and secondary are supporting only. Do not invent a conflicting palette. If an exact logo SVG is provided in the brief, embed that markup verbatim as the header logo — do not redraw, simplify, restyle, or alter it in any way, just place it in the markup and size it with CSS. If no exact SVG is provided but a public logo URL is, use that URL as the header ![]()
src — it is the live website\'s public logo or favicon, not an upload. Only redraw a logo as inline SVG from the logo description when neither an exact SVG nor a public logo URL was provided. Never embed uploaded files, local disk paths, storage URLs, or raster data URIs. Return HTML markup, a complete stylesheet, and JavaScript as separate fields. Do not use external CSS frameworks or markdown. Other visuals must be CSS, inline SVG, or generic public placeholder images such as https://placehold.co. Do not invent product catalog URLs that were not in the brief.',
schema: fn (JsonSchema $schema) => [
'title' => $schema->string()->description('The HTML document title.')->required(),
'html' => $schema->string()->description('Page markup only. No style or script tags, no doctype or html/head wrappers.')->required(),
'css' => $schema->string()->description('A complete, non-empty stylesheet for every class and id in the html field. No style tags.')->required(),
'js' => $schema->string()->description('JavaScript for interactive controls. No script tags. Empty string if none.')->required(),
],
)->prompt($prompt, provider: TextProviderFailover::providers(), timeout: 1200);
$data = $response->toArray();
$html = $this->normalizeSnippet((string) ($data['html'] ?? ''), 'html');
$css = $this->normalizeSnippet((string) ($data['css'] ?? ''), 'css');
$js = $this->normalizeSnippet((string) ($data['js'] ?? ''), 'js');
[$html, $css, $js] = $this->extractEmbeddedAssets($html, $css, $js);
$css = $this->enforceThemeCss($css, $brief);
$css = $this->enforceFontCss($css, $brief);
return new GeneratedLandingPageHtml(
title: $data['title'] ?? $brief->offering,
html: $html,
css: $css,
js: $js,
prompt: $prompt,
);
}
/**
* @param list $forbiddenTokens
*/
private function buildPrompt(
PromptLandingPageBrief $brief,
?string $previousHtml,
?string $revisionNotes,
array $forbiddenTokens,
): string {
$briefBlock = sprintf(
"Brand: %s\nOffering: %s\nPurpose: %s\nHeadline: %s\nAudience: %s\nTone: %s\nPricing: %s\nCTA: %s\nFeatures: %s\nBenefits: %s\nUSPs: %s\nPain points: %s\nTheme / accent color: %s\nPrimary color (supporting): %s\nSecondary color (supporting): %s\nBackground color: %s\nText color: %s\nFont family: %s\nFont stylesheet URL: %s\nLogo present: %s\nLogo type: %s\nLogo wordmark text: %s\nLogo description: %s\nLogo URL: %s\nFavicon URL: %s\nNotes: %s",
$brief->brandName,
$brief->offering,
$brief->purpose !== '' ? $brief->purpose : 'none',
$brief->headline,
$brief->audience,
$brief->tone,
$brief->pricing,
$brief->cta,
implode(', ', $brief->features),
implode(', ', $brief->benefits),
implode(', ', $brief->usps),
implode(', ', $brief->painPoints),
$brief->accentColor,
$brief->primaryColor,
$brief->secondaryColor,
$brief->backgroundColor,
$brief->textColor,
$brief->fontFamily !== '' ? $brief->fontFamily : 'none',
$brief->fontStylesheetUrl !== '' ? $brief->fontStylesheetUrl : 'none',
$brief->logoPresent ? 'yes' : 'no',
$brief->logoType,
$brief->logoWordmarkText !== '' ? $brief->logoWordmarkText : 'none',
$brief->logoDescription !== '' ? $brief->logoDescription : 'none',
$brief->logoUrl !== '' ? $brief->logoUrl : 'none',
$brief->faviconUrl !== '' ? $brief->faviconUrl : 'none',
$brief->notes ?? 'none',
);
if ($brief->logoExactSvg !== '') {
$briefBlock .= "\n\nEXACT logo SVG (embed this verbatim in the header, unmodified, sized with CSS only):\n".$brief->logoExactSvg;
}
$forbidden = $forbiddenTokens === []
? 'none'
: implode(', ', $forbiddenTokens);
$website = $brief->brandName !== '' ? $brief->brandName : 'the website';
$rules = $this->sharedPageRules()."\n".$this->conversionRules($brief, $website);
if (filled($previousHtml) && filled($revisionNotes)) {
return << or