sapiens-mcp 1.94.0 → 1.95.0

package/dist/publicFetch.js

@@ -0,0 +1,221 @@
+import https from "node:https";
+import dns from "node:dns";
+import net from "node:net";
+/**
+ * Download de URL que veio de um AGENTE (sourceUrl de upload, ingest, fonte).
+ * No transporte remoto o pedido sai do NOSSO servidor no Vercel: sem esta
+ * régua, "sobe essa imagem" vira porta pra ler serviço interno ou o metadata
+ * da cloud (169.254.169.254).
+ *
+ * Três furos que o `fetch` com `redirect: "follow"` deixava abertos:
+ *   - o 3xx pra host privado: o fetch já tinha batido no destino quando o
+ *     `res.url` era conferido. Aqui cada salto é conferido ANTES do pedido.
+ *   - o nome público que resolve pra IP privado (127.0.0.1.nip.io): a régua de
+ *     texto não vê. Aqui a conferência é no `lookup` do socket, sobre TODOS os
+ *     endereços que o DNS devolve.
+ *   - o DNS que troca de resposta entre a conferência e a conexão (rebinding):
+ *     conferir num lookup e conectar noutro deixa a janela. Aqui o endereço
+ *     conferido é o mesmo em que o socket conecta.
+ */
+const MAX_REDIRECTS = 3;
+// [rede, prefixo]. Tudo que não é internet pública: loopback, RFC 1918,
+// link-local, CGNAT, documentação, benchmark, multicast e reservado.
+const IPV4_FORA = [
+    ["0.0.0.0", 8],
+    ["10.0.0.0", 8],
+    ["100.64.0.0", 10],
+    ["127.0.0.0", 8],
+    ["169.254.0.0", 16],
+    ["172.16.0.0", 12],
+    ["192.0.0.0", 24],
+    ["192.0.2.0", 24],
+    ["192.168.0.0", 16],
+    ["198.18.0.0", 15],
+    ["198.51.100.0", 24],
+    ["203.0.113.0", 24],
+    ["224.0.0.0", 3], // multicast + reservado + broadcast (224/4 e 240/4)
+];
+const IPV6_FORA = [
+    ["::", 128], // não especificado
+    ["::1", 128], // loopback
+    ["100::", 64], // descarte
+    ["2001:db8::", 32], // documentação
+    ["fc00::", 7], // ULA (a "rede privada" do IPv6)
+    ["fe80::", 10], // link-local
+    ["fec0::", 10], // site-local (obsoleto, ainda roteia em rede velha)
+    ["ff00::", 8], // multicast
+];
+function ipv4Num(ip) {
+    return ip.split(".").reduce((n, o) => n * 256 + Number(o), 0);
+}
+/** Os 16 bytes de um IPv6 válido (cauda IPv4 pontuada inclusa). */
+function ipv6Bytes(ip) {
+    let s = ip.toLowerCase().split("%")[0];
+    const cauda = s.match(/^(.*:)(\d+\.\d+\.\d+\.\d+)$/);
+    if (cauda) {
+        const n = ipv4Num(cauda[2]);
+        s = `${cauda[1]}${(n >>> 16).toString(16)}:${(n & 0xffff).toString(16)}`;
+    }
+    const [cabeca, resto] = s.split("::");
+    const a = cabeca ? cabeca.split(":") : [];
+    const b = resto ? resto.split(":") : [];
+    const grupos = resto === undefined ? a : [...a, ...Array(8 - a.length - b.length).fill("0"), ...b];
+    return grupos.flatMap((g) => {
+        const v = parseInt(g, 16);
+        return [v >> 8, v & 0xff];
+    });
+}
+function dentroIPv6(bytes, rede, prefixo) {
+    const r = ipv6Bytes(rede);
+    for (let bit = 0; bit < prefixo; bit += 8) {
+        const resta = Math.min(8, prefixo - bit);
+        const mascara = (0xff << (8 - resta)) & 0xff;
+        if ((bytes[bit / 8] & mascara) !== (r[bit / 8] & mascara))
+            return false;
+    }
+    return true;
+}
+/**
+ * true pra endereço que não é internet pública. IPv6 que carrega um IPv4 dentro
+ * (::ffff:127.0.0.1, o NAT64 64:ff9b::/96, o compatível ::a.b.c.d) é julgado
+ * pelo IPv4 que carrega. String que não é IP volta true: na dúvida, fora.
+ */
+export function isPrivateAddress(ip) {
+    const limpo = ip.replace(/^\[|\]$/g, "");
+    if (net.isIPv4(limpo)) {
+        const n = ipv4Num(limpo);
+        return IPV4_FORA.some(([rede, prefixo]) => {
+            const tamanho = 2 ** (32 - prefixo);
+            return Math.floor(n / tamanho) === Math.floor(ipv4Num(rede) / tamanho);
+        });
+    }
+    if (!net.isIPv6(limpo))
+        return true;
+    const b = ipv6Bytes(limpo);
+    const zeros = (de, ate) => b.slice(de, ate).every((x) => x === 0);
+    const mapeado = zeros(0, 10) && b[10] === 0xff && b[11] === 0xff;
+    const nat64 = b[0] === 0 && b[1] === 0x64 && b[2] === 0xff && b[3] === 0x9b && zeros(4, 12);
+    const compativel = zeros(0, 12) && !zeros(12, 16) && !(zeros(12, 15) && b[15] === 1);
+    if (mapeado || nat64 || compativel)
+        return isPrivateAddress(b.slice(12).join("."));
+    return IPV6_FORA.some(([rede, prefixo]) => dentroIPv6(b, rede, prefixo));
+}
+/**
+ * Recusa URL que não é https pra host público, pelo TEXTO: nome reservado e IP
+ * literal (que não passa por DNS, então o lookup abaixo não o veria). O nome
+ * comum passa aqui e é conferido no lookup do socket.
+ */
+export function assertPublicHttpsUrl(raw) {
+    let u;
+    try {
+        u = new URL(raw);
+    }
+    catch {
+        throw new Error(`sourceUrl não é uma URL válida: ${raw}`);
+    }
+    if (u.protocol !== "https:") {
+        throw new Error("sourceUrl precisa ser https.");
+    }
+    const h = u.hostname.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.$/, "");
+    const reservado = h === "localhost" ||
+        h.endsWith(".localhost") ||
+        h.endsWith(".local") ||
+        h.endsWith(".internal");
+    if (reservado || (net.isIP(h) && isPrivateAddress(h))) {
+        throw new Error(`Host não permitido: ${u.hostname}`);
+    }
+    return u;
+}
+// O lookup do socket: resolve, recusa se QUALQUER endereço for privado e
+// entrega ao socket exatamente os endereços conferidos. Com `all` (o
+// autoSelectFamily do Node 20+ pede a lista) devolve a lista; sem, o primeiro.
+const lookupPublico = (hostname, options, callback) => {
+    dns.lookup(hostname, { ...options, all: true }, (err, enderecos) => {
+        if (err)
+            return callback(err, "");
+        const privado = enderecos.find((e) => isPrivateAddress(e.address));
+        if (privado || !enderecos.length) {
+            const e = new Error(`Host não permitido: ${hostname} resolve pra ${privado?.address ?? "nada"}`);
+            e.code = "EHOSTPRIVADO";
+            return callback(e, "");
+        }
+        if (options.all)
+            return callback(null, enderecos);
+        callback(null, enderecos[0].address, enderecos[0].family);
+    });
+};
+/**
+ * GET em URL pública com redirect seguido NA MÃO (até 3 saltos, cada Location
+ * passa pela régua antes do pedido) e corpo com teto: o que passa de
+ * `maxBytes` é cortado no meio do download, não depois de ocupar a memória.
+ * `timeoutMs` vale pra cadeia inteira. Status não-2xx volta com ok=false pro
+ * chamador dar o próprio recado.
+ */
+export async function fetchPublicHttps(raw, { timeoutMs, maxBytes }) {
+    const signal = AbortSignal.timeout(timeoutMs);
+    let url = assertPublicHttpsUrl(raw);
+    for (let salto = 0;; salto++) {
+        const res = await pedir(url, signal);
+        const location = res.headers.location;
+        if (res.statusCode && [301, 302, 303, 307, 308].includes(res.statusCode) && location) {
+            res.resume();
+            if (salto >= MAX_REDIRECTS) {
+                throw new Error(`Redirecionamento demais (mais de ${MAX_REDIRECTS}) a partir de ${raw}.`);
+            }
+            url = assertPublicHttpsUrl(new URL(location, url));
+            continue;
+        }
+        const status = res.statusCode ?? 0;
+        const base = {
+            status,
+            statusText: res.statusMessage ?? "",
+            contentType: res.headers["content-type"]?.split(";")[0]?.trim() || undefined,
+            url,
+        };
+        if (status < 200 || status >= 300) {
+            res.resume();
+            return { ...base, ok: false, bytes: Buffer.alloc(0) };
+        }
+        return { ...base, ok: true, bytes: await lerComTeto(res, maxBytes, signal) };
+    }
+}
+function pedir(url, signal) {
+    return new Promise((resolve, reject) => {
+        const req = https.request(url, {
+            method: "GET",
+            // Sem pool: socket reaproveitado não passaria de novo pelo lookup.
+            agent: false,
+            lookup: lookupPublico,
+            signal,
+            headers: { accept: "*/*", "user-agent": "sapiens-mcp" },
+        });
+        req.on("response", resolve);
+        req.on("error", (e) => reject(signal.aborted ? erroDePrazo(url) : e));
+        req.end();
+    });
+}
+function lerComTeto(res, maxBytes, signal) {
+    const teto = `${Math.round(maxBytes / 1024 / 1024)} MB`;
+    const declarado = Number(res.headers["content-length"]);
+    if (declarado > maxBytes) {
+        res.destroy();
+        return Promise.reject(new Error(`Arquivo grande demais: ${(declarado / 1024 / 1024).toFixed(1)} MB (teto ${teto}).`));
+    }
+    return new Promise((resolve, reject) => {
+        const partes = [];
+        let total = 0;
+        res.on("data", (parte) => {
+            total += parte.byteLength;
+            if (total > maxBytes) {
+                res.destroy(new Error(`Arquivo grande demais: passou de ${teto} no download.`));
+                return;
+            }
+            partes.push(parte);
+        });
+        res.on("end", () => resolve(Buffer.concat(partes)));
+        res.on("error", (e) => reject(signal.aborted ? erroDePrazo(null) : e));
+    });
+}
+function erroDePrazo(url) {
+    return new Error(`O download passou do prazo${url ? ` (${url.host})` : ""}.`);
+}

