best-email-builder 0.6.0 → 0.7.0

package/dist/{chunk-QPAZLCPO.js.map → chunk-C6WHIBGH.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/constants.js","../src/core/document.js","../src/validation/images.js"],"sourcesContent":["// @ts-check\n/**\n * Email builder constants.\n *\n * `EMAIL_BUILDER_VERSION` versions THIS package (UI, blocks, rendering);\n * `EMAIL_DOCUMENT_SCHEMA_VERSION` versions the stored JSON envelope (the\n * project JSON). Both are written with every template, so a document read by\n * a newer version knows whether it must be migrated (see `core/document.js`).\n */\n\nexport const EMAIL_BUILDER_VERSION = '0.6.0';\n\nexport const EMAIL_DOCUMENT_SCHEMA_VERSION = 1;\n\n/** @typedef {'desktop'|'mobile'} EmailDevice */\n\n/** @type {EmailDevice[]} */\nexport const EMAIL_DEVICES = ['desktop', 'mobile'];\n\n/** Content column width — the email client standard. */\nexport const EMAIL_CONTENT_WIDTH = 600;\n\n/** Mobile preview frame width (standard iPhone, the common worst case). */\nexport const EMAIL_MOBILE_WIDTH = 375;\n","// @ts-check\n/**\n * DOCUMENT envelope — what gets stored (the project JSON).\n *\n * HTML is only a compilation output; what gets edited is the engine's\n * project. It is not stored bare but wrapped with:\n *\n *   schemaVersion  the shape of THIS envelope (migrations, see MIGRATIONS);\n *   engine         the engine that can read `project` back;\n *   engineVersion  its version at write time;\n *   builderVersion the builder version that wrote it;\n *   project        the engine data, opaque to the rest of the code.\n *\n * A document from another engine, a future schema or a malformed one is\n * REJECTED on read rather than half-loaded: a template silently emptied and\n * then saved again would be lost.\n *\n * Dependency-free module: testable outside the browser.\n */\n\nimport { EMAIL_BUILDER_VERSION, EMAIL_DOCUMENT_SCHEMA_VERSION } from './constants.js';\n\n/**\n * @typedef {{\n *   schemaVersion: number,\n *   engine: string,\n *   engineVersion: string,\n *   builderVersion: string,\n *   project: Record<string, any>,\n * }} EmailDocument\n */\n\n/**\n * Envelope migrations, from N to N+1. Empty while only one schema exists; the\n * first entry will be `1: (doc) => ({ ...doc, schemaVersion: 2 })`.\n *\n * @type {Record<number, (document: any) => any>}\n */\nconst MIGRATIONS = {};\n\nexport class EmailDocumentError extends Error {\n  /** @param {string} message */\n  constructor(message) {\n    super(message);\n    this.name = 'EmailDocumentError';\n    this.status = 422;\n  }\n}\n\nfunction isPlainObject(value) {\n  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * @param {{engine: string, engineVersion: string, project: object}} parts\n * @returns {EmailDocument}\n */\nexport function createDocument({ engine, engineVersion, project }) {\n  if (!engine) throw new EmailDocumentError('Document: missing engine');\n  if (!isPlainObject(project)) throw new EmailDocumentError('Document: invalid engine project');\n  return {\n    schemaVersion: EMAIL_DOCUMENT_SCHEMA_VERSION,\n    engine,\n    engineVersion: String(engineVersion || ''),\n    builderVersion: EMAIL_BUILDER_VERSION,\n    project: /** @type {Record<string, any>} */ (project),\n  };\n}\n\n/**\n * Reads a document (object or JSON string), migrates it to the current schema\n * and validates it.\n *\n * @param {unknown} raw\n * @returns {EmailDocument}\n * @throws {EmailDocumentError}\n */\nexport function readDocument(raw) {\n  let value = raw;\n  if (typeof value === 'string') {\n    try {\n      value = JSON.parse(value);\n    } catch {\n      throw new EmailDocumentError('Unreadable document: invalid JSON');\n    }\n  }\n  if (!isPlainObject(value)) throw new EmailDocumentError('Unreadable document: object expected');\n\n  /** @type {any} */\n  let document = { ...(/** @type {object} */ (value)) };\n  const version = Number(document.schemaVersion);\n  if (!Number.isInteger(version) || version < 1) {\n    throw new EmailDocumentError('Unreadable document: missing schema version');\n  }\n  if (version > EMAIL_DOCUMENT_SCHEMA_VERSION) {\n    throw new EmailDocumentError(\n      `Document written by a newer version of the builder (schema ${version}) — ` +\n        'reload the page'\n    );\n  }\n  for (let v = version; v < EMAIL_DOCUMENT_SCHEMA_VERSION; v += 1) {\n    const migrate = MIGRATIONS[v];\n    if (!migrate) throw new EmailDocumentError(`Document: no migration from schema ${v}`);\n    document = migrate(document);\n  }\n\n  if (typeof document.engine !== 'string' || !document.engine) {\n    throw new EmailDocumentError('Unreadable document: missing engine');\n  }\n  if (!isPlainObject(document.project)) {\n    throw new EmailDocumentError('Unreadable document: missing engine project');\n  }\n\n  return {\n    schemaVersion: EMAIL_DOCUMENT_SCHEMA_VERSION,\n    engine: document.engine,\n    engineVersion: String(document.engineVersion || ''),\n    builderVersion: String(document.builderVersion || ''),\n    project: document.project,\n  };\n}\n\n/** @param {EmailDocument} document */\nexport function serializeDocument(document) {\n  return JSON.stringify(readDocument(document));\n}\n","// @ts-check\n/**\n * Images UPLOADED in the builder — one rule shared by the browser (immediate\n * rejection, storage/client.js) and the server (storage/server/assetFile.js).\n *\n * PNG, JPEG, GIF: the three formats every email client displays. WebP and SVG\n * do not display in Outlook, and an SVG can carry script.\n * The server reads the type from the file BYTES; the browser, from `file.type`.\n */\n\nimport { identity } from '../i18n/index.js';\n\n/** Maximum image size: beyond it, the email becomes slow to open. */\nexport const MAX_IMAGE_BYTES = 2 * 1024 * 1024;\n\n/** Accepted types → extension of the public key. */\nexport const IMAGE_TYPES = { 'image/png': 'png', 'image/jpeg': 'jpg', 'image/gif': 'gif' };\n\n/** Public key: 32 hex characters of the hash + extension. */\nexport const ASSET_KEY_PATTERN = /^[a-f0-9]{32}\\.(png|jpg|gif)$/;\n\nconst SIGNATURES = [\n  { type: 'image/png', bytes: [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a] },\n  { type: 'image/jpeg', bytes: [0xff, 0xd8, 0xff] },\n  { type: 'image/gif', bytes: [0x47, 0x49, 0x46, 0x38] },\n];\n\n/**\n * Image type detected from the file signature, or `null`.\n * @param {Uint8Array} bytes\n * @returns {{type: string, ext: string}|null}\n */\nexport function detectImage(bytes) {\n  if (!bytes || bytes.length < 8) return null;\n  const found = SIGNATURES.find((s) => s.bytes.every((b, i) => bytes[i] === b));\n  return found ? { type: found.type, ext: IMAGE_TYPES[found.type] } : null;\n}\n\n/**\n * Immediate rejection of a file the server would refuse, or `null`.\n * @param {{type?: string, size?: number}} file\n * @param {{t?: import('../i18n/index.js').Translate}} [options]\n */\nexport function imageUploadError(file, { t = identity } = {}) {\n  if (!(String(file?.type || '') in IMAGE_TYPES)) return t('Format rejected: PNG, JPEG or GIF expected');\n  if (Number(file?.size || 0) > MAX_IMAGE_BYTES) {\n    return t('Image too large: {max} MB maximum', { max: MAX_IMAGE_BYTES / (1024 * 1024) });\n  }\n  return null;\n}\n"],"mappings":";;;;;AAUO,IAAM,wBAAwB;AAE9B,IAAM,gCAAgC;AAKtC,IAAM,gBAAgB,CAAC,WAAW,QAAQ;AAM1C,IAAM,qBAAqB;;;ACelC,IAAM,aAAa,CAAC;AAEb,IAAM,qBAAN,cAAiC,MAAM;AAAA;AAAA,EAE5C,YAAY,SAAS;AACnB,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAChB;AACF;AAEA,SAAS,cAAc,OAAO;AAC5B,SAAO,QAAQ,KAAK,KAAK,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAMO,SAAS,eAAe,EAAE,QAAQ,eAAe,QAAQ,GAAG;AACjE,MAAI,CAAC,OAAQ,OAAM,IAAI,mBAAmB,0BAA0B;AACpE,MAAI,CAAC,cAAc,OAAO,EAAG,OAAM,IAAI,mBAAmB,kCAAkC;AAC5F,SAAO;AAAA,IACL,eAAe;AAAA,IACf;AAAA,IACA,eAAe,OAAO,iBAAiB,EAAE;AAAA,IACzC,gBAAgB;AAAA,IAChB;AAAA;AAAA,MAA6C;AAAA;AAAA,EAC/C;AACF;AAUO,SAAS,aAAa,KAAK;AAChC,MAAI,QAAQ;AACZ,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI;AACF,cAAQ,KAAK,MAAM,KAAK;AAAA,IAC1B,QAAQ;AACN,YAAM,IAAI,mBAAmB,mCAAmC;AAAA,IAClE;AAAA,EACF;AACA,MAAI,CAAC,cAAc,KAAK,EAAG,OAAM,IAAI,mBAAmB,sCAAsC;AAG9F,MAAI,WAAW,EAAE;AAAA,EAA2B,MAAQ;AACpD,QAAM,UAAU,OAAO,SAAS,aAAa;AAC7C,MAAI,CAAC,OAAO,UAAU,OAAO,KAAK,UAAU,GAAG;AAC7C,UAAM,IAAI,mBAAmB,6CAA6C;AAAA,EAC5E;AACA,MAAI,UAAU,+BAA+B;AAC3C,UAAM,IAAI;AAAA,MACR,8DAA8D,OAAO;AAAA,IAEvE;AAAA,EACF;AACA,WAAS,IAAI,SAAS,IAAI,+BAA+B,KAAK,GAAG;AAC/D,UAAM,UAAU,WAAW,CAAC;AAC5B,QAAI,CAAC,QAAS,OAAM,IAAI,mBAAmB,sCAAsC,CAAC,EAAE;AACpF,eAAW,QAAQ,QAAQ;AAAA,EAC7B;AAEA,MAAI,OAAO,SAAS,WAAW,YAAY,CAAC,SAAS,QAAQ;AAC3D,UAAM,IAAI,mBAAmB,qCAAqC;AAAA,EACpE;AACA,MAAI,CAAC,cAAc,SAAS,OAAO,GAAG;AACpC,UAAM,IAAI,mBAAmB,6CAA6C;AAAA,EAC5E;AAEA,SAAO;AAAA,IACL,eAAe;AAAA,IACf,QAAQ,SAAS;AAAA,IACjB,eAAe,OAAO,SAAS,iBAAiB,EAAE;AAAA,IAClD,gBAAgB,OAAO,SAAS,kBAAkB,EAAE;AAAA,IACpD,SAAS,SAAS;AAAA,EACpB;AACF;AAGO,SAAS,kBAAkB,UAAU;AAC1C,SAAO,KAAK,UAAU,aAAa,QAAQ,CAAC;AAC9C;;;AChHO,IAAM,kBAAkB,IAAI,OAAO;AAGnC,IAAM,cAAc,EAAE,aAAa,OAAO,cAAc,OAAO,aAAa,MAAM;AAGlF,IAAM,oBAAoB;AAEjC,IAAM,aAAa;AAAA,EACjB,EAAE,MAAM,aAAa,OAAO,CAAC,KAAM,IAAM,IAAM,IAAM,IAAM,IAAM,IAAM,EAAI,EAAE;AAAA,EAC7E,EAAE,MAAM,cAAc,OAAO,CAAC,KAAM,KAAM,GAAI,EAAE;AAAA,EAChD,EAAE,MAAM,aAAa,OAAO,CAAC,IAAM,IAAM,IAAM,EAAI,EAAE;AACvD;AAOO,SAAS,YAAY,OAAO;AACjC,MAAI,CAAC,SAAS,MAAM,SAAS,EAAG,QAAO;AACvC,QAAM,QAAQ,WAAW,KAAK,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5E,SAAO,QAAQ,EAAE,MAAM,MAAM,MAAM,KAAK,YAAY,MAAM,IAAI,EAAE,IAAI;AACtE;AAOO,SAAS,iBAAiB,MAAM,EAAE,IAAI,SAAS,IAAI,CAAC,GAAG;AAC5D,MAAI,EAAE,OAAO,MAAM,QAAQ,EAAE,KAAK,aAAc,QAAO,EAAE,4CAA4C;AACrG,MAAI,OAAO,MAAM,QAAQ,CAAC,IAAI,iBAAiB;AAC7C,WAAO,EAAE,qCAAqC,EAAE,KAAK,mBAAmB,OAAO,MAAM,CAAC;AAAA,EACxF;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/core/constants.js","../src/core/document.js","../src/validation/images.js"],"sourcesContent":["// @ts-check\n/**\n * Email builder constants.\n *\n * `EMAIL_BUILDER_VERSION` versions THIS package (UI, blocks, rendering);\n * `EMAIL_DOCUMENT_SCHEMA_VERSION` versions the stored JSON envelope (the\n * project JSON). Both are written with every template, so a document read by\n * a newer version knows whether it must be migrated (see `core/document.js`).\n */\n\nexport const EMAIL_BUILDER_VERSION = '0.7.0';\n\nexport const EMAIL_DOCUMENT_SCHEMA_VERSION = 1;\n\n/** @typedef {'desktop'|'mobile'} EmailDevice */\n\n/** @type {EmailDevice[]} */\nexport const EMAIL_DEVICES = ['desktop', 'mobile'];\n\n/** Content column width — the email client standard. */\nexport const EMAIL_CONTENT_WIDTH = 600;\n\n/** Mobile preview frame width (standard iPhone, the common worst case). */\nexport const EMAIL_MOBILE_WIDTH = 375;\n","// @ts-check\n/**\n * DOCUMENT envelope — what gets stored (the project JSON).\n *\n * HTML is only a compilation output; what gets edited is the engine's\n * project. It is not stored bare but wrapped with:\n *\n *   schemaVersion  the shape of THIS envelope (migrations, see MIGRATIONS);\n *   engine         the engine that can read `project` back;\n *   engineVersion  its version at write time;\n *   builderVersion the builder version that wrote it;\n *   project        the engine data, opaque to the rest of the code.\n *\n * A document from another engine, a future schema or a malformed one is\n * REJECTED on read rather than half-loaded: a template silently emptied and\n * then saved again would be lost.\n *\n * Dependency-free module: testable outside the browser.\n */\n\nimport { EMAIL_BUILDER_VERSION, EMAIL_DOCUMENT_SCHEMA_VERSION } from './constants.js';\n\n/**\n * @typedef {{\n *   schemaVersion: number,\n *   engine: string,\n *   engineVersion: string,\n *   builderVersion: string,\n *   project: Record<string, any>,\n * }} EmailDocument\n */\n\n/**\n * Envelope migrations, from N to N+1. Empty while only one schema exists; the\n * first entry will be `1: (doc) => ({ ...doc, schemaVersion: 2 })`.\n *\n * @type {Record<number, (document: any) => any>}\n */\nconst MIGRATIONS = {};\n\nexport class EmailDocumentError extends Error {\n  /** @param {string} message */\n  constructor(message) {\n    super(message);\n    this.name = 'EmailDocumentError';\n    this.status = 422;\n  }\n}\n\nfunction isPlainObject(value) {\n  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * @param {{engine: string, engineVersion: string, project: object}} parts\n * @returns {EmailDocument}\n */\nexport function createDocument({ engine, engineVersion, project }) {\n  if (!engine) throw new EmailDocumentError('Document: missing engine');\n  if (!isPlainObject(project)) throw new EmailDocumentError('Document: invalid engine project');\n  return {\n    schemaVersion: EMAIL_DOCUMENT_SCHEMA_VERSION,\n    engine,\n    engineVersion: String(engineVersion || ''),\n    builderVersion: EMAIL_BUILDER_VERSION,\n    project: /** @type {Record<string, any>} */ (project),\n  };\n}\n\n/**\n * Reads a document (object or JSON string), migrates it to the current schema\n * and validates it.\n *\n * @param {unknown} raw\n * @returns {EmailDocument}\n * @throws {EmailDocumentError}\n */\nexport function readDocument(raw) {\n  let value = raw;\n  if (typeof value === 'string') {\n    try {\n      value = JSON.parse(value);\n    } catch {\n      throw new EmailDocumentError('Unreadable document: invalid JSON');\n    }\n  }\n  if (!isPlainObject(value)) throw new EmailDocumentError('Unreadable document: object expected');\n\n  /** @type {any} */\n  let document = { ...(/** @type {object} */ (value)) };\n  const version = Number(document.schemaVersion);\n  if (!Number.isInteger(version) || version < 1) {\n    throw new EmailDocumentError('Unreadable document: missing schema version');\n  }\n  if (version > EMAIL_DOCUMENT_SCHEMA_VERSION) {\n    throw new EmailDocumentError(\n      `Document written by a newer version of the builder (schema ${version}) — ` +\n        'reload the page'\n    );\n  }\n  for (let v = version; v < EMAIL_DOCUMENT_SCHEMA_VERSION; v += 1) {\n    const migrate = MIGRATIONS[v];\n    if (!migrate) throw new EmailDocumentError(`Document: no migration from schema ${v}`);\n    document = migrate(document);\n  }\n\n  if (typeof document.engine !== 'string' || !document.engine) {\n    throw new EmailDocumentError('Unreadable document: missing engine');\n  }\n  if (!isPlainObject(document.project)) {\n    throw new EmailDocumentError('Unreadable document: missing engine project');\n  }\n\n  return {\n    schemaVersion: EMAIL_DOCUMENT_SCHEMA_VERSION,\n    engine: document.engine,\n    engineVersion: String(document.engineVersion || ''),\n    builderVersion: String(document.builderVersion || ''),\n    project: document.project,\n  };\n}\n\n/** @param {EmailDocument} document */\nexport function serializeDocument(document) {\n  return JSON.stringify(readDocument(document));\n}\n","// @ts-check\n/**\n * Images UPLOADED in the builder — one rule shared by the browser (immediate\n * rejection, storage/client.js) and the server (storage/server/assetFile.js).\n *\n * PNG, JPEG, GIF: the three formats every email client displays. WebP and SVG\n * do not display in Outlook, and an SVG can carry script.\n * The server reads the type from the file BYTES; the browser, from `file.type`.\n */\n\nimport { identity } from '../i18n/index.js';\n\n/** Maximum image size: beyond it, the email becomes slow to open. */\nexport const MAX_IMAGE_BYTES = 2 * 1024 * 1024;\n\n/** Accepted types → extension of the public key. */\nexport const IMAGE_TYPES = { 'image/png': 'png', 'image/jpeg': 'jpg', 'image/gif': 'gif' };\n\n/** Public key: 32 hex characters of the hash + extension. */\nexport const ASSET_KEY_PATTERN = /^[a-f0-9]{32}\\.(png|jpg|gif)$/;\n\nconst SIGNATURES = [\n  { type: 'image/png', bytes: [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a] },\n  { type: 'image/jpeg', bytes: [0xff, 0xd8, 0xff] },\n  { type: 'image/gif', bytes: [0x47, 0x49, 0x46, 0x38] },\n];\n\n/**\n * Image type detected from the file signature, or `null`.\n * @param {Uint8Array} bytes\n * @returns {{type: string, ext: string}|null}\n */\nexport function detectImage(bytes) {\n  if (!bytes || bytes.length < 8) return null;\n  const found = SIGNATURES.find((s) => s.bytes.every((b, i) => bytes[i] === b));\n  return found ? { type: found.type, ext: IMAGE_TYPES[found.type] } : null;\n}\n\n/**\n * Immediate rejection of a file the server would refuse, or `null`.\n * @param {{type?: string, size?: number}} file\n * @param {{t?: import('../i18n/index.js').Translate}} [options]\n */\nexport function imageUploadError(file, { t = identity } = {}) {\n  if (!(String(file?.type || '') in IMAGE_TYPES)) return t('Format rejected: PNG, JPEG or GIF expected');\n  if (Number(file?.size || 0) > MAX_IMAGE_BYTES) {\n    return t('Image too large: {max} MB maximum', { max: MAX_IMAGE_BYTES / (1024 * 1024) });\n  }\n  return null;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-NZIQF7IW.js → chunk-CTZ56YJG.js}

@@ -40,6 +40,7 @@ var GENERATION_ERRORS = {
   // The provider's side (providers.js). Never 401 to the browser: the key is the AI's, not the user's session.
   KEY_MISSING: { status: 502, message: "Connect an AI provider first: it needs a key." },
   KEY_REFUSED: { status: 502, message: "The AI provider refused the key. Check it, or use another one." },
+  MODEL_UNAVAILABLE: { status: 502, message: "The AI provider does not have this model. Choose another one." },
   MODEL_CREDITS: { status: 502, message: "The AI provider account has no credits left." },
   MODEL_BUSY: { status: 503, message: "The AI is busy right now. Try again in a minute." },
   MODEL_ERROR: { status: 502, message: "The AI provider could not answer. Try again." }
@@ -963,7 +964,7 @@ function reviewRewrite(original, rewritten, format) {
   return problems;
 }
 function createRewriter({ model, maxAttempts = 2 }) {
-  return async function rewrite(input, { signal } = {}) {
+  return async function rewrite(input, { signal, user } = {}) {
     const request = cleanRewriteInput(input);
     const messages = [{ role: "user", content: buildRewritePrompt(request) }];
     let lastProblem = "";
@@ -971,7 +972,7 @@ function createRewriter({ model, maxAttempts = 2 }) {
       signal?.throwIfAborted();
       let answer;
       try {
-        answer = await model({ system: REWRITE_SYSTEM_PROMPT, messages, schema: REWRITE_SCHEMA, signal, task: "rewrite" });
+        answer = await model({ system: REWRITE_SYSTEM_PROMPT, messages, schema: REWRITE_SCHEMA, signal, task: "rewrite", user });
       } catch (error) {
         if (error instanceof EmailGenerationError && error.code === "REFUSED") throw new EmailGenerationError("REWRITE_REFUSED");
         throw error;
@@ -1213,7 +1214,7 @@ ${request.text}`;
   return { usable: usable.slice(0, SUBJECT_COUNT), problems: usable.length >= SUBJECT_COUNT ? [] : problems };
 }
 function createSubjectSuggester({ model, maxAttempts = 2 }) {
-  return async function suggestSubjects(input, { signal } = {}) {
+  return async function suggestSubjects(input, { signal, user } = {}) {
     const request = cleanSubjectsInput(input);
     const messages = [{ role: "user", content: buildSubjectsPrompt(request) }];
     let best = [];
@@ -1221,7 +1222,7 @@ function createSubjectSuggester({ model, maxAttempts = 2 }) {
       signal?.throwIfAborted();
       let answer;
       try {
-        answer = await model({ system: SUBJECTS_SYSTEM_PROMPT, messages, schema: SUBJECTS_SCHEMA, signal, task: "subjects" });
+        answer = await model({ system: SUBJECTS_SYSTEM_PROMPT, messages, schema: SUBJECTS_SCHEMA, signal, task: "subjects", user });
       } catch (error) {
         if (error instanceof EmailGenerationError && error.code === "REFUSED") throw new EmailGenerationError("SUBJECTS_REFUSED");
         throw error;
@@ -1360,6 +1361,7 @@ var fr = {
   "No usable subject came back. Try again.": "Aucun objet utilisable n'a \xE9t\xE9 propos\xE9. R\xE9essayez.",
   "Connect an AI provider first: it needs a key.": "Connectez d'abord un fournisseur d'IA : il faut une cl\xE9.",
   "The AI provider refused the key. Check it, or use another one.": "Le fournisseur d'IA a refus\xE9 la cl\xE9. V\xE9rifiez-la ou utilisez-en une autre.",
+  "The AI provider does not have this model. Choose another one.": "Le fournisseur d'IA n'a pas ce mod\xE8le. Choisissez-en un autre.",
   "The AI provider account has no credits left.": "Le compte du fournisseur d'IA n'a plus de cr\xE9dits.",
   "The AI is busy right now. Try again in a minute.": "L'IA est occup\xE9e pour le moment. R\xE9essayez dans une minute.",
   "The AI provider could not answer. Try again.": "Le fournisseur d'IA n'a pas pu r\xE9pondre. R\xE9essayez.",
@@ -1387,7 +1389,22 @@ var fr = {
   "Runs on your own machine": "Tourne sur votre propre machine",
   "AI provider": "Fournisseur d'IA",
   "Key saved": "Cl\xE9 enregistr\xE9e",
-  "A key for {provider} is saved in this browser: Connect uses it, or paste another one.": "Une cl\xE9 {provider} est enregistr\xE9e dans ce navigateur : Connecter l'utilise, ou collez-en une autre."
+  "A key for {provider} is saved in this browser: Connect uses it, or paste another one.": "Une cl\xE9 {provider} est enregistr\xE9e dans ce navigateur : Connecter l'utilise, ou collez-en une autre.",
+  "Model": "Mod\xE8le",
+  "Choose a model": "Choisir un mod\xE8le",
+  "Free": "Gratuit",
+  "Free only": "Gratuits",
+  "Search the models": "Rechercher un mod\xE8le",
+  "Search the models\u2026": "Rechercher un mod\xE8le\u2026",
+  "Use \u201C{model}\u201D": "Utiliser \xAB {model} \xBB",
+  "No model matches.": "Aucun mod\xE8le ne correspond.",
+  "Loading the models of {provider}\u2026": "Chargement des mod\xE8les de {provider}\u2026",
+  "Paste the key to see all the models of {provider}.": "Collez la cl\xE9 pour voir tous les mod\xE8les de {provider}.",
+  "{provider} refused this key: its models could not be listed.": "{provider} a refus\xE9 cette cl\xE9 : ses mod\xE8les n'ont pas pu \xEAtre list\xE9s.",
+  "The list of models could not be loaded. The default model works, or type the id of another.": "La liste des mod\xE8les n'a pas pu \xEAtre charg\xE9e. Le mod\xE8le par d\xE9faut fonctionne, ou tapez l'identifiant d'un autre.",
+  "{count} models, the free ones first.": "{count} mod\xE8les, les gratuits en premier.",
+  "{count} models.": "{count} mod\xE8les.",
+  "{provider} lists no models here: type the id of the one you want.": "{provider} ne liste aucun mod\xE8le ici : tapez l'identifiant de celui que vous voulez."
 };
 
 // src/ai/i18n/index.js
@@ -1424,7 +1441,7 @@ function createEmailGenerator({ model, maxAttempts = 2, compile } = (
   {}
 )) {
   if (typeof model !== "function") throw new Error("createEmailGenerator: `model` must be a function");
-  async function generate(input, { signal } = {}) {
+  async function generate(input, { signal, user } = {}) {
     const request = cleanGenerateInput(input);
     if (!request.purpose && !request.details) {
       throw new EmailGenerationError("NOTHING_TO_GENERATE");
@@ -1436,7 +1453,7 @@ function createEmailGenerator({ model, maxAttempts = 2, compile } = (
     let lastProblem = "";
     for (let attempt = 1; attempt <= Math.max(1, maxAttempts); attempt += 1) {
       signal?.throwIfAborted();
-      const answer = await model({ system: SYSTEM_PROMPT, messages, schema: EMAIL_DRAFT_SCHEMA, signal, task: "generate" });
+      const answer = await model({ system: SYSTEM_PROMPT, messages, schema: EMAIL_DRAFT_SCHEMA, signal, task: "generate", user });
       let problems;
       try {
         const draft = parseDraft(answer);
@@ -1486,6 +1503,7 @@ var AI_PROVIDERS = Object.freeze({
     keyUrl: "https://openrouter.ai/keys",
     keyHint: "sk-or-",
     free: "Free models, with a free account",
+    publicModels: true,
     headers: { "X-Title": "Best Email Builder" },
     // Most free models reason before they answer: 5 000 to 12 000 tokens
     // before the email itself, which a limit of 16 000 cut short. Less
@@ -1588,6 +1606,66 @@ function resolveProvider(provider) {
   ] : AI_PROVIDERS["openai-compatible"];
   return define({ ...base, ...provider });
 }
+var NOT_A_WRITER = /embed|tts|audio|transcri|whisper|speech|voxtral|image|imagen|dall-e|sora|veo|lyria|music|moderation|realtime|(^|[-_/.])live($|[-_.])|search|computer-use|robotics|\baqa\b|nano-banana|deep-research|antigravity|guard|safety|ocr|rerank|translate|customtools|codex|^(davinci|babbage)|turbo-instruct/i;
+function writes(entry) {
+  const id = typeof entry?.id === "string" ? entry.id : "";
+  if (!id || NOT_A_WRITER.test(id)) return false;
+  const outputs = entry.architecture?.output_modalities;
+  if (Array.isArray(outputs) && !outputs.every((output) => output === "text")) return false;
+  return entry.capabilities?.completion_chat !== false;
+}
+var entryOf = (entry) => {
+  const id = String(entry.id).replace(/^models\//, "");
+  const price = entry.pricing;
+  return {
+    id,
+    name: String(entry.display_name || entry.name || id),
+    free: /:free$/.test(id) || price != null && Number(price.prompt) === 0 && Number(price.completion) === 0,
+    created: Number(entry.created) || (entry.created_at ? Date.parse(entry.created_at) / 1e3 : 0) || 0
+  };
+};
+var versionOf = (id) => Number(/(\d+(?:\.\d+)?)/.exec(id)?.[1] || 0);
+function orderModels(entries, defaultModel) {
+  const seen = /* @__PURE__ */ new Set();
+  const models = entries.filter((entry) => entry?.id && !seen.has(entry.id) && seen.add(entry.id));
+  const rank = (entry) => entry.id === defaultModel ? 0 : entry.free ? 1 : 2;
+  const dated = models.some((entry) => entry.created);
+  return models.map((entry, at) => ({ entry, at })).sort(
+    (a, b) => rank(a.entry) - rank(b.entry) || (dated ? (b.entry.created || 0) - (a.entry.created || 0) : versionOf(b.entry.id) - versionOf(a.entry.id)) || a.at - b.at
+  ).map(({ entry }) => Object.freeze({ id: entry.id, name: entry.name || entry.id, free: Boolean(entry.free) }));
+}
+async function listProviderModels(options = {}) {
+  const { apiKey = "", fetch: fetchImpl, signal } = options;
+  const provider = resolveProvider(options.provider ?? "openai-compatible");
+  if (provider.listModels) return orderModels(await provider.listModels({ apiKey, fetch: fetchImpl, signal }), provider.model);
+  const baseUrl = String(provider.baseUrl).replace(/\/+$/, "");
+  if (!baseUrl) return [];
+  if (!apiKey && !provider.keyless && !provider.publicModels) throw new EmailGenerationError("KEY_MISSING", `${provider.name}: no key`);
+  let response;
+  try {
+    response = await (fetchImpl || globalThis.fetch)(`${baseUrl}/models`, {
+      headers: { ...apiKey ? { Authorization: `Bearer ${apiKey}` } : {}, ...provider.headers },
+      signal
+    });
+  } catch (error) {
+    if (signal?.aborted || /** @type {any} */
+    error?.name === "AbortError") throw error;
+    throw new EmailGenerationError("MODEL_ERROR", `${provider.name}: ${/** @type {any} */
+    error?.message || error}`);
+  }
+  const text2 = await response.text();
+  if (!response.ok) {
+    throw new EmailGenerationError(failureCode(response.status, errorMessage(text2)), `${provider.name} ${response.status}: ${text2.slice(0, 300)}`);
+  }
+  let data;
+  try {
+    data = JSON.parse(text2);
+  } catch {
+    throw new EmailGenerationError("MODEL_ERROR", `${provider.name}: not JSON \u2014 ${text2.slice(0, 200)}`);
+  }
+  const entries = Array.isArray(data?.data) ? data.data : Array.isArray(data?.models) ? data.models : [];
+  return orderModels(entries.filter(writes).map(entryOf), provider.model);
+}
 var answerInstruction = (schema) => `
 
 # Answer format
@@ -1617,7 +1695,9 @@ function refusal(status, message) {
   if (/\bmodels?\b|harness|region|country|territory|not available|not allowed to (sample|access|use)/i.test(message)) return "MODEL_ERROR";
   return "KEY_REFUSED";
 }
+var missingModel = (status, message) => status === 404 && /\bmodel/i.test(message) || (status === 400 || status === 404) && /not a valid model|(unknown|invalid) model|model\b.*\b(not found|does not exist|no longer available)/i.test(message);
 function failureCode(status, message) {
+  if (missingModel(status, message)) return "MODEL_UNAVAILABLE";
   const refused = refusal(status, message);
   if (refused) return refused;
   if (status === 402 || /credit balance|insufficient[ _](quota|credits|balance)|exceeded your current quota/i.test(message)) return "MODEL_CREDITS";
@@ -1735,18 +1815,7 @@ function claudeEmailModel({
         { signal }
       ).finalMessage();
     } catch (error) {
-      const { status, name } = (
-        /** @type {any} */
-        error || {}
-      );
-      if (signal?.aborted || name === "AbortError" || name === "APIUserAbortError" || error instanceof EmailGenerationError) throw error;
-      const text2 = String(
-        /** @type {any} */
-        error?.error?.error?.message || /** @type {any} */
-        error?.message || error
-      );
-      if (typeof status !== "number") throw new EmailGenerationError("MODEL_ERROR", `Claude: ${text2.slice(0, 300)}`);
-      throw new EmailGenerationError(failureCode(status, text2), `Claude ${status}: ${text2.slice(0, 300)}`);
+      throw sdkFailure(error, signal);
     }
     if (message.stop_reason === "refusal") {
       throw new EmailGenerationError("REFUSED");
@@ -1757,6 +1826,20 @@ function claudeEmailModel({
     return message.content.filter((block) => block.type === "text").map((block) => block.text).join("");
   };
 }
+function sdkFailure(error, signal) {
+  const { status, name } = (
+    /** @type {any} */
+    error || {}
+  );
+  if (signal?.aborted || name === "AbortError" || name === "APIUserAbortError" || error instanceof EmailGenerationError) return error;
+  const text2 = String(
+    /** @type {any} */
+    error?.error?.error?.message || /** @type {any} */
+    error?.message || error
+  );
+  if (typeof status !== "number") return new EmailGenerationError("MODEL_ERROR", `Claude: ${text2.slice(0, 300)}`);
+  return new EmailGenerationError(failureCode(status, text2), `Claude ${status}: ${text2.slice(0, 300)}`);
+}
 function claudeProvider(options) {
   const { client, ...rest } = options || /** @type {any} */
   {};
@@ -1780,18 +1863,100 @@ function claudeProvider(options) {
       "max_tokens"
     ),
     maxTokens: rest.maxTokens ?? 32e3,
-    createModel: ({ apiKey }) => {
+    createModel: ({ apiKey, model }) => {
       let current = null;
       return async (request) => {
         const key = String(await apiKey() || "").trim();
         if (!key) throw new EmailGenerationError("KEY_MISSING", "Claude: no key");
-        if (!current || current.key !== key) current = { key, model: claudeEmailModel({ ...rest, client: await client(key) }) };
+        if (!current || current.key !== key) {
+          current = { key, model: claudeEmailModel({ ...rest, ...model ? { model } : {}, client: await client(key) }) };
+        }
         return current.model(request);
       };
+    },
+    listModels: async ({ apiKey, signal }) => {
+      const key = String(apiKey || "").trim();
+      if (!key) throw new EmailGenerationError("KEY_MISSING", "Claude: no key");
+      try {
+        const page = await (await client(key)).models.list({ limit: 100 }, { signal });
+        return (page?.data || []).map((entry) => ({
+          id: String(entry.id),
+          name: String(entry.display_name || entry.id),
+          created: entry.created_at ? Date.parse(entry.created_at) / 1e3 : 0
+        }));
+      } catch (error) {
+        throw sdkFailure(error, signal);
+      }
     }
   });
 }
 
+// src/ai/agent.js
+var AGENT_PROTOCOL = "best-email-builder/agent@1";
+var AGENT_ERROR_CODES = Object.freeze(["REFUSED", "TRUNCATED", "MODEL_UNAVAILABLE", "MODEL_CREDITS", "MODEL_BUSY", "MODEL_ERROR"]);
+var DEFAULT_TIMEOUT = 18e4;
+var statusCode = (status) => status === 429 || status === 503 || status === 504 || status === 529 ? "MODEL_BUSY" : "MODEL_ERROR";
+var isAgentCode = (code) => typeof code === "string" && AGENT_ERROR_CODES.includes(
+  /** @type {any} */
+  code
+);
+var errorText = (data) => {
+  const error = data?.error ?? data?.detail;
+  if (typeof error === "string") return error;
+  return String(error?.message || (error ? JSON.stringify(error) : ""));
+};
+function agentEmailModel(options) {
+  const { url, headers, fetch: fetchImpl, timeout = DEFAULT_TIMEOUT, name = "Agent" } = options || /** @type {any} */
+  {};
+  if (typeof url !== "string" || !url) throw new TypeError("agentEmailModel: `url` is required \u2014 the endpoint of your agent");
+  if (headers !== void 0 && typeof headers !== "function" && (typeof headers !== "object" || headers === null)) {
+    throw new TypeError("agentEmailModel: `headers` is an object, or a function of { task, user } that returns one");
+  }
+  const emailModel = async ({ system, messages, schema, signal, task = "generate", user }) => {
+    const call = fetchImpl || globalThis.fetch;
+    const own = typeof headers === "function" ? await headers({ task, user }) : headers;
+    signal?.throwIfAborted();
+    const controller = new AbortController();
+    const stop = () => controller.abort(signal?.reason);
+    signal?.addEventListener("abort", stop, { once: true });
+    let late = false;
+    const timer = timeout > 0 ? setTimeout(() => (late = true, controller.abort()), timeout) : null;
+    let response;
+    let text2;
+    try {
+      response = await call(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", Accept: "application/json", ...own },
+        body: JSON.stringify({ protocol: AGENT_PROTOCOL, task, system: system + answerInstruction(schema), messages, schema }),
+        signal: controller.signal
+      });
+      text2 = await response.text();
+    } catch (error) {
+      if (signal?.aborted) throw signal.reason ?? error;
+      if (late) throw new EmailGenerationError("MODEL_BUSY", `${name}: no answer after ${Math.round(timeout / 1e3)} s`);
+      throw new EmailGenerationError("MODEL_ERROR", `${name}: ${/** @type {any} */
+      error?.message || error}`);
+    } finally {
+      if (timer) clearTimeout(timer);
+      signal?.removeEventListener("abort", stop);
+    }
+    let data = null;
+    try {
+      data = JSON.parse(text2);
+    } catch {
+    }
+    if (!response.ok || data && typeof data === "object" && "error" in data && !("text" in data) && !("output" in data)) {
+      const said = data ? errorText(data) : text2;
+      const detail = `${name} ${response.status}: ${said.slice(0, 300)}`;
+      throw new EmailGenerationError(isAgentCode(data?.code) ? data.code : statusCode(response.ok ? 502 : response.status), detail);
+    }
+    if (typeof data?.text === "string") return data.text;
+    if (data?.output && typeof data.output === "object") return JSON.stringify(data.output);
+    return text2;
+  };
+  return Object.assign(emailModel, { url });
+}
+
 export {
   GENERATION_ERRORS,
   EmailGenerationError,
@@ -1821,10 +1986,14 @@ export {
   createEmailGenerator,
   AI_PROVIDERS,
   resolveProvider,
+  listProviderModels,
   failureCode,
   providerEmailModel,
   DEFAULT_CLAUDE_MODEL,
   claudeEmailModel,
-  claudeProvider
+  claudeProvider,
+  AGENT_PROTOCOL,
+  AGENT_ERROR_CODES,
+  agentEmailModel
 };
-//# sourceMappingURL=chunk-NZIQF7IW.js.map
+//# sourceMappingURL=chunk-CTZ56YJG.js.map