sapiens-mcp 1.45.0 → 1.46.0

package/dist/prompts.js

@@ -89,8 +89,8 @@ export const SAPIENS_PROMPTS = [
         build: (a) => `Quero uma imagem de: "${a.cena}". Monte o prompt na regra da casa (full-bleed, ` +
             "sujeito oversized 70%+ do frame, sem moldura/margem, sem 'tarot card'). Confira " +
             "modelo e preço com sapiens_image action=models e meu saldo com sapiens_meta " +
-            "action=credits; me diga o custo antes de gerar. Se eu tiver studio montado e " +
-            "pedir 'do meu jeito', use useStudio=true. Depois de gerar, me mostre a url e " +
+            "action=credits; me diga o custo antes de gerar. Se eu pedir 'na minha marca' ou " +
+            "'com fulano', use brandSlug ou influencerId. Depois de gerar, me mostre a url e " +
             "ofereça publicar na galeria (sapiens_gallery action=publish).",
     },
 ];

package/dist/registry.js

@@ -143,7 +143,7 @@ export const TOOLS = {
         handler: brand,
     },
     sapiens_character: {
-        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). FICHA (generate_sheet, COBRA 450 Sinapses): desenha a página-pôster do personagem, uma folha só com pose, expressões, trocas de roupa e os adereços dele, no traço das imagens que ele já tem (exige pelo menos uma). A personalidade sai da alma (systemPrompt) e é ela que escolhe roupa e objeto, então personagem com alma escrita rende ficha melhor. Cada geração é um estilo NOVO e elas acumulam no personagem (campo sheets em action=get), não se sobrescrevem. É geração síncrona: se voltar Timeout, cheque action=get antes de repetir, senão cobra duas vezes. Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
+        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). FICHA (generate_sheet, COBRA 450 Sinapses): desenha a página-pôster do personagem no traço das imagens que ele já tem (exige pelo menos uma), em duas orientações (arg `orientation`): 'portrait' (default) é a página de processo, pose, expressões, trocas de roupa e adereços soltos na folha; 'landscape' é a prancha larga, com a volta completa à esquerda, a figura grande no meio, poses à direita, estudos de silhueta, expressão e detalhe embaixo e um painel CHARACTER ID na ponta. A personalidade sai da alma (systemPrompt) e é ela que escolhe roupa e objeto, então personagem com alma escrita rende ficha melhor. Cada geração é um estilo NOVO e elas acumulam no personagem (campo sheetUrls em action=get), nenhuma apaga a anterior, e a ficha já entra na galeria dele como referência das próximas gerações. É geração síncrona: se voltar Timeout, cheque action=get antes de repetir, senão cobra duas vezes. Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
         schema: characterSchema,
         handler: character,
     },

package/dist/skills.js