package/dist/registry.js

@@ -161,7 +161,7 @@ export const TOOLS = {
         handler: stockVideo,
     },
     sapiens_brand: {
-        description: "Brand Sapiens (= Design System) — paleta + tipografia + voz + estilo de imagem + persona como FONTE ÚNICA de estilo (espelha o Estúdio de Brand do app). Sub-actions: list (oficiais curados + os custom do user, leve, grátis), get (1 brand completo por slug: voz + imageStyle + persona/logo; só oficial ou o próprio), generate (CRIA design system novo a partir de descrição em texto livre; Gemini monta tudo e já nasce com card premium gpt-image-2; 150 Sinapses pelo texto + o card no gpt-image-2-high a preço de catálogo, hoje 1350 Sinapses no total, reembolsa se falhar), refine (ajusta brand custom por feedback livre tipo 'fundo mais escuro'/'voz mais seca', ~75 Sinapses), reroll (regenera SÓ 1 peça voice|palette|imageStyle numa direção diferente, grátis), card ((re)gera o card premium, preço de catálogo do modelo), delete (apaga brand custom do próprio user), set_visibility (torna um brand custom do user público/privado: público = aparece no perfil + galeria da comunidade, qualquer logado adota), list_public (galeria de design systems PÚBLICOS da comunidade, opt-in pelos donos, com atribuição), adopt (clona um brand público/oficial numa cópia NOVA e PRIVADA na conta do user; persona é dropada), persona (pluga um personagem DO PRÓPRIO user como a cara recorrente das imagens do brand custom dele, por character=<slug|id> de sapiens_character action=list_mine, ou character=null pra tirar; as refs saem da galeria do personagem e o personagem precisa ter pelo menos uma imagem; grátis), favorite (marca, ou com isFavorite=false desmarca, um brand custom do user como o FAVORITO, o escolhido entre as tentativas de um projeto: sobe pro topo da list e dos seletores do app, as outras tentativas ficam guardadas; oficial não se favorita; grátis), import (TRANSCREVE um design system que JÁ EXISTE fora, de outro app, do Figma, do kit de um cliente: o que veio é o que grava, hex e fonte exatos, sem IA no meio, mesmo título e corpo na mesma família ou fonte fora do Google Fonts; grátis, o card nasce em SVG; o shape está no arg `brand`, e o retorno avisa em `warnings` o que pode não aparecer igual), logo (põe a logo no brand custom pelo ID da imagem na galeria do user, img_… de sapiens_gallery action=upload, ou handle=null pra tirar; grátis). Brand que a pessoa JÁ TEM vai por import, nunca por generate: o generate cria e reinterpreta. O personagem só APARECE na imagem quando a marca é persona: depois de plugar, gere com sapiens_image brandSlug=<slug> brandMark=persona. Qualquer conta logada; Sinapses saem do dono do sessionToken. Pra generate: converse com o user e monte uma description rica (vibe, cores, voz, públicos, refs; se ele colar amostra de texto dele, inclua pra a voz sair dali) ANTES de chamar. Confirme o custo (1350 Sinapses) antes de gerar. Valor explícito na descrição (hex, nome de fonte, nome) o generate respeita, mas pra copiar um brand inteiro o import é exato e de graça.",
+        description: "Brand Sapiens (= Design System) — paleta + tipografia + voz + estilo de imagem + persona como FONTE ÚNICA de estilo (espelha o Estúdio de Brand do app). Sub-actions: list (oficiais curados + os custom do user, leve, grátis), get (1 brand completo por slug: voz + imageStyle + persona/logo; só oficial ou o próprio), generate (CRIA design system novo a partir de descrição em texto livre; Gemini monta tudo e já nasce com card premium gpt-image-2; 150 Sinapses pelo texto + o card no gpt-image-2-high a preço de catálogo, hoje 1350 Sinapses no total, reembolsa se falhar), refine (ajusta brand custom por feedback livre tipo 'fundo mais escuro'/'voz mais seca', ~75 Sinapses), reroll (regenera SÓ 1 peça voice|palette|imageStyle numa direção diferente, grátis), card ((re)gera o card premium, preço de catálogo do modelo), delete (apaga brand custom do próprio user), set_visibility (torna um brand custom do user público/privado: público = aparece no perfil + galeria da comunidade, qualquer logado adota), list_public (galeria de design systems PÚBLICOS da comunidade, opt-in pelos donos, com atribuição), adopt (clona um brand público/oficial numa cópia NOVA e PRIVADA na conta do user; persona é dropada), persona (pluga um personagem DO PRÓPRIO user como a cara recorrente das imagens do brand custom dele, por character=<slug|id> de sapiens_character action=list_mine, ou character=null pra tirar; as refs saem da galeria do personagem e o personagem precisa ter pelo menos uma imagem; grátis), favorite (marca, ou com isFavorite=false desmarca, um brand custom do user como o FAVORITO, o escolhido entre as tentativas de um projeto: sobe pro topo da list e dos seletores do app, as outras tentativas ficam guardadas; oficial não se favorita; grátis), import (TRANSCREVE um design system que JÁ EXISTE fora, de outro app, do Figma, do kit de um cliente: o que veio é o que grava, hex e fonte exatos, sem IA no meio, mesmo título e corpo na mesma família ou fonte fora do Google Fonts; grátis, o card nasce em SVG; aceita o ARQUIVO DE DESIGN TOKENS como veio, DTCG ou Tokens Studio, mapeado por papel com o de-onde-saiu em `mapping`, ou o shape da casa; o retorno avisa em `warnings` o que pode não aparecer igual), font (sobe o ARQUIVO de uma fonte que não é do Google Fonts pro papel headline, body ou mono, por filePath, sourceUrl ou base64, até 2 MB, grátis; só fonte com licença pra web), logo (põe a logo no brand custom pelo ID da imagem na galeria do user, img_… de sapiens_gallery action=upload, ou handle=null pra tirar; grátis). Brand que a pessoa JÁ TEM vai por import, nunca por generate: o generate cria e reinterpreta. O personagem só APARECE na imagem quando a marca é persona: depois de plugar, gere com sapiens_image brandSlug=<slug> brandMark=persona. Qualquer conta logada; Sinapses saem do dono do sessionToken. Pra generate: converse com o user e monte uma description rica (vibe, cores, voz, públicos, refs; se ele colar amostra de texto dele, inclua pra a voz sair dali) ANTES de chamar. Confirme o custo (1350 Sinapses) antes de gerar. Valor explícito na descrição (hex, nome de fonte, nome) o generate respeita, mas pra copiar um brand inteiro o import é exato e de graça.",
         schema: brandSchema,
         handler: brand,
     },

