@tomako/tools-runtime 0.1.5 → 0.1.6

package/src/features/tools/product-poster-generator/widget/helpers.test.ts

@@ -0,0 +1,51 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { fetchProductPosterPng } from "./helpers";
+
+test("fetchProductPosterPng fetches through the image proxy and returns a .png download", async () => {
+  let requestedUrl = "";
+  let requestedInit: RequestInit | undefined;
+  const fetcher = async (input: RequestInfo | URL, init?: RequestInit) => {
+    requestedUrl = String(input);
+    requestedInit = init;
+    return new Response(new Uint8Array([137, 80, 78, 71]), {
+      status: 200,
+      headers: { "content-type": "image/png" },
+    });
+  };
+
+  const file = await fetchProductPosterPng(
+    "https://cdn.example.com/generated/poster.png",
+    "example-product",
+    fetcher,
+  );
+
+  assert.equal(
+    requestedUrl,
+    "/tools-api/image-download?url=https%3A%2F%2Fcdn.example.com%2Fgenerated%2Fposter.png",
+  );
+  assert.equal(requestedInit?.cache, "no-store");
+  assert.equal(file.fileName, "example-product-poster.png");
+  assert.equal(file.blob.type, "image/png");
+  assert.equal(file.blob.size, 4);
+});
+
+test("fetchProductPosterPng rejects failed or non-PNG responses", async () => {
+  await assert.rejects(
+    fetchProductPosterPng("https://cdn.example.com/poster.png", "poster", async () =>
+      new Response(null, { status: 502 }),
+    ),
+    /Poster download failed: 502/,
+  );
+
+  await assert.rejects(
+    fetchProductPosterPng("https://cdn.example.com/poster.webp", "poster", async () =>
+      new Response(new Uint8Array([1]), {
+        status: 200,
+        headers: { "content-type": "image/webp" },
+      }),
+    ),
+    /Poster download returned image\/webp/,
+  );
+});

package/src/features/tools/product-poster-generator/widget/helpers.ts

@@ -5,6 +5,7 @@ import type {
     ProductPosterGeneratorInput,
     ProductPosterScene,
 } from "../../../../lib/tools/product-poster-generator-schema";
+import { imageDownloadUrl } from "../../../../lib/tools/image-download";
 
 import { BRAND_COLOR_PRESETS, POSTER_INTENT_OPTIONS } from "./constants";
 import type {
@@ -65,6 +66,32 @@ export function slugifyFileName(value: string) {
   );
 }
 
