best-email-builder 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -6,6 +6,82 @@ All notable changes are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.10.0] — 2026-10-19
+
+The AI no longer writes whole emails: it checks and writes their texts.
+This breaks code that used *Generate* (see *Removed*).
+
+### Added
+- **Proofread**, in the toolbar: the spelling, grammar and punctuation
+  mistakes of every text the reader sees (subject, preview text, text
+  blocks, buttons, menu links), found in one call. The dialog lists the
+  texts with a mistake, the old words struck out and the new ones next to
+  them; each correction is applied on its own or all at once, and the
+  corrections applied together are one step of the history. A text edited
+  since it was read is left as it is. A correction is kept only when it
+  changes words, keeps the markup, links and merge tags, and touches at most
+  a third of the text; otherwise the model gets one repair turn, then it is
+  left out.
+- `ai.proofread`, `generator.proofread` and the handler's
+  `POST {base}/proofread` (60 per user per hour, `rateLimits.proofreadPerHour`).
+  `PROOFREAD_SYSTEM_PROMPT`, `createProofreader` and `reviewFix` are exported
+  from `best-email-builder/ai/server`, `diffWords` from both AI entries.
+- **Write with AI**, in the properties of a text block: a topic ("the sale
+  ends Sunday"), and the text is written anew to fit the rest of the email,
+  a title as one line, a `[placeholder]` where a fact is missing. It is the
+  `write` action of `rewrite` (`{ action: 'write', instruction, context }`).
+- `editor.setContents([{ id, content }])`: the contents of several
+  elements changed in one step of the history.
+
+### Changed
+- `claudeEmailModel` uses `effort: 'low'` for every task by default (every
+  answer is a short one now); `effort` changes it. `rewriteEffort` still
+  works as its old name.
+- The agent protocol (`best-email-builder/agent@1`) has two tasks,
+  `rewrite` and `subjects`: a proofread is sent as `rewrite`, so agents
+  written for 0.9 keep working. `checkAgent` tries a proofread, a rewrite
+  and subject ideas.
+- The live demo explains Proofread and Write with AI.
+
+### Removed
+- **Generate**: the toolbar button, `ai.generate`, `generator.generate`, the
+  handler's `POST {base}/generate` (now 404) and `rateLimits.generatePerHour`.
+  `createAi({ generate: fn })` throws; `generate: false` is still accepted.
+- The 68 purposes and the email prompt: `EMAIL_PURPOSES`,
+  `PURPOSE_CATEGORIES`, `purposeById`, `purposesByCategory`, `SYSTEM_PROMPT`,
+  `EMAIL_DRAFT_SCHEMA`, `buildUserPrompt`, `cleanGenerateInput`,
+  `MAX_DETAILS_LENGTH`, `normalizeGeneratedMjml`, `parseDraft` and
+  `reviewDraft`.
+- The `compile` option of `createEmailGenerator` and `checkAgent`: nothing
+  compiles MJML any more.
+
+### Fixed
+- The gallery's *Welcome*, *Event invitation* and *Newsletter* were
+  translated only when the AI module was loaded (its dictionary had the same
+  words). The core has them now, and `npm run check:i18n` checks the
+  gallery's names and descriptions.
+
+## [0.9.0] — 2026-10-16
+
+### Added
+- **An OpenAI-compatible API of the user's own** in the Connect dialog: add
+  `'openai-compatible'` to `createAi({ provider: [...], askKey: true })`
+  and the user gives its address (LM Studio, vLLM, Ollama on another
+  machine, a proxy…), a key only if it needs one, and a model from its
+  `/models` list. The address is remembered like the key. `ai.key` gains
+  `address(id?)`, `setAddress(url, id?)` and `ready()`; `listModels` takes
+  an `address`. A provider without a key of its own (Ollama) connects
+  without one, once a model is chosen.
+- The live demo offers it too, and its language list is now a list of its
+  own instead of the browser's: by mouse, or by keyboard (arrows, Home/End,
+  type a letter, Enter, Esc).
+
+### Changed
+- The Connect dialog and the list of models show what is free in words
+  only: no gift icons.
+- `ai.key.state().connected` is true once the provider in use can write:
+  its key (unless it needs none), its address and its model.
+
 ## [0.8.0] — 2026-10-16
 
 ### Added

