sapiens-mcp 1.52.0 → 1.53.0

package/dist/registry.js

@@ -128,7 +128,7 @@ export const TOOLS = {
         handler: video,
     },
     sapiens_stock_audio: {
-        description: "Banco de som da casa: trilha pronta E efeito sonoro (tabela stockAudio). Sub-actions de leitura (públicas, sem auth): categories (lista os moods/usos), list (busca com filtros mood/albumSlug/durationMax/search; kind='sfx' traz os EFEITOS: whoosh, clique, impacto, ambiência, foley — devolve {count, items} com title/url/durationSeconds/tags), get (1 item por audioId). Use pra puxar trilha/efeito pronto: pega a `url` e usa direto no ffmpeg. Não achou o efeito? generate (COBRA Sinapses, exige login) cria um novo por texto: prompt + durationSeconds (1-15, default 5) + provider ('mirelo' padrão 35 Sinapses/s mín 70 | 'elevenlabs' premium 60/s mín 120) + promptInfluence opcional (0..1, só elevenlabs: fidelidade ao texto, default 0.3), assíncrono — acompanhe com generation-status (generationId) até 'ready' (audioUrl; o efeito também entra no acervo kind=sfx) ou 'failed' (Sinapses reembolsadas). Efeito é CURTO (1-15s): música/trilha nova é no sapiens_musicator. Mood disponíveis: calmo, intenso, narrativo, épico, sombrio.",
+        description: "Banco de som da casa: trilha pronta E efeito sonoro (tabela stockAudio). Sub-actions de leitura (públicas, sem auth): categories (lista os moods/usos), list (busca com filtros mood/albumSlug/durationMax/search; kind='sfx' traz os EFEITOS: whoosh, clique, impacto, ambiência, foley — devolve {count, items} com title/url/durationSeconds/tags), get (1 item por audioId). Use pra puxar trilha/efeito pronto: pega a `url` e usa direto no ffmpeg. Não achou o efeito? generate (COBRA Sinapses, exige login) cria um novo por texto: prompt + durationSeconds (1-15, default 5) + provider ('mirelo' padrão 35 Sinapses/s mín 70 | 'elevenlabs' premium 60/s mín 120) + promptInfluence opcional (0..1, só elevenlabs: fidelidade ao texto, default 0.3), assíncrono — acompanhe com generation-status (generationId) até 'ready' (audioUrl; o efeito também entra no acervo kind=sfx) ou 'failed' (Sinapses reembolsadas). Efeito é CURTO (1-15s): música/trilha nova é no sapiens_musicator. Mood disponíveis: calmo, intenso, narrativo, épico, sombrio. Precisa de VOZ junto com trilha e efeito (anúncio, vinheta, cena de filme, podcast)? scene (COBRA Sinapses, exige login) cria a CENA INTEIRA num passe só, já batida, sem montar em pedaços e mixar depois: scenePrompt (a direção da cena, quem fala, com que timbre, o que toca atrás, a fala entre aspas) + durationSeconds (3-120, default 15) + loudnessRate/pitchRate/speechRate opcionais + withSubtitles opcional (traz o tempo de cada palavra), 11 Sinapses/s, assíncrono — acompanhe com scene-status (sceneId) até 'ready' (audioUrl + realDurationSeconds) ou 'failed' (Sinapses reembolsadas). A cena fica com o AUTOR e não entra no acervo compartilhado, porque carrega a voz e o roteiro de quem pediu.",
         schema: stockAudioSchema,
         handler: stockAudio,
     },

package/dist/tools/brand.js

@@ -15,7 +15,10 @@ import { convexAction, convexQuery, convexMutation, getSessionToken, } from "../
  *   - generate: cria um design system NOVO a partir de descrição em texto livre
  *               (Gemini monta paleta+tipografia+voz+imageStyle e já nasce com
  *               card premium gpt-image-2). Cobra ~950 Sinapses (texto + card),
- *               reembolsa se falhar. Identidade vem do sessionToken.
+ *               reembolsa se falhar. Identidade vem do sessionToken. Pode
+ *               partir do briefing de um brand JÁ SEU (fromSlug) e aplicar uma
+ *               torção (twist): é assim que se desenha várias direções pro
+ *               mesmo projeto sem redigitar o briefing a cada uma.
  *   - refine:   ajusta um brand custom existente por feedback em texto livre
  *               ("fundo mais escuro", "voz menos professoral"). ~75 Sinapses.
  *   - reroll:   regenera SÓ uma peça (voice | palette | imageStyle) numa direção