+export async function fetchProductPosterPng(
+  imageUrl: string,
+  fileBaseName: string,
+  fetcher: typeof fetch = fetch,
+) {
+  const response = await fetcher(imageDownloadUrl(imageUrl), { cache: "no-store" });
+  if (!response.ok) {
+    throw new Error(`Poster download failed: ${response.status}`);
+  }
+
+  const contentType = response.headers.get("content-type")?.toLowerCase() ?? "";
+  if (!contentType.startsWith("image/png")) {
+    throw new Error(`Poster download returned ${contentType || "an unknown content type"}`);
+  }
+
+  const blob = await response.blob();
+  if (blob.size === 0) {
+    throw new Error("Poster download returned an empty PNG");
+  }
+
+  return {
+    blob,
+    fileName: `${fileBaseName}-poster.png`,
+  };
+}
+
 export function sizeToDimensions(size: string) {
   const [width, height] = size.split("x").map((part) => Number(part));
   return {

package/src/features/tools/product-poster-generator/widget/product-poster-generator.tsx

@@ -3,6 +3,7 @@
 import { ChevronDown, FileImage } from "lucide-react";
 import {
     useMemo,
+    useEffect,
     useRef,
     useState,
     type ChangeEvent,
@@ -22,8 +23,10 @@ import {
     PRODUCT_POSTER_STYLES,
     productPosterGeneratorInputSchema,
     type ProductPosterFormat,
+    type ProductPosterGeneratorInput,
     type ProductPosterStyle,
 } from "../../../../lib/tools/product-poster-generator-schema";
+import { downloadBlob } from "../../../../lib/file/download";
 import { cn } from "@tomako/ui/cn";
 import {
     fetchProductPosterGenerationTask,
@@ -50,6 +53,11 @@ import {
     toolTextareaClass,
     type ToolLoadingStep,
 } from "../../../../components/tools/workspace";
+import {
+    clearToolTaskRecovery,
+    persistToolTaskRecovery,
+    readToolTaskRecovery,
+} from "../../../../components/tools/engine/task-recovery";
 import {
     MAX_TASK_POLL_ATTEMPTS,
     POSTER_FORMAT_OPTIONS,
@@ -70,6 +78,7 @@ import {
     getPosterIntentId,
     getPosterResultError,
     getSafeErrorMessage,
+    fetchProductPosterPng,
     loadingProgress,
     loadingStepIndex,
     readImageAsDataUrl,
@@ -86,6 +95,13 @@ import type {
     ResultState,
 } from "./types";
 
+const RECOVERY_SLUG = "product-poster-generator";
+
+type PosterTaskRecoveryInput = {
+  input: ProductPosterGeneratorInput;
+  settingsSummary: string;
+};
+
 export function ProductPosterGenerator() {
   const locale = useLocale();
   const taskLocale = locale as AppLocale;
@@ -99,6 +115,8 @@ export function ProductPosterGenerator() {
   const [fieldErrors, setFieldErrors] = useState<FieldErrors>({});
   const [formError, setFormError] = useState<string | null>(null);
   const [advancedOpen, setAdvancedOpen] = useState(false);
+  const [downloading, setDownloading] = useState(false);
+  const [downloadError, setDownloadError] = useState<string | null>(null);
 
   const formatLabels = t.raw("formatLabels") as Record<ProductPosterFormat, string>;
   const styleLabels = t.raw("styleLabels") as Record<ProductPosterStyle, string>;
@@ -158,6 +176,39 @@ export function ProductPosterGenerator() {
 
   const busy = result.phase === "submitting" || result.phase === "polling";
 
+  useEffect(() => {
+    const recovered = readToolTaskRecovery<PosterTaskRecoveryInput>(RECOVERY_SLUG, {
+      parseInput: (value) => {
+        if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+        const candidate = value as Partial<PosterTaskRecoveryInput>;
+        const parsed = productPosterGeneratorInputSchema.safeParse(candidate.input);
+        if (!parsed.success || typeof candidate.settingsSummary !== "string") return null;
+        return { input: parsed.data, settingsSummary: candidate.settingsSummary };
+      },
+    });
+    if (!recovered) return;
+    const generationId = generationSeqRef.current + 1;
+    generationSeqRef.current = generationId;
+    setForm({
+      ...defaultForm,
+      ...recovered.input.input,
+      screenshotNames: [],
+      screenshotDataUrls: [],
+      logoName: undefined,
+      logoDataUrl: undefined,
+    });
+    void watchPosterTask(
+      recovered.taskId,
+      recovered.input.input,
+      recovered.input.settingsSummary,
+      generationId,
+      recovered.startedAtMs,
+      "RESTORING",
+    );
+    // Restore only once for this mounted tool route.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
   function scrollToResult() {
     window.requestAnimationFrame(() => {
       resultRef.current?.scrollIntoView({ behavior: "smooth", block: "center" });
@@ -289,6 +340,7 @@ export function ProductPosterGenerator() {
     }
 
     setFormError(null);
+    setDownloadError(null);
     setFieldErrors({});
     const generationId = generationSeqRef.current + 1;
     generationSeqRef.current = generationId;
@@ -320,9 +372,39 @@ export function ProductPosterGenerator() {
     if (generationSeqRef.current !== generationId) return;
 
     const taskId = submitted.taskId;
-    setResult({ phase: "polling", taskId, status: submitted.status });
+    const startedAtMs = Date.now();
+    persistToolTaskRecovery<PosterTaskRecoveryInput>(
+      RECOVERY_SLUG,
+      taskId,
+      { input: posterInput, settingsSummary: posterSettingsSummary },
+      startedAtMs,
+    );
+    await watchPosterTask(
+      taskId,
+      posterInput,
+      posterSettingsSummary,
+      generationId,
+      startedAtMs,
+      submitted.status,
+    );
+  }
 
-    for (let attempt = 0; attempt < MAX_TASK_POLL_ATTEMPTS; attempt += 1) {
+  async function watchPosterTask(
+    taskId: string,
+    posterInput: ProductPosterGeneratorInput,
+    posterSettingsSummary: string,
+    generationId: number,
+    startedAtMs: number,
+    initialStatus: string,
+  ) {
+    setResult({ phase: "polling", taskId, status: initialStatus });
+    const elapsedAttempts = Math.max(
+      0,
+      Math.floor((Date.now() - startedAtMs) / TASK_POLL_INTERVAL_MS),
+    );
+    const remainingAttempts = Math.max(1, MAX_TASK_POLL_ATTEMPTS - elapsedAttempts);
+
+    for (let attempt = 0; attempt < remainingAttempts; attempt += 1) {
       try {
         const task = await fetchProductPosterGenerationTask(taskId);
         if (generationSeqRef.current !== generationId) return;
@@ -376,24 +458,40 @@ export function ProductPosterGenerator() {
     }
   }
 
-  function downloadPosterPng() {
-    if (result.phase !== "ready") return;
-    const link = document.createElement("a");
-    link.href = result.data.imageUrl;
-    link.download = `${result.data.fileBaseName}-poster.webp`;
-    link.target = "_blank";
-    link.rel = "noreferrer";
-    link.click();
+  async function downloadPosterPng() {
+    if (result.phase !== "ready" || downloading) return;
+    const generationId = generationSeqRef.current;
+    setDownloading(true);
+    setDownloadError(null);
+    try {
+      const file = await fetchProductPosterPng(
+        result.data.imageUrl,
+        result.data.fileBaseName,
+      );
+      if (generationSeqRef.current !== generationId) return;
+      downloadBlob(file.blob, file.fileName);
+    } catch {
+      if (generationSeqRef.current === generationId) {
+        setDownloadError(t("errors.downloadFailed"));
+      }
+    } finally {
+      if (generationSeqRef.current === generationId) {
+        setDownloading(false);
+      }
+    }
   }
 
   function reset() {
     generationSeqRef.current += 1;
+    clearToolTaskRecovery(RECOVERY_SLUG);
     if (logoInputRef.current) logoInputRef.current.value = "";
     if (screenshotInputRef.current) screenshotInputRef.current.value = "";
     setForm(defaultForm);
     setResult({ phase: "idle" });
     setFieldErrors({});
     setFormError(null);
+    setDownloadError(null);
+    setDownloading(false);
     setAdvancedOpen(false);
   }
 
@@ -599,14 +697,16 @@ export function ProductPosterGenerator() {
               body={result.data.summary ?? t("readyHint")}
               actions={
                 <ToolResultActions
-                  downloadLabel={t("downloadPng")}
+                  downloadLabel={downloading ? t("loadingSteps.finish") : t("downloadPng")}
                   resetLabel={t("reset")}
-                  onDownload={downloadPosterPng}
+                  onDownload={() => void downloadPosterPng()}
                   onReset={reset}
                 />
               }
             />
 
+            {downloadError ? <ToolErrorBanner>{downloadError}</ToolErrorBanner> : null}
+
             <figure className="flex min-h-[28rem] items-center justify-center overflow-hidden rounded-[1.25rem] border border-[#E4E9F1] bg-white p-3">
               {/* eslint-disable-next-line @next/next/no-img-element */}
               <img

package/src/features/tools/slogan-generator/slogan-generator.package.ts

@@ -6,7 +6,7 @@ import type { ToolPackage } from "../package/types";
  * Slogan Generator（direct 车道）。
  * 证据：docs/seo-keyword-briefs/slogan-generator.md（slogan generator 12,100/mo LOW + 竞品拆解）。
  * 反超点（相对 logo.com / ahrefs / shopify / copy.ai / grammarly）：
- * 免登录页面内直出；每条候选带风格标签 + why-it-works 理由（ahrefs 只有裸文本）；
+ * 登录后在页面内直出；每条候选带风格标签 + why-it-works 理由（ahrefs 只有裸文本）；
  * 一次 10 条覆盖多风格；输出附挑选/测试建议；支持可选品牌名生成 name-based slogan。
  * scene "slogan_generator" 需在 168 compose 的 LLM_DIRECT_ALLOWED_SCENES 白名单内。
  */
@@ -41,12 +41,12 @@ export const sloganGeneratorPackage: ToolPackage = {
     },
   },
   copy: {
-    title: { en: "Slogan Generator", zh: "Slogan 广告语生成器", "zh-tw": "Slogan 廣告語生成器" },
+    title: { en: "AI Slogan Generator for Business", zh: "AI Slogan 广告语生成器", "zh-tw": "AI Slogan 廣告語產生器" },
     description: {
-      en: "Free AI slogan generator: describe your business and get 10 catchy slogan and tagline ideas across styles from bold and minimal to playful and benefit-driven — each with a style tag and a why-it-works note. No sign-up, results on this page.",
-      zh: "免费 AI Slogan 生成器：描述你的业务，一次获得 10 条广告语和 tagline 候选，覆盖大胆、极简、俏皮、利益导向等多种风格，每条附风格标签和入选理由。免注册，结果直接在本页给出。",
+      en: "Describe your business and get 10 AI slogan and tagline ideas across distinct styles, each with a why-it-works note. Sign in to generate and compare the full set.",
+      zh: "描述你的业务，一次生成 10 条 Slogan 和 tagline 候选，覆盖大胆、极简、俏皮、利益导向等多种风格，每条附风格标签和入选理由。登录后可在本页生成并比较完整结果。",
       "zh-tw":
-        "免費 AI Slogan 生成器：描述你的業務，一次獲得 10 條廣告語和 tagline 候選，覆蓋大膽、極簡、俏皮、利益導向等多種風格，每條附風格標籤和入選理由。免註冊，結果直接在本頁給出。",
+        "描述你的業務，一次產生 10 條 Slogan 和 tagline 候選，涵蓋大膽、極簡、俏皮、利益導向等多種風格，每條附風格標籤和入選理由。登入後可在本頁產生並比較完整結果。",
     },
     intro: {
       en: "A good slogan is 3-6 words that carry your brand promise. Instead of staring at a blank page or paying an agency, describe what you do and compare structured candidates side by side — with reasons, not just word salad.",
@@ -60,9 +60,9 @@ export const sloganGeneratorPackage: ToolPackage = {
       "zh-tw": "品牌工具",
     },
     keywords: {
-      en: ["slogan generator", "slogan creator", "slogan maker", "free slogan generator", "ai slogan generator", "tagline generator", "business slogan generator"],
-      zh: ["slogan 生成器", "slogan 制作", "广告语生成器", "品牌口号生成", "tagline 生成器", "免费广告语工具", "AI 广告语"],
-      "zh-tw": ["slogan 生成器", "slogan 製作", "廣告語生成器", "品牌口號生成", "tagline 生成器", "免費廣告語工具", "AI 廣告語"],
+      en: ["slogan generator", "slogan creator", "slogan maker", "ai slogan generator", "tagline generator", "business slogan generator"],
+      zh: ["slogan 生成器", "slogan 制作", "广告语生成器", "品牌口号生成", "tagline 生成器", "AI 广告语"],
+      "zh-tw": ["slogan 產生器", "slogan 製作", "廣告語產生器", "品牌口號產生", "tagline 產生器", "AI 廣告語"],
     },
     inputSignal: {
       en: "One-sentence business description + optional brand name",
@@ -214,13 +214,13 @@ Quality requirements:
       zh: "一句说清业务就够了。品牌名、目标人群和风格方向会让候选更贴合。",
       "zh-tw": "一句說清業務就夠了。品牌名、目標人群和風格方向會讓候選更貼合。",
     },
-    submitLabel: { en: "Generate 10 slogans", zh: "生成 10 条 Slogan", "zh-tw": "生成 10 條 Slogan" },
+    submitLabel: { en: "Generate 10 slogans", zh: "生成 10 条 Slogan", "zh-tw": "產生 10 條 Slogan" },
     resultTitle: { en: "Compare your candidates", zh: "横向比较候选", "zh-tw": "橫向比較候選" },
-    pendingTitle: { en: "Writing your slogans", zh: "正在生成 Slogan", "zh-tw": "正在生成 Slogan" },
+    pendingTitle: { en: "Writing your slogans", zh: "正在生成 Slogan", "zh-tw": "正在產生 Slogan" },
     pendingHint: {
       en: "Usually takes 15-30 seconds. Candidates across multiple styles are being written and annotated.",
       zh: "通常需要 15-30 秒。正在生成多风格候选并为每条写入选理由。",
-      "zh-tw": "通常需要 15-30 秒。正在生成多風格候選並為每條寫入選理由。",
+      "zh-tw": "通常需要 15-30 秒。正在產生多風格候選，並為每條寫入入選理由。",
     },
     errorOverrides: {
       validation: {
@@ -236,16 +236,16 @@ Quality requirements:
   page: {
     workspace: {
       heading: {
-        en: "Get 10 slogan candidates worth comparing",
-        zh: "一次拿到 10 条值得比较的 Slogan",
-        "zh-tw": "一次拿到 10 條值得比較的 Slogan",
+        en: "AI slogan generator: 10 ideas worth comparing",
+        zh: "AI Slogan 生成器：一次拿到 10 条值得比较的候选",
+        "zh-tw": "AI Slogan 產生器：一次取得 10 條值得比較的候選",
       },
       hint: {
         en: "Describe the business in one or two sentences, optionally add the brand name and audience. You get 10 candidates across multiple styles, each with a style tag and a note on why the line works — ready to shortlist, test, and refine.",
         zh: "用一两句话描述业务，可选填品牌名和目标人群。你会得到覆盖多种风格的 10 条候选，每条带风格标签和入选理由——直接进入筛选、测试和打磨。",
         "zh-tw": "用一兩句話描述業務，可選填品牌名和目標人群。你會得到覆蓋多種風格的 10 條候選，每條帶風格標籤和入選理由——直接進入篩選、測試和打磨。",
       },
-      badge: { en: "Free, no sign-up", zh: "免费免注册", "zh-tw": "免費免註冊" },
+      badge: { en: "Sign in to generate", zh: "登录后生成", "zh-tw": "登入後產生" },
     },
     standard: {
       benefits: {
@@ -541,17 +541,17 @@ Quality requirements:
       {
         kind: "cards",
         heading: {
-          en: "Why this beats the usual free slogan tools",
-          zh: "为什么比常见的免费 slogan 工具好用",
-          "zh-tw": "為什麼比常見的免費 slogan 工具好用",
+          en: "Why this beats basic slogan lists",
+          zh: "为什么比常见的 slogan 列表更好用",
+          "zh-tw": "為什麼比常見的 slogan 清單更好用",
         },
         items: [
           {
-            title: { en: "Results on this page, no account", zh: "本页直出，无需注册", "zh-tw": "本頁直出，無需註冊" },
+            title: { en: "Full results on this page", zh: "完整结果在本页展示", "zh-tw": "完整結果在本頁顯示" },
             body: {
-              en: "Slogan creators from Shopify, Copy.ai, and Grammarly route you into a sign-up or product funnel before the full result. Here the complete list renders right below the form.",
-              zh: "Shopify、Copy.ai、Grammarly 的 slogan 工具在给出完整结果前会把你引进注册或产品漏斗。这里的完整候选就渲染在表单下方。",
-              "zh-tw": "Shopify、Copy.ai、Grammarly 的 slogan 工具在給出完整結果前會把你引進註冊或產品漏斗。這裡的完整候選就渲染在表單下方。",
+              en: "After you sign in once, the complete candidate set renders directly below the form instead of sending you to a separate editor or workflow.",
+              zh: "登录后，完整候选会直接显示在表单下方，不会再把你带到另一个编辑器或流程。",
+              "zh-tw": "登入後，完整候選會直接顯示在表單下方，不會再把你帶到另一個編輯器或流程。",
             },
           },
           {
@@ -677,14 +677,14 @@ Quality requirements:
       },
       {
         question: {
-          en: "Is this slogan generator really free?",
-          zh: "这个 slogan 生成器真的免费吗？",
-          "zh-tw": "這個 slogan 生成器真的免費嗎？",
+          en: "Do I need an account to generate slogans?",
+          zh: "生成 Slogan 需要登录吗？",
+          "zh-tw": "產生 Slogan 需要登入嗎？",
         },
         answer: {
-          en: "Yes — no account, no credit card, and the full result renders on this page. Heavy usage is rate-limited per minute to keep the tool fast for everyone.",
-          zh: "免费——不需要账号和信用卡，完整结果就在本页显示。为了保证所有人的速度，每分钟的生成次数有上限。",
-          "zh-tw": "免費——不需要帳號和信用卡，完整結果就在本頁顯示。為了保證所有人的速度，每分鐘的生成次數有上限。",
+          en: "Yes. Sign in before generation so the model request can run securely. After sign-in, the complete candidate set and its review notes render on this page.",
+          zh: "需要。生成前请先登录，以便安全运行模型请求；登录后，完整候选和复核说明会直接显示在本页。",
+          "zh-tw": "需要。產生前請先登入，以便安全執行模型請求；登入後，完整候選與複核說明會直接顯示在本頁。",
         },
       },
     ],

package/src/i18n/messages/en/tools/app-icon-resizer.ts

@@ -21,7 +21,7 @@ const appIconResizer = {
   guide: {
     heroVisualAlt:
       "App icon asset package visual showing one source icon exported into store submission, Xcode, and Android launcher files.",
-    workspaceHeading: "App icon package generator",
+    workspaceHeading: "App Icon Resizer and Asset Package",
     workspaceHint:
       "One source, one local ZIP for store and engineering handoff.",
     workspaceBadge: "PNG + ZIP",

package/src/i18n/messages/en/tools/app-store-screenshot-generator.ts

@@ -18,7 +18,7 @@ const appStoreScreenshotGenerator = {
       "Hero visual for an app store listing image generator, showing a complete app store screenshot set.",
     workspaceHeading: "App Store Screenshot Generator",
     workspaceHint:
-      "Upload real UI screenshots. A cloud Agent uses Skills-OL to fetch supporting context, plan the complete set, and submit live image tasks.",
+      "Upload real UI screenshots. An online image generation workflow reads supporting context, plans the complete set, and submits live image tasks.",
     whatYouGetHeading: "What you get after generation",
     valueVisualAlt:
       "App store listing image export bundle with phone screenshots, a feature graphic, PNG files, and SVG files.",
@@ -78,7 +78,7 @@ const appStoreScreenshotGenerator = {
     supportBody: [
       "You must upload local UI screenshots. Product URL, App Store or Google Play links, product name, and selling points provide supporting context for title, description, and page-summary clues.",
       "Apple App Store and Google Play directions are supported, including complete screenshot sets, portrait screenshots, and feature graphics.",
-      "This version uses a cloud Agent and Skills-OL to submit live image tasks, but it does not connect to App Store Connect or Google Play Console.",
+      "This version uses an online image generation workflow to submit live image tasks, but it does not connect to App Store Connect or Google Play Console.",
       "If a screenshot includes test accounts, real users, private data, or unauthorized brands, redact it before use.",
       "If no result appears, check that the URL is not empty, the uploaded file is PNG/JPG/WebP, browser file reading is allowed, and the selected input source matches your data.",
       "Before real submission, review the latest platform dimensions, review policies, trademark or copyright permissions, privacy content, copy claims, and readability on target devices.",

package/src/i18n/messages/en/tools/cold-start-channel-selector.ts

@@ -1,8 +1,8 @@
 const coldStartChannelSelector = {
   meta: {
-    title: "Growth Channel Strategy Generator",
-    description: "Build an early-product growth channel strategy. Add your product, audience, time, and budget to choose the first test and the signal that guides the next step.",
-    intro: "Choose the first growth channel to test, then use real signals to decide what comes next.",
+    title: "Customer Acquisition Channel Selector",
+    description: "Choose customer acquisition channels to test first. Add your product, audience, time, and budget to get ranked options, first actions, and validation signals.",
+    intro: "Choose the first customer acquisition channel to test, then use real signals to decide what comes next.",
     category: "Growth strategy tools",
     keywords: [
       "customer acquisition channels",
@@ -33,7 +33,7 @@ const coldStartChannelSelector = {
     },
   ],
   guide: {
-    workspaceTitle: "Growth Channel Strategy",
+    workspaceTitle: "Choose the First Customer Acquisition Channels to Test",
     workspaceHint:
       "Add your product, customer, time, and budget. Get a growth channel strategy to test, why it fits, and the signal that tells you what to do next.",
     workspaceBadge: "Early-stage growth channel strategy",

package/src/i18n/messages/en/tools/competitor-analysis.ts

@@ -37,10 +37,10 @@ const competitorAnalysis = {
     running: "Researching…",
     emptyTitle: "The competitor profile will appear here",
     emptyHint:
-      "Enter a competitor URL and a cloud agent researches public signals into a structured profile.",
+      "Enter a competitor URL and an online research workflow turns public signals into a structured profile.",
     runningTitle: "Researching this competitor",
     runningHint:
-      "The agent is reading the site and searching public signals for traffic, scale, team, and funding. This usually takes 1-3 minutes.",
+      "The research workflow is reading the site and searching public signals for traffic, scale, team, and funding. This usually takes 1-3 minutes.",
     status: {
       default: "Researching",
       PENDING: "Queued",
@@ -130,20 +130,21 @@ const competitorAnalysis = {
     workspaceHint: "Enter a public competitor URL to build a sourced profile with confidence and unknowns shown for every major finding.",
     workspaceBadge: "Public sources only",
     visualAlt: {
-      hero: "Competitor profile report preview (visual pending)",
-      howToUse: "Competitor analysis workflow illustration (visual pending)",
-      result: "Competitor profile result guidance illustration (visual pending)",
+      hero: "Competitor profile report with sourced findings and confidence levels.",
+      howToUse: "Workflow from a public competitor URL to a sourced competitor profile.",
+      result: "Competitor findings separated into evidence, estimates, confidence, and unknowns.",
+      useCases: "Teams applying competitor research to positioning, pricing, and launch decisions.",
     },
     howToUseKicker: "How it works",
     howToUse: "How to analyze a competitor",
     howToUseSteps: [
       "Paste the competitor's public website URL; optionally add a name and the dimensions you care about.",
-      "A cloud agent reads the site and searches public signals for traffic, scale, team, and funding.",
+      "An online research workflow reads the site and searches public signals for traffic, scale, team, and funding.",
       "Results come back as a structured profile — each dimension shows confidence and degrades instead of inventing data.",
       "Start with the overview and traffic trend, then turn “Positioning & openings” into your own positioning, pricing, or channel hypotheses.",
     ],
     runtimeNote:
-      "Research runs on a cloud agent using public web and search only. The page renders the structured result only — no local template fallback.",
+      "Research runs through an online workflow using public web and search only. The page renders the structured result only — no local template fallback.",
     resultKicker: "Result guidance",
     resultGuidance: "How to read the profile",
     guidanceBullets: [
@@ -177,7 +178,7 @@ const competitorAnalysis = {
       {
         question: "Does it access private or logged-in pages?",
         answer:
-          "No. The agent reads public pages and public search results only — it does not crawl private, authenticated, or paywalled content.",
+          "No. The research workflow reads public pages and public search results only — it does not crawl private, authenticated, or paywalled content.",
       },
       {
         question: "What should I do with the result?",

package/src/i18n/messages/en/tools/email-template-generator.ts

@@ -18,7 +18,7 @@ const emailTemplateGenerator = {
     heroImageAlt: "Visual of a rough email brief becoming MJML, HTML, plain text, variables, and an export bundle.",
     workspaceHeading: "MJML Email Template Generator",
     workspaceHint:
-      "Describe the email goal, audience, scenario, and brand tone. The Agent returns a structured MJML-first package you can preview, revise, copy, or export.",
+      "Describe the email goal, audience, scenario, and brand tone. The generation workflow returns a structured MJML-first package you can preview, revise, copy, or export.",
     workspaceBadge: "MJML package",
     outputs: "What You Get",
     outputsIntro:
@@ -45,8 +45,8 @@ const emailTemplateGenerator = {
         body: "See compliance, accessibility, rendering, and missing-information notes before handing the template to development.",
       },
       {
-        title: "Agent Revision Loop",
-        body: "After generation, describe the exact wording or module change and regenerate a new structured result from the Agent.",
+        title: "Guided revision loop",
+        body: "After generation, describe the exact wording or module change and regenerate a new structured result.",
       },
     ],
     valueVisualAlt: "Visual of an email template package with MJML, HTML, variables, and developer handoff notes.",
@@ -72,7 +72,7 @@ const emailTemplateGenerator = {
       },
       {
         title: "Fast Iteration",
-        body: "A rough brief can become a first package quickly, then the Agent can revise structure, wording, and sections from follow-up instructions.",
+        body: "A rough brief can become a first package quickly, then the generation workflow can revise structure, wording, and sections from follow-up instructions.",
       },
       {
         title: "Useful Preview",
@@ -103,7 +103,7 @@ const emailTemplateGenerator = {
         title: "How To Recover",
         items: [
           "If the result is too generic, add real product value, user segment, offer, CTA, objections, and brand examples.",
-          "If the template feels too promotional, switch to a transactional scenario or ask the Agent to remove sales language.",
+          "If the template feels too promotional, switch to a transactional scenario or ask for the sales language to be removed.",
           "If a merge field or link is missing, add the required variable name and regenerate through the revision box.",
         ],
       },
@@ -153,7 +153,7 @@ const emailTemplateGenerator = {
       {
         question: "Can I edit the result?",
         answer:
-          "Yes. You can inspect sections and send revision instructions back to the Agent. The next version is written back as a new structured result.",
+          "Yes. You can inspect sections and submit revision instructions. The next version is returned as a new structured result.",
       },
       {
         question: "Is the generated HTML ready to send?",
@@ -207,7 +207,7 @@ const emailTemplateGenerator = {
     emptyTitle: "Your generated package will appear here",
     emptyHint:
       "The result includes HTML preview, MJML source, HTML, plain text, variables, review notes, and export actions.",
-    runningTitle: "The Agent is building your template package",
+    runningTitle: "Your template package is being generated",
     runningHint:
       "It is writing MJML, matching HTML, plain text, variables, and review notes. Short result fetch delays are normal.",
     previewInput: "Input",
@@ -248,7 +248,7 @@ const emailTemplateGenerator = {
       missing: "Missing information",
       empty: "No items returned.",
     },
-    revisionLabel: "Ask the Agent to revise",
+    revisionLabel: "Revise the result",
     revisionHint: "Use a specific change request",
     revisionPlaceholder:
       "Example: Make the hero shorter, change the CTA to book a demo, and add {{calendar_url}} as a variable.",
@@ -262,12 +262,12 @@ const emailTemplateGenerator = {
     },
     errors: {
       invalid: "Add a real product name, audience, and email brief. Placeholder or numeric input cannot produce a useful template.",
-      revision: "Write a specific revision instruction before sending it to the Agent.",
+      revision: "Write a specific revision instruction before submitting it.",
       copy: "Copy failed. You can still select and copy the text manually.",
       submit: "The request could not be submitted.",
       task: "The generation task failed.",
       timeout: "The structured result did not arrive in time.",
-      schema: "The Agent returned a result that did not match the email template schema.",
+      schema: "The generated result could not be read safely. Please try again.",
       generic: "The template could not be generated.",
       recover:
         "Check the brief, try again, or add more concrete product, audience, CTA, and variable details.",

package/src/i18n/messages/en/tools/product-poster-generator.ts

@@ -228,6 +228,7 @@ const productPosterGenerator = {
         "The poster image could not be generated. Simplify the benefits, choose another format, or try again later.",
       unreadableResult: "The result cannot be read right now. Try again later.",
       timeout: "Generation is taking longer than expected. Try again later.",
+      downloadFailed: "The PNG could not be downloaded. Try again in a moment.",
     },
     readyKicker: "Poster ready",
     readyTitle: "Product promo poster is ready",