sapiens-mcp 1.93.1 → 1.94.0

package/dist/registry.js

@@ -26,6 +26,7 @@ import { stockAudio, stockAudioSchema } from "./tools/stockAudio.js";
 import { voiceJp, voiceJpSchema } from "./tools/voiceJp.js";
 import { stockVideo, stockVideoSchema } from "./tools/stockVideo.js";
 import { brand, brandSchema } from "./tools/brand.js";
+import { collection, collectionSchema } from "./tools/collection.js";
 import { character, characterSchema } from "./tools/character.js";
 import { profile, profileSchema } from "./tools/profile.js";
 import { sintetico, sinteticoSchema } from "./tools/sintetico.js";
@@ -65,7 +66,7 @@ export const TOOLS = {
         handler: pipeline,
     },
     sapiens_carrossel: {
-        description: "O CARROSSEL do Instagram da pessoa, pelo agente (qualquer conta logada, só os carrosséis DELA). Puxe a skill 'carrossel' antes. Sub-actions: generate (gera do zero a partir de UMA fonte: brief, articleId de artigo publicado ou userArticleId de artigo dela; 350 Sinapses já com a escolha de fotos, estorna se falhar; model é a FORMA: feed (padrão, 9 slides), reflexao, case ou editorial; aspect é o TAMANHO: 4:5 (padrão, a folha que o feed mostra inteira) ou 9:16; devolve id + url do editor), list (os carrosséis dela, com id, título, nº de slides e url), get (payload inteiro + catálogo de layouts com os slots e limites de cada um, paletas, folhas e a assinatura: tudo pra VOCÊ escrever os slides), update (payload INTEIRO de volta, normalizado no servidor: mande o theme inteiro, com folha e assinatura, e o image de todo slide que não mexeu, senão volta pro padrão e a foto some), auto_images (a IA escolhe fotos do banco pros slides, 60 Sinapses, estorna se não tiver o que preencher; makeVisual converte slides de texto em layout de foto antes; generateMissing gera foto nova pros que o banco não cobrir, até 4, ~450 Sinapses cada, avise o custo antes), generate_image (foto nova pra UM slide, ~450 Sinapses, customPrompt opcional), set_image (põe no slide uma peça da pessoa ou pública pelo ID citável img_…, sem custo; é como ela usa as PRÓPRIAS fotos), cover (a Capa IA: capa 16:9 com a manchete QUEIMADA na imagem e um elemento vivo cruzando as letras; com carouselId fatia em duas e põe na frente do carrossel no lugar da capa IA anterior; cobra pelo motor da capa, confirme o custo antes). A ASSINATURA (theme.signature: o nome no topo, a marca no canto e o @ do fecho) nasce da marca da pessoa, ou do nome dela quando não tem marca; o @ é o dela no Instagram, não invente. O carrossel vai até 15 slides. generate, auto_images com generateMissing, generate_image e cover são SÍNCRONAS e pesadas: vale a REGRA DO TIMEOUT (confira em action=list antes de repetir). Baixar o arquivo é no editor (a url): aqui sai a receita pronta. O carrossel atrelado a uma jogada do Workflow segue pela sapiens_pipeline.",
+        description: "O CARROSSEL do Instagram da pessoa, pelo agente (qualquer conta logada, só os carrosséis DELA). Puxe a skill 'carrossel' antes. Sub-actions: generate (gera do zero a partir de UMA fonte: brief, articleId de artigo publicado ou userArticleId de artigo dela; 350 Sinapses já com a escolha de fotos, estorna se falhar; model é a FORMA: feed (padrão, 9 slides), reflexao, case ou editorial; aspect é o TAMANHO: 4:5 (padrão, a folha que o feed mostra inteira) ou 9:16; devolve id + url do editor), list (os carrosséis dela, com id, título, nº de slides e url), get (payload inteiro + catálogo de layouts com os slots e limites de cada um, paletas, folhas e a assinatura: tudo pra VOCÊ escrever os slides), update (payload INTEIRO de volta, normalizado no servidor: mande o theme inteiro, com folha e assinatura, e o image de todo slide que não mexeu, senão volta pro padrão e a foto some), auto_images (a IA escolhe fotos do banco pros slides, 60 Sinapses, estorna se não tiver o que preencher; makeVisual converte slides de texto em layout de foto antes; generateMissing gera foto nova pros que o banco não cobrir, até 4, ~450 Sinapses cada, avise o custo antes), generate_image (foto nova pra UM slide, ~450 Sinapses, customPrompt opcional), set_image (põe no slide uma peça da pessoa ou pública pelo ID citável img_…, sem custo; é como ela usa as PRÓPRIAS fotos), cover (a Capa IA: capa 16:9 com a manchete QUEIMADA na imagem e um elemento vivo cruzando as letras; com carouselId fatia em duas e põe na frente do carrossel no lugar da capa IA anterior; cobra pelo motor da capa, confirme o custo antes). A ASSINATURA (theme.signature: o nome no topo, a marca no canto e o @ do fecho) nasce da marca da pessoa, ou do nome dela quando não tem marca; o @ é o dela no Instagram, não invente. O BRAND veste a peça inteira: cor (o destaque é a cor do brand que lê no fundo, trocável no editor), fonte do título e do corpo, voz e assinatura; no generate, brandSlug escolhe outro brand que não o padrão da conta. Carrossel que vem de FORA entra pelo update: cada slide de lá casa com um layout do catálogo do get pelo papel (capa, corpo, cta) e pela foto, e o estilo vem do brand (sapiens_brand action=import), não do layout. O carrossel vai até 15 slides. generate, auto_images com generateMissing, generate_image e cover são SÍNCRONAS e pesadas: vale a REGRA DO TIMEOUT (confira em action=list antes de repetir). Baixar o arquivo é no editor (a url): aqui sai a receita pronta. O carrossel atrelado a uma jogada do Workflow segue pela sapiens_pipeline.",
         schema: carrosselSchema,
         handler: carrossel,
     },
