best-email-builder 0.5.1 → 0.7.0

package/CHANGELOG.md

@@ -6,6 +6,69 @@ All notable changes are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.7.0] — 2026-10-15
+
+### Added
+- **The user chooses the model.** In the Connect dialog, under the key, a
+  field opens the provider's list of models in place: the default first,
+  then the free ones (marked, with a *Free only* filter), then the newest;
+  searchable, and an id the list does not have can be used as typed. The
+  list is asked with the key (OpenRouter's needs none, so it shows before
+  any key); embeddings, speech, pictures and video are left out. The model
+  chosen is remembered for each provider and sent with each request.
+  `ai.key` gains `model(id?)`, `chooseModel(model, id?)` and
+  `listModels(id?, { apiKey, signal })`.
+- **`listProviderModels({ provider, apiKey })`** — the models a provider
+  offers for writing, from `/ai` and `/ai/server`. `claudeProvider` lists
+  Claude's through the application's SDK and takes the model chosen.
+- The live demo says which model is connected, and its link is now *Change
+  provider or model*.
+- **Your own AI agent as the builder's AI** — `agentEmailModel({ url, headers })`
+  sends each model turn to an agent of the application's own over a small
+  HTTP protocol, `best-email-builder/agent@1` (`{ task, system, messages,
+  schema }` in, `{ text }` out, errors as codes the interface explains).
+  Generate, Rewrite and Subjects then go through the agent (its tools, its
+  knowledge, its users' rights) and its answers are checked like any model's.
+  On the server, `headers({ task, user })` gets the user `authorize` returned,
+  to forward who asks; the handler now hands that user to the generator and
+  its model. The agent's side: `createAgentEndpoint({ complete })` in
+  JavaScript, a FastAPI router to copy in `examples/agent/python`;
+  `checkAgent({ url, headers })` tries an agent with the builder's own checks.
+  See docs/AGENT.md.
+- **`MODEL_UNAVAILABLE`** — a model the provider does not have, or no longer
+  (a 404 about the model, OpenRouter's "not a valid model ID"): *Choose
+  another one*, instead of *Try again*.
+
+### Changed
+- *Get a key* opens the provider's page in a new tab with `window.open`,
+  also where a link's target is ignored (some embedded browsers).
+
+## [0.6.0] — 2026-10-15
+
+### Added
+- **The user chooses the provider.** `createAi({ provider: [...], askKey: true })`
+  takes a list: the Connect dialog shows the providers as cards (name, model,
+  free or not, a dot on those whose key this browser keeps; arrows move
+  through them). The choice and one key per provider are remembered, and a
+  provider whose key is kept needs nothing pasted. `ai.key` gains `provider`,
+  `providers`, `choose(id)` and `get(id)`; `ai.key.request()` opens the dialog
+  to change provider.
+- **`claudeProvider({ client })`** — Claude as one of those providers, with
+  the user's own Anthropic key; the application's SDK is loaded when Claude
+  is chosen.
+- **`failureCode(status, message)`** — the rule that turns a provider's
+  failure into the interface's error, exported for a model of your own.
+- The live demo offers OpenAI, Claude, Mistral, Gemini and OpenRouter, says
+  which one is connected, and has a *Change provider* link.
+
+### Fixed
+- **An exhausted quota said "busy, try again".** OpenAI answers a quota
+  spent with a 429 (`insufficient_quota`), Anthropic an empty credit balance
+  with a 400: both are now `MODEL_CREDITS`.
+- **Claude's failures were all "could not answer".** The SDK's errors are now
+  read like every provider's: a refused key is `KEY_REFUSED` (asked again with
+  `askKey`), no credits `MODEL_CREDITS`, overloaded (529) `MODEL_BUSY`.
+
 ## [0.5.1] — 2026-10-15
 
 ### Fixed

package/README.md

@@ -61,7 +61,8 @@ Best Email Builder is the second option done once, properly, and given away:
   model's MJML is cleaned and checked like any template before it gets there.
   OpenRouter, Gemini, Groq, Mistral, OpenAI, DeepSeek, Cerebras, Ollama or any
   OpenAI-compatible API by its key — free tiers included — and Claude through
-  its SDK; on your server, or in the page with each user's own key.
+  its SDK; on your server, or in the page with each user's own key — and the
+  provider they choose.
 - **Any text rewritten in one click** — select a text or a button: *Shorter*,
   *Longer*, *Fix mistakes*, *Friendlier*, *More formal*, *Translate* into 13
   languages, or say what to change in your own words. The text changes in
@@ -363,13 +364,55 @@ the provider refuses is forgotten and asked again. Off by default:
 const ai = createAi({ provider: 'openrouter', askKey: true });
 ```
 
-`ai.key` reads and changes it: `get()`, `set(key)`, `forget()`,
-`request()`, `subscribe(fn)`, `state()` (`{ asking, refused, connected }`).
-This is what the live demo does.
+Give a list and each user chooses: the dialog shows the providers as cards
+(name, model, free or not, a dot on those whose key this browser keeps). The
+choice and one key per provider are remembered; going back to a provider whose
+key is kept needs nothing pasted.
+
+```jsx
+const ai = createAi({ provider: ['openai', 'mistral', 'gemini', 'openrouter'], askKey: true });
+```
+
+Under the key, the user can choose the model: the field opens the provider's
+own list (asked with the key; OpenRouter's needs none), the default model
+first, then the free ones, marked, then the newest — searchable, with *Free
+only*, and an id the list does not have can be typed. Embeddings, speech,
+pictures and video are left out. The model chosen is remembered for each
+provider; without the list, the default one still works.
+
+`ai.key` reads and changes it: `provider` (the one in use), `providers`,
+`choose(id)`, `get(id?)`, `set(key)`, `forget()`, `model(id?)`,
+`chooseModel(model, id?)`, `listModels(id?, { apiKey, signal })`, `request()`
+(opens the dialog — to change provider or model, for one), `subscribe(fn)`,
+`state()` (`{ asking, refused, connected }`). This is what the live demo does.
 
 **In the page, with one key for everyone** — prototypes and internal tools
 only, the key is in the page's code: `createAi({ provider: 'groq', apiKey })`.
 
+**Your own AI agent** — the assistant your application already has (its
+model, its tools, its knowledge base, its users' rights) becomes the
+builder's AI: Generate, Rewrite and Subjects go through it. It speaks a small
+HTTP protocol, `best-email-builder/agent@1`: one POST per model turn
+(`{ task, system, messages, schema }` in, `{ text }` out). The builder still
+writes the prompts and checks every answer, so the agent needs to know nothing
+of MJML.
+
+```js
+generator: createEmailGenerator({
+  model: agentEmailModel({
+    url: 'http://agent.internal:8800/email-builder',
+    headers: ({ user }) => ({ 'X-Auth-User': signFor(user) }), // who asks: the user authorize returned
+  }),
+  compile: compileMjml,
+}),
+```
+
+The agent's side is one FastAPI file to copy
+([`examples/agent/python`](examples/agent/python)) or `createAgentEndpoint`
+in JavaScript, and `checkAgent({ url, headers })` tries an agent with the
+builder's own checks. The protocol, the errors and both sides:
+[docs/AGENT.md](docs/AGENT.md).
+
 #### Providers
 
 Every provider here speaks the OpenAI *chat completions* API; nothing to
@@ -402,6 +445,10 @@ providerEmailModel({ provider: { baseUrl: 'http://localhost:1234/v1', model: 'qw
   (`reasoning: { effort: 'low' }`) and given room for it (`maxTokens: 32000`;
   16 000 elsewhere). For drafts in seconds, use a free tier with a key of its
   own (Gemini, Groq, Cerebras) or a paid model.
+- `listProviderModels({ provider, apiKey })` lists the models a provider
+  offers for writing, as the dialog does (`{ id, name, free }`, the default
+  first): its `/models`, or the provider's own `listModels` (`claudeProvider`
+  has one).
 - `body` adds fields of your own to each request — OpenRouter's fallback list,
   for one: `providerEmailModel({ provider: 'openrouter', apiKey, body: { models: [...] } })`.
   It cannot change the model, the messages or the output limit.
@@ -410,8 +457,12 @@ providerEmailModel({ provider: { baseUrl: 'http://localhost:1234/v1', model: 'qw
   remembered. A model whose structured output breaks the JSON (some do on the
   quotes of HTML) can be told to skip it: `provider: { …, format: 'text' }`.
 - The provider's failures become errors the interface explains, in its
-  language: `KEY_MISSING`, `KEY_REFUSED`, `MODEL_CREDITS`, `MODEL_BUSY`,
-  `MODEL_ERROR` (with the provider's own text in `detail`). None is a 401:
+  language: `KEY_MISSING`, `KEY_REFUSED`, `MODEL_UNAVAILABLE` (the provider
+  does not have that model, or no longer), `MODEL_CREDITS`, `MODEL_BUSY`,
+  `MODEL_ERROR` (with the provider's own text in `detail`). An exhausted
+  quota is `MODEL_CREDITS`, not `MODEL_BUSY`, even when it comes as a 429
+  (OpenAI's `insufficient_quota`) or a 400 (Anthropic's credit balance);
+  `failureCode(status, message)` is that rule, for a model of your own. None is a 401:
   the key is the AI's, not the user's session. A 403 about the model (not
   available here, in this region) or the content is not `KEY_REFUSED`: with
   `askKey`, the user's key is not thrown away for it.
@@ -419,7 +470,21 @@ providerEmailModel({ provider: { baseUrl: 'http://localhost:1234/v1', model: 'qw
   Anthropic SDK (`npm install @anthropic-ai/sdk`) — `claude-opus-5-5` by
   default, `effort: 'medium'`, structured output, streamed so a long email
   does not hit a request timeout — or through OpenRouter with an
-  `anthropic/…` model and one key for every model.
+  `anthropic/…` model and one key for every model. With `askKey`, Claude is
+  one more provider to choose, with the user's own Anthropic key and the SDK
+  loaded only when it is chosen:
+
+  ```js
+  import { claudeProvider, createAi } from 'best-email-builder/ai';
+
+  const claude = claudeProvider({
+    client: async (apiKey) => {
+      const { default: Anthropic } = await import('@anthropic-ai/sdk');
+      return new Anthropic({ apiKey, dangerouslyAllowBrowser: true });
+    },
+  });
+  createAi({ provider: ['openai', claude, 'gemini'], askKey: true });
+  ```
 - **Anything else** is a function `({ system, messages, schema, signal, task })
   => Promise<string>` returning the JSON text — `createEmailGenerator({ model })`
   on the server, `createAi({ model })` in the page.
@@ -474,7 +539,8 @@ another click another one, the first row brings the user's subject back.
   are exported.
 
 The live demo has no server: there, the AI runs in the page with the
-visitor's own OpenRouter key (`createAi({ provider: 'openrouter', askKey: true })`).
+visitor's own key, for the provider they choose — OpenAI, Claude, Mistral,
+Gemini or OpenRouter (`createAi({ provider: ['openai', claude, 'mistral', 'gemini', 'openrouter'], askKey: true })`).
 
 ### 5. Your brand (optional)
 

package/dist/ai-server.js

@@ -1,4 +1,6 @@
 import {
+  AGENT_ERROR_CODES,
+  AGENT_PROTOCOL,
   AI_MESSAGES,
   AI_PROVIDERS,
   DEFAULT_CLAUDE_MODEL,
@@ -13,6 +15,7 @@ import {
   REWRITE_SYSTEM_PROMPT,
   SUBJECTS_SYSTEM_PROMPT,
   SYSTEM_PROMPT,
+  agentEmailModel,
   buildUserPrompt,
   claudeEmailModel,
   cleanGenerateInput,
@@ -20,6 +23,8 @@ import {
   createRewriter,
   createSubjectSuggester,
   emailWords,
+  failureCode,
+  listProviderModels,
   normalizeGeneratedMjml,
   parseDraft,
   providerEmailModel,
@@ -29,11 +34,116 @@ import {
   reviewDraft,
   reviewRewrite,
   reviewSubjects
-} from "./chunk-BAA5XMWY.js";
+} from "./chunk-CTZ56YJG.js";
 import "./chunk-OWVXKMLI.js";
 import "./chunk-W424KPCR.js";
 import "./chunk-JI36FNWE.js";
+
+// src/ai/agentEndpoint.js
+var TASKS = ["generate", "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" } });
+var refuse = (error, code, status) => json({ error, code }, status);
+function problemOf(body) {
+  if (!body || typeof body !== "object") return "The body is not a JSON object";
+  if (body.protocol !== AGENT_PROTOCOL) return `Unsupported protocol ${JSON.stringify(body.protocol)} \u2014 this endpoint speaks ${AGENT_PROTOCOL}`;
+  if (!TASKS.includes(body.task)) return `Unknown task ${JSON.stringify(body.task)}`;
+  if (typeof body.system !== "string") return "`system` must be a string";
+  if (!body.schema || typeof body.schema !== "object") return "`schema` must be an object";
+  const { messages } = body;
+  if (!Array.isArray(messages) || !messages.length || messages.length > MAX_MESSAGES) return `\`messages\` must hold 1 to ${MAX_MESSAGES} messages`;
+  for (const message of messages) {
+    if (!message || message.role !== "user" && message.role !== "assistant" || typeof message.content !== "string") {
+      return 'Each message is { role: "user"|"assistant", content: string }';
+    }
+  }
+  return null;
+}
+function createAgentEndpoint({ complete, onError = (error) => console.error("[agent]", error) } = (
+  /** @type {any} */
+  {}
+)) {
+  if (typeof complete !== "function") throw new TypeError("createAgentEndpoint: `complete` must be a function \u2014 your agent");
+  return async function agentEndpoint(request) {
+    if (request.method.toUpperCase() !== "POST") return refuse("POST only", "METHOD_NOT_ALLOWED", 405);
+    const length = Number(request.headers.get("content-length") || 0);
+    if (length > MAX_BODY_BYTES) return refuse("Request too large", "TOO_LARGE", 413);
+    const raw = await request.text();
+    if (raw.length > MAX_BODY_BYTES) return refuse("Request too large", "TOO_LARGE", 413);
+    let body;
+    try {
+      body = JSON.parse(raw);
+    } catch {
+      return refuse("Invalid JSON", "INVALID_JSON", 400);
+    }
+    const problem = problemOf(body);
+    if (problem) return refuse(problem, "INVALID_REQUEST", 400);
+    try {
+      const answer = await complete({
+        task: body.task,
+        system: body.system,
+        messages: body.messages.map((m) => ({ role: m.role, content: m.content })),
+        schema: body.schema,
+        request,
+        signal: request.signal
+      });
+      if (typeof answer === "string") return json({ text: answer });
+      if (answer && typeof answer === "object") return json({ output: answer });
+      return refuse("The agent gave no answer", "MODEL_ERROR", 502);
+    } catch (error) {
+      const code = (
+        /** @type {any} */
+        error?.code
+      );
+      if (AGENT_ERROR_CODES.includes(code)) {
+        const known = GENERATION_ERRORS[
+          /** @type {keyof typeof GENERATION_ERRORS} */
+          code
+        ];
+        return refuse(String(
+          /** @type {any} */
+          error?.detail || /** @type {any} */
+          error?.message || known.message
+        ), code, known.status);
+      }
+      onError(error, request);
+      return refuse("The agent could not answer", "MODEL_ERROR", 502);
+    }
+  };
+}
+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" }) {
+  const model = agentEmailModel({ url, headers, fetch: fetchImpl, timeout });
+  const generator = createEmailGenerator({ model, compile });
+  const steps = [
+    ["generate", () => generator.generate({ purpose: "welcome", language }, { user }), (r) => ({ subject: r.subject, warnings: r.warnings })],
+    ["rewrite", () => generator.rewrite({ action: "shorter", text: SAMPLE_TEXT, format: "html" }, { user }), (r) => r.text],
+    [
+      "subjects",
+      () => 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 }),
+      (r) => r.subjects
+    ]
+  ];
+  const results = [];
+  for (const [task, run, sampleOf] of steps) {
+    const started = Date.now();
+    try {
+      const result = await run();
+      results.push({ task, ok: true, ms: Date.now() - started, attempts: result.attempts, sample: sampleOf(result) });
+    } catch (error) {
+      const failure = (
+        /** @type {any} */
+        error
+      );
+      results.push({ task, ok: false, ms: Date.now() - started, code: failure?.code || "ERROR", error: String(failure?.detail || failure?.message || error) });
+    }
+  }
+  return { ok: results.every((result) => result.ok), results };
+}
 export {
+  AGENT_ERROR_CODES,
+  AGENT_PROTOCOL,
   AI_MESSAGES,
   AI_PROVIDERS,
   DEFAULT_CLAUDE_MODEL,
@@ -48,13 +158,18 @@ export {
   REWRITE_SYSTEM_PROMPT,
   SUBJECTS_SYSTEM_PROMPT,
   SYSTEM_PROMPT,
+  agentEmailModel,
   buildUserPrompt,
+  checkAgent,
   claudeEmailModel,
   cleanGenerateInput,
+  createAgentEndpoint,
   createEmailGenerator,
   createRewriter,
   createSubjectSuggester,
   emailWords,
+  failureCode,
+  listProviderModels,
   normalizeGeneratedMjml,
   parseDraft,
   providerEmailModel,

package/dist/ai-server.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","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, 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":[]}