package/README.md

@@ -65,13 +65,15 @@ once and given away.
   unsubscribe link.
 
 **AI, optional**
-- *Generate* a complete email from one of 68 purposes.
+- *Proofread* the whole email: spelling, grammar and punctuation in every
+  text, each correction shown word by word, applied in one step.
+- *Write* a text on a topic, to fit the rest of the email.
 - *Rewrite* any text: shorter, longer, fixed, friendlier, more formal, or
   translated into 13 languages.
 - *Suggest* three subject lines drawn from the email.
-- OpenRouter, Gemini, Groq, Mistral, OpenAI, DeepSeek, Cerebras, Ollama,
-  Claude or your own agent. The model runs on your server, or in the page
-  with each user's own key.
+- OpenRouter, Gemini, Groq, Mistral, OpenAI, DeepSeek, Cerebras, Ollama, any
+  OpenAI-compatible API, Claude or your own agent. The model runs on your
+  server, or in the page with each user's own key.
 
 **Your app**
 - Merge-tag variables, including ones your users create.
@@ -140,7 +142,7 @@ the layout, Next.js, Express and image hosting.
 | [Editor and library](docs/EDITOR.md) | The three ways to mount them, every prop, theming. |
 | [Server](docs/SERVER.md) | Routes, handler options, the storage contract, your database. |
 | [Variables and sending](docs/VARIABLES.md) | Merge tags, custom variables, personalizing at send time. |
-| [AI](docs/AI.md) | Generate, Rewrite, Subjects. Where the model runs, and the providers. |
+| [AI](docs/AI.md) | Proofread, Write, Rewrite, Subjects. Where the model runs, and the providers. |
 | [Your own AI agent](docs/AGENT.md) | The `agent@1` protocol. |
 | [Brand](docs/BRAND.md) | Logo, colors and font, read from a website. |
 | [Languages](docs/LANGUAGES.md) | Seven built in, your own strings, adding one. |

package/dist/ai-server.js

@@ -4,43 +4,34 @@ import {
   AI_MESSAGES,
   AI_PROVIDERS,
   DEFAULT_CLAUDE_MODEL,
-  EMAIL_DRAFT_SCHEMA,
-  EMAIL_PURPOSES,
   EmailGenerationError,
   GENERATION_ERRORS,
-  MAX_DETAILS_LENGTH,
-  PURPOSE_CATEGORIES,
+  PROOFREAD_SYSTEM_PROMPT,
   REWRITE_ACTIONS,
   REWRITE_LANGUAGES,
   REWRITE_SYSTEM_PROMPT,
   SUBJECTS_SYSTEM_PROMPT,
-  SYSTEM_PROMPT,
   agentEmailModel,
-  buildUserPrompt,
   claudeEmailModel,
-  cleanGenerateInput,
   createEmailGenerator,
+  createProofreader,
   createRewriter,
   createSubjectSuggester,
+  diffWords,
   emailWords,
   failureCode,
   listProviderModels,
-  normalizeGeneratedMjml,
-  parseDraft,
   providerEmailModel,
-  purposeById,
-  purposesByCategory,
   resolveProvider,
-  reviewDraft,
+  reviewFix,
   reviewRewrite,
   reviewSubjects
-} from "./chunk-SHHHYRPC.js";
-import "./chunk-OWVXKMLI.js";
-import "./chunk-AXIM6E7T.js";
-import "./chunk-62HBUBBI.js";
+} from "./chunk-24E4GOHU.js";
+import "./chunk-VQRVBQIB.js";
+import "./chunk-MBZI6NVP.js";
 
 // src/ai/agentEndpoint.js
-var TASKS = ["generate", "rewrite", "subjects"];
+var TASKS = ["rewrite", "subjects"];
 var MAX_BODY_BYTES = 2 * 1024 * 1024;
 var MAX_MESSAGES = 20;
 var json = (body, status = 200) => new Response(JSON.stringify(body), { status, headers: { "Content-Type": "application/json; charset=utf-8", "Cache-Control": "no-store" } });