@@ -160,10 +161,15 @@ 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). 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.",
+        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.",
         schema: brandSchema,
         handler: brand,
     },
+    sapiens_collection: {
+        description: "Collections do Acervo: o álbum de QUALQUER peça (imagem, vídeo, design system, personagem, música, artigo, aula, carrossel), operado na conta do user. Uma Collection junta as peças de um mesmo mundo, e cada peça leva uma NOTA do dono. É o lugar do ESCOLHIDO entre as tentativas de um projeto: junte as tentativas e a escolhida na mesma Collection, nota 'escolhida' na que venceu e 'tentativa' nas outras, e a escolhida no topo (reorder). Sub-actions: list (as Collections do user), get (uma, por id ou slug, com as peças na ordem e as notas), create (title obrigatório; nasce rascunho e privada), update (nome e descrição), add (itemType + refId, note opcional; peça que já está dentro e chega com note tem a nota trocada), remove (tira a peça da Collection, a peça em si não é tocada), note (troca a nota; sem note, apaga), reorder (refIds na ordem nova, o primeiro no topo; os não citados vêm depois, como estavam). itemType: image e video (o id que sapiens_image, sapiens_video e sapiens_gallery devolvem), brand (o design system, pelo SLUG mesmo), character (characterId), track, article, aula, carousel, comic, sticker, fita, app. A Collection se acha pelo id ou pelo slug, e o nome também serve. Só mexe nas Collections e nas peças da própria conta. Publicar a Collection e escolher capa são gestos do dono no Acervo, nunca do agente. Grátis.",
+        schema: collectionSchema,
+        handler: collection,
+    },
     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 form/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/lema em inglês/nome/nome por extenso/forma do próprio), set_presence (escreve onde o personagem existe FORA da casa: redes sociais por handle, Fanvue, site e o email dele, este último privado), set_passport (escreve o PASSAPORTE dele: como ACERTAR este ser, que é outra coisa de quem ele é. Guarda o `descriptor` de geração em inglês pra colar verbatim, o `negative` travado que fica sempre ligado, os `locks` (o que TRAVA nele, um por entrada, que é a lista que vira as perguntas da conferência), as `refs` por PAPEL (proporção, rosto, tatuagem: ref sem papel ninguém sabe usar), as `recipes` medidas por tipo de peça (com o prompt VERBATIM, porque o valor está na palavra exata que funcionou) e o `discarded`, o que já foi recusado. Esse último não é enfeite: o motor traz de volta o que ninguém proibiu, então ideia descartada sem negativo escrito volta sozinha na leva seguinte. É MERGE por campo, então mandar só o negative não apaga o descritor, e campo vazio apaga. Só o DONO lê: receita de produção não sai em personagem público. Em action=get ele volta em duas formas, `passport` (campo a campo, o que se reedita) e `passportPrompt` (o bloco já montado pra colar). Preencha sempre que uma rodada medir algo que a próxima não deve redescobrir: é o que faz a receita viajar pra fora do repo), activate (tira do rascunho e libera o personagem pra USAR nas gerações do dono; exige ≥1 imagem. NÃO torna público: quem publica é set_visibility, e ativar é gesto reversível e privado), set_visibility (isPublic true=Explorar+slug / false=privado), set_hidden (hidden true tira o personagem da TELA do dono: some da lista de personagens e as peças geradas com ele saem da galeria de fotos, vídeos e rascunhos do dono, voltando pelo filtro Ocultos; hidden false devolve. É o gesto de quem vai compartilhar tela. Não despublica, não apaga, não sai dos seletores de geração, e personagem oculto não publica até ser mostrado. Grátis. O list_mine traz `hidden` em cada personagem). 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). FORMA (`form`, o que tipo de CORPO ele tem: human default, humanoid, animal (bicho real), creature (ser inventado), object, abstract): não é enfeite de cadastro, é o que a ficha, as figurinhas e o vídeo leem pra decidir se descrevem rosto e mãos ou silhueta e postura, e é ele que impede uma criatura de voltar desenhada como pessoa. Mande no create sempre que o personagem não for gente; personagem que já existe sem ele conserta com set_card form=creature. Ausente = human, que é o que a casa desenhava antes do campo existir. NOME E NOME POR EXTENSO (`name` e `fullName`): `name` é como o personagem é CHAMADO e é o que toda tela desenha; `fullName` é o nome inteiro, pra quem tem apelido ('Crow Girl' na tela, 'Kaia Crowe' por extenso). Um não substitui o outro, e o extenso não mexe no slug da página nem no cartão de nome do vídeo: batizar personagem que já existe não muda endereço publicado nem assinatura de peça que já saiu. Vem em action=get e list_mine no campo `fullName` (null = ainda sem nome por extenso). TRAÇO (`style`, em que TÉCNICA ele é feito: auto default, realista, anime, manhwa, 3d, custom): irmão da forma, e a divisão é limpa, a forma diz que CORPO é esse e o traço diz como ele é DESENHADO. As mesmas três peças leem daqui. No 'auto' a peça não afirma técnica nenhuma e as imagens de referência mandam; 'realista' é fotografia, 'anime' é cel shading com contorno de tinta, 'manhwa' é pintura de webtoon, '3d' é render com material e oclusão, 'custom' usa a linha escrita em `styleNote` (até 140 caracteres, ex: aquarela sobre papel texturizado). Mande sempre que o personagem tiver técnica definida: até ago/2026 a ficha cravava vocabulário de desenho e devolvia personagem fotográfico virado em ilustração. Conserto sem custo em quem já existe: set_card style=realista. PRESENÇA (set_presence, de graça): o ENDEREÇO do personagem, o que faltava pra ele existir fora da ficha. `socials` é {rede: handle} nas redes instagram, tiktok, youtube, x, threads, bluesky, twitch, spotify, fanvue, patreon, onlyfans, telegram; `websiteUrl` é o site dele e `email` é o email do personagem, o que cadastra e recupera as contas dele nas redes. As redes e o site são PÚBLICOS; o email é PRIVADO e fica só com o dono, mesmo com o personagem publicado, porque email é chave de conta e isca de spam, não canal de contato. Em action=get e list_public de personagem de OUTRA pessoa, o campo simplesmente não vem. É MERGE: mandar {fanvue:'helen'} não apaga o instagram, e pra apagar uma rede se manda ela vazia. O que volta em action=get são as duas formas, `presence` (o handle cru, que é o que se reedita) e `presenceLinks` (o link já montado, pra mostrar sem remontar URL na mão). Vale a pena preencher quando o personagem TEM conta de verdade: é o que separa uma ficha de um ser com endereço, e a página pública dele desenha as redes e o site (nunca o email). FICHA (generate_sheet, COBRA 650 Sinapses, o preço do GPT Image 2.5 Sunburst, que desenha; se ele recusar, a ficha refaz no Nano Banana 2.1 e cobra o preço dele, e o retorno diz em `model`, `modelLabel` e `fellBack` quem desenhou): 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. STICKERS (generate_stickers, COBRA 550 Sinapses): desenha 5 stickers do personagem DE UMA VEZ. Uma folha só, em 2K, com as cinco figuras separadas sobre um fundo verde chroma, recortada por código em peças 512x512 transparentes abaixo de 100KB (o teto do WhatsApp). É por isso que sai o preço de UMA imagem em 2K e não de cinco: quem paga é a folha. As peças entram no pack do personagem (um por personagem, os lotes acumulam) e já ficam no picker de expressão do dono, no chat e no Fórum. Arg `moods`: até 5 humores do vocabulário comum por slug (kkkkk, amei, isso, hmm, chega, que, aff, bora, socorro, seinao, valeu, ainao, seila, ideia, calma, contatudo, perfeito, euavisei, naovourir, zzz, somaisum, sextou, merecido, quedia, tudobem); faltando, a casa completa com os mais usados. Arg `hint`: direcionamento curto do autor (roupa, adereço, clima), até 140 caracteres. Arg `stickerTier`: 'folha' (default) é esse lote de cinco, desenhado no Nano Banana 2.1; 'unica' (COBRA 900 Sinapses) desenha UM sticker por vez no Gemini 3 Pro, o motor mais fiel da casa, com a figura sozinha no quadro e o dobro de pixel por peça, e leva só o PRIMEIRO mood da lista. Pra encher o pack, folha; pra traço difícil ou a reação que vira a cara do personagem, a unica. Ao oferecer a escolha, diga o NOME DO MOTOR e o que ele troca: adjetivo vago de acabamento não informa nada a quem vai pagar. Os dois caem no MESMO pack e acumulam. Sem legenda queimada na imagem, de propósito: modelo erra acento em português, então o rótulo fica na row e serve de busca no picker. Exige pelo menos uma imagem no personagem (é dela que sai a cara) e é geração síncrona: se voltar Timeout, cheque sapiens_gallery antes de repetir. Quando a resposta vem com ok=false, a folha foi gerada e paga mas o corte falhou; ela está na galeria e o recorte de novo é de graça, pela web. Publicar o pack na vitrine e o carimbo da casa (que é o que põe no picker de todo mundo) são gestos da web, não desta tool. PLACAS (generate_plates, COBRA 550 Sinapses): seis ângulos do mesmo rosto numa geração só, no Nano Banana 2.1 em 2K, recortados por código em seis referências com PAPEL: perfil, camera-alta, camera-baixa, frontal, cabeca-baixa e outro-lado, cada um com uma expressão diferente. Não é vitrine (isso é a ficha): é a referência feita pra máquina. Referência trava o ângulo da câmera, então quando a cena pede perfil, passe a placa de perfil em referenceImageUrls. As placas ficam FORA de imageUrls de propósito, porque placa de perfil como referência genérica puxa toda peça pro perfil; elas voltam em action=get no campo `plates` ([{role, url}]). As placas ACUMULAM: cada geração soma seis, e a que não serve sai com remove_image. Em `plates` o lote mais novo vem primeiro, cada lote na ordem da grade, então a primeira placa de um papel é a mais nova. Sai das fotos do personagem (exige pelo menos uma) e, quando ele tem passaporte, o descritor dele entra no pedido. Só personagem com rosto de gente (form human ou humanoid): pra bicho, criatura, objeto ou forma abstrata o servidor recusa antes de cobrar. O perfil puro e a câmera alta às vezes voltam amolecidos pro frontal; quando esses dois ângulos importarem, confira as placas antes de usar. Geração síncrona: se voltar Timeout, cheque action=get antes de repetir. Resposta com ok=false quer dizer grade gerada e paga com o corte falho; o recorte de novo é de graça, pela web. CHARACTER VIDEO (a ficha que anda): o personagem atravessa 6 mundos em 12s, trocando de roupa em cada um, com som gerado junto, e o último plano fecha a peça com ele parando e encarando a câmera. A peça volta FECHADA pelas duas portas (tela e agente), sem ninguém pedir: o personagem se apresenta no cartão de nome por cima do fim do último plano, com o LEMA em inglês embaixo (o campo `titleEn`, escrito uma vez em set_card), e só depois a casa assina. Quem não tem lema recebe o subtítulo que o roteiro inventou naquele take, e ele muda no take seguinte. O fecho é asset, não geração: zero Sinapse a mais, e é fail-open, então a resposta traz `closed` e `nameCard` dizendo o que entrou de verdade em vez de prometer um cartão que não está no arquivo. Pra colocar esse cartão num vídeo que JÁ existe, o caminho é a ficha do take na web (gaveta do fecho, 'Apresentação do personagem'), também sem custo. Exige FICHA gerada (é dela que saem a cara e o guarda-roupa), não só imagem. Duas actions, nesta ordem: plan_video (COBRA 50 Sinapses) devolve os 6 planos que a alma do personagem escolheu, com ambiente, ato, enquadramento e roupa. Cada plano vem nas duas línguas: em inglês (setting/act/wardrobe, que é o que vai pro motor) e em português (settingPt/actPt/wardrobePt). MOSTRE a versão em português pro autor, o público da casa é brasileiro e roteiro que ele lê de través não é roteiro aprovado; peça de novo quantas vezes ele quiser, porque trocar sai por 50 e o take errado sai por milhares. replan_shot (COBRA 15 Sinapses) reescreve UM plano e não toca nos outros cinco: os seis são cenas independentes, então quando o autor gosta de quatro e implica com um, troque só aquele em vez de sortear tudo de novo (mande os 6 planos em `shots`, o número em `shotIndex`, e o que ele quer diferente em `shotHint`; volta só o plano trocado, e é você que remonta o roteiro). Depois generate_video (COBRA) renderiza, com os planos aprovados no arg `shots` e o MOTOR no arg `videoTier`: 'draft' (5.400 Sinapses) é o Seedance 2.0 Mini, metade do preço, que tropeça em mão, pouca luz e câmera rápida, e 'final' (8.640 Sinapses) é o Seedance 2.0 Fast, que segura o que o Mini erra. A peça é a MESMA nos dois (mesmos 6 planos, 12s, 720p, com som), então ofereça pelo nome do motor e pelo que ele troca, nunca por adjetivo vago de acabamento. Vertical ou horizontal pelo arg `orientation`. Chamar generate_video SEM `shots` funciona, mas escreve um roteiro novo às cegas e cobra igual: não faça isso sem o autor ter visto o que vai receber. É geração demorada: se voltar Timeout, cheque sapiens_gallery antes de repetir. Resposta com `pending: true` (sem `url`) quer dizer ACEITO E COBRADO: o servidor continua renderizando sozinho (até 25 min) e a peça chega na ficha já fechada; NÃO repita a chamada, isso cobraria de novo, confira depois em sapiens_gallery. Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate. PARE AÍ. O personagem nasce e continua PRIVADO, e é assim que ele serve pro dono: dá pra gerar, referenciar e iterar sem ninguém ver. set_visibility isPublic=true é o gesto de PUBLICAR no Explorar, com slug público, e nÃO é passo de fluxo: só chame quando o dono pedir pra publicar aquele personagem, com essas palavras. Na dúvida, não publique e pergunte. 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,