package/dist/skills.js

@@ -926,7 +926,7 @@ O nome no topo, a marca no canto da capa e o @ do fecho saem de \`theme.signatur
 
 O design system da pessoa veste a peça inteira: a cor (\`theme.brand\`), a fonte do título e do corpo (\`theme.fonts\`), a voz do texto e a assinatura. No \`generate\`, \`brandSlug\` escolhe um brand que não é o padrão da conta. A cor de DESTAQUE (kicker, número, palavra-chave) é a cor do brand que lê no fundo e se separa do texto; pra trocar, ponha o mesmo hex em \`accent\` e \`kicker\` no update.
 
-Ela já tem identidade fora daqui (outro app, Figma, o kit de um cliente)? Traga com \`sapiens_brand action=import\`, que grava hex e fonte exatos e é grátis. O \`generate\` cria um brand novo e reinterpreta.
+Ela já tem identidade fora daqui (outro app, Figma, o kit de um cliente)? Traga com \`sapiens_brand action=import\`, que grava hex e fonte exatos e é grátis, e aceita o arquivo de design tokens do Figma como veio. O \`generate\` cria um brand novo e reinterpreta. Fonte que não é do Google Fonts (Fontshare, comprada) aparece na fonte da casa até alguém subir o arquivo dela: \`sapiens_brand action=font\`.
 
 ## Carrossel que vem de fora
 

package/dist/tools/brand.js

@@ -1,5 +1,7 @@
 import { z } from "zod";
-import { convexAction, convexQuery, convexMutation, getSessionToken, } from "../convexClient.js";
+import { readFile } from "node:fs/promises";
+import { convexAction, convexQuery, convexMutation, getSessionToken, isRemoteContext, } from "../convexClient.js";
+import { fetchPublicHttps } from "../publicFetch.js";
 /**
  * Brand Sapiens (= Design System). Espelha o Estúdio de Brand do app: um Brand
  * é a FONTE ÚNICA de estilo (paleta, tipografia, voz, estilo de imagem,
@@ -42,6 +44,10 @@ import { convexAction, convexQuery, convexMutation, getSessionToken, } from "../
  *               o kit de um cliente): o que veio é o que grava, sem IA no meio,
  *               fonte e hex exatos. Grátis (card nasce em SVG). É a porta de
  *               quem já tem brand; generate é a de quem quer um.
+ *   - font:     sobe o ARQUIVO de uma fonte do brand (a que não é do Google
+ *               Fonts: Fontshare, comprada, do cliente) pro papel headline,
+ *               body ou mono. Os bytes saem de filePath (stdio), sourceUrl
+ *               (https público) ou base64. De graça, até 2 MB.
  *   - logo:     põe a logo no brand custom pelo ID da imagem na galeria do
  *               user (img_…, de sapiens_gallery action=upload), ou tira
  *               (handle=null). De graça.
@@ -71,6 +77,7 @@ export const brandSchema = z.object({
         "favorite",
         "import",
         "logo",
+        "font",
     ]),
     slug: z
         .string()
@@ -79,7 +86,8 @@ export const brandSchema = z.object({
     brand: z
         .any()
         .optional()
-        .describe("Pra action=import: o design system que JÁ EXISTE, no shape do Brand da casa (o mesmo que action=get devolve). " +
+        .describe("Pra action=import: o design system que JÁ EXISTE. Serve o ARQUIVO DE DESIGN TOKENS como veio (DTCG com $value/$type, ou Tokens Studio com value/type: o servidor mapeia por papel lendo o caminho do token, color.brand.primary vira primary, color.text vira foreground, e devolve em `mapping` de onde saiu cada cor e fonte; aí mande o nome em `name`) " +
+        "OU o shape do Brand da casa (o mesmo que action=get devolve): " +
         "{ name (obrigatório, ≤40), tagline?, description?, " +
         "palette: { primary, secondary?, tertiary?, accent?, background, foreground, swatches?: [{name, hex}] }, " +
         "typography: { headline, body, mono? } (cada uma a família como string, ou {family, note}), " +
@@ -99,6 +107,26 @@ export const brandSchema = z.object({
         .nullable()
         .optional()
         .describe("Pra action=logo: o ID citável da imagem da logo na galeria do user (img_…). Suba antes com sapiens_gallery action=upload (PNG com fundo transparente é o ideal) e use o ID que voltar. null tira a logo."),
+    role: z
+        .enum(["headline", "body", "mono"])
+        .optional()
+        .describe("Pra action=font: o papel da fonte no brand (headline = título, body = corpo, mono = código)."),
+    family: z
+        .string()
+        .optional()
+        .describe("Pra action=font: o nome da família, como o CSS chama (ex: 'Clash Display'). Omita pra usar a família que o papel já tem no brand (o caso comum: o brand importado com Clash Display ganha o arquivo dela)."),
+    filePath: z
+        .string()
+        .optional()
+        .describe("Pra action=font: caminho ABSOLUTO do arquivo de fonte local (.woff2, .woff, .ttf, .otf). Só no MCP instalado (stdio); no remoto use sourceUrl."),
+    sourceUrl: z
+        .string()
+        .optional()
+        .describe("Pra action=font: URL https pública do arquivo de fonte (o servidor baixa e confere os bytes)."),
+    base64: z
+        .string()
+        .optional()
+        .describe("Pra action=font: o arquivo de fonte em base64, quando você já tem os bytes."),
     wordmark: z
         .string()
         .optional()
@@ -127,7 +155,7 @@ export const brandSchema = z.object({
     name: z
         .string()
         .optional()
-        .describe("Pra action=generate: o nome do brand (opcional, ≤40 chars). Vem exatamente como mandado; sem ele o Gemini sugere um."),
+        .describe("Pra action=generate e import: o nome do brand (≤40 chars). Vem exatamente como mandado. No generate, sem ele o Gemini sugere um; no import, vence o nome que vier dentro do arquivo."),
     fromSlug: z
         .string()
         .optional()
@@ -247,7 +275,7 @@ export async function brand(args) {
     // -------- import: transcreve brand de fora, sem IA (grátis) --------
     if (args.action === "import") {
         let raw = args.brand;
-        // Cliente que serializa `any` manda string JSON.
+        // Cliente que serializa `any` manda string JSON: confere aqui e segue.
         if (typeof raw === "string") {
             try {
                 raw = JSON.parse(raw);
@@ -262,8 +290,11 @@ export async function brand(args) {
         }
         const res = await convexAction("customBrandsActions:mcpImportBrand", {
             sessionToken,
-            brand: raw,
+            // Vai como TEXTO: o cliente do Convex recusa campo com `$` ($value,
+            // $type do design token) e fora do ASCII; o servidor faz o parse.
+            brand: JSON.stringify(raw),
             source: args.source?.trim() || undefined,
+            name: args.name?.trim() || undefined,
         });
         return {
             ...res,
@@ -272,7 +303,29 @@ export async function brand(args) {
                 res.slug +
                 " handle=img_…. Card premium (pago): action=card slug=" +
                 res.slug +
-                ". Usar no carrossel: no Tema do editor, ou o carrossel gerado com esse brand como padrão da conta.",
+                ". Carrossel nesse brand: sapiens_carrossel action=generate brandSlug=" +
+                res.slug +
+                " (ou escolha no Tema do editor).",
+        };
+    }
+    // -------- font: arquivo da fonte que não é do Google Fonts (grátis) --------
+    if (args.action === "font") {
+        if (!args.slug)
+            throw new Error("action=font exige slug de um brand custom SEU (pegue via action=list).");
+        if (!args.role)
+            throw new Error("action=font exige role=headline|body|mono (o papel da fonte no brand).");
+        const base64 = await resolveFontBytes(args);
+        const res = await convexAction("customBrandsActions:mcpUploadBrandFont", {
+            sessionToken,
+            slug: args.slug.trim(),
+            role: args.role,
+            ...(args.family?.trim() ? { family: args.family.trim() } : {}),
+            base64,
+        });
+        return {
+            ...res,
+            note: `Arquivo da ${res.family} no papel ${res.role}. O carrossel, o preview e a gaveta do brand passam a desenhar com ele. ` +
+                "Só suba fonte com licença pra uso na web (Google Fonts e Fontshare liberam; fonte comprada, confira a licença).",
         };
     }
     // -------- logo: pelo ID da imagem na galeria do user (grátis) --------
@@ -443,3 +496,26 @@ export async function brand(args) {
         };
     }
 }
+// Os bytes do arquivo de fonte: arquivo local (stdio), URL pública (o fetch roda
+// aqui, então com a mesma régua de host do upload da galeria) ou base64 pronto.
+// O formato quem confere é o servidor, pelos bytes.
+const FONT_MAX_BYTES = 2 * 1024 * 1024;
+async function resolveFontBytes(args) {
+    if (args.base64?.trim())
+        return args.base64.trim().replace(/^data:[^;]+;base64,/, "");
+    if (args.filePath) {
+        if (isRemoteContext())
+            throw new Error("filePath só funciona no MCP instalado (stdio). No remoto, mande sourceUrl.");
+        const buf = await readFile(args.filePath);
+        if (buf.byteLength > FONT_MAX_BYTES)
+            throw new Error("Arquivo de fonte grande demais (teto 2 MB). Prefira o .woff2.");
+        return buf.toString("base64");
+    }
+    if (args.sourceUrl) {
+        const res = await fetchPublicHttps(args.sourceUrl, { timeoutMs: 30_000, maxBytes: FONT_MAX_BYTES });
+        if (!res.ok)
+            throw new Error(`Baixar a fonte falhou: HTTP ${res.status}`);
+        return res.bytes.toString("base64");
+    }
+    throw new Error("action=font exige o arquivo: filePath (local, stdio), sourceUrl (https) ou base64.");
+}

package/dist/tools/gallery.js

@@ -2,6 +2,7 @@ import { z } from "zod";
 import { readFile } from "node:fs/promises";
 import { createHash } from "node:crypto";
 import { convexAction, convexMutation, convexQuery, describeConvexError, getSessionToken, isRemoteContext, } from "../convexClient.js";
+import { assertPublicHttpsUrl, fetchPublicHttps } from "../publicFetch.js";
 /**
  * Galeria do usuário: browse, publicação e UPLOAD de peça de fora.
  * Wrapper sobre `desktopMcp.galleryList` / `galleryGet` / `gallerySetPublic` e
@@ -208,39 +209,6 @@ function mimeFromPath(p) {
     const ext = p.split("?")[0].split("#")[0].split(".").pop()?.toLowerCase();
     return ext ? EXT_MIME[ext] : undefined;
 }
-/**
- * Recusa host que não é internet pública. O `sourceUrl` vem de um agente, e no
- * transporte remoto o fetch roda no NOSSO servidor: sem isto, "sobe essa
- * imagem" viraria uma porta pra ler serviço interno / metadata da cloud.
- */
-function assertPublicHttpsUrl(raw) {
-    let u;
-    try {
-        u = new URL(raw);
-    }
-    catch {
-        throw new Error(`sourceUrl não é uma URL válida: ${raw}`);
-    }
-    if (u.protocol !== "https:") {
-        throw new Error("sourceUrl precisa ser https.");
-    }
-    const h = u.hostname.toLowerCase().replace(/^\[|\]$/g, "");
-    const isPrivate = h === "localhost" ||
-        h.endsWith(".local") ||
-        h.endsWith(".internal") ||
-        h === "::1" ||
-        /^127\./.test(h) ||
-        /^0\./.test(h) ||
-        /^10\./.test(h) ||
-        /^192\.168\./.test(h) ||
-        /^169\.254\./.test(h) ||
-        /^172\.(1[6-9]|2\d|3[01])\./.test(h) ||
-        /^f[cd][0-9a-f]{2}:/.test(h);
-    if (isPrivate) {
-        throw new Error(`Host não permitido no upload: ${u.hostname}`);
-    }
-    return u;
-}
 /** Resolve sourceUrl | filePath | base64 nos bytes prontos pro Convex. */
 async function resolveUploadBytes(args) {
     if (args.base64?.trim()) {
@@ -262,24 +230,15 @@ async function resolveUploadBytes(args) {
     }
     if (args.sourceUrl) {
         const u = assertPublicHttpsUrl(args.sourceUrl);
-        const res = await fetch(u, {
-            redirect: "follow",
-            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        const res = await fetchPublicHttps(u, {
+            timeoutMs: FETCH_TIMEOUT_MS,
+            maxBytes: MAX_UPLOAD_BYTES,
         });
         if (!res.ok) {
             throw new Error(`Baixar a imagem falhou: HTTP ${res.status} ${res.statusText}`);
         }
-        // Revalida o destino final: um 3xx pra host privado seria o buraco que o
-        // assertPublicHttpsUrl da URL inicial não vê.
-        if (res.url)
-            assertPublicHttpsUrl(res.url);
-        const buf = Buffer.from(await res.arrayBuffer());
-        if (buf.byteLength > MAX_UPLOAD_BYTES) {
-            throw new Error(`Imagem grande demais: ${(buf.byteLength / 1024 / 1024).toFixed(1)} MB (teto 12 MB).`);
-        }
-        const headerMime = res.headers.get("content-type")?.split(";")[0]?.trim();
-        const mimeType = args.mimeType || mimeFromPath(u.pathname) || headerMime || "image/png";
-        return { base64: buf.toString("base64"), mimeType };
+        const mimeType = args.mimeType || mimeFromPath(u.pathname) || res.contentType || "image/png";
+        return { base64: res.bytes.toString("base64"), mimeType };
     }
     throw new Error("action=upload exige a peça: sourceUrl (https), filePath (local, stdio) ou base64.");
 }
@@ -324,20 +283,15 @@ async function resolveIngestBytes(args) {
     }
     if (args.sourceUrl) {
         const u = assertPublicHttpsUrl(args.sourceUrl);
-        const res = await fetch(u, {
-            redirect: "follow",
-            signal: AbortSignal.timeout(INGEST_FETCH_TIMEOUT_MS),
+        const res = await fetchPublicHttps(u, {
+            timeoutMs: INGEST_FETCH_TIMEOUT_MS,
+            maxBytes: MAX_INGEST_VIDEO_BYTES,
         });
         if (!res.ok) {
             throw new Error(`Baixar o render falhou: HTTP ${res.status} ${res.statusText}. URL de render expira (Kie em 24h, Magnific no mesmo dia): se passou do prazo, baixe de novo no provedor ou mande o arquivo por filePath.`);
         }
-        // Revalida o destino final: um 3xx pra host privado seria o buraco que o
-        // assertPublicHttpsUrl da URL inicial não vê.
-        if (res.url)
-            assertPublicHttpsUrl(res.url);
-        const headerMime = res.headers.get("content-type")?.split(";")[0]?.trim();
-        const mimeType = args.mimeType || mimeFromPath(u.pathname) || headerMime || "image/png";
-        const bytes = Buffer.from(await res.arrayBuffer());
+        const mimeType = args.mimeType || mimeFromPath(u.pathname) || res.contentType || "image/png";
+        const bytes = res.bytes;
         confereTeto(bytes, mimeType, "Render");
         return { bytes, mimeType, sourceKey: args.sourceUrl, sha256: hexDe(bytes) };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.94.0",
+  "version": "1.95.0",
   "mcpName": "com.sapiensinteticos/sapiens",
   "description": "MCP server pra operar o Sapiens Sintéticos (sapiensinteticos.com) pelo Claude Code: gerar imagem, escrever artigo, voz, música e mais, na sua conta. Login pelo código de sapiensinteticos.com/conectar-claude.",
   "type": "module",