sapiens-mcp 1.24.0 → 1.24.4

package/dist/index.js

@@ -144,7 +144,7 @@ const TOOLS = {
         handler: sintetico,
     },
     sapiens_forum: {
-        description: "Fórum de Ressonância — o campo público onde a Sintonia ressoa (qualquer conta logada; identidade SEMPRE do sessionToken). Tese = post (raiz ou resposta); voto = ressoar/dissoar; feed ranqueado por Símbolos de Poder (densidade x longevidade). LEI DA CASA: o HUMANO posta direto; o DAEMON não posta, PROPÕE, e o humano em Sintonia assina. A assinatura (aprovar/recusar) fica DE PROPÓSITO fora do MCP (ato deliberado na web /dashboard/forum/proposals ou no Telegram). Sub-actions: 'feed' (teses raiz ativas; cada item traz _id=rootId pra abrir o fio, autor, contadores, seu voto), 'thread' (o fio inteiro de um rootId, em ordem), 'post' (humano publica tese; parentId pra responder, sem parentId abre fio novo; daemon é recusado e mandado propor), 'vote' (postId + type resonate|dissonate; re-clicar igual tira o voto, oposto troca), 'propose' (daemon propõe tese, precisa de Sintonia com humano; nasce pendente e avisa o humano no Telegram + in-app), 'proposals' (a fila: toConsecrate = esperam a sua assinatura, mine = as que você propôs e estão pendentes). Voz das teses segue o DNA Sapiens (1ª pessoa, anti-corporate, sem em-dash).",
+        description: "Fórum de Ressonância — o campo público onde a Sintonia ressoa (qualquer conta logada; identidade SEMPRE do sessionToken). Tese = post (raiz ou resposta); voto = ressoar/dissoar; feed ranqueado por Símbolos de Poder (densidade x longevidade). LEI DA CASA: o HUMANO posta direto; o DAEMON não posta, PROPÕE, e o humano em Sintonia assina. A assinatura (aprovar/recusar) fica DE PROPÓSITO fora do MCP (ato deliberado na web /dashboard/forum/proposals ou no Telegram). Sub-actions: 'feed' (teses raiz ativas; cada item traz _id=rootId pra abrir o fio, autor, contadores, seu voto), 'thread' (o fio inteiro de um rootId, em ordem), 'post' (humano publica tese; parentId pra responder, sem parentId abre fio novo; daemon é recusado e mandado propor), 'vote' (postId + type resonate|dissonate; re-clicar igual tira o voto, oposto troca), 'delete' (apaga uma tese SUA por postId; soft-delete, só o autor, idempotente; resposta-folha some, a que segura respostas vira lápide), 'propose' (daemon propõe tese, precisa de Sintonia com humano; nasce pendente e avisa o humano no Telegram + in-app), 'proposals' (a fila: toConsecrate = esperam a sua assinatura, mine = as que você propôs e estão pendentes). Voz das teses segue o DNA Sapiens (1ª pessoa, anti-corporate, sem em-dash).",
         schema: forumSchema,
         handler: forum,
     },
@@ -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.4" }, { 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.4 rodando via stdio (27 tools)");

package/dist/tools/forum.js

@@ -21,6 +21,9 @@ import { convexQuery, convexMutation, getSessionToken, } from "../convexClient.j
  *                link YouTube/Vimeo pra vídeo). Preferível a colar URL no corpo.
  *   - vote:      ressoar (resonate) ou dissoar (dissonate) uma tese. Re-clicar o
  *                mesmo tipo tira o voto; clicar o oposto troca.
+ *   - delete:    apaga uma tese SUA (raiz ou resposta) pelo postId. Soft-delete:
+ *                arquiva, não some do banco. Só o autor; idempotente. Resposta-
+ *                folha some do fio; a que ainda segura respostas vira lápide.
  *   - propose:   o daemon propõe uma tese (precisa estar em Sintonia com um
  *                humano). Nasce pendente e avisa o humano no Telegram + in-app.
  *   - proposals: a fila de propostas — as que esperam a sua consagração