@@ -325,6 +331,7 @@ const TOOL_TITLES = {
     sapiens_stock_audio: "Banco de Áudio",
     sapiens_stock_video: "Banco de Vídeo",
     sapiens_brand: "Brand (Design System)",
+    sapiens_collection: "Collections",
     sapiens_character: "Personagens",
     sapiens_profile: "Perfil",
     sapiens_sintetico: "Sintético & Sintonia",

package/dist/skills.js

@@ -922,6 +922,16 @@ Um carrossel é uma RECEITA: tema (paleta, folha e assinatura) mais slides, cada
 
 O nome no topo, a marca no canto da capa e o @ do fecho saem de \`theme.signature\` (\`label\`, \`handle\`, \`logoUrl\`). Nasce da marca da pessoa, ou do nome dela quando não tem marca. Se ela pedir pra mudar, mude ali, no update. O @ é o dela no Instagram: não invente, pergunte.
 
+## O brand da peça
+
+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.
+
+## Carrossel que vem de fora
+
+Trazendo slides de outro editor: crie o carrossel, leia o catálogo no \`get\` e case cada slide de lá com um layout daqui pelo PAPEL (\`role\`: capa, corpo, cta), pela foto (\`requiresImage\`) e pelos \`slots\`. O texto vai nos slots, o estilo vem do brand, nunca do layout de lá. Slide sem par vira o corpo mais próximo: não force texto num slot que não cabe, corte ou divida em dois slides.
+
 ## A capa IA
 
 \`action=cover\` gera uma capa 16:9 com a manchete QUEIMADA na imagem, um elemento vivo cruzando as letras, e com \`carouselId\` fatia em duas e põe na frente do carrossel, no lugar da capa IA anterior. Cobra pelo motor da capa (o preço sai de \`sapiens_image action=models\`). Confirme o custo com a pessoa antes. Animar a capa é no editor, não por aqui.
@@ -964,7 +974,34 @@ Baixe e leia ANTES de escrever o código. Num agente com pasta de skills, ele en
 - Preço: o de cada modelo está em \`GET /models\`; vídeo cota de graça em \`POST /videos/quote\`. O valor de uma chamada pode variar um pouco com a oferta da hora. O valor de cada chamada volta no header \`x-sapiens-charge-usd\`. Pra pôr o preço da API ao lado de outro provedor (fal.ai, WaveSpeed): \`sapiens_meta action=precos\`, parte \`api\`.
 - Vídeo cota de graça antes (\`POST /videos/quote\`), aceita \`webhook_url\` pra avisar quando termina e devolve a \`url\` do mp4 guardado. Falha do motor volta pro saldo sozinha.
 - Saldo que acabou volta 402 \`insufficient_balance\` com \`recharge_url\` no erro: o código da pessoa deve mostrar esse link (recarga no cartão ou em stablecoin) em vez de só falhar.
-- Uma chamada de teste antes de qualquer lote. Nunca vídeo em laço.`,
+- Uma chamada de teste antes de qualquer lote. Nunca vídeo em laço.
+
+## Modelos de texto de preço variável: sapiens-auto e Jev Router
+
+Dois modelos de texto que escolhem, a cada pedido, qual modelo responde, e cobram o preço dele. Não são de uso casual: o valor de cada chamada só se sabe depois, e o código da pessoa precisa respeitar isso. O preço está em \`sapiens_meta action=precos\` com \`midia=texto\`, parte \`api.texto.roteadores\` (a faixa do sapiens-auto, do candidato mais barato ao mais caro), e em \`GET /models\`.
+
+### sapiens-auto (no POST /chat/completions)
+
+- \`model: "sapiens-auto"\` e a casa escolhe o modelo de texto da conversa: código vai pra um modelo forte em código, prova e conta pesada pro topo, conversa e pergunta curta pra um modelo leve, o resto pra um do meio.
+- Cobra o preço do modelo escolhido, sem taxa a mais. O \`model\` da resposta diz qual atendeu, e o \`x-sapiens-charge-usd\` diz quanto custou. A faixa de preço (do candidato mais barato ao mais caro) está na tabela.
+- A escolha vale pra conversa inteira por 2 horas: as falas seguintes ficam no mesmo modelo, mesmo que fiquem triviais. A casa reconhece a conversa pelo começo dela, sem guardar o texto.
+- Cuidado: quem joga no sapiens-auto texto que não escreveu (email, página, mensagem de terceiro) deixa esse texto puxar a conversa pra faixa de topo, que custa dezenas de vezes a leve. Pra agente que lê conteúdo de fora, ponha teto de gasto por dia na API key (Developers) ou fixe o modelo.
+- Quem precisa de um modelo previsível (avaliação, lote com orçamento fechado) manda o id do modelo, não o sapiens-auto.
+
+### Jev Router (no POST /chat/completions)
+
+- \`model: "jev-router"\`: o router da TypeSafe escolhe o modelo e o esforço de raciocínio de cada pedido. O \`model\` da resposta é o que ele escolheu.
+- Preço variável, o do modelo que ele escolher. Não dá pra cotar antes: leia o \`x-sapiens-charge-usd\` de cada chamada e, em lote, confira o gasto do dia em \`GET /balance\`.
+
+## Decisão: o Laya (POST /systemone)
+
+Um modelo de decisão responde sem gerar texto: sim ou não, uma opção entre várias ou uma nota numa escala, com a confiança de cada resposta. Serve pra triagem, moderação, filtro, roteamento e leitura de intenção, em volume e barato, antes ou no lugar de chamar um modelo de texto. O preço está em \`sapiens_meta action=precos\` com \`midia=decidir\`, parte \`api.decidir\`, e em \`GET /models\` (\`type: "decision"\`).
+
+- Formato System One (o mesmo do Jev): \`state\` (texto ou objeto) e \`questions\`, cada uma \`noul\` (sim ou não), \`choice\` (uma das opções de \`criteria\`) ou \`score\` (um nível de uma escala). Modelo: \`laya-multilingual\`, aberto, 100+ línguas.
+- Cobra só a entrada. Até 4 perguntas por chamada. Uma pergunta curta decide em cerca de meio segundo; o tempo cresce com o tamanho do \`state\`.
+- Uma decisão por vez na máquina: com fila cheia volta 503, sem cobrar. Lote vai em sequência, nunca em paralelo, e o código trata o 503 esperando e tentando de novo.
+- Sem ajuste fino, o Laya erra mais que um modelo de texto em classificação aberta, às vezes com confiança alta. Serve pra triagem barata e em volume. Antes de pôr no fluxo da pessoa, rode uma amostra do caso dela e confira as respostas.
+- Quem já usa o SDK do Jev troca a URL base pela da API e o modelo por \`laya-multilingual\`.`,
     },
 ];
 export const SKILLS = Object.fromEntries(SKILL_LIST.map((s) => [s.name, s]));

