sapiens-mcp 1.112.0 → 1.113.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/registry.js CHANGED
@@ -68,7 +68,7 @@ export const TOOLS = {
68
68
  handler: pipeline,
69
69
  },
70
70
  sapiens_carrossel: {
71
- 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.",
71
+ description: "O CARROSSEL do Instagram da pessoa, pelo agente (qualquer conta logada, só os carrosséis DELA). Puxe a skill 'carrossel' antes. CUSTO ZERO quando VOCÊ escreve: create (cria o carrossel com o payload que você escreveu, ou vazio; a casa só grava, grátis, teto de 20 por dia) → get → update → search_images (busca GRÁTIS no banco de fotos da casa por palavra; nem pede login) → set_image com stockImageId. Sub-actions pagas e o resto: generate (a IA da casa escreve 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, customPrompt opcional; imageModel 'nano-banana-2' (padrão, ~450 Sinapses) ou 'flux-3-klein' (o barato, 60 Sinapses), avise antes; o preço do Klein vale só no slide e essa foto não rende prêmio de publicar), set_image (põe no slide uma foto do banco pelo stockImageId do search_images, ou 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.",
72
72
  schema: carrosselSchema,
73
73
  handler: carrossel,
74
74
  },
@@ -158,7 +158,7 @@ export const TOOLS = {
158
158
  handler: video,
159
159
  },
160
160
  sapiens_stock_audio: {
161
- 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), 13 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.",
161
+ 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 ('elevenlabs' padrão 35 Sinapses/s mín 70 | 'mirelo' 35 Sinapses/s mín 70) + 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), 13 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.",
162
162
  schema: stockAudioSchema,
163
163
  handler: stockAudio,
164
164
  },
package/dist/skills.js CHANGED
@@ -211,7 +211,7 @@ Depois de pronta: \`action=publish\` põe a faixa no Acervo da Comunidade (só a
211
211
  Efeito é CURTO. Música inteira é no Musicator, não aqui.
212
212
 
213
213
  1. Procure pronto primeiro: \`sapiens_stock_audio action=list kind=sfx\`. Grátis.
214
- 2. Não achou: \`action=generate\` com \`prompt\` e \`durationSeconds\` (1 a 15, default 5) e \`provider\` ('mirelo' padrão 35 Sinapses/s mín 70, 'elevenlabs' premium 60/s mín 120). \`promptInfluence\` (0..1) só vale no elevenlabs.
214
+ 2. Não achou: \`action=generate\` com \`prompt\` e \`durationSeconds\` (1 a 15, default 5) e \`provider\` ('elevenlabs' padrão 35 Sinapses/s mín 70, 'mirelo' 35 Sinapses/s mín 70). \`promptInfluence\` (0..1) só vale no elevenlabs.
215
215
  3. É assíncrono: devolve \`generationId\`, acompanhe com \`action=generation-status\` até 'ready' (traz audioUrl) ou 'failed' (reembolsa sozinho).
216
216
 
217
217
  ## Sonorizar um clipe
@@ -983,17 +983,30 @@ A Teia é da pessoa: "quando sai no Instagram, entra na fila do Threads". \`acti
983
983
  {
984
984
  name: "carrossel",
985
985
  title: "Carrossel: gerar, escrever, pôr foto e entregar",
986
- description: "O carrossel do Instagram pelo agente: gerar do brief ou de um artigo, reescrever os slides direto no payload, pôr foto da galeria da pessoa, a capa IA, e onde ela baixa. Puxe ANTES de sapiens_carrossel.",
986
+ description: "O carrossel do Instagram pelo agente: o caminho de custo zero (você escreve, foto do banco da casa), gerar do brief ou de um artigo pela IA da casa, reescrever os slides direto no payload, pôr foto da galeria da pessoa, a capa IA, e onde ela baixa. Puxe ANTES de sapiens_carrossel.",
987
987
  body: `## O que é
988
988
 
