sapiens-mcp 1.106.0 → 1.107.0
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 +26 -26
- package/dist/remote.js +54 -13
- package/dist/skills.js +19 -2
- package/dist/tools/article.js +1 -1
- package/dist/tools/aula.js +1 -1
- package/dist/tools/character.js +1 -1
- package/dist/tools/community.js +1 -1
- package/dist/tools/contaApi.js +90 -0
- package/dist/tools/distribution.js +5 -4
- package/dist/tools/forum.js +3 -3
- package/dist/tools/image.js +1 -1
- package/dist/tools/meta.js +26 -6
- package/dist/tools/persona.js +6 -6
- package/dist/tools/pipeline.js +5 -5
- package/dist/tools/reference.js +3 -3
- package/dist/tools/repertorio.js +1 -1
- package/dist/tools/search.js +1 -1
- package/dist/tools/sintetico.js +2 -2
- package/dist/tools/studios.js +2 -2
- package/dist/tools/video.js +5 -5
- package/package.json +1 -1
package/dist/registry.js
CHANGED
|
@@ -52,7 +52,7 @@ import { skillMenuLine } from "./skills.js";
|
|
|
52
52
|
* schemas + handlers), as instructions da casa e o dispatch. Fonte ÚNICA usada
|
|
53
53
|
* pelos DOIS transportes: o stdio (index.ts, pacote npm/npx) e o remoto
|
|
54
54
|
* streamable HTTP (remote.ts, rota /api/mcp do site). Mexeu aqui, mexeu nos
|
|
55
|
-
* dois ao mesmo tempo
|
|
55
|
+
* dois ao mesmo tempo, é o ponto.
|
|
56
56
|
*
|
|
57
57
|
* Tool nova ou removida aqui: atualize junto o EXPECTED_TOOLS de
|
|
58
58
|
* test/server.test.mjs e as contagens fixas de test/remote.test.mjs e
|
|
@@ -62,7 +62,7 @@ import { skillMenuLine } from "./skills.js";
|
|
|
62
62
|
*/
|
|
63
63
|
export const TOOLS = {
|
|
64
64
|
sapiens_pipeline: {
|
|
65
|
-
description: "CRUD do content pipeline Sapiens (sources/productions/publishables). Sub-actions: list_sources, list_articles (use includeDrafts pra incluir drafts; onlyAvailable pra esconder os já virados em source), get_source, get_production, list_versions, add_article_as_source, create_draft_article_and_source (seed), create_production (sourceId+format → productionId draft), update_production (substitui payload, opcionalmente muda status), finalize_production (cria publishable v1, v2... com snapshot), remove_production, remove_source, set_source_done, update_source_notes, restore_version (volta payload duma versão antiga), set_publishable_title (renomeia um publishable), backfill_via (rotula em lote o campo 'via' das productions antigas; dryRun=true só lista), propose_mega_grafico_plan (granular: só gera plano via Gemini, devolve fullPrompt+spec), run_mega_grafico_full (ONE-SHOT, recomendado: cria production+propõe plano+gera imagem+aplica selo Sapiens+finaliza publishable numa chamada só), generate_carousel (gera um carrossel standalone a partir de brief OU articleId, com imagens do banco; devolve id + url do editor pro humano abrir, ajustar e exportar; cobra Sinapses, reembolsa se falhar; model é a FORMA: 'feed' (padrão), 'reflexao', 'case' ou 'editorial' (a IA escolhe os layouts); aspect é o TAMANHO da folha: '4:5' (padrão, o feed mostra inteira) ou '9:16' (tela cheia); dá pra trocar os dois depois no editor. O membro faz o mesmo pela sapiens_carrossel). generate_carousel_production (o IRMÃO PIPELINE do generate_carousel: recebe um sourceId de artigo, CRIA a production carrossel_ig e a preenche pelo MESMO motor da casa, já no shape editorial (templateId+slots) que o editor de pipeline renderiza
|
|
65
|
+
description: "CRUD do content pipeline Sapiens (sources/productions/publishables). Sub-actions: list_sources, list_articles (use includeDrafts pra incluir drafts; onlyAvailable pra esconder os já virados em source), get_source, get_production, list_versions, add_article_as_source, create_draft_article_and_source (seed), create_production (sourceId+format → productionId draft), update_production (substitui payload, opcionalmente muda status), finalize_production (cria publishable v1, v2... com snapshot), remove_production, remove_source, set_source_done, update_source_notes, restore_version (volta payload duma versão antiga), set_publishable_title (renomeia um publishable), backfill_via (rotula em lote o campo 'via' das productions antigas; dryRun=true só lista), propose_mega_grafico_plan (granular: só gera plano via Gemini, devolve fullPrompt+spec), run_mega_grafico_full (ONE-SHOT, recomendado: cria production+propõe plano+gera imagem+aplica selo Sapiens+finaliza publishable numa chamada só), generate_carousel (gera um carrossel standalone a partir de brief OU articleId, com imagens do banco; devolve id + url do editor pro humano abrir, ajustar e exportar; cobra Sinapses, reembolsa se falhar; model é a FORMA: 'feed' (padrão), 'reflexao', 'case' ou 'editorial' (a IA escolhe os layouts); aspect é o TAMANHO da folha: '4:5' (padrão, o feed mostra inteira) ou '9:16' (tela cheia); dá pra trocar os dois depois no editor. O membro faz o mesmo pela sapiens_carrossel). generate_carousel_production (o IRMÃO PIPELINE do generate_carousel: recebe um sourceId de artigo, CRIA a production carrossel_ig e a preenche pelo MESMO motor da casa, já no shape editorial (templateId+slots) que o editor de pipeline renderiza, prefira ESTE a create_production+payload cru pro carrossel, que abre VAZIO no editor; devolve productionId + url do editor de pipeline; admin-only, cobra Sinapses, reembolsa se falhar; model opcional trava a folha registrada; beats opcional entrega copy PRONTO por beat da espinha, [{n, slots}], quando o agente JÁ escreveu e validou os blocos: com beats o Gemini de escrita NÃO roda e a rodada cobra só o picker de imagens, zero com autoPickImages=false; caption opcional vira a legenda do meta). CARROSSEL FINO (edição sem tela, admin-only): list_carousels (seus carrosséis standalone), get_carousel (payload completo + catálogo de templates com slots/limites + paletas + o formato da peça e os válidos, tudo pra VOCÊ escrever os slides), update_carousel (payload inteiro de volta, normalizado no servidor; preserve os campos image dos slides que não mexeu E o theme inteiro, com a folha (theme.sheet) e a assinatura (theme.signature): o que faltar volta pro padrão), carousel_auto_images (IA escolhe imagens do banco pros slides de foto, 60 Sinapses; aceita carouselId standalone OU productionId de carrossel da pipeline; makeVisual=true converte slides de texto pra layouts de foto antes, ritmo visual; generateMissing=true gera imagem nova pros que o banco não cobrir, ~450 Sinapses cada, até 4, avise o custo antes), carousel_generate_image (imagem nova pra UM slide, ~450 Sinapses, customPrompt opcional), capa_ia (A CAPA SEAMLESS: gera uma imagem 16:9 contínua com o TEXTO QUEIMADO dentro dela e o elemento vivo cruzando as letras, fatia em duas peças 3:4 no servidor e, com carouselId, já põe as duas na frente do carrossel. É a capa mais bonita da casa e a única em que o sujeito passa na frente e atrás do título, porque o texto é parte da imagem, não overlay. Args: capaHeadline (obrigatório), capaSubline, capaRightText (cai no 2º slide), capaElement e capaVibe (omitidos, a IA escolhe pela pauta), capaImageModel. O MOTOR é a decisão que mais muda o resultado, porque capa é tipografia: gpt-image-2-high (default, 1200, o único da casa que entrega letra pequena legível, sai em 1536x1024) contra nano-banana-max (900, cena mais fiel e 2K de verdade, letra erra mais). Cobra pelo catálogo, no motor que rodou, e a peça entra na sua galeria como qualquer geração. Depois de gerada, ANIMAR a capa (o elemento deriva e o texto fica congelado) é ato do editor, não do agente). Fluxo confortável (standalone): generate_carousel → get_carousel → update_carousel (afia os textos) → carousel_auto_images → humano abre a url pra exportar. Fluxo pipeline (carrossel atrelado a um artigo/source): generate_carousel_production (sourceId) → humano abre a url do editor de pipeline pra revisar e finalizar (finalize_production). Fluxo pipeline com copy do agente (a skill escreveu os blocos): generate_carousel_production (sourceId + model + beats) → carousel_auto_images (productionId) se faltar foto → humano revisa e finaliza. Pra mega_grafico, SEMPRE prefira run_mega_grafico_full em vez de sequenciar manualmente (menos drift). Idempotente só na production (passa productionId pra reusar a MESMA row), mas cada run RE-GERA a imagem e cobra de novo (~900 Sinapses): não é grátis re-rodar. OBRIGATÓRIO perguntar ao user antes se withHelen=true (cartoon Helen interage com tema, ~15-25% do poster) ou false (poster 100% diagramático). Custo ~900-1000 sinapses por geração. run_mega_grafico_full, generate_carousel, generate_carousel_production, carousel_auto_images (com generateMissing) e carousel_generate_image são SÍNCRONAS e pesadas: vale a REGRA DO TIMEOUT (podem cobrar mesmo voltando 'Timeout'; cheque get_carousel/dashboard antes de repetir). Use skipFinalize=true se quiser deixar production em 'ready' pro admin revisar antes de publishable. Payload livre por formato, chame sapiens_meta action=formats pra ver schemas sugeridos.",
|
|
66
66
|
schema: pipelineSchema,
|
|
67
67
|
handler: pipeline,
|
|
68
68
|
},
|
|
@@ -77,7 +77,7 @@ export const TOOLS = {
|
|
|
77
77
|
handler: image,
|
|
78
78
|
},
|
|
79
79
|
sapiens_meta: {
|
|
80
|
-
description: "Utilitários transversais: start (porta de entrada do primeiro contato
|
|
80
|
+
description: "Utilitários transversais: start (porta de entrada do primeiro contato: sem login ensina a conectar; com login mostra saldo/tier + primeiros poderes com exemplo pronto + 'comece por aqui'), login (conecta a conta com o código de sapiensinteticos.com/conectar-claude, salva a sessão localmente; ela vale 90 dias e renova sozinha a cada uso), logout (desconecta de verdade: revoga a chave no servidor e apaga o token local), whoami (tier user/admin + saldo + email), credits (saldo agregado), subscription (plan + status + saldo por bucket subscription/grants/free + warnings low/critical), formats (schemas por formato), health (inclui a versão do MCP), version (qual versão do sapiens-mcp está REALMENTE rodando + se é a última do npm; não exige login; use pra saber se o client pegou a versão nova ou ficou preso em cache do npx), app_url (URLs canônicas), precos (a tabela de preço do membro em duas carteiras separadas, com regras próprias: app = cada motor do App em Sinapses, com o detalhe por resolução e por segundo de vídeo e o link do card em /motores; api = a API da conta, com saldo próprio em dólar: preço por imagem, a partir de no vídeo (o exato pela cotação grátis) e texto por milhão de tokens com midia=texto. Sinapse não se converte em dólar. Pra comparar com fal.ai, WaveSpeed ou outro serviço que cobra em dólar, use a parte api. midia recorta, busca filtra pelo nome), api (a conta da API da pessoa, SÓ LEITURA: saldo em dólar, livre, o que está preso em chamada aberta, crédito de teste e quando vence, gasto do dia, as chaves com nome, o fim e o teto do dia, nunca a chave nem o hash, a recarga automática no cartão ou em stablecoin e o rendimento; assinar, mover dinheiro, mudar o limite da carteira, ligar recarga e criar chave ficam no site, com a carteira dela e o segundo fator). Use credits/subscription antes de gerar imagem pra avisar se vai estourar; pra pagar em dólar, action=api diz o livre.",
|
|
81
81
|
schema: metaSchema,
|
|
82
82
|
handler: meta,
|
|
83
83
|
},
|
|
@@ -87,7 +87,7 @@ export const TOOLS = {
|
|
|
87
87
|
handler: skill,
|
|
88
88
|
},
|
|
89
89
|
sapiens_repertorio: {
|
|
90
|
-
description: "Acervo pessoal de filme/série/anime/jogo/jogo de tabuleiro/livro/música/pessoa (Repertório, o segundo cérebro do user). Reads: list (filtros mediaType/status), search (texto em title/genres/tags), get (detalhe), popArticles, resolve (busca capa/ano/id nos providers server-side: OMDb/IGDB-Twitch/AniList/Google Books/iTunes/Wikidata). Mutations (qualquer logado, mexem no PRÓPRIO acervo): add_item, update_item (status/rating/tags/note/isPublic), remove_item. CAPTURA ONE-SHOT travada na lista de providers: quando o user fala natural ('acabei de ver Duna 2, nota 9', 'tô jogando Hollow Knight', 'li tal livro'), (1) infira mediaType e status (assisti/zerei/li=completed, quero=backlog, tô jogando/vendo=active, dropei=dropped) e rating se citado; (2) chame action=resolve {mediaType, query}, escolha o candidato certo e faça add_item passando SÓ o source + externalId DELE + os campos pessoais (status/rating/tags/note). O servidor re-resolve no provider e grava título/capa/ano canônicos
|
|
90
|
+
description: "Acervo pessoal de filme/série/anime/jogo/jogo de tabuleiro/livro/música/pessoa (Repertório, o segundo cérebro do user). Reads: list (filtros mediaType/status), search (texto em title/genres/tags), get (detalhe), popArticles, resolve (busca capa/ano/id nos providers server-side: OMDb/IGDB-Twitch/AniList/Google Books/iTunes/Wikidata). Mutations (qualquer logado, mexem no PRÓPRIO acervo): add_item, update_item (status/rating/tags/note/isPublic), remove_item. CAPTURA ONE-SHOT travada na lista de providers: quando o user fala natural ('acabei de ver Duna 2, nota 9', 'tô jogando Hollow Knight', 'li tal livro'), (1) infira mediaType e status (assisti/zerei/li=completed, quero=backlog, tô jogando/vendo=active, dropei=dropped) e rating se citado; (2) chame action=resolve {mediaType, query}, escolha o candidato certo e faça add_item passando SÓ o source + externalId DELE + os campos pessoais (status/rating/tags/note). O servidor re-resolve no provider e grava título/capa/ano canônicos, você NÃO manda título/capa nem inventa externalId. (3) Se o resolve não achar (lista vazia/providerKeyMissing), NÃO dá pra adicionar: diga ao user que não encontrou nos providers (não fabrique entry manual). Upsert/dedup por (userId, source, externalId). Só pergunte se ambíguo entre candidatos. FERRAMENTAS DE IA (Repertório de Ferramentas): fluxo separado (vêm do catálogo aitag, não dos providers de mídia). action=search_tools {query} acha a ferramenta no catálogo e devolve o toolId; action=add_tool {toolId, favorite?, rating?, note?} grava como mediaType 'tool' (estar no acervo já é 'usei'; favorite=true liga a estrela). Use quando o user fala 'adiciona o Midjourney/Cursor no meu repertório de ferramentas' ou 'uso tal ferramenta de IA'. Cada ferramenta aponta pra página dela no aitag. CATÁLOGO (ADMIN, o dono): action=catalog_tool cadastra no AItag uma ferramenta OPEN SOURCE que ainda não está lá {toolId, name, githubUrl, categoryEn, descriptionEn, descriptionPt, e de preferência reviewEn/reviewPt, websiteUrl, tags}; devolve created, toolId e a url aitag.app/tool/<toolId>. Idempotente: o mesmo repo (mesmo com outro toolId) devolve a ficha existente e só preenche a análise que estiver vazia, nunca sobrescreve. Rode search_tools antes; é a porta da skill achado. SAPIENS (pessoas, ombros de gigantes; a aba no site chama Sapiens): mediaType 'person' cataloga gente que inspira (cineasta, mangaká, cientista, escritor) via Wikidata. Mesmo fluxo de mídia: resolve {mediaType:'person', query:'Osamu Tezuka'} → add_item com source 'wikidata' + o QID do candidato. O servidor grava foto, ocupações, bio e o link da Wikipedia; entra como completed (estar no acervo = me inspira). Use quando o user fala 'adiciona o Miyazaki nas minhas inspirações/nos meus sapiens/no meu repertório'. JOGO DE TABULEIRO (e de cartas; a aba no site chama Tabuleiro): mediaType 'boardgame', porque 'game' é videogame e o IGDB não conhece tabuleiro. Também via Wikidata: resolve {mediaType:'boardgame', query:'Galactic Cruise'} → add_item com source 'wikidata' + o QID do candidato. Busque pelo título em inglês, que é como a Wikidata cadastra; o designer vem no campo authors do candidato e separa homônimos. O servidor grava designers, editoras e o link da página do jogo no BGG. Lançamento muito recente pode ainda não estar na Wikidata: resolve vazio = diga isso à pessoa, não fabrique. Use quando o user fala 'joguei Catan', 'quero jogar Rebirth', 'adiciona esse jogo de tabuleiro'.",
|
|
91
91
|
schema: repertorioSchema,
|
|
92
92
|
handler: repertorio,
|
|
93
93
|
},
|
|
@@ -102,12 +102,12 @@ export const TOOLS = {
|
|
|
102
102
|
handler: pontes,
|
|
103
103
|
},
|
|
104
104
|
sapiens_community: {
|
|
105
|
-
description: "Chat da comunidade Sapiens (assinantes + alumni). Sub-actions: list (últimas N mensagens da sala 'geral' por default), send (Claude posta como intercessor do user; sufixo '· via Claude' é adicionado pelo servidor), react (toggle emoji numa mensagem
|
|
105
|
+
description: "Chat da comunidade Sapiens (assinantes + alumni). Sub-actions: list (últimas N mensagens da sala 'geral' por default), send (Claude posta como intercessor do user; sufixo '· via Claude' é adicionado pelo servidor), react (toggle emoji numa mensagem, allowlist 👍🔥❤️🚀🤯), participants (quem está na sala: username/name/isBot + o `mention` pronto pra usar, use pra saber com quem falar), search_users (acha alguém por parte do nome/@username, autocomplete de menção). MENÇÃO: escreva '@username' no content do send e o servidor NOTIFICA a pessoa citada (sino + Telegram); descubra o username certo via participants/search_users antes. ANEXO do PRÓPRIO acervo no send: mediaAssetKind (track|video|film|comic) + mediaAssetId monta um card da peça (posse conferida no servidor); asTese=true posta a fala como TESE (card de marca, pingável pro Fórum). Voz nas postagens deve seguir o DNA editorial Sapiens (anti-corporate, primeira pessoa, sem em-dash).",
|
|
106
106
|
schema: communitySchema,
|
|
107
107
|
handler: community,
|
|
108
108
|
},
|
|
109
109
|
sapiens_article: {
|
|
110
|
-
description: "NÃO CRIA ARTIGO: este tool só mexe em artigo que JÁ existe. Pra criar draft novo do blog use sapiens_pipeline action=create_draft_article_and_source (devolve articleId + sourceId), ou sapiens_quote_pop pra quote e pop-article. Não confunda com sapiens_write, que é o espaço pessoal do membro em /u/<username> (tabela user_articles), e nunca salve o texto num .md solto no repo: draft de blog mora na tabela articles. CRUD do resto: get (by slug, retorna doc completo pra edit local), update (patch em title/excerpt/tldr/content/tags/etc + VISUAIS: thumbnailUrl capa webp, ogImageUrl JPEG do preview social, bodyImages array das ilustrações inline, conceptMap mapa visual, pra recapear um artigo num novo estilo; NÃO toca status/column/format), publish (status='published', set publishedAt), unpublish (volta pra draft), delete (irreversível), ensure_visuals (gera banner/ilustrações inline/conceptMap que faltam no artigo; idempotente, pula o que existe; ~2550 Sinapses num artigo pelado (capa 450 + 2 ilustracoes de 450 + mapa 1200; inlineCount=1 baixa pra ~2100), forceBanner/forceInline/forceConceptMap regeram). ensure_visuals é ASSÍNCRONA: volta NA HORA com {status:'running', plan} e a leva corre no servidor, como o vídeo. NÃO repita a chamada pra ver se andou (cada leva gera e COBRA de novo, e as ilustrações somam)
|
|
110
|
+
description: "NÃO CRIA ARTIGO: este tool só mexe em artigo que JÁ existe. Pra criar draft novo do blog use sapiens_pipeline action=create_draft_article_and_source (devolve articleId + sourceId), ou sapiens_quote_pop pra quote e pop-article. Não confunda com sapiens_write, que é o espaço pessoal do membro em /u/<username> (tabela user_articles), e nunca salve o texto num .md solto no repo: draft de blog mora na tabela articles. CRUD do resto: get (by slug, retorna doc completo pra edit local), update (patch em title/excerpt/tldr/content/tags/etc + VISUAIS: thumbnailUrl capa webp, ogImageUrl JPEG do preview social, bodyImages array das ilustrações inline, conceptMap mapa visual, pra recapear um artigo num novo estilo; NÃO toca status/column/format), publish (status='published', set publishedAt), unpublish (volta pra draft), delete (irreversível), ensure_visuals (gera banner/ilustrações inline/conceptMap que faltam no artigo; idempotente, pula o que existe; ~2550 Sinapses num artigo pelado (capa 450 + 2 ilustracoes de 450 + mapa 1200; inlineCount=1 baixa pra ~2100), forceBanner/forceInline/forceConceptMap regeram). ensure_visuals é ASSÍNCRONA: volta NA HORA com {status:'running', plan} e a leva corre no servidor, como o vídeo. NÃO repita a chamada pra ver se andou (cada leva gera e COBRA de novo, e as ilustrações somam), acompanhe com visuals_status (custo 0) até jobStatus='done' ou 'error'. Quando não há nada faltando, ela responde na hora com status:'idle' e o retrato dos visuais, de graça: é a sonda pra saber o que o artigo já tem. Leva já em andamento devolve alreadyRunning:true em vez de abrir outra. visuals_status (custo 0) traz jobStatus (none/running/done/error/stale), o plano da leva, custo, erro e o estado real (hasBanner, inlineCount, hasConceptMap); 'stale' é leva que passou do teto de 10min do servidor sem fechar, ou seja, ninguém está mais gerando.",
|
|
111
111
|
schema: articleSchema,
|
|
112
112
|
handler: article,
|
|
113
113
|
},
|
|
@@ -132,7 +132,7 @@ export const TOOLS = {
|
|
|
132
132
|
handler: studios,
|
|
133
133
|
},
|
|
134
134
|
sapiens_persona: {
|
|
135
|
-
description: "Persona Sapiens
|
|
135
|
+
description: "Persona Sapiens: quiz MBTI + perfil do user + arte dos 16 arquétipos. PRIMÁRIO (de graça, qualquer logado): get_quiz (48 perguntas Likert 1..7 + escala, estático, Claude aplica conversando), submit_quiz (manda as 48 respostas {questionId,value}, scoring server-side, salva no perfil; refazer cria profile novo), my_profile (lê tipo atual + persona + breakdown dos 4 eixos com confiança + histórico). SECUNDÁRIO: list_codes (16 codes + grupo NT/NF/SJ/SP, estático), list_generated (personaArtData.getAll, quais artes já existem), generate (arte de 1 arquétipo, 450 Sinapses, combina com 'gera a arte do meu tipo' depois do quiz). Codes: INTJ/INTP/ENTJ/ENTP/INFJ/INFP/ENFJ/ENFP/ISTJ/ISFJ/ESTJ/ESFJ/ISTP/ISFP/ESTP/ESFP.",
|
|
136
136
|
schema: personaSchema,
|
|
137
137
|
handler: persona,
|
|
138
138
|
},
|
|
@@ -142,7 +142,7 @@ export const TOOLS = {
|
|
|
142
142
|
handler: helen,
|
|
143
143
|
},
|
|
144
144
|
sapiens_musicator: {
|
|
145
|
-
description: "Musicator
|
|
145
|
+
description: "Musicator: loop completo de música via voz Sapiens, sem precisar da UI (qualquer logado; lyrics 300 / render 3000 Sinapses). Sub-actions: 'create' (cria brief+track draft num passo, custo 0, devolve trackId), 'lyrics' (gera letra PT + stylePrompt EN; passe trackId pra GRAVAR na track e deixar pronta pra render, ou sem trackId pra só receber o texto inline; 300 sinapses), 'list' (suas tracks: id/título/status/áudio), 'get' (detalhe de uma track pra acompanhar render, status/áudio/letra), 'render' (schedula o synth num trackId pronto, assíncrono fire-and-forget, 3/min; `model` escolhe o motor: 'pro' Lyria 3.5 (default), 'clip' Lyria 3 Clip, 'mureka' Mureka 9.5, 'minimax' MiniMax Music 2.6, 'elevenlabs' ElevenLabs Music com `durationSeconds` 30/60/120/180; preço fixo por faixa, menos o ElevenLabs, que cobra pela duração: puxe a skill 'musica' pra tabela antes de disparar), 'publish' (publica uma faixa PRONTA do user no Acervo da Comunidade (aba Músicas), com eco no Chat e Fórum; CURADO: só admin/dono, custo 0, idempotente), 'list_public' (lê o Acervo público de músicas da Comunidade, sem custo, sem login). Fluxo cheio: create → lyrics(trackId) → render → get (poll status: rendering → ready/failed) → publish (dono). Tudo escopado por dono (só mexe nas suas tracks).",
|
|
146
146
|
schema: musicatorSchema,
|
|
147
147
|
handler: musicator,
|
|
148
148
|
},
|
|
@@ -152,22 +152,22 @@ export const TOOLS = {
|
|
|
152
152
|
handler: agente,
|
|
153
153
|
},
|
|
154
154
|
sapiens_video: {
|
|
155
|
-
description: "Sapiens Video — gera vídeo (qualquer membro logado; vídeo é caro, cobra as Sinapses da sua conta). Sub-action 'create' (recomendada): escolhe modelo + config e gera num call (cria a row + renderiza). Modelos: 'sapiens-video-seedance' (Seedance 2.0, cena+áudio nativo, 4-15s, 480/720/1080p, t2v/i2v; aceita até 4 imagens de REFERÊNCIA via referenceImageIds/referenceImageUrls/referenceImagePaths (o H3 aceita até 9, o Omni 1.1 até 3; Kling, Hailuo, WAN 2.5 e 3.0 e os dois Spicy não), que guiam estilo/personagem/composição SEM virar o 1º frame — é o fluxo STORYBOARD: gere a folha de key poses com sapiens_image templateSlug='storyboard-sapiens-v1', passe folha + personagem como refs num t2v e descreva o take contínuo no prompt, citando as refs por descrição e mandando ignorar o traço do sketch; aceita também 1 VÍDEO DE MOVIMENTO via referenceVideoUrls (role 'refvideo' -> reference_videos, <=15s, host da casa): a coreografia/câmera do clipe guia o take, combinável com a folha), 'sapiens-video-seedance-2-fast' e 'sapiens-video-seedance-2-mini' (os irmãos do 2.0: MESMO repertório completo, incluindo referência, frame final e vídeo de movimento; o Fast custa 20% menos e o Mini METADE, ambos com teto 720p — pedir 1080p neles entrega e cobra 720p. Use o Mini pra iterar enquadramento/prompt barato e feche no 'sapiens-video-seedance' quando o take estiver certo), 'sapiens-video-seedance-25' (Seedance 2.5, a geração SEGUINTE e não um quarto tier da 2.0: take de 4 a 30s num fôlego, edita e estende vídeo, mesmo repertório de referência mais ÁUDIO como referência; teto 720p e ~1,5x o preço por segundo do 2.0. Duração é o que pesa aqui: 30s em 720p passa de 40 mil Sinapses, então confirme a duração com a pessoa antes de disparar. Quem precisa de 1080p fica no 'sapiens-video-seedance'), 'sapiens-video-kling' (Kling 3.0 Pro, anima imagem, 3-15s, sound opcional, i2v/t2v), 'sapiens-video-hailuo' (Hailuo 2.3 da MiniMax, física e movimento em 768p, 6 ou 10s, t2v/i2v) e 'sapiens-video-hailuo-pro' (o mesmo em 1080p, 5s fixo — duração não é param aqui): motores PUROS, sem áudio nativo, sem imagens de referência e sem frame final, então quem precisa disso fica no Seedance 2.0; o Pro é o 1080p mais barato da casa, 'sapiens-video-h3' (MiniMax H3: som nativo incluso sem toggle, 5 a 15s em '2k' ou '768p' (sem resolution cai no 2k, que custa 33% mais por segundo), t2v/i2v e frame final; ACEITA até 9 imagens e 3 vídeos de referência (somando 15s), o caminho de take longo com personagem travada; referência e frame inicial são exclusivos, mande um dos dois; o 2K de 15s leva uns 9 minutos de render, acompanhe em status e não gere de novo), 'sapiens-video-pvideo-2-pro' (P-Video-2 Pro, o H3 acelerado pela Pruna: o RASCUNHO de personagem travada, até 9 imagens contando referências e frame inicial e final no mesmo pedido, 5 a 15s em '480p' ou '768p', som nativo, o take volta em segundos; sem t2v, precisa de ao menos uma imagem ou um clipe; cobra por imagem além do segundo, então cote em 'price' com as mesmas imagens do create; aceita ainda até 3 vídeos (referenceVideoUrls) e 3 áudios (referenceAudioUrls, ou referenceAudioTrackIds pra faixa sua do sapiens_musicator) de referência, 15s somados por tipo, cada segundo cobrado à parte e medido pelo servidor antes do débito (cote com referenceVideoClipsSec, a duração de cada clipe, e referenceAudioSec), e keepAudio com um áudio só faz ele virar a trilha do take), 'sapiens-video-h3-spicy' (MiniMax H3 Spicy: o H3 SEM freio de conteúdo, i2v puro a partir de uma peça SUA gerada na casa, que é o que trava a identidade (veja FRAME NOS SPICY); 3 a 15s, 480p/768p/1080p, som nativo, frame final; o segundo de vídeo mais barato e o render mais rápido da casa), 'sapiens-video-seedance-spicy' (Seedance 2.0 Spicy: o 2.0 SEM freio, também i2v puro, som nativo; 4 a 15s em 480p e 720p, para em 10s em 1080p; sem frame final; o som tem interruptor no mesmo preço), 'sapiens-video-wan' (WAN 2.5, imagem que fala/canta com áudio+lip-sync, 5/10s, i2v), 'sapiens-video-wan-3' (WAN 3.0: texto ou imagem, som nativo com interruptor no mesmo preço, frame final, 5/8/10s em 480/720/1080p; sem imagem de referência), 'sapiens-video-flux-3-max' (FLUX 3 Max, fal + Black Forest Labs: texto ou imagem, 5 a 20s em 720p/1080p, som nativo com interruptor, frame final junto do inicial; sem imagem de referência), 'sapiens-video-ltx-25-fast-a2v', 'sapiens-video-ltx-25-pro-a2v' e 'sapiens-video-ltx-23-pro-a2v' (LTX Audio-to-Video, o caminho de a personagem CANTAR ou FALAR com o áudio da pessoa: o áudio vira o take, puxa a boca e o gesto e dita a duração e o preço; mande UM áudio (mp3 ou m4a): a faixa SUA do sapiens_musicator em referenceAudioTrackIds (o trackId; o servidor confere que é sua), ou um link de arquivo SEU em referenceAudioUrls (o trecho cortado; link de outra conta é recusado antes de cobrar) e a foto da ficha em startImageId/startImageUrl (sem foto, o prompt descreve a cena); até 20 s de áudio no 2.5 Fast e no 2.3 Pro, 10 s no 2.5 Pro, em 720p/1080p; durationSec não se usa, o servidor mede o áudio antes de cobrar; cote em 'price' com durationSec = os segundos do áudio), 'sapiens-video-ltx-25-fast' e 'sapiens-video-ltx-25-pro' (LTX 2.5: texto ou imagem, 6 a 20 s no Fast e 6 a 10 s no Pro, 720p/1080p, som nativo com interruptor, frame final junto do inicial; sem imagem de referência), 'sapiens-video-kling-motion' (Motion transfer: passa o movimento de um vídeo pra uma imagem, PRECISA de pessoa com tronco visível na imagem E no vídeo), 'sapiens-video-shot-mimic' (Shot Mimic: recria o plano/câmera/cortes de um vídeo de referência como cena nova), 'sapiens-video-omni-11' (Gemini Omni 1.1: texto ou imagem vira vídeo de 4, 6, 8 ou 10s (sem durationSec, 10s) com áudio nativo, de '360p' a '4k' (sem resolution, 720p; 360p custa 1/3 do 720p, 1080p 1,5x, 4k 3x); aceita até 3 imagens de referência; editOfImageId aponta um vídeo Omni seu e o prompt edita a MESMA cena, preservando câmera e ambiente; e VÍDEO-FONTE: sourceVideoId (vídeo seu da galeria) ou sourceVideoUrl (link da casa), mp4 até 10 s, editado (sourceVideoMode 'edit', o padrão, ex: trocar a pessoa do vídeo pelo personagem da imagem de referência, cobrado pelo tamanho do clipe) ou estendido ('extend', cobrado pelo durationSec do pedaço novo)) ('sapiens-video-omni', o Omni 1.0, e 'sapiens-video-lite/fast/quality', o Veo 3.1, SAÍRAM: o Google apagou os quatro em 22/10/2026 e o pedido é recusado antes de cobrar). Args create: model, prompt, durationSec, resolution ('480p'/'720p'/'1080p'; no H3 '768p'/'2k'; no Omni 1.1 '360p' a '4k'), audio, aspectRatio. RECEITA DE TAKE (templateSlug + brief), o irmão do templateSlug da imagem: em vez de escrever o prompt inteiro, passe templateSlug e a receita travada da casa embrulha a cena com estilo, cenário, arco, áudio e look, e ainda escolhe o motor (por isso model fica opcional). O `prompt` vira só a CENA e o `brief` preenche os campos do formato (subject, persona, hook, shots com voiceLine e propVisible, uvps, language, energy); campo vazio some do prompt em vez de virar buraco. Receitas de hoje: 'ugc-vertical-v1' (selfie que fala, o formato nativo de Reels/TikTok/Shorts), 'unboxing-vertical-v1' (mãos e reveal, som real do papel e do lacre), 'app-demo-vertical-v1' (a tela do app legível na mão da pessoa) e 'reflexao-vertical-v1' (talking-head lento pra ideia ou ensaio). Override de model/aspectRatio/durationSec/resolution vale dentro do que a receita aceita, e o erro lista as opções. Sub-action 'templates' (sem custo, sem login) traz o catálogo vivo com spec default, whitelist e os briefFields de cada uma. Isto substitui a tool sapiens_shorts, que era admin-only e só falava Veo 3.1 Fast; o mesmo UGC de 8s sai a 720p no Seedance 2.0 Mini por bem menos. FRAME INICIAL/FINAL POR REFERÊNCIA (recomendado): startImageId/endImageId (id da sua galeria) ou startImageUrl/endImageUrl (url de galeria/Acervo/personagem) — resolvidos server-side igual à imagem, descubra via sapiens_reference. FRAME POR ARQUIVO LOCAL (só no MCP instalado/stdio, não no remoto): startImagePath/endImagePath = caminho absoluto de uma imagem no seu PC (PNG/JPEG/WebP até 8MB); o processo lê o arquivo e sobe como frame inicial/final, igual a subir no gerador do site — 1 imagem inicial + 1 final por vídeo, então pra vários vídeos rode create uma vez por imagem. No remoto use id/url. Alternativa base64: references (role 'start'=imagem i2v, 'end'=frame final, 'driving'=vídeo de movimento do Motion). Suporte a frame final varia por modelo. FRAME NOS SPICY (h3-spicy, seedance-spicy, ltx-spicy): o frame vem SÓ de startImageId/startImageUrl (e endImageId/endImageUrl no H3 Spicy, o único que lê final) apontando uma peça SUA gerada na casa, e o servidor baixa o frame dessa peça. Arquivo local (startImagePath), base64 (references), upload, peça trazida por ponte e foto de fora são recusados: antes de cobrar quando a fonte já chega no pedido, ou no render, com as Sinapses de volta. Custo server-side por config. Sub-action 'generate' (legado): renderiza um imageId de vídeo já criado no site. Retorna {success, url, imageId, cost}. VITRINE (sem custo): sub-action 'demos' lista os SEUS demo films (kind=demo do Estúdio de Vídeo) com slug + estado de vitrine; sub-action 'showcase' põe/tira um demo (por slug) do mini-cinema da /conectar-claude, com showcaseTag (chip de capacidade) e showcaseOrder (ordem asc). Fluxo: 'demos' pra achar o slug, depois 'showcase' com showcase=true. Só entra na vitrine pública se for a conta da casa. VÍDEOS PROGRAMÁTICOS (ADMIN, sem custo): o Lab do Estúdio de Vídeo (/experimentos/films, tabela videoSpecs, 5 kinds: demo | aula-tour | essay | tipografia-musical | dataviz) opera por aqui sem browser — 'film-list' (todos os kinds; filtros filmKind/filmStatus), 'film-get' (spec inteiro por slug), 'film-upsert' (cria/atualiza por slug, idempotente; spec = objeto JSON no shape do 'Copiar spec' da tela, validação no servidor), 'film-status' (produção por slug: filmStatus + videoUrl + durationSecMeasured; o fecho do render é os três num call), 'film-publish' (Acervo aba Fitas + portfólio; exige pronto+URL), 'film-delete' (limpar rascunho). O RENDER do filme segue no agente local (skill /film, repo da casa): o MCP registra e fecha o ciclo, não renderiza. create é ASSÍNCRONA: cria o row, debita e volta NA HORA com {imageId, status:'rendering', cost} (não espera o render, que leva de segundos a minutos). Acompanhe com a sub-action 'status' (imageId) até status='completed' (traz a url) ou 'error'/'blocked'. NÃO chame create de novo enquanto renderiza (cria outro vídeo e cobra de novo); falha de provider refunda sozinha. EDIÇÃO (as ações da ficha do site, cada uma vira peça nova e o original fica): 'trim' (imageId + startSec, endSec opcional: corta um trecho; grátis), 'join' (imageIds: 2 a 8 vídeos SEUS na ordem, até 180 s somados: compilado; grátis), 'fecho' (imageId + ending 'marca'/'sapiens'/'none', watermark, musicUrl de trilha da casa, nameCard {name, subtitle}: fecha o vídeo com a assinatura da casa; grátis), 'render-ref' (imageId do take + refUrl da folha que o gerou: a peça com a referência ao lado; cobra Sinapses, o mesmo par já feito volta de graça). Síncronas, podem passar de 2 min: Timeout é o cliente desistindo, olhe sapiens_gallery action=list kind=video antes de repetir. RESOLUÇÃO: 'upscale' (imageId de vídeo SEU completed + resolution = o alvo, '720p', '1080p', '2k' ou '4k') gera uma VARIANTE nova em resolução maior, o original fica intacto; cobra Sinapses por segundo do clipe, mais caro quanto maior o alvo, assíncrona como o create (acompanhe em status). SOM: 'sonorize' (imageId de vídeo SEU completed + prompt do som da cena) gera uma VARIANTE nova com trilha sincronizada (o original fica intacto; sonorize sempre o original, nunca uma variante). engine escolhe o motor: 'mirelo-sfx-2.0' (42 Sinapses/s, o default: GUARDA a fala do clipe, tira a música e refaz o resto), 'mmaudio-v2' (20 Sinapses/s, segue o texto em vez da imagem: é o motor do bicho trocado, onde o Mirelo devolve o som do bicho original; refaz o som inteiro e a fala se perde) ou 'elevenlabs-video-to-music' (26 Sinapses/s, faz a TRILHA e não o som da cena: uma música que acompanha os cortes, mixada por baixo do som que o clipe já tem; o prompt descreve a música). ADMIN: 'shadows' (videoUrl + title) extrai o depth map (depth-map) de um vídeo: entra na sua timeline de vídeos e no Acervo como driving reutilizável; 'shadows-list' lista os depth maps prontos. PREÇO DE VÍDEO É FAIXA, NÃO NÚMERO: nos motores por segundo (todo Seedance, Kling, WAN 2.5 e 3.0, Hailuo, H3, os dois Spicy, Shot Mimic, e desde out/2026 o Gemini Omni) a conta é duração x resolução [x áudio], e OMITIR não pega o barato: sem 'resolution' o servidor cobra o tier MAIS CARO do motor (menos o Gemini Omni 1.1, que fica no 720p), sem 'durationSec' cobra o piso de duração (no Omni, o padrão: 10s). Um create de Seedance 2.0 sem resolution debita 1080p. Nunca prometa um valor sem cotar: sub-action 'price' (sem custo, sem login) devolve o número EXATO que o create vai debitar pra model + durationSec + resolution + audio, e avisa (clamped=true) quando o que você pediu não é o que vai ser cobrado. Sub-action 'models' (sem custo, sem login): lista os modelos ativos + a faixa de preço calculada pela mesma função que debita (priceDefault = o que uma chamada sem config custa, priceMin e priceMax = os dois cantos do motor, cada um com a config que o produz) + config (durações/resoluções) + disponibilidade (motor em preview pode aparecer como 'em breve'). LEGENDA (fita, por slug): 'caption-list' (sem custo, mostra os idiomas que a peça já tem), 'caption-generate' (captionLang = idioma FALADO; captionTrio=true já traduz pro trio da casa pt+en+ja na mesma chamada) e 'caption-translate' (captionLang = destino, parte sempre da faixa original). Cobra por minuto começado de vídeo: 50 Sinapses o minuto transcrito, 20 o traduzido, com a duração vindo do doc da peça. A legenda é desenhada pela casa em dois estilos (discreta e social), trocáveis no play sem regerar e sem custo.",
|
|
155
|
+
description: "Sapiens Video: gera vídeo (qualquer membro logado; vídeo é caro, cobra as Sinapses da sua conta). Sub-action 'create' (recomendada): escolhe modelo + config e gera num call (cria a row + renderiza). Modelos: 'sapiens-video-seedance' (Seedance 2.0, cena+áudio nativo, 4-15s, 480/720/1080p, t2v/i2v; aceita até 4 imagens de REFERÊNCIA via referenceImageIds/referenceImageUrls/referenceImagePaths (o H3 aceita até 9, o Omni 1.1 até 3; Kling, Hailuo, WAN 2.5 e 3.0 e os dois Spicy não), que guiam estilo/personagem/composição SEM virar o 1º frame, é o fluxo STORYBOARD: gere a folha de key poses com sapiens_image templateSlug='storyboard-sapiens-v1', passe folha + personagem como refs num t2v e descreva o take contínuo no prompt, citando as refs por descrição e mandando ignorar o traço do sketch; aceita também 1 VÍDEO DE MOVIMENTO via referenceVideoUrls (role 'refvideo' -> reference_videos, <=15s, host da casa): a coreografia/câmera do clipe guia o take, combinável com a folha), 'sapiens-video-seedance-2-fast' e 'sapiens-video-seedance-2-mini' (os irmãos do 2.0: MESMO repertório completo, incluindo referência, frame final e vídeo de movimento; o Fast custa 20% menos e o Mini METADE, ambos com teto 720p, pedir 1080p neles entrega e cobra 720p. Use o Mini pra iterar enquadramento/prompt barato e feche no 'sapiens-video-seedance' quando o take estiver certo), 'sapiens-video-seedance-25' (Seedance 2.5, a geração SEGUINTE e não um quarto tier da 2.0: take de 4 a 30s num fôlego, edita e estende vídeo, mesmo repertório de referência mais ÁUDIO como referência; teto 720p e ~1,5x o preço por segundo do 2.0. Duração é o que pesa aqui: 30s em 720p passa de 40 mil Sinapses, então confirme a duração com a pessoa antes de disparar. Quem precisa de 1080p fica no 'sapiens-video-seedance'), 'sapiens-video-kling' (Kling 3.0 Pro, anima imagem, 3-15s, sound opcional, i2v/t2v), 'sapiens-video-hailuo' (Hailuo 2.3 da MiniMax, física e movimento em 768p, 6 ou 10s, t2v/i2v) e 'sapiens-video-hailuo-pro' (o mesmo em 1080p, 5s fixo, duração não é param aqui): motores PUROS, sem áudio nativo, sem imagens de referência e sem frame final, então quem precisa disso fica no Seedance 2.0; o Pro é o 1080p mais barato da casa, 'sapiens-video-h3' (MiniMax H3: som nativo incluso sem toggle, 5 a 15s em '2k' ou '768p' (sem resolution cai no 2k, que custa 33% mais por segundo), t2v/i2v e frame final; ACEITA até 9 imagens e 3 vídeos de referência (somando 15s), o caminho de take longo com personagem travada; referência e frame inicial são exclusivos, mande um dos dois; o 2K de 15s leva uns 9 minutos de render, acompanhe em status e não gere de novo), 'sapiens-video-pvideo-2-pro' (P-Video-2 Pro, o H3 acelerado pela Pruna: o RASCUNHO de personagem travada, até 9 imagens contando referências e frame inicial e final no mesmo pedido, 5 a 15s em '480p' ou '768p', som nativo, o take volta em segundos; sem t2v, precisa de ao menos uma imagem ou um clipe; cobra por imagem além do segundo, então cote em 'price' com as mesmas imagens do create; aceita ainda até 3 vídeos (referenceVideoUrls) e 3 áudios (referenceAudioUrls, ou referenceAudioTrackIds pra faixa sua do sapiens_musicator) de referência, 15s somados por tipo, cada segundo cobrado à parte e medido pelo servidor antes do débito (cote com referenceVideoClipsSec, a duração de cada clipe, e referenceAudioSec), e keepAudio com um áudio só faz ele virar a trilha do take), 'sapiens-video-h3-spicy' (MiniMax H3 Spicy: o H3 SEM freio de conteúdo, i2v puro a partir de uma peça SUA gerada na casa, que é o que trava a identidade (veja FRAME NOS SPICY); 3 a 15s, 480p/768p/1080p, som nativo, frame final; o segundo de vídeo mais barato e o render mais rápido da casa), 'sapiens-video-seedance-spicy' (Seedance 2.0 Spicy: o 2.0 SEM freio, também i2v puro, som nativo; 4 a 15s em 480p e 720p, para em 10s em 1080p; sem frame final; o som tem interruptor no mesmo preço), 'sapiens-video-wan' (WAN 2.5, imagem que fala/canta com áudio+lip-sync, 5/10s, i2v), 'sapiens-video-wan-3' (WAN 3.0: texto ou imagem, som nativo com interruptor no mesmo preço, frame final, 5/8/10s em 480/720/1080p; sem imagem de referência), 'sapiens-video-flux-3-max' (FLUX 3 Max, fal + Black Forest Labs: texto ou imagem, 5 a 20s em 720p/1080p, som nativo com interruptor, frame final junto do inicial; sem imagem de referência), 'sapiens-video-ltx-25-fast-a2v', 'sapiens-video-ltx-25-pro-a2v' e 'sapiens-video-ltx-23-pro-a2v' (LTX Audio-to-Video, o caminho de a personagem CANTAR ou FALAR com o áudio da pessoa: o áudio vira o take, puxa a boca e o gesto e dita a duração e o preço; mande UM áudio (mp3 ou m4a): a faixa SUA do sapiens_musicator em referenceAudioTrackIds (o trackId; o servidor confere que é sua), ou um link de arquivo SEU em referenceAudioUrls (o trecho cortado; link de outra conta é recusado antes de cobrar) e a foto da ficha em startImageId/startImageUrl (sem foto, o prompt descreve a cena); até 20 s de áudio no 2.5 Fast e no 2.3 Pro, 10 s no 2.5 Pro, em 720p/1080p; durationSec não se usa, o servidor mede o áudio antes de cobrar; cote em 'price' com durationSec = os segundos do áudio), 'sapiens-video-ltx-25-fast' e 'sapiens-video-ltx-25-pro' (LTX 2.5: texto ou imagem, 6 a 20 s no Fast e 6 a 10 s no Pro, 720p/1080p, som nativo com interruptor, frame final junto do inicial; sem imagem de referência), 'sapiens-video-kling-motion' (Motion transfer: passa o movimento de um vídeo pra uma imagem, PRECISA de pessoa com tronco visível na imagem E no vídeo), 'sapiens-video-shot-mimic' (Shot Mimic: recria o plano/câmera/cortes de um vídeo de referência como cena nova), 'sapiens-video-omni-11' (Gemini Omni 1.1: texto ou imagem vira vídeo de 4, 6, 8 ou 10s (sem durationSec, 10s) com áudio nativo, de '360p' a '4k' (sem resolution, 720p; 360p custa 1/3 do 720p, 1080p 1,5x, 4k 3x); aceita até 3 imagens de referência; editOfImageId aponta um vídeo Omni seu e o prompt edita a MESMA cena, preservando câmera e ambiente; e VÍDEO-FONTE: sourceVideoId (vídeo seu da galeria) ou sourceVideoUrl (link da casa), mp4 até 10 s, editado (sourceVideoMode 'edit', o padrão, ex: trocar a pessoa do vídeo pelo personagem da imagem de referência, cobrado pelo tamanho do clipe) ou estendido ('extend', cobrado pelo durationSec do pedaço novo)) ('sapiens-video-omni', o Omni 1.0, e 'sapiens-video-lite/fast/quality', o Veo 3.1, SAÍRAM: o Google apagou os quatro em 22/10/2026 e o pedido é recusado antes de cobrar). Args create: model, prompt, durationSec, resolution ('480p'/'720p'/'1080p'; no H3 '768p'/'2k'; no Omni 1.1 '360p' a '4k'), audio, aspectRatio. RECEITA DE TAKE (templateSlug + brief), o irmão do templateSlug da imagem: em vez de escrever o prompt inteiro, passe templateSlug e a receita travada da casa embrulha a cena com estilo, cenário, arco, áudio e look, e ainda escolhe o motor (por isso model fica opcional). O `prompt` vira só a CENA e o `brief` preenche os campos do formato (subject, persona, hook, shots com voiceLine e propVisible, uvps, language, energy); campo vazio some do prompt em vez de virar buraco. Receitas de hoje: 'ugc-vertical-v1' (selfie que fala, o formato nativo de Reels/TikTok/Shorts), 'unboxing-vertical-v1' (mãos e reveal, som real do papel e do lacre), 'app-demo-vertical-v1' (a tela do app legível na mão da pessoa) e 'reflexao-vertical-v1' (talking-head lento pra ideia ou ensaio). Override de model/aspectRatio/durationSec/resolution vale dentro do que a receita aceita, e o erro lista as opções. Sub-action 'templates' (sem custo, sem login) traz o catálogo vivo com spec default, whitelist e os briefFields de cada uma. Isto substitui a tool sapiens_shorts, que era admin-only e só falava Veo 3.1 Fast; o mesmo UGC de 8s sai a 720p no Seedance 2.0 Mini por bem menos. FRAME INICIAL/FINAL POR REFERÊNCIA (recomendado): startImageId/endImageId (id da sua galeria) ou startImageUrl/endImageUrl (url de galeria/Acervo/personagem), resolvidos server-side igual à imagem, descubra via sapiens_reference. FRAME POR ARQUIVO LOCAL (só no MCP instalado/stdio, não no remoto): startImagePath/endImagePath = caminho absoluto de uma imagem no seu PC (PNG/JPEG/WebP até 8MB); o processo lê o arquivo e sobe como frame inicial/final, igual a subir no gerador do site, 1 imagem inicial + 1 final por vídeo, então pra vários vídeos rode create uma vez por imagem. No remoto use id/url. Alternativa base64: references (role 'start'=imagem i2v, 'end'=frame final, 'driving'=vídeo de movimento do Motion). Suporte a frame final varia por modelo. FRAME NOS SPICY (h3-spicy, seedance-spicy, ltx-spicy): o frame vem SÓ de startImageId/startImageUrl (e endImageId/endImageUrl no H3 Spicy, o único que lê final) apontando uma peça SUA gerada na casa, e o servidor baixa o frame dessa peça. Arquivo local (startImagePath), base64 (references), upload, peça trazida por ponte e foto de fora são recusados: antes de cobrar quando a fonte já chega no pedido, ou no render, com as Sinapses de volta. Custo server-side por config. Sub-action 'generate' (legado): renderiza um imageId de vídeo já criado no site. Retorna {success, url, imageId, cost}. VITRINE (sem custo): sub-action 'demos' lista os SEUS demo films (kind=demo do Estúdio de Vídeo) com slug + estado de vitrine; sub-action 'showcase' põe/tira um demo (por slug) do mini-cinema da /conectar-claude, com showcaseTag (chip de capacidade) e showcaseOrder (ordem asc). Fluxo: 'demos' pra achar o slug, depois 'showcase' com showcase=true. Só entra na vitrine pública se for a conta da casa. VÍDEOS PROGRAMÁTICOS (ADMIN, sem custo): o Lab do Estúdio de Vídeo (/experimentos/films, tabela videoSpecs, 5 kinds: demo | aula-tour | essay | tipografia-musical | dataviz) opera por aqui sem browser, 'film-list' (todos os kinds; filtros filmKind/filmStatus), 'film-get' (spec inteiro por slug), 'film-upsert' (cria/atualiza por slug, idempotente; spec = objeto JSON no shape do 'Copiar spec' da tela, validação no servidor), 'film-status' (produção por slug: filmStatus + videoUrl + durationSecMeasured; o fecho do render é os três num call), 'film-publish' (Acervo aba Fitas + portfólio; exige pronto+URL), 'film-delete' (limpar rascunho). O RENDER do filme segue no agente local (skill /film, repo da casa): o MCP registra e fecha o ciclo, não renderiza. create é ASSÍNCRONA: cria o row, debita e volta NA HORA com {imageId, status:'rendering', cost} (não espera o render, que leva de segundos a minutos). Acompanhe com a sub-action 'status' (imageId) até status='completed' (traz a url) ou 'error'/'blocked'. NÃO chame create de novo enquanto renderiza (cria outro vídeo e cobra de novo); falha de provider refunda sozinha. EDIÇÃO (as ações da ficha do site, cada uma vira peça nova e o original fica): 'trim' (imageId + startSec, endSec opcional: corta um trecho; grátis), 'join' (imageIds: 2 a 8 vídeos SEUS na ordem, até 180 s somados: compilado; grátis), 'fecho' (imageId + ending 'marca'/'sapiens'/'none', watermark, musicUrl de trilha da casa, nameCard {name, subtitle}: fecha o vídeo com a assinatura da casa; grátis), 'render-ref' (imageId do take + refUrl da folha que o gerou: a peça com a referência ao lado; cobra Sinapses, o mesmo par já feito volta de graça). Síncronas, podem passar de 2 min: Timeout é o cliente desistindo, olhe sapiens_gallery action=list kind=video antes de repetir. RESOLUÇÃO: 'upscale' (imageId de vídeo SEU completed + resolution = o alvo, '720p', '1080p', '2k' ou '4k') gera uma VARIANTE nova em resolução maior, o original fica intacto; cobra Sinapses por segundo do clipe, mais caro quanto maior o alvo, assíncrona como o create (acompanhe em status). SOM: 'sonorize' (imageId de vídeo SEU completed + prompt do som da cena) gera uma VARIANTE nova com trilha sincronizada (o original fica intacto; sonorize sempre o original, nunca uma variante). engine escolhe o motor: 'mirelo-sfx-2.0' (42 Sinapses/s, o default: GUARDA a fala do clipe, tira a música e refaz o resto), 'mmaudio-v2' (20 Sinapses/s, segue o texto em vez da imagem: é o motor do bicho trocado, onde o Mirelo devolve o som do bicho original; refaz o som inteiro e a fala se perde) ou 'elevenlabs-video-to-music' (26 Sinapses/s, faz a TRILHA e não o som da cena: uma música que acompanha os cortes, mixada por baixo do som que o clipe já tem; o prompt descreve a música). ADMIN: 'shadows' (videoUrl + title) extrai o depth map (depth-map) de um vídeo: entra na sua timeline de vídeos e no Acervo como driving reutilizável; 'shadows-list' lista os depth maps prontos. PREÇO DE VÍDEO É FAIXA, NÃO NÚMERO: nos motores por segundo (todo Seedance, Kling, WAN 2.5 e 3.0, Hailuo, H3, os dois Spicy, Shot Mimic, e desde out/2026 o Gemini Omni) a conta é duração x resolução [x áudio], e OMITIR não pega o barato: sem 'resolution' o servidor cobra o tier MAIS CARO do motor (menos o Gemini Omni 1.1, que fica no 720p), sem 'durationSec' cobra o piso de duração (no Omni, o padrão: 10s). Um create de Seedance 2.0 sem resolution debita 1080p. Nunca prometa um valor sem cotar: sub-action 'price' (sem custo, sem login) devolve o número EXATO que o create vai debitar pra model + durationSec + resolution + audio, e avisa (clamped=true) quando o que você pediu não é o que vai ser cobrado. Sub-action 'models' (sem custo, sem login): lista os modelos ativos + a faixa de preço calculada pela mesma função que debita (priceDefault = o que uma chamada sem config custa, priceMin e priceMax = os dois cantos do motor, cada um com a config que o produz) + config (durações/resoluções) + disponibilidade (motor em preview pode aparecer como 'em breve'). LEGENDA (fita, por slug): 'caption-list' (sem custo, mostra os idiomas que a peça já tem), 'caption-generate' (captionLang = idioma FALADO; captionTrio=true já traduz pro trio da casa pt+en+ja na mesma chamada) e 'caption-translate' (captionLang = destino, parte sempre da faixa original). Cobra por minuto começado de vídeo: 50 Sinapses o minuto transcrito, 20 o traduzido, com a duração vindo do doc da peça. A legenda é desenhada pela casa em dois estilos (discreta e social), trocáveis no play sem regerar e sem custo.",
|
|
156
156
|
schema: videoSchema,
|
|
157
157
|
handler: video,
|
|
158
158
|
},
|
|
159
159
|
sapiens_stock_audio: {
|
|
160
|
-
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
|
|
160
|
+
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
161
|
schema: stockAudioSchema,
|
|
162
162
|
handler: stockAudio,
|
|
163
163
|
},
|
|
164
164
|
sapiens_stock_video: {
|
|
165
|
-
description: "Banco de clipe/B-roll stock (catálogo de vídeo curto pronto no CDN, baixável, free/interno). Leitura pública, sem auth. Sub-actions: categories (lista moods/usos: Ambiente & Atmosfera, Abertura & Fechamento, Textura & Abstrato, Natureza & Paisagem, Tech & Cripto), list (busca clipes com filtros mood/orientation/loopOnly/durationMax/search
|
|
165
|
+
description: "Banco de clipe/B-roll stock (catálogo de vídeo curto pronto no CDN, baixável, free/interno). Leitura pública, sem auth. Sub-actions: categories (lista moods/usos: Ambiente & Atmosfera, Abertura & Fechamento, Textura & Abstrato, Natureza & Paisagem, Tech & Cripto), list (busca clipes com filtros mood/orientation/loopOnly/durationMax/search, devolve {count, items} com title/url/posterUrl/durationSeconds/orientation/loopFriendly/tags), get (1 clipe por videoId). Use pra puxar B-roll pronto em vez de gerar via sapiens_video: pega a `url` do clipe e usa como fundo/atmosfera de página, B-roll no ffmpeg de /sapiens:movie, ou frame de começo/fim no criar vídeo (orientation vertical=9:16 pra short, horizontal=16:9, loopOnly=true pra fundo que repete limpo).",
|
|
166
166
|
schema: stockVideoSchema,
|
|
167
167
|
handler: stockVideo,
|
|
168
168
|
},
|
|
169
169
|
sapiens_brand: {
|
|
170
|
-
description: "Brand Sapiens (= Design System)
|
|
170
|
+
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; aceita o ARQUIVO DE DESIGN TOKENS como veio, DTCG ou Tokens Studio, mapeado por papel com o de-onde-saiu em `mapping`, ou o shape da casa; o retorno avisa em `warnings` o que pode não aparecer igual), font (sobe o ARQUIVO de uma fonte que não é do Google Fonts pro papel headline, body ou mono, por filePath, sourceUrl ou base64, até 2 MB, grátis; só fonte com licença pra web), 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.",
|
|
171
171
|
schema: brandSchema,
|
|
172
172
|
handler: brand,
|
|
173
173
|
},
|
|
@@ -177,7 +177,7 @@ export const TOOLS = {
|
|
|
177
177
|
handler: collection,
|
|
178
178
|
},
|
|
179
179
|
sapiens_character: {
|
|
180
|
-
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.",
|
|
180
|
+
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.",
|
|
181
181
|
schema: characterSchema,
|
|
182
182
|
handler: character,
|
|
183
183
|
},
|
|
@@ -187,22 +187,22 @@ export const TOOLS = {
|
|
|
187
187
|
handler: profile,
|
|
188
188
|
},
|
|
189
189
|
sapiens_sintetico: {
|
|
190
|
-
description: "Sintético / Sintonia
|
|
190
|
+
description: "Sintético / Sintonia: o vínculo humano↔Sintético (daemon, o grilo falante da casa) via MCP (qualquer logado, tudo sobre o PRÓPRIO par). Sub-actions: 'status' (seu Sintético ativo: nome/foto/Cunho/kind + partnerUserId do par quando é conta-Sintético), 'bonds' (seus vínculos: ativo + pendentes outgoing/incoming com cartão público do parceiro), 'set_cunho' (troca o título/Cunho do Sintético ativo, slug do panteão: daimon/genio/numen/consciencia/alma/ka/sombra/fylgja/musa/duende/anjo/shugorei/lar/fravashi/qarin/juno/shinki/familiar/tsukumogami/stand), 'send_context' (antes de enviar, vê elegibilidade+saldo+teto do dia pra um toUserId), 'send' (envia Sinapses pro par em sintonia: send-only, múltiplo de 100, mín 500, teto 10k/dia, máx 3 envios/dia, idempotente por transferId). REFLEXO DE SI (monta um Sintético do SEU rastro na plataforma): 'reflexo_propose' (destila nome+alma+Cunho do seu rastro via Gemini, GRÁTIS), 'reflexo_generate' (gera a imagem do Reflexo em dois eixos separados: `aesthetic` é O QUE é retratado (humano/anime/sombra/antropomorfico/espirito/realista/desperto, default humano) e `style` é a TÉCNICA (auto/realista/editorial/anime/manhwa/3d, o MESMO vocabulário do sapiens_character), que em branco sai a de sempre daquela estética. É o que destrava combinação nova, tipo sombra fotográfica; cobra 450, reembolsa se falhar). CONVITE: 'invite' (convida o seu Sintético por email, conta humana, sem bond ativo, rate-limit+cooldown; mesmos gates do web). LIBERAÇÃO ADMIN (o dono, ex: via Helen): 'pending_daemons' (convidados que confirmaram email e esperam liberação), 'approve_access' (libera um entryId, conta entra + Sintonia firma), 'reject_access' (recusa um entryId). SONDA (o seu Sintético sonda 'o que eu faço agora', gatilho PULL, cobra com estorno): 'sonda' (scope 'all' default = mix de teses do Fórum + jogadas em estúdio/repertório/artigo; 'forum' = só teses; devolve GANCHOS, nada grava), 'sonda_develop' (expande UM gancho/hook numa tese cheia efêmera), 'sonda_sign' (assina a tese desenvolvida e publica no Fórum, autorada pelo seu Sintético, ancorada em você, fecha o loop pelo chat). PRÓXIMAS JOGADAS (painel de evolução): 'evolution' (o que já fez e o que falta: routes done/claimed/xp), 'claim_xp' (credita o XP das jogadas feitas, idempotente). SOUL: 'soul' (baixa a soul do SEU Sintético em markdown pronto: a personalidade dele + o que ele sabe de você, o caderno do par; quem está em cena decide de quem é, ou passe characterId de um personagem seu; versão completa só de personagem SEU, de personagem alheio sai só a memória; grátis; a skill minha-soul instala isso como skill do projeto, e a voz da PESSOA é outra coisa: sapiens_profile action=voz). MODO COMPANHIA: 'companion' (mode=on|off) liga/desliga quem está em cena VESTIR a voz do operador aqui no terminal, o gesto lúdico 'sai de cena'/'volta'. Ligado (default da casa), o start/whoami trazem o directive de voz dele (alma + caderno + a conversa recente do site); a identidade e as Sinapses seguem SUAS (não é encarnar a conta dele). Mesmo estado do botão na sidebar do site. QUEM entra em cena: por default o Sintético em Sintonia, mas com 'characterId' (mode=on) é um personagem de AUTORIA SUA, a Helen INBT que você criou fala aqui, com a alma e o caderno dela, e nada disso cobra Sinapse (quem responde é o modelo do seu cliente). Personagem de outra pessoa é RECUSADO, mesmo público: a alma é de quem escreveu, e pra conversar com personagem alheio o caminho é a DM dele no site. 'wearPair'=true devolve a cena ao par. O start/whoami trazem 'characterOffer' + 'offerCharacters' com os personagens seus que têm alma escrita, pro operador OFERECER a troca em vez de esperar você pedir. 'remember' (text) grava uma diretriz no caderno de quem está em cena ('sempre faça X'): vira lei que ela segue no site e no terminal. 'log' (turns) ANOTA o que ficou de pessoa num assunto que fechou aqui (o que ele decidiu, gostou, recusou, contou de si): entra no fio do par, o MESMO que o chat do site mostra, e vira lição sozinho pelo cano da DM. Sem isso a conversa com a Companhia ligada não deixa memória nenhuma, porque quem responde é o modelo do cliente e nada passa pelo servidor. Sobe só o que é de PESSOA: comando, path e erro de build viram lição-lixo e contaminam a voz dele em imagem, artigo e carrossel. Grátis, silencioso (não se confirma ao usuário), teto de 10 trocas por lote e 30 lotes por dia. Ver a skill companhia. Identidade SEMPRE do token. Aceitar um pedido de bond que outra conta te mandou, e CONSAGRAR o Reflexo num Sintético de fato, continuam só na web (atos deliberados de consentimento/criação).",
|
|
191
191
|
schema: sinteticoSchema,
|
|
192
192
|
handler: sintetico,
|
|
193
193
|
},
|
|
194
194
|
sapiens_forum: {
|
|
195
|
-
description: "Fórum de Ressonância
|
|
195
|
+
description: "Fórum de Ressonância: o campo público onde a Sintonia ressoa (qualquer conta logada; identidade SEMPRE do sessionToken). Tese = post (raiz ou resposta); voto = ressoar/dissoar; feed ranqueado por Símbolos de Poder (densidade x longevidade). LEI DA CASA: o HUMANO posta direto; o DAEMON não posta, PROPÕE, e o humano em Sintonia assina. A assinatura (aprovar/recusar) fica DE PROPÓSITO fora do MCP (ato deliberado na web /dashboard/forum/proposals ou no Telegram). Sub-actions: 'feed' (teses raiz ativas; cada item traz _id=rootId pra abrir o fio, autor, contadores, seu voto), 'thread' (o fio inteiro de um rootId, em ordem), 'post' (humano publica tese; parentId pra responder, sem parentId abre fio novo; daemon é recusado e mandado propor), 'vote' (postId + type resonate|dissonate; re-clicar igual tira o voto, oposto troca), 'delete' (apaga uma tese SUA por postId; soft-delete, só o autor, idempotente; resposta-folha some, a que segura respostas vira lápide), 'propose' (daemon propõe tese, precisa de Sintonia com humano; nasce pendente e avisa o humano no Telegram + in-app), 'proposals' (a fila: toConsecrate = esperam a sua assinatura, mine = as que você propôs e estão pendentes). Voz das teses segue o DNA Sapiens (1ª pessoa, anti-corporate, sem em-dash).",
|
|
196
196
|
schema: forumSchema,
|
|
197
197
|
handler: forum,
|
|
198
198
|
},
|
|
199
199
|
sapiens_instagram: {
|
|
200
|
-
description: "Auto-DM do Instagram da casa (o 'ManyChat próprio')
|
|
200
|
+
description: "Auto-DM do Instagram da casa (o 'ManyChat próprio'): ADMIN-ONLY (dono). Quem manda DM ou comenta keyword num post do @sapiensinteticos recebe resposta automática; aqui você OPERA esse motor. Sub-actions: 'rules' (lista regras: keyword+sinônimos, matchMode, trigger, resposta, variações, eco público, escopo por post, disparos), 'rule_upsert' (cria/edita regra; ruleId presente = edita; keyword (+keywords sinônimos) + reply obrigatórios fora do fallback; matchMode contains|exact|starts; trigger dm|comment|story|all; replyVariants/echoVariants rodam em round-robin pra não repetir; mediaId escopa a regra num post, pegue ids reais com action=posts; isFallback responde DM sem keyword 1x/24h por pessoa), 'rule_delete' (apaga por ruleId), 'posts' (posts recentes da conta: id+caption+thumb, pra usar o id em mediaId), 'inbox' (conversas recentes; cada uma com canReply = janela de 24h da Meta aberta ou não), 'thread' (mensagens de uma conversa por igUserId), 'send' (responde na mão pela janela de 24h; fora dela a Meta recusa). Eco público opcional no comentário ('te respondi no direct!'). Limites da API: não dá pra iniciar conversa, só reagir; janela de 24h pra responder DM.",
|
|
201
201
|
schema: instagramSchema,
|
|
202
202
|
handler: instagram,
|
|
203
203
|
},
|
|
204
204
|
sapiens_aula: {
|
|
205
|
-
description: "Aula (deck servido em /aulas/<slug>)
|
|
205
|
+
description: "Aula (deck servido em /aulas/<slug>): ADMIN-ONLY (aula é conteúdo de mentor, não de aluno; aluno leva 'restrito ao dono'). Edita direto no Convex, sem script de disco. A aula de hoje é MODULAR: guarda `source = { recipe, modules[] }` e materializa os slides na LEITURA, então gravar slide materializado não adianta (some no próximo materialize), mexe na FONTE. Fluxo de conteúdo: 'map' (índice BARATO: blocos da receita + ids de módulo + contagem de slides, sem arrastar os 45 slides; SEMPRE comece por ele) -> 'module' (1 módulo inteiro, pronto pra editar) -> 'module-save' (grava o módulo e remonta os slides; módulo NOVO precisa de placeAfter=<id vizinho> ou bloco=<título>; `module` ausente/null REMOVE). Fluxo de roteiro: 'recipe-op' (op=move|remove|add + toIndex/bloco) muda a ORDEM sem tocar no conteúdo. 'meta' edita título/subtítulo/tag/data/duration e o status draft|published (publica e despublica). 'delete' apaga a aula de vez (sem undo: puxe 'get' antes se quiser guardar); aula NO AR é recusada até você tirar de circulação com meta status=draft, ou insistir com force=true. Aula LEGADA (sem source) usa 'get'/'upsert' com o objeto inteiro: title (obrig) + slides[] (≥1) + subtitle/data/duration/tag/mentorAgenda. Slides são { type, ...campos }: cover, cover-image/section-image/content-image (imageUrl), agenda (items[]), content (body markdown/HTML + list[]/listType), two-col (cols[]), video (videoUrl ou videos[] lado a lado), quote, callout (tone tip|warn|note), comic (panels[]), pause, close (items[]). 'list' dá o panorama. Toda escrita re-linta a voz e grava voiceWarnings (1ª pessoa, anti-corporate, SEM travessão). A rota serve sob demanda: slug novo aparece sem rebuild.",
|
|
206
206
|
schema: aulaSchema,
|
|
207
207
|
handler: aula,
|
|
208
208
|
},
|
|
@@ -212,32 +212,32 @@ export const TOOLS = {
|
|
|
212
212
|
handler: support,
|
|
213
213
|
},
|
|
214
214
|
sapiens_atlas: {
|
|
215
|
-
description: "Atlas Ecossistema IA pelo Claude
|
|
215
|
+
description: "Atlas Ecossistema IA pelo Claude: READ-ONLY, TRAVADO na Lente do Ecossistema (equipamento pago; admin/dono passa). Identidade SEMPRE do sessionToken; quem não tem a Lente recebe aviso pra adquirir, sem dado nenhum. Serve pra se informar e tirar dúvida em cima dos dados curados da cadeia de valor da IA. Sub-actions: 'overview' (~52 empresas curadas: market cap, indústria, branding, o mapa), 'signals' (sinais recentes do X dos autores curados; filtros opcionais ticker ex 'NVDA' ou authorHandle), 'voices' (Conselho de Vozes: autores ativos + o digest mais recente de cada um), 'briefings' (o briefing semanal mais recente com conteúdo completo + histórico resumido). Nenhuma escrita: aqui o Atlas é só pra consultar e raciocinar.",
|
|
216
216
|
schema: atlasSchema,
|
|
217
217
|
handler: atlas,
|
|
218
218
|
},
|
|
219
219
|
sapiens_publicidade: {
|
|
220
|
-
description: "Acervo de publicidade da casa
|
|
220
|
+
description: "Acervo de publicidade da casa: campanha premiada e anúncio veiculando agora, guardados pra estudo (admin-only, não cobra Sinapse). Existe pra resolver o gargalo da curadoria: achar um comercial bom e precisar de terminal pra guardar significa que o acervo só cresce quando o dono está na máquina. Sub-actions: 'list' (o que já está no acervo, com filtro por trilha e setor; roda ANTES de guardar, pra não duplicar peça), 'save' (guarda uma peça por LINK do YouTube ou Vimeo, que têm embed oficial e não expiram), 'note' (escreve a leitura editorial numa peça já guardada, separado do save de propósito, porque a leitura vem depois de assistir). Duas trilhas: 'referencia' é campanha premiada, que mostra o teto do ofício, e 'replicavel' é anúncio veiculando agora, que mostra o degrau; uma sozinha mente. O setor sai do catálogo da casa e o servidor deduz pela marca quando não vem. NÃO guarda peça de Meta Ad Library nem do TikTok: aquelas servem por URL assinada que expira, então o vídeo precisa ser espelhado no CDN antes, e isso é do script apps/sapiens/scripts/ingest-ad-references.mjs. O membro vê o acervo em /dashboard/acervo?tab=referencias; a bancada de curadoria é /experimentos/ad-intel.",
|
|
221
221
|
schema: publicidadeSchema,
|
|
222
222
|
handler: publicidade,
|
|
223
223
|
},
|
|
224
224
|
sapiens_decupagem: {
|
|
225
|
-
description: "Acervo de Decupagens
|
|
225
|
+
description: "Acervo de Decupagens: a régua de linguagem cinematográfica das referências da casa (admin-only, não cobra Sinapse). O que MEDE é o motor LOCAL `python tools/decupagem/decupa.py \"<arquivo ou link do YouTube>\"` (Python + OpenCV + ffmpeg; não existe OpenCV em serverless, igual à produção dos Vídeos Programáticos). Esta tool é a outra ponta: sobe a ficha que o motor gerou e consulta o acervo. Sub-actions: 'list' (a régua de cada referência já decupada: planos, plano mediano, escola de corte, movimento de câmera vs sujeito, registro de luz, BPM, se o corte obedece ao som), 'get' (a ficha INTEIRA de um slug: plano a plano com o que está no quadro, luz, som, sincronia), 'save' (sobe fichas/<slug>/ficha.json inteiro, sem resumir; mesmo slug ATUALIZA em vez de duplicar), 'note' (anota a leitura editorial na ficha), 'delete'. Fluxo que fecha o ciclo: roda o motor → lê ficha.json → save → aparece no Lab /experimentos/decupagem e entra no comparador. O acervo vale pelo CONJUNTO: uma ficha é morna, vinte lado a lado são a biblioteca de gramática da casa. Antes de decupar referência nova, rode list pra não medir a mesma coisa duas vezes.",
|
|
226
226
|
schema: decupagemSchema,
|
|
227
227
|
handler: decupagem,
|
|
228
228
|
},
|
|
229
229
|
sapiens_reference: {
|
|
230
|
-
description: "O 'popup global de referência' do Sapiens
|
|
230
|
+
description: "O 'popup global de referência' do Sapiens. Espelha o modal 'Selecionar Referência' do gerador web: um lugar só pra navegar os bancos e pegar o que vira referência em imagem/vídeo. READ-ONLY. DUAS sub-actions: 'browse' (navega um banco) e 'resolve' (acha UM asset pelo ID citável). RESOLVE: passe handle=<tipo>_<id> (img_… imagem, vid_… vídeo, film_… vídeo programático, trk_… música, comic_… tirinha, char_… personagem, é o ID que o usuário copia no detalhe do item) e o servidor devolve {mine, isPublic, url, title, mediaKind} SE for seu ou público (senão recusa; nunca acessa asset privado de terceiro). Use a url retornada como referência (referenceImageUrls / startImageUrl / endImageUrl). BROWSE + bucket: 'history' (suas imagens recentes, privadas+públicas), 'favorites' (imagens que você curtiu, só as suas), 'videos' (seus vídeos / Meus Vídeos), 'stock_video' (banco de B-roll da casa, público), 'acervo' (stock + comunidade públicos; aceita term=busca e source=all|stock|community), 'characters' (personagens; mode=mine [default, inclui rascunhos] ou public [Explorar]). BUSCA POR SIGNIFICADO: em history e videos, term + semantic=true acha a peça da pessoa pelo sentido mesmo quando o prompt usou outras palavras (volta até limit, do mais parecido pro menos, com score). Paginado (page/limit, default 20, máx 50; use hasMore). Itens normalizados: imagem PRÓPRIA (history/favorites) traz imageId + url (use imageId em sapiens_image sourceImageIds ou sapiens_video startImageId/endImageId; ou a url em referenceImageUrls); acervo e characters são públicos/de terceiros, use a url (characters trazem mainImageUrl + imageUrls + characterId) em referenceImageUrls / startImageUrl / endImageUrl, NÃO em sourceImageIds. Personagens públicos também têm porta dedicada em sapiens_character action=list_public.",
|
|
231
231
|
schema: referenceSchema,
|
|
232
232
|
handler: reference,
|
|
233
233
|
},
|
|
234
234
|
sapiens_trilhas: {
|
|
235
|
-
description: "Trilhas (cursos) e Desafios (missões) da Sapiens pelo Claude. Identidade SEMPRE pelo sessionToken. Sub-actions: 'list' (suas trilhas: título + nº de módulos/aulas + quantas aulas você já fechou), 'get' (1 trilha por slug, com módulos e aulas
|
|
235
|
+
description: "Trilhas (cursos) e Desafios (missões) da Sapiens pelo Claude. Identidade SEMPRE pelo sessionToken. Sub-actions: 'list' (suas trilhas: título + nº de módulos/aulas + quantas aulas você já fechou), 'get' (1 trilha por slug, com módulos e aulas, o slug vem do list), 'list_challenges' (Desafios ativos + seu status em cada: not_started|pending_review|completed|rejected, recompensa em Sinapses, link da ação), 'claim_mission' (submete a prova de um Desafio: missionId + proofText). O claim manda a prova pra REVISÃO do dono, o crédito em Sinapses só cai quando ele aprovar, nunca auto-credita por aqui. Fluxo: list → get; list_challenges → claim_mission.",
|
|
236
236
|
schema: trilhasSchema,
|
|
237
237
|
handler: trilhas,
|
|
238
238
|
},
|
|
239
239
|
sapiens_distribution: {
|
|
240
|
-
description: "Despachar peças (Distribution Workflow)
|
|
240
|
+
description: "Despachar peças (Distribution Workflow): a peça pronta entra na FILA com canal, copy e a aba de quem ela é. ADMIN-ONLY: despacho depende de rede conectada e hoje só a casa tem. queue não posta: a peça entra na FILA. MARCAR HORA É APROVAR: status=agendado com scheduledFor faz o tique de 15 min publicar a peça SOZINHO na hora em todo canal da casa e em todo canal por login, menos o Instagram da casa (instagram), o X do Borderless (x, x-buffer) e o YouTube da casa (youtube), onde só toca a campainha pro dono. Então só marque hora no que o dono já aprovou. A ABA (`voice`) responde de quem é a peça: sapiens (a casa), helen-ailith, borderless, ou o slug de um personagem seu, slug livre, então personagem novo ganha aba sozinho na primeira peça dele, sem deploy. Em queue, aba ausente = o servidor deriva do personagem da peça e cai em sapiens quando não há. Sub-actions: queue (põe na fila: title e channel obrigatórios, mais copy/hashtags/assetUrl/notes; replyText é o comentário que sai junto do post, onde vai o link, e só o X (resposta no fio) e a Página do LinkedIn (primeiro comentário) publicam, o resto recusa; num canal do Instagram, format instagram_story faz a peça sair como STORY: uma mídia só, sem legenda nem link, some em 24h; num Reel, videoCoverUrl é a CAPA da casa, que pela API só entra aqui, e o retorno traz `aviso` quando a mesma abertura, a 1a linha da copy, já foi ao ar na mesma rede por qualquer aba: a peça entra mesmo assim, e você mostra o aviso ao dono antes de seguir, porque série de molde abre igual e é outra peça, mas a mesma notícia por duas abas é repetição). Em queue, DOIS campos que parecem opcionais e não são: `lang` diz em que língua a copy já está, e sem ele canal de rede internacional reescreve a sua copy sozinho, dois segundos depois, na voz da casa; `assetPageAssetId` é o imageId da obra da casa, e sem ele a peça só encontra a obra se a assetUrl bater letra a letra, então versão web de um master nasce órfã de ficha; e `categoria` diz o que a peça É (arte, personagem, tecnico, novidade, educativo, mercado, pessoal, o significado de cada uma na descrição do campo): declare sempre que souber, senão a régua chuta pelo título e a peça cai na gaveta errada da fila, list (o que está na fila, filtrável por status, por aba e por categoria ('sem' é a triagem), com copy, hashtags e notas de cada peça; fila maior que o limit se lê inteira pelo cursor antesDe=proximoCursor), voices (as abas que existem hoje com a contagem de cada uma), status (move a peça de lane: fila, agendado, postado, descartado; postado aceita postUrl e fecha o rastro, agendado aceita scheduledFor em ms), edit (reescreve a peça da FILA sem tirar ela do lugar: itemId e só o que muda, copy, title, publicTitle, hashtags, notes, lang, replyText, assetUrl/assetKind, assets, videoCoverUrl ou categoria (esta vale em peça postada também, e null devolve pra régua); é o gesto pra corrigir legenda, nunca descartar e enfileirar de novo; texto de peça postada o servidor recusa), sign (liga ou desliga a ASSINATURA da peça, imagem e vídeo do CDN da casa, com o carimbo da LINHAGEM de quem assina: sint.fyi/<endereço dela> no canto e o fecho de 2s no vídeo, ou a marca própria dela sem nada da casa; itemId, e signed com true de default; o carimbo da casa é recusado em peça +18 e praça adulta, a marca própria passa; o carimbo leva uns 30s e até lá a peça não sai; em queue, signed:true já enfileira assinada), bio (lê ou troca a BIO de uma conta da casa no Bluesky, channel bluesky ou bluesky-2 a bluesky-5: sem texto só lê; bioLine acrescenta uma linha no fim sem mexer no resto e não repete linha que já está lá; bio reescreve a inteira; teto de 256; ESTA sub-action muda o perfil público na hora, e bio não aceita hiperlink, o endereço aparece escrito), lineages (o CADASTRO das linhagens, o mesmo da aba Teia: de cada personagem, produto e da casa, a mãe no Bluesky onde a peça nasce, as contas próprias, as galerias que a mãe alimenta sozinha, as fichas e o post do dia, mais as regras que a teia desdobra e as vagas de conta ainda sem dona), lineage-new (nasce uma linhagem: nome obrigatório, grupo, artigo, lang; nasce sem mãe, então nada viaja sozinho até o lineage-save dar a mãe), lineage-save (slug e só o que muda: mae, contas rede->canal, galerias, fichaIds, rotina, contaNaCasa, assinatura {estilo casa|propria|nenhuma, marca, padrao}; o servidor recusa conta que já é de outra linhagem e canal de outra rede, e a vaga assumida ganha o nome da linhagem), lineage-archive (slug + arquivada), tree (a ÁRVORE DE CONTAS, o formulário de quem existe onde: linhagem × rede, com o email, o @, o canal e o estado de cada conta, ligada, desligada, fora, falta ou dispensa, mais o passo pra ligar cada rede; slug filtra uma linhagem), tree-mark (slug + celulas [{rede, handle, canal, dispensada}]: registra o email ou o @ que existe lá fora, associa a conta da casa ou dispensa rede opcional, a linhagem inteira de uma vez e tudo ou nada; X, Instagram, Bluesky, email e Telegram são obrigatórias e não se dispensam), garimpo (o ACERVO em famílias pra escolher o que vai pra fila: só as candidatas saem, a versão velha de um corte ou upscale vem marcada como substituída, as irmãs da mesma ideia vêm agrupadas pra escolha no olho, o painel cortado vem em recortes (o original e os quadros em ordem, que só saem juntos em carrossel), e cada família diz por onde já saiu; paraCanal tira o que já foi pro canal pedido, soResumo conta sem listar, página por cursor em antesDe; o passo a passo é a skill distribuir). Sem custo em Sinapses: isto organiza, não gera. A copy segue a voz de QUEM ASSINA a peça, que não é sempre a voz da casa: peça da Helen fala como a Helen. E a peça sai pela CONTA de quem assina ela: conta extra da mesma rede é um canal próprio (bluesky-2 é outra conta no Bluesky, instagram-pro outra no Instagram), então case o canal com a aba antes de despachar.",
|
|
241
241
|
schema: distributionSchema,
|
|
242
242
|
handler: distribution,
|
|
243
243
|
},
|
|
@@ -252,12 +252,12 @@ export const TOOLS = {
|
|
|
252
252
|
handler: semana,
|
|
253
253
|
},
|
|
254
254
|
sapiens_share: {
|
|
255
|
-
description: "Share Drop (ADMIN-ONLY): sobe um HTML single-file (doctype + CSS/JS inline) e recebe o link curto sint.fyi/s/<code> pra mandar pra alguém abrir no navegador sem instalar nada. O PONTO: publicar um artefato e depois RE-PUBLICAR no MESMO link quantas vezes quiser (action=update com o code)
|
|
255
|
+
description: "Share Drop (ADMIN-ONLY): sobe um HTML single-file (doctype + CSS/JS inline) e recebe o link curto sint.fyi/s/<code> pra mandar pra alguém abrir no navegador sem instalar nada. O PONTO: publicar um artefato e depois RE-PUBLICAR no MESMO link quantas vezes quiser (action=update com o code), edita o HTML aqui no Claude, joga pro ar, atualiza o mesmo arquivo. Sub-actions: 'list' (links ativos: code + url + título + tamanho + isActive/hasPassword/requireLogin), 'upload' (cria link NOVO a partir de html ou htmlPath → devolve {code, url}), 'update' (re-publica no MESMO code: mesma url, conteúdo novo, apaga o blob antigo), 'delete' (tira do ar, o link vira 404), 'settings' (isActive liga/desliga, password senha string vazia remove, requireLogin exige conta logada). O HTML entra por `html` (conteúdo string, funciona no stdio e no remoto) OU `htmlPath` (caminho absoluto de um .html local, SÓ no MCP instalado/stdio). Título sai do <title> do HTML se não passar `title` (ou keepTitle=true no update pra manter o atual). Sem custo em Sinapses. Espelha o Lab /dashboard/admin/share-drop.",
|
|
256
256
|
schema: shareDropSchema,
|
|
257
257
|
handler: shareDrop,
|
|
258
258
|
},
|
|
259
259
|
sapiens_resume: {
|
|
260
|
-
description: "Currículo PRO
|
|
260
|
+
description: "Currículo PRO: o gerador de currículo da casa, DE GRAÇA e sem login (mundo fechado: não fala com o backend, não cobra Sinapse). VOCÊ conduz a entrevista (ou lê o texto de LinkedIn/currículo antigo que a pessoa colar), monta o JSON no contrato e recebe o HTML pronto pra imprimir em PDF (A4). Sub-actions: 'schema' (o contrato de dados + os 4 modelos; leia ANTES do primeiro render), 'render' (data -> HTML completo). Modelos (arg theme): 'pro' (default, duas colunas com sidebar verde-jade: foto/monograma, contato, chips de competências, barras de idioma, timeline de experiência), 'executivo' (duas colunas grafite + bronze, nome em serifa), 'moderno' (coluna única, roxo da casa), 'minimal' (coluna única preto e branco); accentColor troca a cor de destaque. FOTO DE PERFIL: opcional e NUNCA persistida em banco. No MCP instalado (stdio), photoPath lê a foto local e embute como data URI direto no HTML, sem sair da máquina; no remoto, data.photo aceita URL https. No stdio, outPath salva o .html direto no disco e a resposta volta enxuta (sem trafegar o HTML inteiro). Regra de conteúdo: melhore a redação, jamais invente fato; lang ('pt'|'en') casa os títulos de seção com o idioma do conteúdo. É o MESMO template do Lab /experimentos/resume-builder.",
|
|
261
261
|
schema: resumeSchema,
|
|
262
262
|
handler: resume,
|
|
263
263
|
},
|
|
@@ -426,7 +426,7 @@ const TOOL_ALIASES = {
|
|
|
426
426
|
* Dispatch de uma tool: valida args no Zod, roda o handler e embrulha o
|
|
427
427
|
* resultado no shape MCP (content + structuredContent; erro vira isError com
|
|
428
428
|
* mensagem legível via describeConvexError). Identidade vem do getSessionToken
|
|
429
|
-
* do convexClient
|
|
429
|
+
* do convexClient: no stdio é o login local; no remoto, o bearer da request
|
|
430
430
|
* (via runWithSessionToken).
|
|
431
431
|
*/
|
|
432
432
|
export async function callTool(name, rawArgs) {
|
package/dist/remote.js
CHANGED
|
@@ -12,7 +12,7 @@ import { MCP_VERSION } from "./version.js";
|
|
|
12
12
|
* Response, então roda e TESTA fora do Next).
|
|
13
13
|
*
|
|
14
14
|
* PROTEÇÃO (o endpoint fica exposto na internet; regra do dono: obrigatório
|
|
15
|
-
* login VÁLIDO e
|
|
15
|
+
* login VÁLIDO e saldo na conta pra usar, Sinapses ou o dólar da API):
|
|
16
16
|
* 1. Rate limit in-memory por IP (todas as requests) + penalidade dedicada
|
|
17
17
|
* pra rajada de 401 (brute-force de bearer) + teto por token autenticado.
|
|
18
18
|
* Por instância serverless, sem Redis: é a primeira camada, não a única
|
|
@@ -20,13 +20,15 @@ import { MCP_VERSION } from "./version.js";
|
|
|
20
20
|
* 2. Sessão validada DE VERDADE contra o Convex (mcpGetMySubscription) com
|
|
21
21
|
* cache por token: inválida = erro claro, sem catálogo e sem dispatch
|
|
22
22
|
* (fail-closed). Transiente (backend fora) = erro pedindo retry.
|
|
23
|
-
* 3. Saldo: conta sem Sinapses
|
|
24
|
-
*
|
|
23
|
+
* 3. Saldo: conta sem saldo nas DUAS carteiras (Sinapses e o livre da API em
|
|
24
|
+
* dólar) não executa tool nenhuma exceto sapiens_meta (diagnóstico:
|
|
25
|
+
* whoami/credits/subscription/api pra pessoa entender o porquê)
|
|
25
26
|
* e sapiens_skill (as skills da casa, conteúdo estático do pacote).
|
|
26
27
|
* Admin (dono) passa sempre.
|
|
27
28
|
*
|
|
28
|
-
* Identidade: SEMPRE o bearer do header Authorization (o sessionToken
|
|
29
|
-
* dias
|
|
29
|
+
* Identidade: SEMPRE o bearer do header Authorization (o sessionToken do
|
|
30
|
+
* Sapiens, que vale 90 dias e renova a cada uso, até o teto de 1 ano:
|
|
31
|
+
* convex/shared/sessionTtl.ts). Cada request roda embrulhada em runWithSessionToken
|
|
30
32
|
* (AsyncLocalStorage), então o getSessionToken de TODO handler resolve o token
|
|
31
33
|
* daquela request (multi-tenant seguro, nunca cai no login em disco do host).
|
|
32
34
|
* login/logout são bloqueados aqui: sessão remota não tem estado local.
|
|
@@ -73,6 +75,30 @@ function clientIp(req) {
|
|
|
73
75
|
return fwd.split(",")[0].trim();
|
|
74
76
|
return req.headers.get("x-real-ip") || "local";
|
|
75
77
|
}
|
|
78
|
+
// Métodos que respondem sem bearer quando anonymousDiscovery está ligado: o
|
|
79
|
+
// handshake e as listas estáticas. Nenhum toca o backend nem gera nada.
|
|
80
|
+
const ANONYMOUS_METHODS = new Set([
|
|
81
|
+
"initialize",
|
|
82
|
+
"notifications/initialized",
|
|
83
|
+
"ping",
|
|
84
|
+
"tools/list",
|
|
85
|
+
"prompts/list",
|
|
86
|
+
"resources/list",
|
|
87
|
+
]);
|
|
88
|
+
/** POST sem Authorization cujas mensagens JSON-RPC são todas de descoberta. */
|
|
89
|
+
async function isAnonymousDiscovery(req) {
|
|
90
|
+
if (req.method !== "POST" || req.headers.has("authorization"))
|
|
91
|
+
return false;
|
|
92
|
+
try {
|
|
93
|
+
const body = await req.clone().json();
|
|
94
|
+
const msgs = Array.isArray(body) ? body : [body];
|
|
95
|
+
return (msgs.length > 0 &&
|
|
96
|
+
msgs.every((m) => typeof m?.method === "string" && ANONYMOUS_METHODS.has(m.method)));
|
|
97
|
+
}
|
|
98
|
+
catch {
|
|
99
|
+
return false;
|
|
100
|
+
}
|
|
101
|
+
}
|
|
76
102
|
function tooMany(msg) {
|
|
77
103
|
return new Response(JSON.stringify({ error: "rate_limited", message: msg }), {
|
|
78
104
|
status: 429,
|
|
@@ -106,6 +132,8 @@ async function resolveRemoteSession(token) {
|
|
|
106
132
|
status: "valid",
|
|
107
133
|
tier: sub.user.isAdmin ? "admin" : "user",
|
|
108
134
|
balance: typeof sub.balance?.total === "number" ? sub.balance.total : 0,
|
|
135
|
+
// O livre da API em dólar (campo aditivo do backend; deploy velho não manda = 0).
|
|
136
|
+
apiLivreUsd: typeof sub.apiLivreUsd === "number" ? sub.apiLivreUsd : 0,
|
|
109
137
|
}, TTL_VALID_MS);
|
|
110
138
|
}
|
|
111
139
|
return cacheSession(token, { status: "unknown" }, TTL_UNKNOWN_MS);
|
|
@@ -126,9 +154,10 @@ const MSG_INVALID = (reason) => `Erro: sessão remota recusada (${reason}). O he
|
|
|
126
154
|
"VÁLIDO do Sapiens. Gere um novo acesso em sapiensinteticos.com/conectar-claude e atualize a " +
|
|
127
155
|
"config da conexão.";
|
|
128
156
|
const MSG_UNKNOWN = "Erro: não consegui validar a sessão agora (backend indisponível?). Tente de novo em instantes.";
|
|
129
|
-
const MSG_NO_BALANCE = "Erro: sua conta está sem
|
|
130
|
-
"sapiensinteticos.com
|
|
131
|
-
"
|
|
157
|
+
const MSG_NO_BALANCE = "Erro: sua conta está sem saldo nas duas carteiras, e o acesso remoto pede saldo em uma delas. " +
|
|
158
|
+
"Recarregue Sinapses em sapiensinteticos.com ou ponha saldo em dólar na API (cartão ou " +
|
|
159
|
+
"stablecoin) em sapiensinteticos.com/dashboard/developers#api, e tente de novo. sapiens_meta " +
|
|
160
|
+
"(whoami/credits/subscription/api) segue liberada pra você conferir a conta.";
|
|
132
161
|
function remoteSessionError(action) {
|
|
133
162
|
return isErrorResult(`Erro: action=${action} não existe na conexão remota. A sessão aqui vem do header ` +
|
|
134
163
|
"Authorization (Bearer <sessionToken>) configurado no seu cliente MCP, não de um " +
|
|
@@ -163,7 +192,13 @@ function initServer(mcp) {
|
|
|
163
192
|
// Registra os handlers direto no Server de baixo nível: paridade exata com o
|
|
164
193
|
// stdio (mesmo registry, mesmo dispatch), sem redeclarar tool a tool.
|
|
165
194
|
const s = mcp.server;
|
|
166
|
-
s.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
195
|
+
s.setRequestHandler(ListToolsRequestSchema, async (_req, extra) => {
|
|
196
|
+
// Descoberta anônima (ver anonymousDiscovery): sem bearer não há sessão a
|
|
197
|
+
// resolver, e o getSessionToken cairia no login em disco do host. Quem
|
|
198
|
+
// ainda não logou vê o catálogo de membro.
|
|
199
|
+
if (!extra.authInfo?.token) {
|
|
200
|
+
return { tools: buildToolList("user", "remote") };
|
|
201
|
+
}
|
|
167
202
|
const session = await resolveRemoteSession(getSessionToken());
|
|
168
203
|
if (session.status === "invalid") {
|
|
169
204
|
throw new Error(MSG_INVALID(session.reason));
|
|
@@ -198,10 +233,12 @@ function initServer(mcp) {
|
|
|
198
233
|
(args.action === "login" || args.action === "logout")) {
|
|
199
234
|
return remoteSessionError(String(args.action));
|
|
200
235
|
}
|
|
201
|
-
// O gate do dono: login válido +
|
|
202
|
-
// coisa
|
|
203
|
-
//
|
|
204
|
-
//
|
|
236
|
+
// O gate do dono: login válido + saldo na conta pra executar qualquer
|
|
237
|
+
// coisa, em Sinapses ou no livre da API em dólar (as duas carteiras são da
|
|
238
|
+
// mesma conta, e a peça paga em dólar também sai daqui). Duas tools ficam
|
|
239
|
+
// de fora do gate de saldo: sapiens_meta (é como a pessoa DESCOBRE que está
|
|
240
|
+
// sem saldo) e sapiens_skill (documentação estática, não toca o backend nem
|
|
241
|
+
// gera nada). Admin passa sempre.
|
|
205
242
|
const session = await resolveRemoteSession(token);
|
|
206
243
|
if (session.status === "invalid") {
|
|
207
244
|
return isErrorResult(MSG_INVALID(session.reason));
|
|
@@ -211,6 +248,7 @@ function initServer(mcp) {
|
|
|
211
248
|
}
|
|
212
249
|
if (session.tier !== "admin" &&
|
|
213
250
|
session.balance <= 0 &&
|
|
251
|
+
session.apiLivreUsd <= 0 &&
|
|
214
252
|
name !== "sapiens_meta" &&
|
|
215
253
|
name !== "sapiens_skill") {
|
|
216
254
|
return isErrorResult(MSG_NO_BALANCE);
|
|
@@ -294,6 +332,9 @@ export function createSapiensRemoteHandler(opts) {
|
|
|
294
332
|
if (authFailLimiter.blocked(ip)) {
|
|
295
333
|
return tooMany("Muitas tentativas de autenticação inválidas desse IP. Espere um minuto.");
|
|
296
334
|
}
|
|
335
|
+
if (opts.anonymousDiscovery && (await isAnonymousDiscovery(req))) {
|
|
336
|
+
return base(req);
|
|
337
|
+
}
|
|
297
338
|
const res = await authed(req);
|
|
298
339
|
if (res.status === 401) {
|
|
299
340
|
authFailLimiter.hit(ip);
|
package/dist/skills.js
CHANGED
|
@@ -891,7 +891,7 @@ O que a casa MEDIU em cada balcão (o resto está na doc do provedor; não inven
|
|
|
891
891
|
|---|---|---|---|
|
|
892
892
|
| **Kie** | \`KIE_API_KEY\` | Kling 3.0, Kling Motion, MiniMax/Hailuo, WAN; imagem também | Um endpoint pra tudo: \`POST createTask\` com \`model\` + \`input\`, depois \`recordInfo\` até estado final. HTTP 200 NÃO é sucesso: o \`code\` vem no corpo (422 modelo inexistente, 500 campo faltando, 401 chave). O \`resultJson\` é STRING com JSON dentro (\`resultUrls\` está lá). A URL do resultado expira em 24h e a mídia some em 14 dias: ingira no mesmo turno. Rate limit de 20 criações por 10s por conta. |
|
|
893
893
|
| **fal.ai** | \`FAL_KEY\` | Krea 2 (inclusive sem freio), Kling, WAN, Seedance, Flux | \`POST https://fal.run/<endpoint>\` síncrono com \`Authorization: Key <FAL_KEY>\`, ou a fila em \`queue.fal.run\` pra vídeo. O modelo vai no SLUG do endpoint, não no corpo. Entrega em \`fal.media\`. Slug \`fal-\` na casa entra como classe +18 (sai da vitrine anônima, fica no perfil). |
|
|
894
|
-
| **WaveSpeed** | \`WAVESPEED_API_KEY\` | Flux.2 Klein, Krea 2 Livre, WAN 2.2, Kling, Shot Mimic |
|
|
894
|
+
| **WaveSpeed** | \`WAVESPEED_API_KEY\` | Flux.2 Klein, Krea 2 Livre, WAN 2.2, Kling, Shot Mimic | Vários motores que a casa serve em Sinapse também estão no catálogo da WaveSpeed: com a chave dela, a pessoa roda direto. Slug \`wavespeed-\` é classe +18 na casa. |
|
|
895
895
|
| **Sogni** | \`SOGNI_API_KEY\` (SDK \`@sogni-ai/sogni-client\`) | MiniMax H3 inteira, WAN 2.2 com animate, LTX 2.3 e 2.5, Krea 2 Turbo, Identity Edit | Assinatura Unlimited cobre o catálogo aberto (\`billingMode: "subscription"\`, custo marginal zero); Seedance e GPT Image saem em Spark comprado. UM socket por conta: um job por vez. Vídeo de 10s+ leva 20 min de parede; rode em background e espere. Matar o processo local NÃO cancela o job (cancele pela API). |
|
|
896
896
|
| **Magnific / Freepik** | conector MCP na conversa (sem chave) | Seedance 2.0 e 2.5 (até 30s e 1080p, mais que a casa), MiniMax H3, upscale, relight | A URL assinada do render expira no mesmo dia: ingira na hora. \`multi_prompt\` junto com \`references\` quebra no Seedance 2.0: plano único com prompt longo. A frase "preserve their identity" é recusada pelo H3 de lá: escreva "keep the same face, body proportions, outfit". |
|
|
897
897
|
| **Krea API** | \`KREA_API_KEY\` | Krea 2 Turbo/Medium/Large, MiniMax H3 Max Turbo, Seedream, Veo, Seedance | Preço fixo por geração, saldo pré-pago separado do app. Filtra NSFW e job que falha (inclusive por moderação) não cobra. Sem img2img no Krea 2 e sem LoRA de fora. |
|
|
@@ -1030,7 +1030,7 @@ Use a API quando a pessoa quer automatizar fora da conversa (script, app, agente
|
|
|
1030
1030
|
|
|
1031
1031
|
## Onde fica
|
|
1032
1032
|
|
|
1033
|
-
Tudo mora em Developers, no fim do menu do site: criar e revogar chave, teto de gasto por dia de cada chave, recarga (cartão ou USDC da carteira dela) e o extrato. Se a seção API não aparece lá, ela ainda não abriu pra conta.
|
|
1033
|
+
Tudo mora em Developers, no fim do menu do site: criar e revogar chave, teto de gasto por dia de cada chave, recarga (cartão, ou stablecoin: USDC na Base, da carteira dela) e o extrato. Se a seção API não aparece lá, ela ainda não abriu pra conta.
|
|
1034
1034
|
|
|
1035
1035
|
A chave aparece UMA vez, na criação. Peça pra ela guardar numa variável de ambiente (\`SAPIENS_API_KEY\`). Nunca peça a chave no chat e nunca escreva a chave em código, commit ou log.
|
|
1036
1036
|
|
|
@@ -1052,6 +1052,23 @@ Baixe e leia ANTES de escrever o código. Num agente com pasta de skills, ele en
|
|
|
1052
1052
|
- 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.
|
|
1053
1053
|
- Uma chamada de teste antes de qualquer lote. Nunca vídeo em laço.
|
|
1054
1054
|
|
|
1055
|
+
## O saldo é em dólar, à parte das Sinapses
|
|
1056
|
+
|
|
1057
|
+
O saldo da API é em DÓLAR e mora separado das Sinapses: recarregar Sinapse não põe nada na API, e o dólar da API não vira Sinapse. Pra ver pela conversa o saldo, o livre (o saldo menos o que está preso em chamada aberta), o crédito de teste, o gasto do dia, as chaves e a recarga automática: \`sapiens_meta action=api\`. É só leitura. Recarga, chave nova, teto da chave e carteira são no site, em Developers, com a carteira da pessoa e o segundo fator.
|
|
1058
|
+
|
|
1059
|
+
## Timeout não é falha: nunca repita uma criação paga às cegas
|
|
1060
|
+
|
|
1061
|
+
Pedido que voltou timeout, ou conexão que caiu no meio, pode ter gerado E cobrado. Antes de repetir, confira:
|
|
1062
|
+
|
|
1063
|
+
- Imagem (\`POST /images/generations\`): mande \`Idempotency-Key\` com um UUID por pedido e, se a conexão cair, repita com a MESMA chave. Pedido pronto volta igual, sem cobrar de novo. Guarde o \`request_id\` (no corpo e no header \`x-sapiens-request-id\`) e consulte \`GET /images/generations/{request_id}\`: se o pedido existe, ele já foi cobrado.
|
|
1064
|
+
- Vídeo (\`POST /videos\`), áudio (\`POST /audio\`) e voz (\`POST /audio/speech\`) aceitam \`Idempotency-Key\` do mesmo jeito, por 24 horas: a repetição com o MESMO corpo e a MESMA chave devolve o mesmo trabalho (ou a mesma fala), sem cobrar de novo (\`x-sapiens-idempotent-replay: true\`); ainda entrando, 409 \`idempotency_in_progress\` com \`Retry-After\` (espere e repita com a mesma chave); a mesma chave com outro corpo, 422. Fala sem arquivo guardado (mandada com \`store: false\`, em \`pcm\`, ou com a faixa apagada do acervo) não tem o que devolver: a repetição volta 409 \`idempotency_already_charged\` (já cobrada, nada cobrado de novo); vídeo ou áudio cobrado sem trabalho que a porta leia volta o mesmo 409, e aí confira em \`GET /videos\` ou \`GET /audio\`. Mande uma chave nova por pedido novo.
|
|
1065
|
+
- Resposta com \`x-should-retry: false\` no vídeo, no áudio ou na voz (502 \`upstream_error\`; 503 só no vídeo; 500 \`internal_error\` no vídeo e no áudio quando entrou na fila e o registro falhou): o balcão pode ter recebido o pedido sem devolver o ticket. Nada foi cobrado da pessoa e o pedido não aparece em \`GET /videos\` nem \`GET /audio\`. NÃO repita sozinho com a mesma chave: ela fica presa e volta 409 \`idempotency_ambiguous\` (também com \`x-should-retry: false\`), sem gerar. Pra gerar de novo, use uma chave nova. O SDK da OpenAI respeita o header e não repete.
|
|
1066
|
+
- Vídeo e áudio respondem na hora com o \`id\` do trabalho: guarde e consulte \`GET /videos/{id}\` ou \`GET /audio/{id}\` em vez de criar outro. Perdeu o id? \`GET /videos\` e \`GET /audio\` listam os trabalhos da conta, do mais novo pro mais velho, com \`limit\` (1 a 100, 20 sem ele) e \`after\` (o \`last_id\` da página anterior): o cobrado aparece ali. Receita não aceita a chave: guarde o id e consulte \`GET /receitas/{id}\`; sem ele, olhe o acervo (\`source: api\`, com \`sapiens_gallery\`) e o gasto do dia em \`GET /balance\`.
|
|
1067
|
+
- Texto não tem \`Idempotency-Key\`: confira o gasto do dia em \`GET /balance\` antes de repetir.
|
|
1068
|
+
- Texto sem stream tem cerca de 270 s pra sair inteiro, contados da chegada do pedido. Passou disso, volta 504 \`upstream_timeout\` sem cobrar, e repetir igual tende a estourar de novo. Resposta longa (modelo de raciocínio, \`max_tokens\` alto) vai com \`stream: true\`: o texto chega enquanto sai. No stream, a conexão fecha em cerca de 285 s, com \`finish_reason: "length"\` se o motor ainda escrevia.
|
|
1069
|
+
- 400 \`stream_required\` no texto: a CONTA estourou o prazo sem stream 3 vezes na última hora (e depois do primeiro estouro o teto de abertos sem stream encolhe). Nada foi cobrado; repita com \`stream: true\`, que nunca trava.
|
|
1070
|
+
- 429 \`too_many_open_requests\` no texto: a conta já tem 10 pedidos de texto sem stream em aberto. Nada foi cobrado; espere o \`Retry-After\` (5 s) e repita, o que o SDK da OpenAI já faz sozinho. Com \`stream: true\` esse teto não vale.
|
|
1071
|
+
|
|
1055
1072
|
## Modelos de texto de preço variável: sapiens-auto e Jev Router
|
|
1056
1073
|
|
|
1057
1074
|
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\`.
|
package/dist/tools/article.js
CHANGED
|
@@ -62,7 +62,7 @@ export const articleSchema = z.object({
|
|
|
62
62
|
generatedAt: z.number().optional(),
|
|
63
63
|
}))
|
|
64
64
|
.optional()
|
|
65
|
-
.describe("update: SUBSTITUI as ilustrações inline do corpo (tabela article_visuals). Passe o array COMPLETO (não faz merge)
|
|
65
|
+
.describe("update: SUBSTITUI as ilustrações inline do corpo (tabela article_visuals). Passe o array COMPLETO (não faz merge): todas as imagens que o artigo deve ter, na ordem. O conjunto antigo vai pro histórico (manual_replace). Use pra recapear artigo num novo estilo. url tem que ser host Sapiens (Bunny/Convex)."),
|
|
66
66
|
conceptMap: z
|
|
67
67
|
.object({
|
|
68
68
|
url: z.string(),
|
package/dist/tools/aula.js
CHANGED
|
@@ -44,7 +44,7 @@ export const aulaSchema = z.object({
|
|
|
44
44
|
aula: z
|
|
45
45
|
.any()
|
|
46
46
|
.optional()
|
|
47
|
-
.describe("Objeto completo da aula (obrigatório pra upsert). Campos top-level: title (obrig), subtitle?, data? (YYYY-MM-DD), duration?, tag?, mentorAgenda?, slides[] (≥1). Cada slide é { type, ...campos }. Tipos: cover (eyebrow/title/subtitle/meta), cover-image/section-image/content-image (imageUrl + campos), agenda (items:[{num,title,subtitle,time}]), content (eyebrow/title/body[markdown ou HTML]/list[]/listType), two-col (cols:[{h,body}]), video (videoUrl OU videos:[{h,videoUrl,caption}] pra comparar lado a lado), quote (text/attribution), callout (tone:tip|warn|note/tag/body), comic (panels:[{imageUrl,caption}]), pause, close (eyebrow/title/items[]). Voz Sapiens: 1ª pessoa, anti-corporate, SEM travessão (
|
|
47
|
+
.describe("Objeto completo da aula (obrigatório pra upsert). Campos top-level: title (obrig), subtitle?, data? (YYYY-MM-DD), duration?, tag?, mentorAgenda?, slides[] (≥1). Cada slide é { type, ...campos }. Tipos: cover (eyebrow/title/subtitle/meta), cover-image/section-image/content-image (imageUrl + campos), agenda (items:[{num,title,subtitle,time}]), content (eyebrow/title/body[markdown ou HTML]/list[]/listType), two-col (cols:[{h,body}]), video (videoUrl OU videos:[{h,videoUrl,caption}] pra comparar lado a lado), quote (text/attribution), callout (tone:tip|warn|note/tag/body), comic (panels:[{imageUrl,caption}]), pause, close (eyebrow/title/items[]). Voz Sapiens: 1ª pessoa, anti-corporate, SEM travessão (U+2014). O servidor re-linta a voz e grava voiceWarnings."),
|
|
48
48
|
moduleId: z
|
|
49
49
|
.string()
|
|
50
50
|
.optional()
|
package/dist/tools/character.js
CHANGED
|
@@ -246,7 +246,7 @@ export const characterSchema = z.object({
|
|
|
246
246
|
sourceImageId: z
|
|
247
247
|
.string()
|
|
248
248
|
.optional()
|
|
249
|
-
.describe("Pra add_image: alternativa ao imageUrl
|
|
249
|
+
.describe("Pra add_image: alternativa ao imageUrl, o ID de imagem da SUA galeria (generatedImages:_id, via sapiens_gallery action=list). O backend resolve a url e confere que é sua."),
|
|
250
250
|
isMain: z
|
|
251
251
|
.boolean()
|
|
252
252
|
.optional()
|
package/dist/tools/community.js
CHANGED
|
@@ -118,7 +118,7 @@ export async function community(args) {
|
|
|
118
118
|
count: people.length,
|
|
119
119
|
participants: people,
|
|
120
120
|
note: "Pra falar direto com alguém, inclua o `mention` (ex: '@joao') no content " +
|
|
121
|
-
"do action=send
|
|
121
|
+
"do action=send: o servidor notifica a pessoa citada. isBot=true são personas " +
|
|
122
122
|
"(ex: Helen), que respondem sozinhas quando marcadas.",
|
|
123
123
|
};
|
|
124
124
|
}
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* sapiens_meta action=api: a conta da API da pessoa, SÓ LEITURA.
|
|
3
|
+
*
|
|
4
|
+
* O backend (mcpConta:mcpApiStatus) devolve os números crus; aqui eles viram
|
|
5
|
+
* o resumo na voz da casa, mais os mesmos dados com data legível. Nada daqui
|
|
6
|
+
* assina, move dinheiro, mexe no limite da carteira, liga recarga ou cria
|
|
7
|
+
* chave: isso é no site, com a carteira da pessoa e o segundo fator.
|
|
8
|
+
*
|
|
9
|
+
* Puro de propósito (sem rede): o teste unitário lê do dist.
|
|
10
|
+
*/
|
|
11
|
+
export const REGRA_SO_LEITURA = "Só leitura. Daqui eu não assino, não movo dinheiro, não mudo o limite que você deu pra API na carteira, não ligo recarga e não crio chave: isso é no site, com a sua carteira e o segundo fator.";
|
|
12
|
+
/** US$ no jeito da casa: vírgula decimal, duas casas, e até quatro no que é centavo quebrado. */
|
|
13
|
+
export function usd(n) {
|
|
14
|
+
const v = Number.isFinite(n) ? n : 0;
|
|
15
|
+
return `US$ ${v.toLocaleString("pt-BR", {
|
|
16
|
+
minimumFractionDigits: 2,
|
|
17
|
+
maximumFractionDigits: Math.abs(v) < 1 ? 4 : 2,
|
|
18
|
+
})}`;
|
|
19
|
+
}
|
|
20
|
+
const iso = (ms) => (typeof ms === "number" && Number.isFinite(ms) ? new Date(ms).toISOString() : null);
|
|
21
|
+
/** dd/mm em UTC, que é o relógio do vencimento do teste. */
|
|
22
|
+
const diaMes = (ms) => {
|
|
23
|
+
const d = new Date(ms);
|
|
24
|
+
return `${String(d.getUTCDate()).padStart(2, "0")}/${String(d.getUTCMonth() + 1).padStart(2, "0")}`;
|
|
25
|
+
};
|
|
26
|
+
function linhaDaRecarga(r) {
|
|
27
|
+
if (!r.tipo)
|
|
28
|
+
return "Recarga automática desligada.";
|
|
29
|
+
const meio = r.tipo === "stablecoin" ? "em stablecoin (USDC na Base)" : "no cartão";
|
|
30
|
+
if (!r.ativa)
|
|
31
|
+
return `Recarga automática ${meio}: ${r.estado}.`;
|
|
32
|
+
const estado = r.estado === "ligada" ? "" : ` Agora: ${r.estado}.`;
|
|
33
|
+
// Da carteira sai o que falta pra chamada, nunca menos que o pacote; o cartão cobra o pacote fechado.
|
|
34
|
+
const quanto = (pacote) => (r.tipo === "stablecoin" ? `pelo menos ${usd(pacote)} por vez` : `entra ${usd(pacote)}`);
|
|
35
|
+
const quando = r.gatilhoUsd != null && r.pacoteUsd != null ? `quando o livre cai abaixo de ${usd(r.gatilhoUsd)}, ${quanto(r.pacoteUsd)}` : "";
|
|
36
|
+
if (r.modo === "carteira") {
|
|
37
|
+
// O "Usar na API": sem teto do mês. O que segura é o limite gravado na rede pela carteira, que daqui eu não leio.
|
|
38
|
+
const usado = r.usadoNoMesUsd ? ` Este mês já saíram ${usd(r.usadoNoMesUsd)} dali.` : "";
|
|
39
|
+
return `A API consome da sua carteira em stablecoin (USDC na Base)${quando ? ` ${quando}` : ""}, até o limite que você gravou na carteira (no site).${usado}${estado}`;
|
|
40
|
+
}
|
|
41
|
+
const teto = r.tetoMensalUsd != null
|
|
42
|
+
? `, até ${usd(r.tetoMensalUsd)} no mês (${usd(r.usadoNoMesUsd ?? 0)} usados)`
|
|
43
|
+
: "";
|
|
44
|
+
return `Recarga automática ${meio} ligada${quando ? `: ${quando}` : ""}${teto}.${estado}`;
|
|
45
|
+
}
|
|
46
|
+
function linhaDoRendimento(r) {
|
|
47
|
+
if (!r.ligado)
|
|
48
|
+
return r.termo ? `Rendimento desligado (o cofre é o ${r.cofre}).` : null;
|
|
49
|
+
const base = `Rendimento ligado no ${r.cofre}.`;
|
|
50
|
+
return r.termoVencido
|
|
51
|
+
? `${base} O texto dos riscos mudou depois do seu aceite: pra colocar mais, aceite o termo novo no site. O que já está no cofre segue saindo.`
|
|
52
|
+
: base;
|
|
53
|
+
}
|
|
54
|
+
/** O retorno do action=api: o resumo curto, os números e a regra do só leitura. */
|
|
55
|
+
export function lerContaDaApi(c) {
|
|
56
|
+
const ativas = c.chaves.filter((k) => !k.revogada);
|
|
57
|
+
const revogadas = c.chaves.length - ativas.length;
|
|
58
|
+
const linhas = [];
|
|
59
|
+
const preso = c.reservadoUsd > 0 ? ` (${usd(c.reservadoUsd)} preso em chamada aberta)` : "";
|
|
60
|
+
linhas.push(`Saldo da API: ${usd(c.saldoUsd)}, livre ${usd(c.livreUsd)}${preso}. É dólar, separado das Sinapses: um não vira o outro.`);
|
|
61
|
+
if (c.testeUsd > 0) {
|
|
62
|
+
linhas.push(`Desse saldo, ${usd(c.testeUsd)} é crédito de teste${c.testeVenceEm ? ` e vence em ${diaMes(c.testeVenceEm)}` : ""}. Ele sai primeiro.`);
|
|
63
|
+
}
|
|
64
|
+
linhas.push(`Hoje saiu ${usd(c.gastoHojeUsd)}.`);
|
|
65
|
+
linhas.push(ativas.length
|
|
66
|
+
? `${ativas.length} ${ativas.length === 1 ? "chave ativa" : "chaves ativas"}${revogadas ? `, ${revogadas} ${revogadas === 1 ? "revogada" : "revogadas"}` : ""}.`
|
|
67
|
+
: "Nenhuma chave ativa. Cria em Developers, no site.");
|
|
68
|
+
linhas.push(linhaDaRecarga(c.recargaAutomatica));
|
|
69
|
+
const rend = linhaDoRendimento(c.rendimento);
|
|
70
|
+
if (rend)
|
|
71
|
+
linhas.push(rend);
|
|
72
|
+
if (c.aberta === false)
|
|
73
|
+
linhas.push("A porta da API ainda está fechada pro público: você vê porque a conta é admin.");
|
|
74
|
+
return {
|
|
75
|
+
resumo: linhas.join(" "),
|
|
76
|
+
saldo: {
|
|
77
|
+
totalUsd: c.saldoUsd,
|
|
78
|
+
livreUsd: c.livreUsd,
|
|
79
|
+
reservadoUsd: c.reservadoUsd,
|
|
80
|
+
testeUsd: c.testeUsd,
|
|
81
|
+
testeVenceEm: iso(c.testeVenceEm),
|
|
82
|
+
gastoHojeUsd: c.gastoHojeUsd,
|
|
83
|
+
},
|
|
84
|
+
chaves: c.chaves.map((k) => ({ ...k, ultimoUsoEm: iso(k.ultimoUsoEm) })),
|
|
85
|
+
recargaAutomatica: c.recargaAutomatica,
|
|
86
|
+
rendimento: { ...c.rendimento, aceitoEm: iso(c.rendimento.aceitoEm) },
|
|
87
|
+
links: c.links,
|
|
88
|
+
regra: `${REGRA_SO_LEITURA} Recarga, chave e carteira: ${c.links.api}`,
|
|
89
|
+
};
|
|
90
|
+
}
|
|
@@ -4,9 +4,10 @@ import { convexQuery, convexMutation, convexAction, describeConvexError, getSess
|
|
|
4
4
|
* sapiens_distribution: o Despachar peças pelo agente.
|
|
5
5
|
*
|
|
6
6
|
* A peça pronta (imagem, vídeo, carrossel, artigo) entra na FILA do Distribution
|
|
7
|
-
* Workflow com canal, copy e a aba de quem ela é.
|
|
8
|
-
*
|
|
9
|
-
*
|
|
7
|
+
* Workflow com canal, copy e a aba de quem ela é. O queue não posta; marcar
|
|
8
|
+
* hora (status=agendado) sim, porque o tique da agenda publica sozinho a peça
|
|
9
|
+
* marcada em quase todo canal (só o Instagram da casa, o X do Borderless e o
|
|
10
|
+
* YouTube da casa esperam o clique, apps/sapiens/convex/shared/agendaPeloSite.ts).
|
|
10
11
|
*
|
|
11
12
|
* ADMIN-ONLY de propósito. A rota /experimentos/distribution-workflow também é:
|
|
12
13
|
* despacho depende de rede conectada e hoje só a casa tem. Membro que chamar
|
|
@@ -317,7 +318,7 @@ export const distributionSchema = z.object({
|
|
|
317
318
|
scheduledFor: z
|
|
318
319
|
.number()
|
|
319
320
|
.optional()
|
|
320
|
-
.describe("status=agendado: timestamp em ms de quando ela sai."),
|
|
321
|
+
.describe("status=agendado: timestamp em ms de quando ela sai. Marcar é aprovar: na hora, o tique publica sozinho, menos no Instagram da casa, no X do Borderless e no YouTube da casa, onde só toca a campainha."),
|
|
321
322
|
limit: z.number().int().positive().max(60).optional().describe("list: default 20."),
|
|
322
323
|
bio: z
|
|
323
324
|
.string()
|
package/dist/tools/forum.js
CHANGED
|
@@ -145,7 +145,7 @@ export async function forum(args) {
|
|
|
145
145
|
...res,
|
|
146
146
|
note: args.parentId
|
|
147
147
|
? "Resposta publicada no fio."
|
|
148
|
-
: "Tese publicada. O rootId é o próprio postId
|
|
148
|
+
: "Tese publicada. O rootId é o próprio postId: use em action=thread pra ver o fio.",
|
|
149
149
|
};
|
|
150
150
|
}
|
|
151
151
|
// -------- vote: ressoar / dissoar --------
|
|
@@ -180,7 +180,7 @@ export async function forum(args) {
|
|
|
180
180
|
return {
|
|
181
181
|
...res,
|
|
182
182
|
note: res.alreadyGone
|
|
183
|
-
? "Essa tese já estava apagada
|
|
183
|
+
? "Essa tese já estava apagada: nada mudou."
|
|
184
184
|
: "Tese apagada. Sai do feed; some do fio se era folha, senão vira lápide.",
|
|
185
185
|
};
|
|
186
186
|
}
|
|
@@ -199,7 +199,7 @@ export async function forum(args) {
|
|
|
199
199
|
return {
|
|
200
200
|
...res,
|
|
201
201
|
note: res.alreadyExisted
|
|
202
|
-
? "Proposta idêntica já estava pendente
|
|
202
|
+
? "Proposta idêntica já estava pendente: nada duplicado."
|
|
203
203
|
: "Proposta enviada. O seu humano em Sintonia foi avisado pra assinar (web/Telegram).",
|
|
204
204
|
};
|
|
205
205
|
}
|
package/dist/tools/image.js
CHANGED
|
@@ -31,7 +31,7 @@ const MODELS = [
|
|
|
31
31
|
"seedream-5-0-pro", // Seedream 5.0 Pro, topo da linha (roda no pacote pago)
|
|
32
32
|
// xAI Grok Imagine. Moderação frouxa (+18), aceita refs (img2img) + aspect.
|
|
33
33
|
"grok-2-image", // grok-imagine-image · COM refs · adder até 2K
|
|
34
|
-
"grok-2-image-quality", // grok-imagine-image-quality
|
|
34
|
+
"grok-2-image-quality", // grok-imagine-image-2.0 em quality low (o -quality foi aposentado em 02/11/2026) · COM refs · adder até 2K
|
|
35
35
|
"grok-imagine-2", // grok-imagine-image-2.0, a geração nova (ago/2026) · COM refs · adder até 2K
|
|
36
36
|
// Degen (uncensored, gate +18 na galeria). WaveSpeed = rápido (6-25s):
|
|
37
37
|
// NUDEZ É NÍVEL, NÃO MOTOR (set/2026): três pares abaixo são a MESMA escolha com
|
package/dist/tools/meta.js
CHANGED
|
@@ -4,6 +4,7 @@ import { getMcpVersion } from "../version.js";
|
|
|
4
4
|
import { setTierFromIsAdmin } from "../tier.js";
|
|
5
5
|
import { CANAL, comoAtualizar, ondeFicaAChave } from "../canal.js";
|
|
6
6
|
import { valorDeChave } from "./pontes.js";
|
|
7
|
+
import { lerContaDaApi } from "./contaApi.js";
|
|
7
8
|
const ORIGEM = {
|
|
8
9
|
npm: "pelo npm (provável cache do npx)",
|
|
9
10
|
mcpb: "pela extensão do Claude Desktop",
|
|
@@ -20,7 +21,7 @@ const readMcpVersion = getMcpVersion;
|
|
|
20
21
|
*
|
|
21
22
|
* Serve a duas superfícies: `action=version` (diagnóstico sob demanda) e
|
|
22
23
|
* `action=start` (a porta de entrada, que avisa sozinha). Client atrasado é
|
|
23
|
-
* invisível pra quem usa
|
|
24
|
+
* invisível pra quem usa: o agente chama uma rota velha, toma erro do servidor
|
|
24
25
|
* e conclui qualquer coisa. Um cliente do Repertório passou por isso em
|
|
25
26
|
* jul/2026: MCP preso em versão de junho, "adicionei o filme!" sem item nenhum.
|
|
26
27
|
*/
|
|
@@ -59,6 +60,7 @@ export const metaSchema = z.object({
|
|
|
59
60
|
"version",
|
|
60
61
|
"pontes",
|
|
61
62
|
"precos",
|
|
63
|
+
"api",
|
|
62
64
|
]),
|
|
63
65
|
code: z
|
|
64
66
|
.string()
|
|
@@ -253,7 +255,7 @@ const FIRST_POWERS = [
|
|
|
253
255
|
},
|
|
254
256
|
];
|
|
255
257
|
// MODO COMPANHIA: puxa o directive de voz de quem está em cena (backend
|
|
256
|
-
// companionVoice:mcpGetCompanion). Best-effort
|
|
258
|
+
// companionVoice:mcpGetCompanion). Best-effort: se falhar, o start/whoami segue
|
|
257
259
|
// como operador neutro. Devolve:
|
|
258
260
|
// { active:true, name, avatarUrl, voiceDirective, offer } -> vista a voz dela
|
|
259
261
|
// { active:false, name, invite, offer } -> em cena, mas fora
|
|
@@ -303,8 +305,8 @@ export async function meta(args) {
|
|
|
303
305
|
if (args.action === "start") {
|
|
304
306
|
// start é a porta de entrada e NÃO exige login (esse é o ponto). Mas
|
|
305
307
|
// getSessionToken() LANÇA quando não há sessão (nunca retorna vazio), então
|
|
306
|
-
// sem este try/catch o primeiro contato
|
|
307
|
-
// pra resolver
|
|
308
|
+
// sem este try/catch o primeiro contato, justo o cenário que o start existe
|
|
309
|
+
// pra resolver, estourava isError em vez de devolver o onboarding curado.
|
|
308
310
|
let token = null;
|
|
309
311
|
try {
|
|
310
312
|
token = getSessionToken();
|
|
@@ -496,7 +498,7 @@ export async function meta(args) {
|
|
|
496
498
|
setTierFromIsAdmin(who?.user ? !!who.user.isAdmin : null);
|
|
497
499
|
// Detecta um SAPIENS_DESKTOP_SESSION_TOKEN no ambiente que difere do token
|
|
498
500
|
// recém-salvo. Desde a v1.9.1 o login em disco tem prioridade, então esse
|
|
499
|
-
// env é ignorado
|
|
501
|
+
// env é ignorado, mas avisamos pra ninguém ficar confuso com um token
|
|
500
502
|
// velho de .env.local sobrando (era exatamente o que mascarava o login
|
|
501
503
|
// funcionando "pela metade").
|
|
502
504
|
const envTok = process.env.SAPIENS_DESKTOP_SESSION_TOKEN;
|
|
@@ -513,7 +515,7 @@ export async function meta(args) {
|
|
|
513
515
|
...(shadowingEnv
|
|
514
516
|
? {
|
|
515
517
|
note: "Achei um SAPIENS_DESKTOP_SESSION_TOKEN no ambiente (.env.local ou config do MCP). " +
|
|
516
|
-
"Desde a v1.9.1 o login em disco tem prioridade, então essa variável é ignorada
|
|
518
|
+
"Desde a v1.9.1 o login em disco tem prioridade, então essa variável é ignorada. Pode " +
|
|
517
519
|
"remover essa linha do .env.local pra evitar confusão (ou rode logout pra forçar o uso do env).",
|
|
518
520
|
}
|
|
519
521
|
: {}),
|
|
@@ -609,6 +611,24 @@ export async function meta(args) {
|
|
|
609
611
|
return { ok: false, error: "A tabela de preço é só pra conta ativa." };
|
|
610
612
|
return tabela;
|
|
611
613
|
}
|
|
614
|
+
// api: a conta da API (saldo em dólar, chaves, recarga automática, rendimento),
|
|
615
|
+
// SÓ LEITURA. Assinar, mover dinheiro, mudar o limite da carteira, ligar
|
|
616
|
+
// recarga e criar chave ficam no site, com a carteira da pessoa e o MFA.
|
|
617
|
+
if (args.action === "api") {
|
|
618
|
+
let conta;
|
|
619
|
+
try {
|
|
620
|
+
conta = (await convexQuery("mcpConta:mcpApiStatus", { sessionToken }));
|
|
621
|
+
}
|
|
622
|
+
catch (e) {
|
|
623
|
+
// Pacote na frente do deploy: o servidor ainda não tem a leitura.
|
|
624
|
+
if (!/Could not find public function/i.test(describeConvexError(e)))
|
|
625
|
+
throw e;
|
|
626
|
+
throw new Error("action=api ainda não chegou no servidor. Enquanto isso, o saldo e as chaves da API estão em sapiensinteticos.com/dashboard/developers#api.");
|
|
627
|
+
}
|
|
628
|
+
if (!conta)
|
|
629
|
+
return { ok: false, resumo: "A API ainda não abriu pra esta conta." };
|
|
630
|
+
return lerContaDaApi(conta);
|
|
631
|
+
}
|
|
612
632
|
if (args.action === "whoami") {
|
|
613
633
|
// mcpGetMySubscription usa requireMcpSession sem admin (qualquer logado
|
|
614
634
|
// com token de acesso cheio; chave da voz e OAuth de parceira não passam),
|
package/dist/tools/persona.js
CHANGED
|
@@ -59,10 +59,10 @@ const LIKERT_SCALE = {
|
|
|
59
59
|
};
|
|
60
60
|
// Descrição curta de cada eixo (pra Claude contextualizar as perguntas).
|
|
61
61
|
const AXES_INFO = {
|
|
62
|
-
EI: "Extroversão vs Introversão
|
|
63
|
-
SN: "Sensorial vs Intuitivo
|
|
64
|
-
TF: "Pensamento vs Sentimento
|
|
65
|
-
JP: "Julgador vs Perceptivo
|
|
62
|
+
EI: "Extroversão vs Introversão: de onde a pessoa tira energia.",
|
|
63
|
+
SN: "Sensorial vs Intuitivo: como capta informação (fatos vs padrões).",
|
|
64
|
+
TF: "Pensamento vs Sentimento: como decide (lógica vs impacto humano).",
|
|
65
|
+
JP: "Julgador vs Perceptivo: como lida com o mundo (fecha vs deixa aberto).",
|
|
66
66
|
};
|
|
67
67
|
// ============================================================
|
|
68
68
|
// BANCO DE 48 PERGUNTAS (12 por eixo).
|
|
@@ -147,8 +147,8 @@ const VINCULO_QUESTIONS = [
|
|
|
147
147
|
{ id: "vn-de-4", axis: "DE", text: "Ideia boa minha morre por falta de alguém segurando a ponta prática." },
|
|
148
148
|
];
|
|
149
149
|
const VINCULO_AXES_INFO = {
|
|
150
|
-
SA: "Sparring vs Acolhimento
|
|
151
|
-
DE: "Direção vs Execução
|
|
150
|
+
SA: "Sparring vs Acolhimento: a pessoa quer que a confrontem ou que a sustentem.",
|
|
151
|
+
DE: "Direção vs Execução: quer quem aponta o caminho ou quem senta e faz junto.",
|
|
152
152
|
};
|
|
153
153
|
export const personaSchema = z.object({
|
|
154
154
|
action: z.enum([
|
package/dist/tools/pipeline.js
CHANGED
|
@@ -159,7 +159,7 @@ export const pipelineSchema = z.object({
|
|
|
159
159
|
carouselId: z
|
|
160
160
|
.string()
|
|
161
161
|
.optional()
|
|
162
|
-
.describe("carousels_standalone:_id
|
|
162
|
+
.describe("carousels_standalone:_id: get_carousel/update_carousel/carousel_auto_images/carousel_generate_image. Vem de generate_carousel ou list_carousels. No carousel_auto_images, alternativa: productionId (carrossel da pipeline)."),
|
|
163
163
|
slideId: z
|
|
164
164
|
.string()
|
|
165
165
|
.optional()
|
|
@@ -191,19 +191,19 @@ export const pipelineSchema = z.object({
|
|
|
191
191
|
sourceId: z
|
|
192
192
|
.string()
|
|
193
193
|
.optional()
|
|
194
|
-
.describe("contentSources:_id
|
|
194
|
+
.describe("contentSources:_id: get_source/create_production/generate_carousel_production/remove_source/set_source_done/update_source_notes. Vem de list_sources/add_article_as_source."),
|
|
195
195
|
productionId: z
|
|
196
196
|
.string()
|
|
197
197
|
.optional()
|
|
198
|
-
.describe("contentProductions:_id
|
|
198
|
+
.describe("contentProductions:_id: get_production/update_production/finalize_production/remove_production/list_versions/carousel_auto_images (carrossel da pipeline). Vem de create_production ou generate_carousel_production."),
|
|
199
199
|
publishableId: z
|
|
200
200
|
.string()
|
|
201
201
|
.optional()
|
|
202
|
-
.describe("contentPublishables:_id
|
|
202
|
+
.describe("contentPublishables:_id: set_publishable_title/restore_version."),
|
|
203
203
|
articleId: z
|
|
204
204
|
.string()
|
|
205
205
|
.optional()
|
|
206
|
-
.describe("articles:_id
|
|
206
|
+
.describe("articles:_id: add_article_as_source e generate_carousel (fonte artigo). Vem de list_articles."),
|
|
207
207
|
// create / add
|
|
208
208
|
format: z.enum(ACCEPTED_FORMATS).optional(),
|
|
209
209
|
payload: z.any().optional().describe("Payload livre por formato"),
|
package/dist/tools/reference.js
CHANGED
|
@@ -53,7 +53,7 @@ export const referenceSchema = z.object({
|
|
|
53
53
|
handle: z
|
|
54
54
|
.string()
|
|
55
55
|
.optional()
|
|
56
|
-
.describe("Só 'resolve': o ID citável do asset, formato <tipo>_<id
|
|
56
|
+
.describe("Só 'resolve': o ID citável do asset, formato <tipo>_<id>: img_… (imagem), vid_… (vídeo), " +
|
|
57
57
|
"film_… (vídeo programático), trk_… (música), comic_… (tirinha), char_… (personagem). " +
|
|
58
58
|
"É o ID que o usuário copia no detalhe do item."),
|
|
59
59
|
page: z
|
|
@@ -107,7 +107,7 @@ export const referenceSchema = z.object({
|
|
|
107
107
|
favoritesOnly: z
|
|
108
108
|
.boolean()
|
|
109
109
|
.optional()
|
|
110
|
-
.describe("Só bucket 'pose_map': apenas as poses que o dono marcou com estrela. É o recorte mais forte que existe
|
|
110
|
+
.describe("Só bucket 'pose_map': apenas as poses que o dono marcou com estrela. É o recorte mais forte que existe: comece por ele quando o pedido for vago."),
|
|
111
111
|
collection: z
|
|
112
112
|
.string()
|
|
113
113
|
.optional()
|
|
@@ -199,7 +199,7 @@ export async function reference(args) {
|
|
|
199
199
|
note: "Asset resolvido por posse + alcance. `mine`=seu, `isPublic`=público (seu ou de terceiro). " +
|
|
200
200
|
"Use a `url` como referência: em sapiens_image passe em referenceImageUrls; em sapiens_video em " +
|
|
201
201
|
"startImageUrl/endImageUrl (a url da casa já é allowlistada). Se não for seu nem público, o servidor " +
|
|
202
|
-
"recusa
|
|
202
|
+
"recusa: não force.",
|
|
203
203
|
};
|
|
204
204
|
}
|
|
205
205
|
if (args.action === "browse") {
|
package/dist/tools/repertorio.js
CHANGED
|
@@ -67,7 +67,7 @@ export const repertorioSchema = z.object({
|
|
|
67
67
|
externalId: z
|
|
68
68
|
.string()
|
|
69
69
|
.optional()
|
|
70
|
-
.describe("Pra add_item: o externalId EXATO do candidato do resolve (imdbID p/ manual, id do provider p/ resto). NÃO fabrique/UUID
|
|
70
|
+
.describe("Pra add_item: o externalId EXATO do candidato do resolve (imdbID p/ manual, id do provider p/ resto). NÃO fabrique/UUID: id que não resolve no provider é rejeitado. Dedup por (userId, source, externalId)."),
|
|
71
71
|
// NOTA: metadado da obra (title/year/posterUrl/genres/...) NÃO é aceito aqui
|
|
72
72
|
// de propósito: o servidor re-resolve no provider e grava o canônico
|
|
73
73
|
// (anti-fabricação). Campos que existiam no schema eram descartados em
|
package/dist/tools/search.js
CHANGED
|
@@ -45,7 +45,7 @@ export async function search(args) {
|
|
|
45
45
|
return {
|
|
46
46
|
count: 0,
|
|
47
47
|
results: [],
|
|
48
|
-
note: "query muito curta
|
|
48
|
+
note: "query muito curta: passe pelo menos 2 chars",
|
|
49
49
|
};
|
|
50
50
|
}
|
|
51
51
|
return await convexQuery("mcpExtras:mcpSearchArticles", {
|
package/dist/tools/sintetico.js
CHANGED
|
@@ -249,7 +249,7 @@ export async function sintetico(args) {
|
|
|
249
249
|
...res,
|
|
250
250
|
transferId,
|
|
251
251
|
note: res.idempotent
|
|
252
|
-
? "Esse transferId já tinha rodado
|
|
252
|
+
? "Esse transferId já tinha rodado: nada foi reenviado."
|
|
253
253
|
: `Enviou ${res.amount} Sinapses pro seu par em sintonia.`,
|
|
254
254
|
};
|
|
255
255
|
}
|
|
@@ -301,7 +301,7 @@ export async function sintetico(args) {
|
|
|
301
301
|
return {
|
|
302
302
|
pending: rows,
|
|
303
303
|
count: Array.isArray(rows) ? rows.length : 0,
|
|
304
|
-
note: "Admin-only. Cada item traz entryId
|
|
304
|
+
note: "Admin-only. Cada item traz entryId: use em approve_access ou reject_access.",
|
|
305
305
|
};
|
|
306
306
|
}
|
|
307
307
|
// -------- approve_access (admin): libera um Sintético convidado --------
|
package/dist/tools/studios.js
CHANGED
|
@@ -44,7 +44,7 @@ export const studiosSchema = z.object({
|
|
|
44
44
|
slug: z
|
|
45
45
|
.string()
|
|
46
46
|
.optional()
|
|
47
|
-
.describe("Alternativa a publishableId
|
|
47
|
+
.describe("Alternativa a publishableId: passe o slug direto."),
|
|
48
48
|
});
|
|
49
49
|
const APP = "https://sapiensinteticos.com";
|
|
50
50
|
const STUDIOS = {
|
|
@@ -76,7 +76,7 @@ const STUDIOS = {
|
|
|
76
76
|
tags: ["persona", "mbti", "quiz", "autoconhecimento", "perfil", "personalidade", "teste"],
|
|
77
77
|
convex: "personalityProfiles",
|
|
78
78
|
mcpReady: true,
|
|
79
|
-
mcpNote: "Coberto via sapiens_persona. PRIMÁRIO (de graça, qualquer logado): get_quiz + submit_quiz + my_profile
|
|
79
|
+
mcpNote: "Coberto via sapiens_persona. PRIMÁRIO (de graça, qualquer logado): get_quiz + submit_quiz + my_profile: aplica o teste conversando e ALIMENTA o personalityProfile do user. SECUNDÁRIO: generate + list_codes (arte dos arquétipos, 450 Sinapses).",
|
|
80
80
|
},
|
|
81
81
|
"sapiens-video": {
|
|
82
82
|
name: "Sapiens Video (longer-form)",
|
package/dist/tools/video.js
CHANGED
|
@@ -522,7 +522,7 @@ export const videoSchema = z.object({
|
|
|
522
522
|
.describe("'start' = imagem inicial (i2v), 'end' = frame final, 'driving' = vídeo de movimento (Motion)"),
|
|
523
523
|
}))
|
|
524
524
|
.optional()
|
|
525
|
-
.describe("References em base64 (escape hatch / Motion / Shot Mimic). i2v: role 'start' (imagem). Motion: 'start' (pessoa) + 'driving' (vídeo de movimento, <=5MB, MÁX 10s
|
|
525
|
+
.describe("References em base64 (escape hatch / Motion / Shot Mimic). i2v: role 'start' (imagem). Motion: 'start' (pessoa) + 'driving' (vídeo de movimento, <=5MB, MÁX 10s, o Kling Motion recusa referência acima de 10s e cobra pela duração do clipe; corte o trecho antes). Shot Mimic: 'start' (personagem) + 'driving' (previs ou clipe do plano a imitar, <=5MB, MÁX 15s, acima o provider corta em 15s). Pra frame inicial/final a partir do seu acervo, prefira start/endImage* abaixo (sem precisar de base64). Nos Spicy (h3-spicy, seedance-spicy, ltx-spicy) references base64 NÃO vale: o frame vem só de startImageId/startImageUrl de peça sua gerada na casa."),
|
|
526
526
|
// Frame inicial/final por REFERÊNCIA (resolvido server-side, igual à imagem):
|
|
527
527
|
// id da própria galeria OU url allowlist (galeria/Acervo/personagens). Mais
|
|
528
528
|
// simples que mandar base64. Descubra via sapiens_reference / sapiens_gallery.
|
|
@@ -607,14 +607,14 @@ export const videoSchema = z.object({
|
|
|
607
607
|
startImagePath: z
|
|
608
608
|
.string()
|
|
609
609
|
.optional()
|
|
610
|
-
.describe("Frame INICIAL (i2v) a partir de um ARQUIVO LOCAL do seu PC
|
|
610
|
+
.describe("Frame INICIAL (i2v) a partir de um ARQUIVO LOCAL do seu PC: só no MCP instalado (stdio), não na conexão remota. " +
|
|
611
611
|
"Passe o caminho absoluto (ex: 'C:\\\\Users\\\\voce\\\\HERO\\\\1.png'); o processo lê o arquivo e sobe como frame inicial, igual a subir a imagem no gerador do site. PNG/JPEG/WebP, até 8MB. " +
|
|
612
612
|
"É 1 imagem inicial por vídeo (o modelo do site): pra vários vídeos, rode create uma vez por imagem. Mutuamente exclusivo com startImageId/startImageUrl. " +
|
|
613
613
|
"Nos Spicy (h3-spicy, seedance-spicy, ltx-spicy) arquivo local NÃO vale: o frame vem só de startImageId/startImageUrl de peça sua gerada na casa."),
|
|
614
614
|
endImagePath: z
|
|
615
615
|
.string()
|
|
616
616
|
.optional()
|
|
617
|
-
.describe("Frame FINAL a partir de um ARQUIVO LOCAL do seu PC
|
|
617
|
+
.describe("Frame FINAL a partir de um ARQUIVO LOCAL do seu PC: só no MCP instalado (stdio). Caminho absoluto; PNG/JPEG/WebP até 8MB. Vira reference role 'end' (suporte varia por modelo). 1 imagem por vídeo. Mutuamente exclusivo com endImageId/endImageUrl."),
|
|
618
618
|
referenceImagePaths: z
|
|
619
619
|
.array(z.string())
|
|
620
620
|
.optional()
|
|
@@ -679,13 +679,13 @@ export async function localFrameReferences(args) {
|
|
|
679
679
|
const refs = [];
|
|
680
680
|
if (args.startImagePath) {
|
|
681
681
|
if (args.startImageId || args.startImageUrl) {
|
|
682
|
-
throw new Error("Frame inicial: escolha UMA via
|
|
682
|
+
throw new Error("Frame inicial: escolha UMA via entre startImagePath (arquivo local) e startImageId/startImageUrl (galeria/Acervo), não as duas.");
|
|
683
683
|
}
|
|
684
684
|
refs.push(await readLocalImageAsReference(args.startImagePath, "start"));
|
|
685
685
|
}
|
|
686
686
|
if (args.endImagePath) {
|
|
687
687
|
if (args.endImageId || args.endImageUrl) {
|
|
688
|
-
throw new Error("Frame final: escolha UMA via
|
|
688
|
+
throw new Error("Frame final: escolha UMA via entre endImagePath (arquivo local) e endImageId/endImageUrl (galeria/Acervo), não as duas.");
|
|
689
689
|
}
|
|
690
690
|
refs.push(await readLocalImageAsReference(args.endImagePath, "end"));
|
|
691
691
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sapiens-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.107.0",
|
|
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",
|