package/dist/tools/brand.js

@@ -38,6 +38,17 @@ import { convexAction, convexQuery, convexMutation, getSessionToken, } from "../
  *               (character=null). As refs saem da galeria do personagem. De
  *               graça. É o que faz "gera na minha marca, com o meu personagem"
  *               funcionar sem anexar referência a cada geração.
+ *   - import:   TRANSCREVE um design system que já existe fora (Figma, outro app,
+ *               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.
+ *   - 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.
+ *   - favorite: marca (isFavorite=true, default) ou desmarca um brand custom do
+ *               user como FAVORITO, o escolhido entre as tentativas de um
+ *               projeto. Favorito sobe pro topo das listas dele (list, seletores
+ *               do app). Oficial não se favorita. De graça.
  *
  * Auth: qualquer conta logada (sessionToken). As Sinapses saem do dono do token.
  * NÃO mexe em brand custom de terceiro (só lê o estilo público via list_public e
@@ -57,11 +68,45 @@ export const brandSchema = z.object({
         "list_public",
         "adopt",
         "persona",
+        "favorite",
+        "import",
+        "logo",
     ]),
     slug: z
         .string()
         .optional()
-        .describe("Slug do brand. Obrigatório em get/refine/reroll/card/delete/set_visibility/adopt/persona. Pegue via action=list (seus) ou action=list_public (da comunidade)."),
+        .describe("Slug do brand. Obrigatório em get/refine/reroll/card/delete/set_visibility/adopt/persona/favorite/logo. Pegue via action=list (seus) ou action=list_public (da comunidade)."),
+    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). " +
+        "{ 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}), " +
+        "voice?: { rules (texto ou lista de regras), lexicon?, avoid?, sampleLines? }, " +
+        "imageStyle?: { styleBase (em inglês), negative?, backgroundSignature? } }. " +
+        "Cor em hex (#RRGGBB, aceita #RGB e sem #). Obrigatórios: name, background, foreground, primary (ou accent), headline e body. " +
+        "PAPÉIS DAS CORES na casa: primary é a cor da marca, accent é a que DESTACA a peça (kicker, número, palavra-chave). " +
+        "Se no sistema de origem o accent é só cor de botão, mande assim mesmo: o carrossel escolhe sozinho a cor que lê no fundo e se separa do texto, e o editor deixa trocar. " +
+        "Mapeie o que a origem chama por outro nome (brand/main → primary, bg/surface → background, text/ink → foreground, cta/highlight → accent). " +
+        "Fonte fora do Google Fonts grava como veio (fidelidade) e aparece na fonte da casa onde o navegador não acha a dela; o retorno avisa em `warnings`."),
+    source: z
+        .string()
+        .optional()
+        .describe("Pra action=import: de onde o brand veio (o nome do app, 'Figma', 'kit do cliente'). Vai pro briefing e pro aviso. ≤60 chars."),
+    handle: z
+        .string()
+        .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."),
+    wordmark: z
+        .string()
+        .optional()
+        .describe("Pra action=logo: o nome escrito que acompanha a logo, quando ele difere do nome do brand (≤60 chars)."),
+    isFavorite: z
+        .boolean()
+        .optional()
+        .describe("Pra action=favorite: true (default) marca o brand como o favorito, o escolhido entre as tentativas; false tira. Só brand custom seu."),
     character: z
         .string()
         .nullable()