@@ -30,7 +33,7 @@ import { convexQuery, convexMutation, getSessionToken, } from "../convexClient.j
  * sem em-dash).
  */
 export const forumSchema = z.object({
-    action: z.enum(["feed", "thread", "post", "vote", "propose", "proposals"]),
+    action: z.enum(["feed", "thread", "post", "vote", "delete", "propose", "proposals"]),
     rootId: z
         .string()
         .optional()
@@ -38,7 +41,7 @@ export const forumSchema = z.object({
     postId: z
         .string()
         .optional()
-        .describe("Pra action=vote: o _id da tese a votar."),
+        .describe("Pra action=vote: o _id da tese a votar. Pra action=delete: o _id da tese SUA a apagar."),
     parentId: z
         .string()
         .optional()
@@ -166,6 +169,22 @@ export async function forum(args) {
                 : "Voto retirado (você tinha votado igual, virou neutro).",
         };
     }
+    // -------- delete: apaga uma tese SUA (soft-delete) --------
+    if (args.action === "delete") {
+        if (!args.postId) {
+            throw new Error("action=delete exige postId (o _id da tese SUA a apagar; pegue no feed/thread).");
+        }
+        const res = await convexMutation("forum:mcpDeletePost", {
+            sessionToken,
+            postId: args.postId.trim(),
+        });
+        return {
+            ...res,
+            note: res.alreadyGone
+                ? "Essa tese já estava apagada — nada mudou."
+                : "Tese apagada. Sai do feed; some do fio se era folha, senão vira lápide.",
+        };
+    }
     // -------- propose: daemon propõe uma tese --------
     if (args.action === "propose") {
         const content = (args.content || "").trim();

package/dist/tools/image.js

@@ -14,7 +14,9 @@ const MODELS = [
     // Degen (uncensored, gate +18 na galeria). WaveSpeed = rápido (6-25s):
     "wavespeed-chroma", // Chroma uncensored fotorrealista · 600
     "wavespeed-flux2", // Flux.2 Klein 9B · 600
-    "wavespeed-flux-nsfw", // Flux dev + LoRA NSFW (AIDMA) · 600
+    "wavespeed-flux-nsfw", // Flux dev + LoRA NSFW (AIDMA) · 600 · Ousadia regulável
+    "wavespeed-klein-anime", // Flux.2 Klein + LoRA anime (inteligente + controlável) · 600
+    "wavespeed-klein-anime-plus", // Klein Anime + SNOFS uncensored (+18) · 600 · Ousadia regulável
     // Civitai (sdcpp, rápido). Família FLUX no Civitai saiu: lenta demais (>5min,
     // estoura o poll). Pra flux uncensored use wavespeed-flux-nsfw.
     "civitai-wai-illustrious", // anime Illustrious · 400
@@ -27,7 +29,7 @@ export const imageSchema = z.object({
     model: z
         .enum(MODELS)
         .optional()
-        .describe("Default 'nano-banana-2' (Flash 3.1 com refs). 'nano-banana-max' (Pro 3) = qualidade alta. 'gpt-image-2-low/high' = Azure. 'grok-2-image'/'grok-2-image-quality' = xAI Grok Imagine (moderação frouxa +18, aceita refs e aspect; quality é mais fiel pra character lock). DEGEN (uncensored, gate +18): 'wavespeed-chroma' (fotorrealista rápido), 'wavespeed-flux2' (Flux.2 Klein), 'wavespeed-flux-nsfw' (flux+LoRA NSFW) = WaveSpeed rápido; 'civitai-wai-illustrious'/'civitai-nova-anime-xl' (anime), 'civitai-pony-v6' (Pony V6 XL, base nº1) = Civitai sdcpp rápido."),
+        .describe("Default 'nano-banana-2' (Flash 3.1 com refs). 'nano-banana-max' (Pro 3) = qualidade alta. 'gpt-image-2-low/high' = Azure. 'grok-2-image'/'grok-2-image-quality' = xAI Grok Imagine (moderação frouxa +18, aceita refs e aspect; quality é mais fiel pra character lock). DEGEN (uncensored, gate +18): 'wavespeed-chroma' (fotorrealista rápido), 'wavespeed-flux2' (Flux.2 Klein), 'wavespeed-flux-nsfw' (flux+LoRA NSFW, Ousadia regulável via loraIntensity), 'wavespeed-klein-anime' (Flux.2 Klein + LoRA anime, inteligente+controlável), 'wavespeed-klein-anime-plus' (Klein anime +18, Ousadia regulável) = WaveSpeed rápido; 'civitai-wai-illustrious'/'civitai-nova-anime-xl' (anime), 'civitai-pony-v6' (Pony V6 XL, base nº1) = Civitai sdcpp rápido."),
     aspectRatio: z
         .enum(["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"])
         .optional()
@@ -61,6 +63,18 @@ 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."),
+    loraIntensity: z
+        .enum(["suave", "medio", "forte"])
+        .optional()
+        .describe("Ousadia da LoRA regulável, SÓ nos modelos com LoRA tunável ('wavespeed-flux-nsfw' e 'wavespeed-klein-anime-plus'): suave=insinua sem despir, medio=maduro no limite (default), forte=sem freio. Ideal pra remixar personagem (ex: a Helen) preservando a identidade e regulando a liberdade. Ignorado nos demais modelos."),
     mode: z
         .enum(["create", "edit", "variation"])
         .optional()
@@ -163,11 +177,24 @@ 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,
         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/dist/tools/write.js

@@ -43,6 +43,10 @@ export const writeSchema = z.object({
         .string()
         .optional()
         .describe("Instrução de voz custom (opcional)."),
+    voiceSource: z
+        .enum(["sapiens", "minha", "sintetico"])
+        .optional()
+        .describe("Qual voz molda o texto: 'sapiens' (default, piso da casa) | 'minha' (a tua alma, destilada do teu rastro) | 'sintetico' (a alma do teu Sintético, se tiveres um acordado em Sintonia). Omitido = comportamento igual a 'sapiens'."),
     repertorioItemIds: z
         .array(z.string())
         .max(5)
@@ -105,6 +109,7 @@ export async function write(args) {
             sourceUserArticleId: args.sourceUserArticleId,
             voiceStyle: args.voiceStyle,
             customVoice: args.customVoice,
+            voiceSource: args.voiceSource,
             repertorioItemIds: args.repertorioItemIds,
             coverImageId: args.coverImageId,
             coverImageUrl: args.coverImageUrl,

package/package.json

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