@@ -69,6 +72,14 @@ export const brandSchema = z.object({
         .string()
         .optional()
         .describe("Pra action=generate: nome sugerido pro brand (opcional, ≤40 chars). Sem isso o Gemini sugere um."),
+    fromSlug: z
+        .string()
+        .optional()
+        .describe("Pra action=generate: slug de um brand SEU cujo briefing vira a base da variação (o brand original não é tocado, nasce um novo). Com isso, `description` fica opcional. Só funciona em brand que guarda briefing (os criados a partir de ago/2026); veja em action=get, campo `brief`."),
+    twist: z
+        .string()
+        .optional()
+        .describe("Pra action=generate: a torção aplicada sobre o briefing ('mais bruto', 'mais editorial', 'paleta clara'). Combina com fromSlug (variação de um brand seu) ou com description (torção sobre o briefing que você acabou de escrever). ≤400 chars."),
     feedback: z
         .string()
         .optional()
@@ -113,19 +124,32 @@ export async function brand(args) {
         if (!b) {
             throw new Error(`Brand "${args.slug}" não encontrado (ou é custom de outro user). Veja os seus em action=list.`);
         }
-        return b;
+        return {
+            ...b,
+            // O briefing só vem em brand seu (ou oficial) e só existe nos criados a
+            // partir de ago/2026. Quando existe, é o atalho pra desenhar variações.
+            briefNote: b.brief?.text
+                ? `Esse brand guarda o briefing que gerou ele. Pra desenhar outra direção a partir dele: action=generate fromSlug=${b.slug} twist='mais bruto' (não toca neste aqui, nasce um brand novo).`
+                : "Esse brand não guarda o briefing (nasceu antes disso existir), então variação por fromSlug não funciona nele. Pra criar um parecido, escreva a description na mão.",
+        };
     }
     // -------- generate: cria design system novo (cobra Sinapses) --------
     if (args.action === "generate") {
         const description = (args.description || "").trim();
-        if (description.length < 30) {
+        const fromSlug = args.fromSlug?.trim();
+        // Com fromSlug o briefing vem do brand de origem (o servidor lê e confere a
+        // posse), então a description deixa de ser obrigatória.
+        if (!fromSlug && description.length < 30) {
             throw new Error("action=generate exige description com pelo menos 30 chars (vibe, cores, voz, referências). " +
-                "Quanto mais rico, melhor o brand. Converse com o user e monte a descrição antes de chamar.");
+                "Quanto mais rico, melhor o brand. Converse com o user e monte a descrição antes de chamar. " +
+                "Pra variar um brand que já é dele, use fromSlug=<slug> (+ twist='mais bruto').");
         }
         const res = await convexAction("customBrandsActions:mcpGenerateBrand", {
             sessionToken,
             description,
             name: args.name?.trim() || undefined,
+            fromSlug: fromSlug || undefined,
+            twist: args.twist?.trim() || undefined,
         });
         return {
             ...res,
@@ -138,7 +162,10 @@ export async function brand(args) {
                 res.slug +
                 " feedback='...'. Regenerar uma peça: action=reroll slug=" +
                 res.slug +
-                " piece=voice|palette|imageStyle.",
+                " piece=voice|palette|imageStyle. Outra direção do MESMO briefing: " +
+                "action=generate fromSlug=" +
+                res.slug +
+                " twist='mais bruto'.",
         };
     }
     // -------- refine: ajusta brand custom existente (cobra Sinapses) --------

package/dist/tools/stockAudio.js

@@ -17,10 +17,12 @@ import { convexQuery, convexAction, getSessionToken } from "../convexClient.js";
  */
 export const stockAudioSchema = z.object({
     action: z
-        .enum(["list", "get", "categories", "generate", "generation-status"])
+        .enum(["list", "get", "categories", "generate", "generation-status", "scene", "scene-status"])
         .describe("list = busca faixas/efeitos; get = 1 item por id; categories = moods/usos; " +
         "generate = cria efeito sonoro novo (COBRA Sinapses, assíncrono); " +
-        "generation-status = status de uma geração (até ready/failed)."),
+        "generation-status = status de uma geração (até ready/failed); " +
+        "scene = cria uma CENA de áudio completa, voz + trilha + efeito + ambiência num passe só " +
+        "(COBRA Sinapses, assíncrono); scene-status = status de uma cena (até ready/failed)."),
     limit: z
         .number()
         .int()
@@ -63,7 +65,9 @@ export const stockAudioSchema = z.object({
     durationSeconds: z
         .number()
         .optional()
-        .describe("action=generate: duração alvo em segundos, 1 a 15. Default 5. O custo escala por segundo."),
+        .describe("Duração alvo em segundos. action=generate: 1 a 15, default 5. action=scene: 3 a 120, default 15. " +
+        "O custo escala por segundo nos dois. Na CENA a duração não é parâmetro do modelo, ela sai da " +
+        "direção escrita: o alvo entra no pedido como instrução e o preço é acertado pela duração que voltou."),
     provider: z
         .enum(["mirelo", "elevenlabs"])
         .optional()
@@ -78,6 +82,46 @@ export const stockAudioSchema = z.object({
         .string()
         .optional()
         .describe("action=generation-status: o generationId que o generate devolveu."),
+    // --- action=scene (cena de áudio completa, Seed Audio 1.0) ---
+    scenePrompt: z
+        .string()
+        .optional()
+        .describe("action=scene: a DIREÇÃO da cena inteira, não só a fala. Diga quem fala, com que timbre e " +
+        "humor, em que idioma, o que toca atrás e o que se ouve no fundo, e ponha a fala entre aspas. " +
+        "Ex: 'Voz masculina adulta, calma e um pouco rouca, em português do Brasil. Estúdio à noite, " +
+        "um teclado bem baixo atrás. Ela fala: Sapiens Sintéticos, o Lab onde a sua ideia vira peça " +
+        "pronta.' Mín. 10 chars, máx. 2.000. Escreva como quem dirige, não como quem preenche campo: " +
+        "o modelo entende cena inteira e é daí que sai a qualidade."),
+    loudnessRate: z
+        .number()
+        .int()
+        .min(-50)
+        .max(100)
+        .optional()
+        .describe("action=scene: volume. -50 = metade, 100 = dobro. Default 0 (natural do modelo)."),
+    pitchRate: z
+        .number()
+        .int()
+        .min(-12)
+        .max(12)
+        .optional()
+        .describe("action=scene: tom da voz. Default 0 (natural do modelo)."),
+    speechRate: z
+        .number()
+        .int()
+        .min(-50)
+        .max(100)
+        .optional()
+        .describe("action=scene: velocidade da fala. -50 = metade, 100 = dobro. Default 0."),
+    withSubtitles: z
+        .boolean()
+        .optional()
+        .describe("action=scene: guarda a legenda com o tempo de cada palavra, pra casar texto com a fala " +
+        "sem transcrever depois. Default false."),
+    sceneId: z
+        .string()
+        .optional()
+        .describe("action=scene-status: o sceneId que o scene devolveu."),
 });
 export async function stockAudio(args) {
     if (args.action === "categories") {
@@ -102,6 +146,31 @@ export async function stockAudio(args) {
             promptInfluence: args.promptInfluence,
         });
     }
+    if (args.action === "scene") {
+        if (!args.scenePrompt || args.scenePrompt.trim().length < 10) {
+            throw new Error("action=scene exige scenePrompt (mín. 10 chars dirigindo a cena: quem fala, como, o que se ouve atrás).");
+        }
+        const sessionToken = getSessionToken();
+        return await convexAction("mcpExtrasActions:mcpAudioSceneGenerate", {
+            sessionToken,
+            scenePrompt: args.scenePrompt,
+            durationSeconds: args.durationSeconds,
+            loudnessRate: args.loudnessRate,
+            pitchRate: args.pitchRate,
+            speechRate: args.speechRate,
+            withSubtitles: args.withSubtitles,
+        });
+    }
+    if (args.action === "scene-status") {
+        if (!args.sceneId) {
+            throw new Error("action=scene-status exige sceneId (o que o scene devolveu).");
+        }
+        const sessionToken = getSessionToken();
+        return await convexQuery("mcpExtras:mcpAudioSceneStatus", {
+            sessionToken,
+            sceneId: args.sceneId,
+        });
+    }
     if (args.action === "generation-status") {
         if (!args.generationId) {
             throw new Error("action=generation-status exige generationId (o que o generate devolveu).");

package/package.json

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