@@ -82,7 +127,7 @@ export const brandSchema = z.object({
     name: z
         .string()
         .optional()
-        .describe("Pra action=generate: nome sugerido pro brand (opcional, ≤40 chars). Sem isso o Gemini sugere um."),
+        .describe("Pra action=generate: o nome do brand (opcional, ≤40 chars). Vem exatamente como mandado; sem ele o Gemini sugere um."),
     fromSlug: z
         .string()
         .optional()
@@ -119,9 +164,29 @@ export async function brand(args) {
                 typography: b.typography ?? null,
                 cardUrl: b.card?.url ?? null,
                 persona: b.persona?.label ?? null,
+                // Ausente em servidor antigo: aí ninguém é favorito, e a lista segue igual.
+                isFavorite: b.isFavorite === true,
             })),
-            note: "Oficiais (curados) + os seus custom. Pra detalhe completo (voz + estilo " +
-                "de imagem): action=get slug=<slug>. Pra criar um novo: action=generate.",
+            note: "Oficiais (curados) + os seus custom, os favoritos (isFavorite) primeiro. " +
+                "Pra detalhe completo (voz + estilo de imagem): action=get slug=<slug>. " +
+                "Pra criar um novo: action=generate. Pra marcar o escolhido: action=favorite.",
+        };
+    }
+    // -------- favorite: marca/desmarca o escolhido entre as tentativas --------
+    if (args.action === "favorite") {
+        if (!args.slug)
+            throw new Error("action=favorite exige slug de um brand custom SEU (pegue via action=list).");
+        const isFavorite = args.isFavorite ?? true;
+        const res = await convexMutation("brands:mcpSetBrandFavorite", {
+            sessionToken,
+            slug: args.slug.trim(),
+            isFavorite,
+        });
+        return {
+            ...res,
+            note: isFavorite
+                ? "Favorito marcado: ele sobe pro topo das suas listas e dos seletores do app. As outras tentativas ficam guardadas como estão. Pra juntar o projeto inteiro (o brand, as imagens, as notas de escolhida e tentativa), sapiens_collection."
+                : "Favorito tirado: o brand volta pra ordem de sempre.",
         };
     }
     // -------- get: brand completo por slug (grátis) --------
