best-email-builder 0.5.1 → 0.7.0

package/dist/{chunk-BAA5XMWY.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.",
@@ -1384,7 +1386,25 @@ var fr = {
   "Free models, with a free account": "Mod\xE8les gratuits, avec un compte gratuit",
   "Free tier, with rate limits": "Offre gratuite, avec des limites de d\xE9bit",
   'Free "Experiment" plan': "Offre gratuite \xAB Experiment \xBB",
-  "Runs on your own machine": "Tourne sur votre propre machine"
+  "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.",
+  "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
@@ -1421,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");
@@ -1433,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);
@@ -1483,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
@@ -1585,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
@@ -1614,6 +1695,15 @@ 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";
+  if (status === 429 || status === 503 || status === 529) return "MODEL_BUSY";
+  return "MODEL_ERROR";
+}
 function textOf(message) {
   const content = message?.content;
   if (typeof content === "string") return content;
@@ -1673,11 +1763,7 @@ function providerEmailModel(options = {}) {
           continue;
         }
         const detail = `${provider.name} ${response.status}: ${text2.slice(0, 300)}`;
-        const refused = refusal(response.status, errorMessage(text2));
-        if (refused) throw new EmailGenerationError(refused, detail);
-        if (response.status === 402) throw new EmailGenerationError("MODEL_CREDITS", detail);
-        if (response.status === 429 || response.status === 503 || response.status === 529) throw new EmailGenerationError("MODEL_BUSY", detail);
-        throw new EmailGenerationError("MODEL_ERROR", detail);
+        throw new EmailGenerationError(failureCode(response.status, errorMessage(text2)), detail);
       }
       let data;
       try {
@@ -1688,10 +1774,7 @@ function providerEmailModel(options = {}) {
       if (data?.error) {
         const code = Number(data.error.code) || 0;
         const detail = `${provider.name}: ${data.error.message || JSON.stringify(data.error).slice(0, 300)}`;
-        const refused = refusal(code, String(data.error.metadata?.raw || data.error.message || ""));
-        if (refused) throw new EmailGenerationError(refused, detail);
-        if (code === 429 || code === 503) throw new EmailGenerationError("MODEL_BUSY", detail);
-        throw new EmailGenerationError("MODEL_ERROR", detail);
+        throw new EmailGenerationError(failureCode(code, String(data.error.metadata?.raw || data.error.message || "")), detail);
       }
       const choice = data?.choices?.[0];
       if (choice?.message?.refusal) throw new EmailGenerationError("REFUSED", String(choice.message.refusal));
@@ -1719,16 +1802,21 @@ function claudeEmailModel({
     throw new Error("claudeEmailModel: pass an Anthropic client \u2014 `new Anthropic()` from @anthropic-ai/sdk");
   }
   return async ({ system, messages, schema, signal, task }) => {
-    const message = await client.messages.stream(
-      {
-        model,
-        max_tokens: maxTokens,
-        system,
-        messages,
-        output_config: { effort: task === "rewrite" || task === "subjects" ? rewriteEffort : effort, format: { type: "json_schema", schema } }
-      },
-      { signal }
-    ).finalMessage();
+    let message;
+    try {
+      message = await client.messages.stream(
+        {
+          model,
+          max_tokens: maxTokens,
+          system,
+          messages,
+          output_config: { effort: task === "rewrite" || task === "subjects" ? rewriteEffort : effort, format: { type: "json_schema", schema } }
+        },
+        { signal }
+      ).finalMessage();
+    } catch (error) {
+      throw sdkFailure(error, signal);
+    }
     if (message.stop_reason === "refusal") {
       throw new EmailGenerationError("REFUSED");
     }
@@ -1738,6 +1826,136 @@ 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} */
+  {};
+  if (typeof client !== "function") {
+    throw new TypeError("claudeProvider: `client` is a function that makes the Anthropic client from a key");
+  }
+  return Object.freeze({
+    id: "anthropic",
+    name: "Claude",
+    baseUrl: "https://api.anthropic.com",
+    model: rest.model || DEFAULT_CLAUDE_MODEL,
+    keyUrl: "https://console.anthropic.com/settings/keys",
+    keyHint: "sk-ant-",
+    free: null,
+    format: (
+      /** @type {const} */
+      "json_schema"
+    ),
+    tokens: (
+      /** @type {const} */
+      "max_tokens"
+    ),
+    maxTokens: rest.maxTokens ?? 32e3,
+    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, ...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,
@@ -1768,8 +1986,14 @@ export {
   createEmailGenerator,
   AI_PROVIDERS,
   resolveProvider,
+  listProviderModels,
+  failureCode,
   providerEmailModel,
   DEFAULT_CLAUDE_MODEL,
-  claudeEmailModel
+  claudeEmailModel,
+  claudeProvider,
+  AGENT_PROTOCOL,
+  AGENT_ERROR_CODES,
+  agentEmailModel
 };
-//# sourceMappingURL=chunk-BAA5XMWY.js.map
+//# sourceMappingURL=chunk-CTZ56YJG.js.map