sapiens-mcp 1.24.0 → 1.24.1

package/dist/index.js

@@ -198,10 +198,15 @@ Música (sapiens_musicator) é fluxo de 4 passos, EM ORDEM:
   4. get     passe o trackId e fique polando o status até 'ready' (ou 'failed').
   Pular pro lyrics/render sem create, ou sem os campos, sempre falha.
 
-Vídeo (sapiens_video) action=create EXIGE 'model': sapiens-video-seedance | kling | wan | kling-motion | lite | fast | quality. Sem model, falha de cara. Vídeo é o mais caro: confirme com o usuário antes.
+Vídeo (sapiens_video) action=create EXIGE 'model': sapiens-video-seedance | kling | wan | kling-motion | lite | fast | quality | omni. Sem model, falha de cara. O 'omni' (Gemini Omni) é SÓ text-to-video: texto vira clipe de 10s 720p com áudio nativo, ignora imagem/duração/resolução. Vídeo é o mais caro: confirme com o usuário antes.
 
 Imagem (sapiens_image) action=generate: prompt + model + aspectRatio. Referência via referenceImageUrls (galeria/Acervo/personagens) e/ou sourceImageIds. templateSlug aplica um super-prompt travado da casa.
 
+SEU STUDIO vs geração BASE (não confunda, é o ponto): o usuário tem UM "Meu Studio", único, que o servidor resolve pela SESSÃO. Você NUNCA passa id de studio: é sempre o studio dele. É a identidade configurada dele: marca + personagem-operador + por ferramenta os presets e a "vibe" (o estilo afinado).
+- Criar SEGUINDO o studio (na cara dele): sapiens_image com useStudio=true. O servidor acha o studio e aplica marca + personagem + vibe + presets sozinho (o que você passar explícito vence). O retorno traz studioApplied=true. Use quando ele diz "no meu studio", "na minha marca", "do meu jeito", "como sempre".
+- Geração AVULSA (Sapiens base, sem a identidade dele): sapiens_image SEM useStudio (studioApplied=false). Pra teste solto ou pedido fora da identidade. Não misture: ou é studio, ou é base.
+- Antes de criar no studio, cheque com sapiens_studios action=mine (nível, marca, operador, ferramentas, a vibe da imagem). Se você pediu useStudio e voltar studioApplied=false, o user não tem studio montado: avise e aponte /dashboard/studio. Gerar no studio faz ele evoluir de nível.
+
 Tirinha / Comic (sapiens_pipeline format=tirinha + sapiens_image): fluxo de 2 FASES, decida o MODO antes de gerar pixel.
   FASE 1 (roteiro): monte 3-6 painéis, cada um com a CENA visual e a FALA/legenda SEPARADAS. Salve em sapiens_pipeline create_production format=tirinha. O texto dos balões mora no payload (campos dialogue/caption), NUNCA dentro da imagem.
   FASE 2 (imagem), escolha UM dos dois modos (pergunte ao user, ou decida pelo caso):
@@ -214,7 +219,7 @@ Mídia no Fórum (PADRÃO, faça sempre assim): a peça vai EMBEDADA num card es
 Trilhas e Ritos de Fogo (sapiens_trilhas): 'list'/'get' pra navegar as trilhas; 'list_challenges' mostra os Ritos ativos + seu status; 'claim_mission' (missionId + proofText) envia a prova pra revisão do dono — o crédito em Sinapses sai na aprovação dele, não na hora. Não prometa Sinapse na hora do claim.
 
 Voz da casa: 1ª pessoa, direto, anti-corporate, sem travessão. Pra bom entendedor, meia palavra basta.`;
-const server = new Server({ name: "mcp-sapiens", version: "1.24.0" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
+const server = new Server({ name: "mcp-sapiens", version: "1.24.1" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -247,4 +252,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.24.0 rodando via stdio (27 tools)");
+console.error("mcp-sapiens v1.24.1 rodando via stdio (27 tools)");

package/dist/tools/image.js

@@ -61,6 +61,14 @@ 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."),
     mode: z
         .enum(["create", "edit", "variation"])
         .optional()
@@ -163,11 +171,23 @@ export async function image(args) {
         brandSlug: args.brandSlug,
         brandMark: args.brandMark,
         templateSlug: args.templateSlug,
+        useStudio: args.useStudio,
+        influencerId: args.influencerId,
     });
+    const studioApplied = result?.studioApplied === true;
     return {
         imageId: result?.imageId,
         url: result?.url,
         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

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { convexAction, getSessionToken } from "../convexClient.js";
 /**
  * Catálogo dos estúdios/experimentos Sapiens (v1.3).
  *
@@ -12,7 +13,9 @@ import { z } from "zod";
  * Por hora skills usam Claude-side + dashboard URL.
  */
 export const studiosSchema = z.object({
-    action: z.enum(["list", "get", "publishable_url"]),
+    action: z
+        .enum(["list", "get", "publishable_url", "mine"])
+        .describe("mine = o SEU studio ('Meu Studio', singular): nível, marca, operador e ferramentas, pra você gerar com useStudio. list/get = catálogo de estúdios da casa. publishable_url = URL de artigo."),
     studio: z
         .string()
         .optional()
@@ -148,6 +151,19 @@ const STUDIOS = {
     },
 };
 export async function studios(args) {
+    // action=mine: o STUDIO do user logado (o "Meu Studio", singular), resumo
+    // non-PII pro Claude saber o que está montado antes de gerar com useStudio.
+    if (args.action === "mine") {
+        const sessionToken = getSessionToken();
+        const studio = await convexAction("desktopMcp:studioMine", { sessionToken });
+        if (!studio) {
+            return {
+                studio: null,
+                note: "Você ainda não tem um studio. Crie em sapiensinteticos.com/dashboard/studio, escolha as ferramentas e ancore a sua marca.",
+            };
+        }
+        return { studio };
+    }
     if (args.action === "list") {
         return {
             count: Object.keys(STUDIOS).length,

package/dist/tools/video.js

@@ -16,6 +16,8 @@ import { convexAction, getSessionToken } from "../convexClient.js";
  *   - 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)
  *   - sapiens-video-lite/fast/quality   Veo 3.1 (2000/5000/25000 sinapses)
+ *   - sapiens-video-omni           Gemini Omni — texto -> vídeo 10s 720p com áudio nativo embutido.
+ *                                   SÓ text-to-video (não anima imagem: ignora references/durationSec/resolution).
  *
  * Custo: server-side por config (duração x resolução [x áudio]). i2v/motion usam
  * `references` em base64 (role 'start' = imagem inicial, 'end' = frame final,
@@ -31,6 +33,7 @@ const VIDEO_MODELS = [
     "sapiens-video-lite",
     "sapiens-video-fast",
     "sapiens-video-quality",
+    "sapiens-video-omni",
 ];
 export const videoSchema = z.object({
     action: z.enum(["create", "generate"]),
@@ -41,7 +44,8 @@ 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-kling-motion' (motion transfer, precisa pessoa na imagem E no vídeo de movimento), " +
-        "'sapiens-video-lite/fast/quality' (Veo 3.1)."),
+        "'sapiens-video-lite/fast/quality' (Veo 3.1), " +
+        "'sapiens-video-omni' (Gemini Omni: texto -> vídeo 10s 720p com áudio nativo; SÓ t2v, ignora imagem/duração/resolução)."),
     durationSec: z
         .number()
         .optional()

package/package.json

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