@@ -179,6 +244,57 @@ export async function brand(args) {
                 " twist='mais bruto'.",
         };
     }
+    // -------- import: transcreve brand de fora, sem IA (grátis) --------
+    if (args.action === "import") {
+        let raw = args.brand;
+        // Cliente que serializa `any` manda string JSON.
+        if (typeof raw === "string") {
+            try {
+                raw = JSON.parse(raw);
+            }
+            catch {
+                throw new Error("action=import: `brand` chegou como texto que não é JSON. Mande o objeto do design system.");
+            }
+        }
+        if (!raw || typeof raw !== "object") {
+            throw new Error("action=import exige `brand` com o design system que já existe (name, palette, typography; voz e imagem opcionais). " +
+                "Pra CRIAR um brand do zero a partir de uma descrição, o caminho é action=generate.");
+        }
+        const res = await convexAction("customBrandsActions:mcpImportBrand", {
+            sessionToken,
+            brand: raw,
+            source: args.source?.trim() || undefined,
+        });
+        return {
+            ...res,
+            viewUrl: `${APP}/experimentos/brands`,
+            next: "Logo: suba a imagem com sapiens_gallery action=upload e rode action=logo slug=" +
+                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.",
+        };
+    }
+    // -------- logo: pelo ID da imagem na galeria do user (grátis) --------
+    if (args.action === "logo") {
+        if (!args.slug)
+            throw new Error("action=logo exige slug de um brand custom SEU (pegue via action=list).");
+        if (args.handle === undefined) {
+            throw new Error("action=logo exige handle=img_… (a imagem da logo na sua galeria; suba com sapiens_gallery action=upload) ou handle=null pra tirar.");
+        }
+        const res = await convexMutation("brands:mcpSetBrandLogo", {
+            sessionToken,
+            slug: args.slug.trim(),
+            handle: args.handle === null ? null : args.handle.trim(),
+            wordmark: args.wordmark?.trim() || undefined,
+        });
+        return {
+            ...res,
+            note: res.logo
+                ? "Logo no brand: ela assina o carrossel e entra nas imagens com brandMark=logo."
+                : "Logo tirada do brand.",
+        };
+    }
     // -------- refine: ajusta brand custom existente (cobra Sinapses) --------
     if (args.action === "refine") {
         if (!args.slug)

package/dist/tools/carrossel.js

@@ -50,6 +50,10 @@ export const carrosselSchema = z.object({
         .enum(["4:5", "9:16"])
         .optional()
         .describe("generate: o TAMANHO da folha. '4:5' (padrão, o feed do Instagram mostra inteira) ou '9:16' (tela cheia). Dá pra trocar depois no editor."),
+    brandSlug: z
+        .string()
+        .optional()
+        .describe("generate: o brand da peça (slug de sapiens_brand action=list), quando não é o padrão da conta. Veste a cor, a fonte, a voz e a assinatura dele. Sem isso vale o padrão da conta. Brand que a pessoa não pode usar cai no padrão."),
     useSintetico: z
         .boolean()
         .optional()
@@ -66,7 +70,10 @@ export const carrosselSchema = z.object({
     payload: z
         .any()
         .optional()
-        .describe("update: o payload INTEIRO, no shape do get: { theme: { palette, sheet, signature }, slides: [{ id, templateId, slots, image }], meta }. Preserve image dos slides que você não mexeu e o theme inteiro (folha e assinatura): o que faltar volta pro padrão. Foto NOVA não entra por URL aqui: use set_image (ID da peça) ou generate_image."),
+        .describe("update: o payload INTEIRO, no shape do get: { theme: { palette, sheet, signature, brand?, fonts? }, slides: [{ id, templateId, slots, image }], meta }. Preserve image dos slides que você não mexeu e o theme inteiro (folha, assinatura, cor e fonte do brand): o que faltar volta pro padrão. " +
+        "Na peça que veste um brand (palette 'brand'), theme.brand traz os tokens de cor (bg, text, accent, kicker em hex) e theme.fonts a tipografia ({ display: família do título, text: família do corpo }, sem fonts = a da casa). Pra trocar a cor de DESTAQUE, ponha o mesmo hex em accent e kicker. " +
+        "Carrossel que vem de FORA (outro app, outro editor): case cada slide de lá com um layout do catálogo do get pelo PAPEL (role: capa, corpo, cta), pela foto (requiresImage) e pelos slots, e ponha o texto nos slots daquele layout; o estilo (cor, fonte, logo) vem do brand, não do layout. Layout de fora sem par no catálogo vira o corpo mais próximo, nunca layout inventado. " +
+        "Foto NOVA não entra por URL aqui: use set_image (ID da peça) ou generate_image."),
     title: z.string().optional().describe("update: novo título do carrossel (opcional)."),
     baseUpdatedAt: z
         .number()
@@ -131,6 +138,7 @@ export async function carrossel(args) {
                 ...(args.userArticleId ? { sourceUserArticleId: args.userArticleId } : {}),
                 ...(args.model ? { model: args.model } : {}),
                 ...(args.aspect ? { aspect: args.aspect } : {}),
+                ...(args.brandSlug?.trim() ? { brandSlug: args.brandSlug.trim() } : {}),
                 ...(args.useSintetico !== undefined ? { useSintetico: args.useSintetico } : {}),
                 ...(args.autoPickImages !== undefined ? { autoPickImages: args.autoPickImages } : {}),
             });

package/dist/tools/collection.js

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import { convexQuery, convexMutation, getSessionToken } from "../convexClient.js";
+/**
+ * Collections: o álbum generalizado do Acervo, operado pelo agente. Uma
+ * Collection junta as peças de um mesmo mundo (imagens, vídeos, o design
+ * system, o personagem, a música) e cada peça leva uma NOTA do dono. É o lugar
+ * do "escolhido entre as tentativas": as tentativas e a escolhida na mesma
+ * Collection, cada uma com a sua nota, a escolhida no topo.
+ *
+ * Sub-actions:
+ *   - list:    as Collections do user (rascunho e publicadas). Grátis.
+ *   - get:     uma Collection (por id ou slug) com as peças, na ordem, e as notas.
+ *   - create:  nasce uma Collection, rascunho e privada (title obrigatório).
+ *   - update:  troca nome e descrição.
+ *   - add:     põe uma peça (itemType + refId, com nota opcional). Peça que já
+ *              está dentro e chega com nota tem a nota trocada.
+ *   - remove:  tira uma peça (a peça em si não é tocada).
+ *   - note:    troca a nota de uma peça que já está dentro (sem note, apaga).
+ *   - reorder: nova ordem pelos refId, o primeiro no topo; os não citados vêm
+ *              depois, na ordem em que estavam.
+ *
+ * Publicar a Collection e escolher capa são gestos do dono no Acervo, de
+ * propósito: Collection publicada não volta a rascunho.
+ *
+ * Auth: qualquer conta logada (sessionToken). Só mexe nas Collections e nas
+ * peças da própria conta.
+ */
+const APP = "https://sapiensinteticos.com";
+export const collectionSchema = z.object({
+    action: z.enum(["list", "get", "create", "update", "add", "remove", "note", "reorder"]),
+    collection: z
+        .string()
+        .optional()
+        .describe("A Collection: o id OU o slug (o nome também serve, ele vira slug). Obrigatório em get/update/add/remove/note/reorder. As suas saem em action=list."),
+    title: z
+        .string()
+        .optional()
+        .describe("Pra action=create (obrigatório) e update: o nome da Collection, até 80 caracteres."),
+    description: z
+        .string()
+        .optional()
+        .describe("Pra action=create e update: uma linha sobre o mundo que a Collection junta, até 600 caracteres."),
+    itemType: z
+        .string()
+        .optional()
+        .describe("Pra add/remove/note: o tipo da peça. image (imageId de sapiens_image/sapiens_gallery), video (o mesmo id da galeria), brand (o design system: aceita o SLUG, ex 'adult-blue-madrugada'), character (characterId), track (música), article, aula, carousel, comic, sticker, fita, app."),
+    refId: z
+        .string()
+        .optional()
+        .describe("Pra add/remove/note: o id da peça (no brand, o slug serve)."),
+    note: z
+        .string()
+        .optional()
+        .describe("Pra add e note: a nota do dono sobre a peça DENTRO desta Collection, até 240 caracteres. Pra marcar o escolhido de um projeto: 'escolhida' na que venceu e 'tentativa' nas outras."),
+    refIds: z
+        .array(z.string())
+        .optional()
+        .describe("Pra action=reorder: os refId na ordem nova, o primeiro vai pro topo. Basta citar os que mudam de lugar: 'põe a escolhida em primeiro' é mandar só o refId dela."),
+});
+function exigir(valor, mensagem) {
+    if (valor === undefined || valor === null || (typeof valor === "string" && !valor.trim())) {
+        throw new Error(mensagem);
+    }
+    return valor;
+}
+export async function collection(args) {
+    const sessionToken = getSessionToken();
+    const qual = () => exigir(args.collection, `action=${args.action} exige collection (o id ou o slug; as suas saem em action=list).`).trim();
+    const peca = () => ({
+        itemType: exigir(args.itemType, `action=${args.action} exige itemType (image, video, brand, character...).`).trim(),
+        refId: exigir(args.refId, `action=${args.action} exige refId (o id da peça; no brand, o slug serve).`).trim(),
+    });
+    if (args.action === "list") {
+        const cols = await convexQuery("collections:mcpListCollections", { sessionToken });
+        return {
+            count: Array.isArray(cols) ? cols.length : 0,
+            collections: cols,
+            note: "No site, as suas Collections moram no seu perfil, nas Criações privadas, aba Collections " +
+                `(${APP}/u/<seu @>?tab=private&criacoes=collections). As publicadas também aparecem na aba Collections do Acervo.`,
+        };
+    }
+    if (args.action === "get") {
+        return await convexQuery("collections:mcpGetCollection", { sessionToken, collection: qual() });
+    }
+    if (args.action === "create") {
+        const title = exigir(args.title, "action=create exige title (o nome da Collection).").trim();
+        const res = await convexMutation("collections:mcpCreateCollection", {
+            sessionToken,
+            title,
+            description: args.description?.trim() || undefined,
+        });
+        return {
+            ...res,
+            note: "Collection criada, rascunho e privada. Junte as peças com action=add collection=" +
+                res.slug +
+                ". Publicar e escolher capa são no Acervo, pelo dono.",
+        };
+    }
+    if (args.action === "update") {
+        if (args.title === undefined && args.description === undefined) {
+            throw new Error("action=update exige title ou description.");
+        }
+        return await convexMutation("collections:mcpUpdateCollection", {
+            sessionToken,
+            collection: qual(),
+            title: args.title,
+            description: args.description,
+        });
+    }
+    if (args.action === "add") {
+        return await convexMutation("collections:mcpAddCollectionItem", {
+            sessionToken,
+            collection: qual(),
+            ...peca(),
+            note: args.note,
+        });
+    }
+    if (args.action === "remove") {
+        return await convexMutation("collections:mcpRemoveCollectionItem", {
+            sessionToken,
+            collection: qual(),
+            ...peca(),
+        });
+    }
+    if (args.action === "note") {
+        return await convexMutation("collections:mcpSetCollectionItemNote", {
+            sessionToken,
+            collection: qual(),
+            ...peca(),
+            note: args.note,
+        });
+    }
+    if (args.action === "reorder") {
+        const refIds = exigir(args.refIds, "action=reorder exige refIds (a ordem nova, o primeiro no topo).");
+        return await convexMutation("collections:mcpReorderCollection", {
+            sessionToken,
+            collection: qual(),
+            refIds,
+        });
+    }
+}

package/dist/tools/meta.js

@@ -65,9 +65,9 @@ export const metaSchema = z.object({
         .optional()
         .describe("Código XXXX-XXXX gerado (logado) em sapiensinteticos.com/conectar-claude. Só pra action=login."),
     midia: z
-        .enum(["imagem", "video", "musica", "voz", "texto"])
+        .enum(["imagem", "video", "musica", "voz", "texto", "decidir"])
         .optional()
-        .describe("Só pra action=precos: recorta a tabela numa mídia. Sem ela vêm imagem, vídeo, música e voz (o texto da API é longo e só vem com midia=texto)."),
+        .describe("Só pra action=precos: recorta a tabela numa mídia. Sem ela vêm imagem, vídeo, música e voz (o texto da API é longo e só vem com midia=texto, com os modelos de preço variável em `texto.roteadores` e a parte `decidir`). midia=decidir traz só os modelos de decisão da API (o Laya): respondem sim ou não, uma opção ou uma nota, sem gerar texto."),
     busca: z
         .string()
         .optional()

package/package.json

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