@@ -113,11 +104,17 @@ function createAgentEndpoint({ complete, onError = (error) => console.error("[ag
   };
 }
 var SAMPLE_TEXT = '<p>Our summer sale starts on Monday: 30% off everything in store, for three days only. It ends on Wednesday at midnight. <a href="https://example.com/sale">See the offers</a>.</p>';
-async function checkAgent({ url, headers, user, fetch: fetchImpl, timeout, compile, language = "en" }) {
+var SAMPLE_EMAIL = [
+  { id: "subject", kind: "subject", format: "plain", text: "Our sumer sale starts on Monday" },
+  { id: "text-1", kind: "text", format: "html", text: SAMPLE_TEXT },
+  { id: "text-2", kind: "text", format: "html", text: "<p>We hope to see you their. <b>Every</b> product are on sale.</p>" },
+  { id: "button-1", kind: "button", format: "plain", text: "See the offers" }
+];
+async function checkAgent({ url, headers, user, fetch: fetchImpl, timeout, language = "en" }) {
   const model = agentEmailModel({ url, headers, fetch: fetchImpl, timeout });
-  const generator = createEmailGenerator({ model, compile });
+  const generator = createEmailGenerator({ model });
   const steps = [
-    ["generate", () => generator.generate({ purpose: "welcome", language }, { user }), (r) => ({ subject: r.subject, warnings: r.warnings })],
+    ["proofread", () => generator.proofread({ texts: SAMPLE_EMAIL, language }, { user }), (r) => r.fixes],
     ["rewrite", () => generator.rewrite({ action: "shorter", text: SAMPLE_TEXT, format: "html" }, { user }), (r) => r.text],
     [
       "subjects",
@@ -147,36 +144,28 @@ export {
   AI_MESSAGES,
   AI_PROVIDERS,
   DEFAULT_CLAUDE_MODEL,
-  EMAIL_DRAFT_SCHEMA,
-  EMAIL_PURPOSES,
   EmailGenerationError,
   GENERATION_ERRORS,
-  MAX_DETAILS_LENGTH,
-  PURPOSE_CATEGORIES,
+  PROOFREAD_SYSTEM_PROMPT,
   REWRITE_ACTIONS,
   REWRITE_LANGUAGES,
   REWRITE_SYSTEM_PROMPT,
   SUBJECTS_SYSTEM_PROMPT,
-  SYSTEM_PROMPT,
   agentEmailModel,
-  buildUserPrompt,
   checkAgent,
   claudeEmailModel,
-  cleanGenerateInput,
   createAgentEndpoint,
   createEmailGenerator,
+  createProofreader,
   createRewriter,
   createSubjectSuggester,
+  diffWords,
   emailWords,
   failureCode,
   listProviderModels,
-  normalizeGeneratedMjml,
-  parseDraft,
   providerEmailModel,
-  purposeById,
-  purposesByCategory,
   resolveProvider,
-  reviewDraft,
+  reviewFix,
   reviewRewrite,
   reviewSubjects
 };

package/dist/ai-server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ai/agentEndpoint.js"],"sourcesContent":["// @ts-check\n/**\n * THE AGENT'S SIDE of `best-email-builder/agent@1` (see agent.js), for an\n * agent written in JavaScript — and `checkAgent`, to try any agent with the\n * builder's own checks before plugging it in.\n *\n *   const endpoint = createAgentEndpoint({\n *     complete: async ({ task, system, messages, schema, request }) => {\n *       const who = await sessionOf(request);           // your rights\n *       return myAgent.answer({ system, messages, who }); // text, or the answer as an object\n *     },\n *   });\n *   // Next.js: export const POST = endpoint;   Express: app.post('/email-builder', toNodeListener(endpoint))\n *\n *   const report = await checkAgent({ url: 'http://localhost:8800/email-builder', headers, compile: compileMjml });\n *   // { ok, results: [{ task: 'generate', ok, ms, attempts, sample }, …] }\n */\n\nimport { AGENT_ERROR_CODES, AGENT_PROTOCOL, agentEmailModel } from './agent.js';\nimport { GENERATION_ERRORS } from './draft.js';\nimport { createEmailGenerator } from './generator.js';\n\nconst TASKS = ['generate', 'rewrite', 'subjects'];\n/** A repair turn carries the last answer: a whole email at most. */\nconst MAX_BODY_BYTES = 2 * 1024 * 1024;\nconst MAX_MESSAGES = 20;\n\n/**\n * @typedef {{\n *   task: 'generate'|'rewrite'|'subjects',\n *   system: string,\n *   messages: {role: 'user'|'assistant', content: string}[],\n *   schema: object,\n *   request: Request,\n *   signal: AbortSignal,\n * }} AgentTask\n */\n\n/** @param {unknown} body @param {number} status */\nconst json = (body, status = 200) =>\n  new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' } });\n\n/** @param {string} error @param {string} code @param {number} status */\nconst refuse = (error, code, status) => json({ error, code }, status);\n\n/**\n * What the builder sent, checked; or why not.\n * @param {any} body\n * @returns {string|null} the problem\n */\nfunction problemOf(body) {\n  if (!body || typeof body !== 'object') return 'The body is not a JSON object';\n  if (body.protocol !== AGENT_PROTOCOL) return `Unsupported protocol ${JSON.stringify(body.protocol)} — this endpoint speaks ${AGENT_PROTOCOL}`;\n  if (!TASKS.includes(body.task)) return `Unknown task ${JSON.stringify(body.task)}`;\n  if (typeof body.system !== 'string') return '`system` must be a string';\n  if (!body.schema || typeof body.schema !== 'object') return '`schema` must be an object';\n  const { messages } = body;\n  if (!Array.isArray(messages) || !messages.length || messages.length > MAX_MESSAGES) return `\\`messages\\` must hold 1 to ${MAX_MESSAGES} messages`;\n  for (const message of messages) {\n    if (!message || (message.role !== 'user' && message.role !== 'assistant') || typeof message.content !== 'string') {\n      return 'Each message is { role: \"user\"|\"assistant\", content: string }';\n    }\n  }\n  return null;\n}\n\n/**\n * @param {{\n *   complete: (task: AgentTask) => Promise<string | object> | string | object,\n *   onError?: (error: unknown, request: Request) => void,\n * }} options\n *   `complete`: your agent. It answers with the text of its model, or with\n *   the answer as an object. To fail with a reason the builder explains, throw\n *   an error whose `code` is one of AGENT_ERROR_CODES ('REFUSED',\n *   'MODEL_BUSY'…); any other error is logged with `onError` and answered as\n *   MODEL_ERROR, its message kept out of the response.\n * @returns {(request: Request) => Promise<Response>}\n */\nexport function createAgentEndpoint({ complete, onError = (error) => console.error('[agent]', error) } = /** @type {any} */ ({})) {\n  if (typeof complete !== 'function') throw new TypeError('createAgentEndpoint: `complete` must be a function — your agent');\n\n  return async function agentEndpoint(request) {\n    if (request.method.toUpperCase() !== 'POST') return refuse('POST only', 'METHOD_NOT_ALLOWED', 405);\n    const length = Number(request.headers.get('content-length') || 0);\n    if (length > MAX_BODY_BYTES) return refuse('Request too large', 'TOO_LARGE', 413);\n    const raw = await request.text();\n    if (raw.length > MAX_BODY_BYTES) return refuse('Request too large', 'TOO_LARGE', 413);\n    /** @type {any} */\n    let body;\n    try {\n      body = JSON.parse(raw);\n    } catch {\n      return refuse('Invalid JSON', 'INVALID_JSON', 400);\n    }\n    const problem = problemOf(body);\n    if (problem) return refuse(problem, 'INVALID_REQUEST', 400);\n\n    try {\n      const answer = await complete({\n        task: body.task,\n        system: body.system,\n        messages: body.messages.map((/** @type {any} */ m) => ({ role: m.role, content: m.content })),\n        schema: body.schema,\n        request,\n        signal: request.signal,\n      });\n      if (typeof answer === 'string') return json({ text: answer });\n      if (answer && typeof answer === 'object') return json({ output: answer });\n      return refuse('The agent gave no answer', 'MODEL_ERROR', 502);\n    } catch (error) {\n      const code = /** @type {any} */ (error)?.code;\n      if (AGENT_ERROR_CODES.includes(code)) {\n        const known = GENERATION_ERRORS[/** @type {keyof typeof GENERATION_ERRORS} */ (code)];\n        return refuse(String(/** @type {any} */ (error)?.detail || /** @type {any} */ (error)?.message || known.message), code, known.status);\n      }\n      onError(error, request);\n      return refuse('The agent could not answer', 'MODEL_ERROR', 502);\n    }\n  };\n}\n\nconst SAMPLE_TEXT =\n  '<p>Our summer sale starts on Monday: 30% off everything in store, for three days only. ' +\n  'It ends on Wednesday at midnight. <a href=\"https://example.com/sale\">See the offers</a>.</p>';\n\n/**\n * Tries an agent with the builder's own checks: one email written, one text\n * rewritten, subject ideas — in turn, each as the builder would ask it (with\n * its repair turn). Three to six calls to the agent.\n * @param {{\n *   url: string,\n *   headers?: import('./agent.js').AgentHeaders,\n *   user?: any,\n *   fetch?: typeof fetch,\n *   timeout?: number,\n *   compile?: (mjml: string) => Promise<{warnings?: {message: string}[]}>,\n *   language?: string,\n * }} options\n *   `user`: what `headers` gets, as the handler's `authorize` would give it.\n *   `compile`: `compileMjml` (best-email-builder/server), for MJML's own\n *   warnings as on the server.\n * @returns {Promise<{ok: boolean, results: {task: string, ok: boolean, ms: number, attempts?: number, sample?: unknown, code?: string, error?: string}[]}>}\n */\nexport async function checkAgent({ url, headers, user, fetch: fetchImpl, timeout, compile, language = 'en' }) {\n  const model = agentEmailModel({ url, headers, fetch: fetchImpl, timeout });\n  const generator = createEmailGenerator({ model, compile });\n  /** @type {[string, () => Promise<any>, (result: any) => unknown][]} */\n  const steps = [\n    ['generate', () => generator.generate({ purpose: 'welcome', language }, { user }), (r) => ({ subject: r.subject, warnings: r.warnings })],\n    ['rewrite', () => generator.rewrite({ action: 'shorter', text: SAMPLE_TEXT, format: 'html' }, { user }), (r) => r.text],\n    [\n      'subjects',\n      () => generator.suggestSubjects({ subject: 'Summer sale: 30% off', text: 'Our summer sale starts on Monday: 30% off everything in store, for three days only.', language }, { user }),\n      (r) => r.subjects,\n    ],\n  ];\n  const results = [];\n  for (const [task, run, sampleOf] of steps) {\n    const started = Date.now();\n    try {\n      const result = await run();\n      results.push({ task, ok: true, ms: Date.now() - started, attempts: result.attempts, sample: sampleOf(result) });\n    } catch (error) {\n      const failure = /** @type {any} */ (error);\n      results.push({ task, ok: false, ms: Date.now() - started, code: failure?.code || 'ERROR', error: String(failure?.detail || failure?.message || error) });\n    }\n  }\n  return { ok: results.every((result) => result.ok), results };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/ai/agentEndpoint.js"],"sourcesContent":["// @ts-check\n/**\n * THE AGENT'S SIDE of `best-email-builder/agent@1` (see agent.js), for an\n * agent written in JavaScript — and `checkAgent`, to try any agent with the\n * builder's own checks before plugging it in.\n *\n *   const endpoint = createAgentEndpoint({\n *     complete: async ({ task, system, messages, schema, request }) => {\n *       const who = await sessionOf(request);           // your rights\n *       return myAgent.answer({ system, messages, who }); // text, or the answer as an object\n *     },\n *   });\n *   // Next.js: export const POST = endpoint;   Express: app.post('/email-builder', toNodeListener(endpoint))\n *\n *   const report = await checkAgent({ url: 'http://localhost:8800/email-builder', headers });\n *   // { ok, results: [{ task: 'proofread', ok, ms, attempts, sample }, …] }\n */\n\nimport { AGENT_ERROR_CODES, AGENT_PROTOCOL, agentEmailModel } from './agent.js';\nimport { GENERATION_ERRORS } from './errors.js';\nimport { createEmailGenerator } from './generator.js';\n\nconst TASKS = ['rewrite', 'subjects'];\n/** A repair turn carries the last answer: the texts of an email at most. */\nconst MAX_BODY_BYTES = 2 * 1024 * 1024;\nconst MAX_MESSAGES = 20;\n\n/**\n * @typedef {{\n *   task: 'rewrite'|'subjects',\n *   system: string,\n *   messages: {role: 'user'|'assistant', content: string}[],\n *   schema: object,\n *   request: Request,\n *   signal: AbortSignal,\n * }} AgentTask\n */\n\n/** @param {unknown} body @param {number} status */\nconst json = (body, status = 200) =>\n  new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' } });\n\n/** @param {string} error @param {string} code @param {number} status */\nconst refuse = (error, code, status) => json({ error, code }, status);\n\n/**\n * What the builder sent, checked; or why not.\n * @param {any} body\n * @returns {string|null} the problem\n */\nfunction problemOf(body) {\n  if (!body || typeof body !== 'object') return 'The body is not a JSON object';\n  if (body.protocol !== AGENT_PROTOCOL) return `Unsupported protocol ${JSON.stringify(body.protocol)} — this endpoint speaks ${AGENT_PROTOCOL}`;\n  if (!TASKS.includes(body.task)) return `Unknown task ${JSON.stringify(body.task)}`;\n  if (typeof body.system !== 'string') return '`system` must be a string';\n  if (!body.schema || typeof body.schema !== 'object') return '`schema` must be an object';\n  const { messages } = body;\n  if (!Array.isArray(messages) || !messages.length || messages.length > MAX_MESSAGES) return `\\`messages\\` must hold 1 to ${MAX_MESSAGES} messages`;\n  for (const message of messages) {\n    if (!message || (message.role !== 'user' && message.role !== 'assistant') || typeof message.content !== 'string') {\n      return 'Each message is { role: \"user\"|\"assistant\", content: string }';\n    }\n  }\n  return null;\n}\n\n/**\n * @param {{\n *   complete: (task: AgentTask) => Promise<string | object> | string | object,\n *   onError?: (error: unknown, request: Request) => void,\n * }} options\n *   `complete`: your agent. It answers with the text of its model, or with\n *   the answer as an object. To fail with a reason the builder explains, throw\n *   an error whose `code` is one of AGENT_ERROR_CODES ('REFUSED',\n *   'MODEL_BUSY'…); any other error is logged with `onError` and answered as\n *   MODEL_ERROR, its message kept out of the response.\n * @returns {(request: Request) => Promise<Response>}\n */\nexport function createAgentEndpoint({ complete, onError = (error) => console.error('[agent]', error) } = /** @type {any} */ ({})) {\n  if (typeof complete !== 'function') throw new TypeError('createAgentEndpoint: `complete` must be a function — your agent');\n\n  return async function agentEndpoint(request) {\n    if (request.method.toUpperCase() !== 'POST') return refuse('POST only', 'METHOD_NOT_ALLOWED', 405);\n    const length = Number(request.headers.get('content-length') || 0);\n    if (length > MAX_BODY_BYTES) return refuse('Request too large', 'TOO_LARGE', 413);\n    const raw = await request.text();\n    if (raw.length > MAX_BODY_BYTES) return refuse('Request too large', 'TOO_LARGE', 413);\n    /** @type {any} */\n    let body;\n    try {\n      body = JSON.parse(raw);\n    } catch {\n      return refuse('Invalid JSON', 'INVALID_JSON', 400);\n    }\n    const problem = problemOf(body);\n    if (problem) return refuse(problem, 'INVALID_REQUEST', 400);\n\n    try {\n      const answer = await complete({\n        task: body.task,\n        system: body.system,\n        messages: body.messages.map((/** @type {any} */ m) => ({ role: m.role, content: m.content })),\n        schema: body.schema,\n        request,\n        signal: request.signal,\n      });\n      if (typeof answer === 'string') return json({ text: answer });\n      if (answer && typeof answer === 'object') return json({ output: answer });\n      return refuse('The agent gave no answer', 'MODEL_ERROR', 502);\n    } catch (error) {\n      const code = /** @type {any} */ (error)?.code;\n      if (AGENT_ERROR_CODES.includes(code)) {\n        const known = GENERATION_ERRORS[/** @type {keyof typeof GENERATION_ERRORS} */ (code)];\n        return refuse(String(/** @type {any} */ (error)?.detail || /** @type {any} */ (error)?.message || known.message), code, known.status);\n      }\n      onError(error, request);\n      return refuse('The agent could not answer', 'MODEL_ERROR', 502);\n    }\n  };\n}\n\nconst SAMPLE_TEXT =\n  '<p>Our summer sale starts on Monday: 30% off everything in store, for three days only. ' +\n  'It ends on Wednesday at midnight. <a href=\"https://example.com/sale\">See the offers</a>.</p>';\n\n/** An email with three mistakes to find, and one text without. @type {import('./proofread.js').ProofreadText[]} */\nconst SAMPLE_EMAIL = [\n  { id: 'subject', kind: 'subject', format: 'plain', text: 'Our sumer sale starts on Monday' },\n  { id: 'text-1', kind: 'text', format: 'html', text: SAMPLE_TEXT },\n  { id: 'text-2', kind: 'text', format: 'html', text: '<p>We hope to see you their. <b>Every</b> product are on sale.</p>' },\n  { id: 'button-1', kind: 'button', format: 'plain', text: 'See the offers' },\n];\n\n/**\n * Tries an agent with the builder's own checks: an email proofread, one text\n * rewritten, subject ideas — in turn, each as the builder would ask it (with\n * its repair turn). Three to six calls to the agent.\n * @param {{\n *   url: string,\n *   headers?: import('./agent.js').AgentHeaders,\n *   user?: any,\n *   fetch?: typeof fetch,\n *   timeout?: number,\n *   language?: string,\n * }} options\n *   `user`: what `headers` gets, as the handler's `authorize` would give it.\n * @returns {Promise<{ok: boolean, results: {task: string, ok: boolean, ms: number, attempts?: number, sample?: unknown, code?: string, error?: string}[]}>}\n */\nexport async function checkAgent({ url, headers, user, fetch: fetchImpl, timeout, language = 'en' }) {\n  const model = agentEmailModel({ url, headers, fetch: fetchImpl, timeout });\n  const generator = createEmailGenerator({ model });\n  /** @type {[string, () => Promise<any>, (result: any) => unknown][]} */\n  const steps = [\n    ['proofread', () => generator.proofread({ texts: SAMPLE_EMAIL, language }, { user }), (r) => r.fixes],\n    ['rewrite', () => generator.rewrite({ action: 'shorter', text: SAMPLE_TEXT, format: 'html' }, { user }), (r) => r.text],\n    [\n      'subjects',\n      () => generator.suggestSubjects({ subject: 'Summer sale: 30% off', text: 'Our summer sale starts on Monday: 30% off everything in store, for three days only.', language }, { user }),\n      (r) => r.subjects,\n    ],\n  ];\n  const results = [];\n  for (const [task, run, sampleOf] of steps) {\n    const started = Date.now();\n    try {\n      const result = await run();\n      results.push({ task, ok: true, ms: Date.now() - started, attempts: result.attempts, sample: sampleOf(result) });\n    } catch (error) {\n      const failure = /** @type {any} */ (error);\n      results.push({ task, ok: false, ms: Date.now() - started, code: failure?.code || 'ERROR', error: String(failure?.detail || failure?.message || error) });\n    }\n  }\n  return { ok: results.every((result) => result.ok), results };\n}\n"],"mappings":"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","names":[]}