989
989
  Um carrossel é uma RECEITA: tema (paleta, folha e assinatura) mais slides, cada um com um layout (\`templateId\`) e os textos dele (\`slots\`). O desenho sai dessa receita no editor da pessoa, que é também onde ela baixa os arquivos. Você escreve a receita; ela abre, confere e baixa.
990
990
 
991
- ## O fluxo
991
+ ## O caminho de custo zero (você escreve, a casa grava)
992
+
993
+ Quem escreve o texto é VOCÊ, no plano da pessoa: a casa não gasta token, então não cobra. É o caminho padrão quando ela só quer o carrossel pronto e não pediu a IA da casa.
994
+
995
+ 1. \`action=create\` cria o carrossel. Sem \`payload\` nasce vazio; com \`aspect\` escolhe a folha (\`4:5\` padrão). Grátis, teto de 20 novos por dia por conta.
996
+ 2. \`action=get\` traz o catálogo de layouts (os \`slots\` e o limite de cada um, quais têm foto em \`requiresImage\`).
997
+ 3. Escreva os slides e grave com \`action=update\` (payload inteiro + \`baseUpdatedAt\`). Puxe a skill \`voz-da-casa\` antes. Já sabendo o catálogo, dá pra mandar o payload direto no \`create\` e pular este passo.
998
+ 4. \`action=search_images query=<o assunto da foto> orientation=vertical\` busca no banco de fotos da casa, grátis e sem login. Escolha pelo título, tags e descrição.
999
+ 5. \`action=set_image stockImageId=<id>\` em cada slide de layout com foto. Grátis.
1000
+ 6. Mande a \`url\` do editor: ela abre, confere e baixa.
1001
+
1002
+ Foto que o banco não cobre: \`action=generate_image\` gera uma nova pra um slide. \`imageModel=flux-3-klein\` (FLUX 3 Image Klein) é o barato, 60 Sinapses a foto, texto puro: preço que vale SÓ no slide do carrossel, e essa foto não rende o prêmio de publicar se for publicada sozinha. \`nano-banana-2\` (Nano Banana 2.1, o padrão) segue o estilo do banco por referência e cobra pelo catálogo (\`sapiens_image action=models\`). Avise o preço e espere o sim antes.
1003
+
1004
+ ## O fluxo com a IA da casa
992
1005
 
993
1006
  1. \`sapiens_carrossel action=generate\` com \`brief\` (o tema e o ângulo, um parágrafo) OU \`articleId\` (artigo publicado) OU \`userArticleId\` (artigo dela). Custa 350 Sinapses, já com a escolha de fotos, e estorna se falhar. Devolve o \`id\` e a \`url\` do editor.
994
1007
  2. \`action=get\` traz o payload inteiro e o catálogo: os layouts com os slots de cada um, as paletas, as folhas e a assinatura. Leia antes de mexer.
995
1008
  3. \`action=update\` grava o payload INTEIRO de volta. Reescreva os textos com a voz da pessoa (puxe a skill \`voz-da-casa\`). Mande o \`theme\` inteiro e o \`image\` de todo slide que você não mexeu: o que faltar volta pro padrão e a foto do slide some. Mande também \`baseUpdatedAt\` com o \`updatedAt\` do get: se o carrossel mudou depois (uma foto gerada, uma edição dela no editor), o update recusa em vez de apagar isso, e aí você faz get de novo. Foto nova não entra por URL no update, só pelo passo 4.
996
- 4. Foto: \`action=auto_images\` (60) deixa a IA escolher do banco; \`action=set_image\` põe uma peça DA PESSOA pelo ID citável (\`img_…\`, de \`sapiens_reference\` ou \`sapiens_gallery\`), de graça; \`action=generate_image\` gera uma nova pra um slide, ~450 cada.
1009
+ 4. Foto: \`action=auto_images\` (60) deixa a IA escolher do banco; \`action=set_image\` põe uma foto do banco (\`stockImageId\`, do \`search_images\`) ou uma peça DA PESSOA pelo ID citável (\`img_…\`, de \`sapiens_reference\` ou \`sapiens_gallery\`), de graça; \`action=generate_image\` gera uma nova pra um slide, pelo preço do motor (\`imageModel\`).
997
1010
  5. Mande a \`url\` do editor. É lá que ela confere, ajusta e baixa.
998
1011
 
999
1012
  ## A forma e o tamanho
@@ -19,6 +19,8 @@ const MODELS = ["feed", "reflexao", "case", "editorial"];
19
19
  export const carrosselSchema = z.object({
20
20
  action: z
21
21
  .enum([
22
+ "create",
23
+ "search_images",
22
24
  "generate",
23
25
  "list",
24
26
  "get",
@@ -28,7 +30,8 @@ export const carrosselSchema = z.object({
28
30
  "set_image",
29
31
  "cover",
30
32
  ])
31
- .describe("generate (gera um carrossel do zero a partir de brief OU artigo, 350 Sinapses, estorna se falhar) · list (seus carrosséis) · get (payload inteiro + catálogo de layouts, paletas, folhas e a assinatura, tudo pra você escrever os slides) · update (grava o payload inteiro de volta, normalizado no servidor) · auto_images (a IA escolhe fotos do banco pros slides, 60 Sinapses; generateMissing gera as que faltarem, ~450 cada) · generate_image (foto nova pra UM slide, ~450) · set_image (põe no slide uma peça SUA ou pública, pelo ID citável img_…, sem custo) · cover (a Capa IA: capa 16:9 com o texto queimado, fatiada em duas e posta na frente do carrossel, cobra pelo motor da capa)."),
33
+ .describe("create (GRÁTIS: cria o carrossel com o texto que VOCÊ escreveu, a casa só grava; sem payload nasce vazio e você segue por get → update) · search_images (GRÁTIS: busca fotos no banco da casa por palavra, devolve o id pra set_image) · generate (a IA da casa escreve do zero a partir de brief OU artigo, 350 Sinapses, estorna se falhar) · list (seus carrosséis) · get (payload inteiro + catálogo de layouts, paletas, folhas e a assinatura, tudo pra você escrever os slides) · update (grava o payload inteiro de volta, normalizado no servidor, grátis) · auto_images (a IA escolhe fotos do banco pros slides, 60 Sinapses; generateMissing gera as que faltarem, ~450 cada) · generate_image (foto NOVA pra UM slide, cobra pelo motor: imageModel 'flux-3-klein' é o barato, 60 Sinapses) · set_image (põe no slide uma foto do banco pelo stockImageId OU uma peça sua ou pública pelo img_…, grátis) · cover (a Capa IA: capa 16:9 com o texto queimado, fatiada em duas e posta na frente do carrossel, cobra pelo motor da capa). " +
34
+ "Caminho de custo ZERO: create → get (catálogo) → update (seus textos) → search_images → set_image em cada slide de foto → mande a url do editor pra pessoa abrir e baixar."),
32
35
  // generate
33
36
  brief: z
34
37
  .string()
@@ -49,7 +52,17 @@ export const carrosselSchema = z.object({
49
52
  aspect: z
50
53
  .enum(["4:5", "9:16"])
51
54
  .optional()
52
- .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."),
55
+ .describe("generate e create: 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."),
56
+ // search_images
57
+ query: z
58
+ .string()
59
+ .optional()
60
+ .describe("search_images: o que procurar, em palavras do assunto da foto (ex.: 'mar noturno', 'mãos', 'cidade chuva'). Busca em título, tags e descrição. Sem query devolve as mais recentes."),
61
+ orientation: z
62
+ .enum(["vertical", "horizontal", "square"])
63
+ .optional()
64
+ .describe("search_images: filtra pelo formato da foto. Pra folha 4:5 ou 9:16, prefira 'vertical'."),
65
+ limit: z.number().int().min(1).max(40).optional().describe("search_images: quantas fotos (default 12, max 40)."),
53
66
  brandSlug: z
54
67
  .string()
55
68
  .optional()
@@ -66,15 +79,15 @@ export const carrosselSchema = z.object({
66
79
  carouselId: z
67
80
  .string()
68
81
  .optional()
69
- .describe("O id do carrossel (vem do generate e do list). Obrigatório em get, update, auto_images, generate_image, set_image; opcional no cover (sem ele a capa só é gerada)."),
82
+ .describe("O id do carrossel (vem do create, do generate e do list). Obrigatório em get, update, auto_images, generate_image, set_image; opcional no cover (sem ele a capa só é gerada)."),
70
83
  payload: z
71
84
  .any()
72
85
  .optional()
73
- .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. " +
86
+ .describe("create (opcional) e 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. " +
74
87
  "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. " +
75
88
  "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. " +
76
89
  "Foto NOVA não entra por URL aqui: use set_image (ID da peça) ou generate_image."),
77
- title: z.string().optional().describe("update: novo título do carrossel (opcional)."),
90
+ title: z.string().optional().describe("create e update: o título do carrossel (opcional)."),
78
91
  baseUpdatedAt: z
79
92
  .number()
80
93
  .optional()
@@ -90,10 +103,18 @@ export const carrosselSchema = z.object({
90
103
  .describe("auto_images: true gera foto nova pros slides que o banco não cobriu (até 4, ~450 Sinapses cada). Avise o custo antes."),
91
104
  slideId: z.string().optional().describe("generate_image e set_image: o id do slide (vem do get)."),
92
105
  customPrompt: z.string().optional().describe("generate_image: direção da cena (opcional; sem ela a cena sai do texto do slide)."),
106
+ imageModel: z
107
+ .enum(["nano-banana-2", "flux-3-klein"])
108
+ .optional()
109
+ .describe("generate_image: o motor da foto. 'nano-banana-2' (Nano Banana 2.1, padrão: segue o estilo do banco por referência, preço do catálogo em sapiens_image action=models) ou 'flux-3-klein' (FLUX 3 Image Klein: o barato, 60 Sinapses a foto, texto puro; preço que vale SÓ aqui, no slide do carrossel, e a foto não rende prêmio de publicar). Avise o custo antes."),
93
110
  handle: z
94
111
  .string()
95
112
  .optional()
96
- .describe("set_image: o ID citável da peça (img_…), que o usuário copia no detalhe dela ou vem de sapiens_reference/sapiens_gallery. Peça sua ou pública."),
113
+ .describe("set_image: o ID citável da peça (img_…), que o usuário copia no detalhe dela ou vem de sapiens_reference/sapiens_gallery. Peça sua ou pública. Use handle OU stockImageId."),
114
+ stockImageId: z
115
+ .string()
116
+ .optional()
117
+ .describe("set_image: o id de uma foto do banco da casa (o campo id do search_images). Grátis. Use stockImageId OU handle."),
97
118
  focalX: z.number().min(0).max(1).optional().describe("set_image: ponto focal horizontal (0 a 1, default 0.5)."),
98
119
  focalY: z.number().min(0).max(1).optional().describe("set_image: ponto focal vertical (0 a 1, default 0.5)."),
99
120
  // cover
@@ -119,8 +140,56 @@ function coercePayload(raw) {
119
140
  }
120
141
  }
121
142
  export async function carrossel(args) {
143
+ // O banco da casa é público (a linha ativa): a busca não pede login, e a
144
+ // pessoa pode escolher as fotos antes mesmo de conectar a conta.
145
+ if (args.action === "search_images") {
146
+ const limit = args.limit ?? 12;
147
+ const buscar = (search) => convexQuery("stock:getImages", {
148
+ limit,
149
+ ...(search ? { search } : {}),
150
+ ...(args.orientation ? { orientation: args.orientation } : {}),
151
+ });
152
+ // O texto de busca do banco guarda o acento como foi escrito: as tags
153
+ // automáticas vêm sem ("xicara de cafe") e as manuais com ("cinemático").
154
+ // Quem pede "café" não achava nada. Busca as duas formas e junta.
155
+ const termo = args.query?.trim() || undefined;
156
+ const semAcento = termo?.normalize("NFD").replace(/[̀-ͯ]/g, "");
157
+ const listas = await Promise.all(termo && semAcento && semAcento !== termo ? [buscar(semAcento), buscar(termo)] : [buscar(termo)]);
158
+ const vistos = new Set();
159
+ const fotos = listas
160
+ .flat()
161
+ .filter((f) => f && !vistos.has(f._id) && vistos.add(f._id))
162
+ .slice(0, limit);
163
+ // Resposta enxuta: quem lê é o Claude da pessoa, e cada foto do banco traz
164
+ // dezenas de tags (inglês, português, artista parecido, carimbo do tagger).
165
+ const RUIDO = /autotagger|similar artist|artista similar/i;
166
+ return {
167
+ custo: 0,
168
+ total: fotos.length,
169
+ fotos: fotos.map((f) => ({
170
+ id: f._id,
171
+ title: f.title,
172
+ description: f.description
173
+ ? String(f.description).replace(/^#\s*Description\s*/i, "").slice(0, 240)
174
+ : null,
175
+ tags: (f.tags ?? []).filter((t) => !RUIDO.test(t)).slice(0, 10),
176
+ width: f.width ?? null,
177
+ height: f.height ?? null,
178
+ thumbnailUrl: f.thumbnailUrl ?? f.url,
179
+ })),
180
+ dica: "Ponha a foto num slide com action=set_image carouselId=… slideId=… stockImageId=<id>. Só slide de layout com foto (requiresImage no get) mostra a imagem.",
181
+ };
182
+ }
122
183
  const sessionToken = getSessionToken();
123
184
  switch (args.action) {
185
+ case "create":
186
+ // GRÁTIS: quem escreve é você; a casa valida e grava.
187
+ return await convexMutation("carouselMcp:mcpCreateCarouselFree", {
188
+ sessionToken,
189
+ ...(args.payload !== undefined ? { payload: coercePayload(args.payload) } : {}),
190
+ ...(args.title?.trim() ? { title: args.title.trim() } : {}),
191
+ ...(args.aspect ? { aspect: args.aspect } : {}),
192
+ });
124
193
  case "generate": {
125
194
  const brief = args.brief?.trim();
126
195
  const fontes = [brief, args.articleId, args.userArticleId].filter(Boolean).length;
@@ -172,16 +241,23 @@ export async function carrossel(args) {
172
241
  carouselId: need(args.carouselId, "carouselId"),
173
242
  slideId: need(args.slideId, "slideId"),
174
243
  ...(args.customPrompt ? { customPrompt: args.customPrompt } : {}),
244
+ ...(args.imageModel ? { imageModel: args.imageModel } : {}),
175
245
  });
176
- case "set_image":
246
+ case "set_image": {
247
+ const handle = args.handle?.trim();
248
+ const stockImageId = args.stockImageId?.trim();
249
+ if (!!handle === !!stockImageId) {
250
+ throw new Error("set_image: passe UM dos dois, handle (img_…) OU stockImageId (do search_images).");
251
+ }
177
252
  return await convexMutation("carouselMcp:mcpSetSlideImage", {
178
253
  sessionToken,
179
254
  carouselId: need(args.carouselId, "carouselId"),
180
255
  slideId: need(args.slideId, "slideId"),
181
- handle: need(args.handle, "handle"),
256
+ ...(handle ? { handle } : { stockImageId }),
182
257
  ...(args.focalX !== undefined ? { focalX: args.focalX } : {}),
183
258
  ...(args.focalY !== undefined ? { focalY: args.focalY } : {}),
184
259
  });
260
+ }
185
261
  case "cover":
186
262
  return await convexAction("capaIa:mcpCapaIa", {
187
263
  sessionToken,
@@ -71,7 +71,7 @@ export const stockAudioSchema = z.object({
71
71
  provider: z
72
72
  .enum(["mirelo", "elevenlabs"])
73
73
  .optional()
74
- .describe("action=generate: 'mirelo' (padrão, 35 Sinapses/s, mín 70) | 'elevenlabs' (premium, 60/s, mín 120)."),
74
+ .describe("action=generate: 'elevenlabs' (padrão, 35 Sinapses/s, mín 70; segue o texto ao pé da letra) | 'mirelo' (35 Sinapses/s, mín 70; lê a descrição com liberdade)."),
75
75
  promptInfluence: z
76
76
  .number()
77
77
  .min(0)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sapiens-mcp",
3
- "version": "1.112.0",
3
+ "version": "1.113.1",
4
4
  "mcpName": "com.sapiensinteticos/sapiens",
5
5
  "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. mcprush.com-bd2545268b8471cdb213c674",
6
6
  "type": "module",