@@ -263,33 +263,24 @@ Aí não é geração base, é o Studio dela. Veja a skill \`studio\`.`,
     {
         name: "studio",
         title: "Meu Studio e a Emancipação",
-        description: "O studio é o perfil de EMPRESA da pessoa (obra, time, endereço público) e é também a identidade que o useStudio aplica na geração. Puxe quando ela disser 'do meu jeito', 'na minha marca', falar do studio dela, ou pedir casa própria.",
+        description: "O studio é a PÁGINA de portfólio da pessoa (obra, time, endereço público). Puxe quando ela falar do studio dela, quiser mostrar a casa, montar time, ou pedir casa própria.",
         body: `## O que o studio é
 
-O studio é o **perfil de empresa** da pessoa: um endereço público (\`sapiensinteticos.com/studios/<slug>\`) com a obra, o time e o que a casa faz. Não é uma paleta de ferramentas, e não tem níveis: isso morreu.
+O studio é a **página de portfólio** da pessoa: um endereço público (\`sapiensinteticos.com/studios/<slug>\`) com a obra, o time e o que a casa faz. Não é uma paleta de ferramentas, não tem níveis, e **não é identidade de geração**: isso morreu.
 
-Duas coisas moram nele, e vale separar:
+Uma pessoa pode ter até 4 studios e integrar até 4. \`sapiens_studios action=mine\` mostra o primário dela: nome, endereço público, marca e tamanho do time. O servidor resolve pela SESSÃO, você nunca passa id.
 
-- **A página.** Obra, time, sobre, capa, logo, folha. Quem edita é o membro, na própria página, no modo edição. Você não edita isso pelo MCP.
-- **A identidade de geração.** Marca e personagem-operador, que o \`useStudio\` aplica.
+Quem edita a página (obra, time, sobre, capa, logo, folha) é o membro, na própria página, no modo edição. Você não edita isso pelo MCP.
 
-Uma pessoa pode ter até 4 studios e integrar até 4. O que o \`useStudio\` aplica é o **primário** dela; o servidor resolve pela SESSÃO, você nunca passa id.
+## O studio NÃO entra na geração
 
-## Studio vs base: não misture
+Gerar imagem "no studio dela" não existe. Se ela pedir "na minha marca" ou "do meu jeito", o caminho é explícito e é seu:
 
-**Seguindo o studio:** \`sapiens_image\` com \`useStudio=true\`. O servidor acha o studio primário e aplica marca, personagem e vibe sozinho (o que você passar explícito vence). O retorno traz \`studioApplied=true\`.
+- **marca da casa** → \`sapiens_image\` com \`brandSlug\` (veja \`sapiens_brand\`);
+- **personagem dela** → \`influencerId\` (veja \`sapiens_character\`);
+- **o traço da casa** → \`templateSlug\`.
 
-Use quando ela disser "no meu studio", "na minha marca", "do meu jeito", "como sempre".
-
-**Geração avulsa:** \`sapiens_image\` SEM \`useStudio\` (\`studioApplied=false\`). Pra teste solto ou pedido fora da identidade.
-
-Ou é studio, ou é base. Não misture na mesma peça.
-
-## Antes de criar no studio
-
-\`sapiens_studios action=mine\` mostra nome, endereço público, marca, operador e o tamanho do time.
-
-Se você pediu \`useStudio=true\` e voltou \`studioApplied=false\`, a pessoa ainda não fundou uma casa: avise e aponte /dashboard/studio.
+Pergunte qual, não adivinhe.
 
 ## O time
 

package/dist/tools/character.js

@@ -24,6 +24,9 @@ import { convexQuery, convexMutation, convexAction, getSessionToken } from "../c
  *   - remove_image: tira UMA imagem do próprio personagem (por url).
  *   - set_main_image: define a principal (por url, entre as que já existem).
  *   - reorder_images: reordena as imagens (posição 0 = principal).
+ *   - generate_sheet: desenha a ficha do personagem (COBRA), vertical ou
+ *                   horizontal (`orientation`). A ficha entra na galeria dele e
+ *                   já serve de referência; elas acumulam.
  *   - delete:       apaga o próprio personagem (permanente).
  *
  * Fluxo típico de criação: create → add_image (1+) → set_card (opcional) →
@@ -72,7 +75,7 @@ export const characterSchema = z.object({
         .describe("Pra create/set_card: a 'alma' do personagem (personalidade, jeito de falar, contexto). Usado no chat e como guia de geração."),
     imageUrl: httpUrl()
         .optional()
-        .describe("Pra add_image: URL pública da imagem (Bunny CDN / Convex storage). Use a `url` que sapiens_image/sapiens_gallery devolvem. Pra remove_image/set_main_image: a url da imagem JÁ no personagem (pegue via action=get, campo imageUrls)."),
+        .describe("Pra add_image: URL pública da imagem (Bunny CDN / Convex storage). Use a `url` que sapiens_image/sapiens_gallery devolvem. Pra remove_image/set_main_image: a url da imagem JÁ no personagem (pegue via action=get, campo imageUrls, ou sheetUrls pra apagar uma ficha)."),
     orderedUrls: z
         .array(z.string())
         .optional()
@@ -89,6 +92,10 @@ export const characterSchema = z.object({
         .boolean()
         .optional()
         .describe("Pra set_visibility: true = público no Explorar (gera slug), false = privado."),
+    orientation: z
+        .enum(["portrait", "landscape"])
+        .optional()
+        .describe("Pra generate_sheet: 'portrait' (default) é a página de processo vertical, composição livre, sem texto. 'landscape' é a prancha larga: volta completa à esquerda, figura grande no meio, poses à direita, estudos de silhueta/expressão/detalhe embaixo e painel CHARACTER ID na ponta. As duas acumulam no personagem, uma não substitui a outra."),
 });
 export async function character(args) {
     // -------- list_public: catálogo global (sessionToken opcional, marca `mine`) --------
@@ -243,7 +250,9 @@ export async function character(args) {
     }
     // -------- generate_sheet: a ficha (página-pôster) do personagem --------
     // Geração SÍNCRONA que COBRA: cai na regra do timeout. Se voltar Timeout,
-    // NÃO repita às cegas: confira em action=get (campo sheets) se a peça caiu.
+    // NÃO repita às cegas: confira em action=get (campo imageUrls) se a peça caiu.
+    // A ficha entra na galeria do personagem, então já vira referência das
+    // próximas gerações sem passo extra.
     if (args.action === "generate_sheet") {
         if (!args.characterId)
             throw new Error("action=generate_sheet exige characterId.");
@@ -251,6 +260,7 @@ export async function character(args) {
         return await convexAction("characterSheetActions:mcpGenerateCharacterSheet", {
             sessionToken,
             influencerId: args.characterId,
+            orientation: args.orientation,
         });
     }
     // -------- delete: apaga o próprio personagem (permanente) --------

package/dist/tools/gallery.js

@@ -80,7 +80,7 @@ export const gallerySchema = z.object({
     prompt: z
         .string()
         .optional()
-        .describe("action=ingest: o prompt que a CASA escreveu pra essa peça. Vira a descrição na galeria e a busca acha por ele."),
+        .describe("action=ingest: o PROMPT DE GERAÇÃO, copiado inteiro do motor externo, exatamente como foi enviado. É o que a ficha mostra e a busca acha, e é o que permite regerar a peça depois. NÃO escreva aqui nota, resumo, título ou comentário sobre a peça: isso deixa a ficha sem sentido pra quem abrir. Re-ingerir a mesma sourceUrl com um prompt novo CORRIGE o que já está gravado, sem duplicar."),
     aspectRatio: z
         .string()
         .optional()

package/dist/tools/image.js

@@ -77,14 +77,10 @@ export const imageSchema = z.object({
         .string()
         .optional()
         .describe("Slug de um template de imagem (super-prompt travado da casa). Quando setado, o `prompt` vira só a CENA (quem + pose + objeto-conceito) e o template embrulha com o estilo + fundo + enquadramento + ref de traço da casa. Ex: 'retrato-sapiens-v1' = retrato editorial cartoon de UM personagem no grid verde Sapiens (mesma 'mão' dos artigos). O template define model/aspect/size default (sobreponíveis) e injeta a ref da Helen como âncora de traço quando você não passa referenceImageUrls própria (passar refs = trocar quem aparece, mantendo o estilo). Mutuamente exclusivo com brandSlug. Vale em action=generate, mode=create."),
-    useStudio: z
-        .boolean()
-        .optional()
-        .describe("Quando true, gera SEGUINDO o studio do user (o 'Meu Studio', ÚNICO, resolvido pela sessão — você NÃO passa id): marca + personagem-operador + a vibe + os presets do bloco de imagem entram sozinhos (o explícito sempre vence). O retorno traz studioApplied: true se aplicou o studio, false se caiu no Sapiens base (sem studio montado — aí avise o user). É o 'criar no meu studio' do Nível 2, e gerar assim faz o studio evoluir. SEM useStudio = geração base, fora da identidade dele: não misture. Cheque o studio com sapiens_studios action=mine. Vale em action=generate."),
     influencerId: z
         .string()
         .optional()
-        .describe("ID de personagem (influencer) pra character-lock. Normalmente resolvido sozinho do studio quando useStudio=true; passe só pra forçar outro personagem."),
+        .describe("ID de personagem (influencer) pra character-lock: a imagem sai com ESSE personagem. Descubra o id com sapiens_character."),
     loraIntensity: z
         .enum(["suave", "medio", "forte"])
         .optional()
@@ -216,25 +212,14 @@ export async function image(args) {
         brandSlug: args.brandSlug,
         brandMark: args.brandMark,
         templateSlug: args.templateSlug,
-        useStudio: args.useStudio,
         influencerId: args.influencerId,
         loraIntensity: args.loraIntensity,
     });
-    const studioApplied = result?.studioApplied === true;
     return {
         imageId: result?.imageId,
         url: result?.url,
         webUrl: result?.imageId ? `https://sapiensinteticos.com/imagem/${result.imageId}` : undefined,
         mimeType: result?.mimeType,
-        // studioApplied=true só quando useStudio achou e aplicou o studio do user.
-        // false = geração base. É o sinal pra não confundir studio com base.
-        studioApplied,
-        // Pediu o studio mas não há um montado: caiu no base, avise o user.
-        ...(args.useStudio && !studioApplied
-            ? {
-                note: "Você pediu o seu studio, mas não há um montado: gerei no Sapiens base. Monte o seu studio em sapiensinteticos.com/dashboard/studio (ferramentas + marca + a vibe).",
-            }
-            : {}),
         // Não incluir base64 no retorno (polui contexto). Quem quiser bytes
         // chama sapiens_gallery action=get com includeBase64=true.
     };

package/dist/tools/studios.js

@@ -15,7 +15,7 @@ import { convexAction, convexQuery, getSessionToken } from "../convexClient.js";
 export const studiosSchema = z.object({
     action: z
         .enum(["list", "get", "publishable_url", "mine", "emancipar", "module"])
-        .describe("mine = o SEU studio (o perfil de empresa da sua casa): nome, endereço público, marca, operador e tamanho do time, pra você gerar com useStudio. list/get = catálogo de estúdios da casa. publishable_url = URL de artigo. " +
+        .describe("mine = o SEU studio (a página de portfólio da sua casa): nome, endereço público, marca, operador e tamanho do time. list/get = catálogo de estúdios da casa. publishable_url = URL de artigo. " +
         "emancipar = INICIA a Emancipação (Nível 3 do Studio): puxa o blueprint-mestre pra VOCÊ (Claude) construir a casa PRÓPRIA do membro, na infra DELE (Vercel + Convex + domínio dele), FORA do Sapiens. Devolve a identidade do studio dele já hidratada + o índice de módulos + o guia da Fundação. " +
         "module = puxa o guia de UM módulo de infra pra continuar a construção (ex: fundacao, sapiens-connect, midia, telegram, email, auth)."),
     studio: z
@@ -149,11 +149,11 @@ const STUDIOS = {
     },
 };
 export async function studios(args) {
-    // action=mine: o studio PRIMÁRIO do user logado (o perfil de empresa da casa
-    // dele), resumo non-PII pro Claude saber o que está montado antes de gerar
-    // com useStudio. Os campos `level`/`levelLabel`/`tools` vêm vazios: os níveis
-    // e as ferramentas à la carte morreram quando o studio virou company page, e
-    // eles só continuam no retorno porque pacotes já publicados os imprimem.
+    // action=mine: o studio PRIMÁRIO do user logado (a página de portfólio da casa
+    // dele), resumo non-PII. Os campos `level`/`levelLabel`/`tools`/`imageVibe`/
+    // `studioMcpRuns` vêm vazios: os níveis e as ferramentas à la carte morreram
+    // quando o studio virou página, e a geração ancorada (`useStudio`) morreu com
+    // ela; só continuam no retorno porque pacotes já publicados os imprimem.
     if (args.action === "mine") {
         const sessionToken = getSessionToken();
         const studio = await convexAction("desktopMcp:studioMine", { sessionToken });

package/dist/tools/video.js

@@ -57,6 +57,12 @@ import { httpUrl } from "../schema.js";
  *                                   Motor puro: SEM áudio, SEM referência, SEM frame final.
  *   - sapiens-video-hailuo-pro     Hailuo 2.3 Pro — o mesmo em 1080p, 5s fixo (duração não é param).
  *                                   É o 1080p mais barato da casa depois do Seedance 1.0 Fast.
+ *   - sapiens-video-h3             MiniMax H3 — 2K (2560x1440) com ÁUDIO nativo, 5/6/8/10s (t2v/i2v),
+ *                                   frame final (role 'end'). O menor custo por pixel da prateleira.
+ *                                   Áudio vem sempre e já está no preço (não tem toggle). NÃO aceita
+ *                                   imagem de referência: no H3 isso é outro endpoint, ainda fora.
+ *                                   O provider faz até 15s; a casa para em 10 (o render de 5s leva
+ *                                   ~3min e o poll do backend morre em 8).
  *   - sapiens-video-wan            WAN 2.5 — imagem que fala/canta (áudio+lip-sync nativo), 5/10s (i2v)
  *   - sapiens-video-kling-motion   Kling Motion — transfere o movimento de um vídeo pra uma imagem
  *                                   (PRECISA de pessoa com tronco visível na imagem E no vídeo;
@@ -93,6 +99,7 @@ const VIDEO_MODELS = [
     "sapiens-video-kling",
     "sapiens-video-hailuo",
     "sapiens-video-hailuo-pro",
+    "sapiens-video-h3",
     "sapiens-video-wan",
     "sapiens-video-kling-motion",
     "sapiens-video-shot-mimic",
@@ -199,6 +206,7 @@ export const videoSchema = z.object({
         .describe("action=create: modelo de vídeo. 'sapiens-video-seedance' (cinematográfico+áudio, t2v/i2v), " +
         "'sapiens-video-kling' (anima imagem, i2v/t2v), 'sapiens-video-wan' (imagem que fala, i2v), " +
         "'sapiens-video-hailuo' (MiniMax, física e movimento, 768p 6/10s) e 'sapiens-video-hailuo-pro' (o mesmo em 1080p, 5s fixo) — os dois sem áudio, sem referência e sem frame final, " +
+        "'sapiens-video-h3' (MiniMax H3: 2K com áudio nativo, 5 a 10s, t2v/i2v e frame final; áudio incluso sem toggle, não aceita imagem de referência), " +
         "'sapiens-video-kling-motion' (motion transfer, precisa pessoa na imagem E no vídeo de movimento; vídeo de referência MÁX 10s, cobra pela duração do clipe), " +
         "'sapiens-video-shot-mimic' (recria o plano do vídeo de referência com seu personagem: mesma câmera, mesmos cortes; 'driving' = previs/clipe do plano MÁX 15s, 'start' = personagem), " +
         "'sapiens-video-lite/fast/quality' (Veo 3.1), " +
@@ -206,7 +214,7 @@ export const videoSchema = z.object({
     durationSec: z
         .number()
         .optional()
-        .describe("action=create (modelos WaveSpeed): duração em segundos. Seedance/Shot Mimic 4-15, Kling 3-15, WAN 5/10. " +
+        .describe("action=create (modelos WaveSpeed): duração em segundos. Seedance/Shot Mimic 4-15, Kling 3-15, WAN 5/10, H3 5/6/8/10. " +
         "Sem isso usa a config mais barata. O preço escala com a duração. " +
         "action=shadows: duração do vídeo-fonte, se souber (cobra 200/s; sem ela, flat ~2000)."),
     resolution: z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.45.0",
+  "version": "1.46.0",
   "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",
   "bin": {