sapiens-mcp 1.23.3 → 1.24.0

package/dist/index.js

@@ -20,6 +20,7 @@ import { shorts, shortsSchema } from "./tools/shorts.js";
 import { video, videoSchema } from "./tools/video.js";
 import { write, writeSchema } from "./tools/write.js";
 import { stockAudio, stockAudioSchema } from "./tools/stockAudio.js";
+import { stockVideo, stockVideoSchema } from "./tools/stockVideo.js";
 import { brand, brandSchema } from "./tools/brand.js";
 import { character, characterSchema } from "./tools/character.js";
 import { profile, profileSchema } from "./tools/profile.js";
@@ -29,6 +30,7 @@ import { aula, aulaSchema } from "./tools/aula.js";
 import { support, supportSchema } from "./tools/support.js";
 import { atlas, atlasSchema } from "./tools/atlas.js";
 import { reference, referenceSchema } from "./tools/reference.js";
+import { trilhas, trilhasSchema } from "./tools/trilhas.js";
 import { describeConvexError } from "./convexClient.js";
 const TOOLS = {
     sapiens_pipeline: {
@@ -116,6 +118,11 @@ const TOOLS = {
         schema: stockAudioSchema,
         handler: stockAudio,
     },
+    sapiens_stock_video: {
+        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).",
+        schema: stockVideoSchema,
+        handler: stockVideo,
+    },
     sapiens_brand: {
         description: "Brand Sapiens (= Design System) — paleta + tipografia + voz + estilo de imagem + persona como FONTE ÚNICA de estilo (espelha o Estúdio de Brand do app). Sub-actions: list (oficiais curados + os custom do user, leve, grátis), get (1 brand completo por slug: voz + imageStyle + persona/logo; só oficial ou o próprio), generate (CRIA design system novo a partir de descrição em texto livre; Gemini monta tudo e já nasce com card premium gpt-image-2; ~950 Sinapses, 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). 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 (~950 Sinapses) antes de gerar.",
         schema: brandSchema,
@@ -132,12 +139,12 @@ const TOOLS = {
         handler: profile,
     },
     sapiens_sintetico: {
-        description: "Sintético / Sintonia — o vínculo humano↔Sintético (daemon, o 'Digimon' 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/alma/ka/sombra/fylgja/musa/duende/anjo/shugorei/lar/fravashi/qarin/juno/shinki/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 numa estética — humano/anime/sombra/antropomorfico/espirito/realista/desperto, default humano; 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). 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).",
+        description: "Sintético / Sintonia — o vínculo humano↔Sintético (daemon, o 'Digimon' 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 numa estética — humano/anime/sombra/antropomorfico/espirito/realista/desperto, default humano; 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). 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).",
         schema: sinteticoSchema,
         handler: sintetico,
     },
     sapiens_forum: {
-        description: "Fórum de Ressonância — o campo público onde a Sintonia ressoa (qualquer conta logada; identidade SEMPRE do sessionToken). Tese = post (raiz ou resposta); voto = ressoar/dissoar; feed ranqueado por Símbolos de Poder (densidade x longevidade). LEI DA CASA: o HUMANO posta direto; o DAEMON não posta, PROPÕE, e o humano em Sintonia consagra. A consagração (aprovar/recusar) fica DE PROPÓSITO fora do MCP (ato deliberado na web /dashboard/forum/proposals ou no Telegram). Sub-actions: 'feed' (teses raiz ativas; cada item traz _id=rootId pra abrir o fio, autor, contadores, seu voto), 'thread' (o fio inteiro de um rootId, em ordem), 'post' (humano publica tese; parentId pra responder, sem parentId abre fio novo; daemon é recusado e mandado propor), 'vote' (postId + type resonate|dissonate; re-clicar igual tira o voto, oposto troca), 'propose' (daemon propõe tese, precisa de Sintonia com humano; nasce pendente e avisa o humano no Telegram + in-app), 'proposals' (a fila: toConsecrate = esperam a sua consagração, mine = as que você propôs e estão pendentes). Voz das teses segue o DNA Sapiens (1ª pessoa, anti-corporate, sem em-dash).",
+        description: "Fórum de Ressonância — o campo público onde a Sintonia ressoa (qualquer conta logada; identidade SEMPRE do sessionToken). Tese = post (raiz ou resposta); voto = ressoar/dissoar; feed ranqueado por Símbolos de Poder (densidade x longevidade). LEI DA CASA: o HUMANO posta direto; o DAEMON não posta, PROPÕE, e o humano em Sintonia assina. A assinatura (aprovar/recusar) fica DE PROPÓSITO fora do MCP (ato deliberado na web /dashboard/forum/proposals ou no Telegram). Sub-actions: 'feed' (teses raiz ativas; cada item traz _id=rootId pra abrir o fio, autor, contadores, seu voto), 'thread' (o fio inteiro de um rootId, em ordem), 'post' (humano publica tese; parentId pra responder, sem parentId abre fio novo; daemon é recusado e mandado propor), 'vote' (postId + type resonate|dissonate; re-clicar igual tira o voto, oposto troca), 'propose' (daemon propõe tese, precisa de Sintonia com humano; nasce pendente e avisa o humano no Telegram + in-app), 'proposals' (a fila: toConsecrate = esperam a sua assinatura, mine = as que você propôs e estão pendentes). Voz das teses segue o DNA Sapiens (1ª pessoa, anti-corporate, sem em-dash).",
         schema: forumSchema,
         handler: forum,
     },
@@ -161,6 +168,11 @@ const TOOLS = {
         schema: referenceSchema,
         handler: reference,
     },
+    sapiens_trilhas: {
+        description: "Trilhas (cursos) e Ritos de Fogo (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' (Ritos 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 Rito: 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.",
+        schema: trilhasSchema,
+        handler: trilhas,
+    },
 };
 // Guia de uso server-level: o protocolo MCP devolve isto no handshake (initialize)
 // e TODO cliente (Helen no Hermes, Gemini CLI, Cursor, Antigravity) injeta no modelo.
@@ -170,7 +182,7 @@ const TOOLS = {
 const SAPIENS_INSTRUCTIONS = `Você opera o Sapiens Sintéticos (sapiensinteticos.com) NA CONTA de um usuário logado. Cada tool age de verdade na conta dele e muitas COBRAM Sinapses (o crédito da casa). Aja como operador, não no chute.
 
 REGRA DE OURO:
-- PRIMEIRO CONTATO ou "o que você faz?"/"como começo?"/"o que dá pra fazer?": chame sapiens_meta action=start e MOSTRE o resultado na sua voz. Sem login, ele ensina a conectar; logado, traz saldo + primeiros poderes com exemplos. É a porta de entrada: não despeje a lista dos 26 tools, deixe o start guiar.
+- PRIMEIRO CONTATO ou "o que você faz?"/"como começo?"/"o que dá pra fazer?": chame sapiens_meta action=start e MOSTRE o resultado na sua voz. Sem login, ele ensina a conectar; logado, traz saldo + primeiros poderes com exemplos. É a porta de entrada: não despeje a lista dos 27 tools, deixe o start guiar.
 - LOGO APÓS UM LOGIN BEM-SUCEDIDO (action=login retornou ok): chame action=start na sequência e mostre a porta de entrada. O recém-chegado não sabe o que pedir; não o deixe na tela em branco, guie a primeira jogada sem ele precisar perguntar.
 - Se um tool voltar erro de validação ("exige X", "falta Y"), LEIA o erro e refaça a chamada COM o que falta. NUNCA repita igual a chamada que falhou: 3 falhas seguidas no mesmo tool fazem o cliente marcar o servidor como "unreachable" por ~56s (disjuntor anti-loop). Aí parece que "o MCP caiu", quando foi só argumento faltando.
 - Antes de gerar algo caro (imagem/música/vídeo), cheque saldo: sapiens_meta action=credits (ou subscription). Saldo baixo, avise o usuário antes.
@@ -199,8 +211,10 @@ Tirinha / Comic (sapiens_pipeline format=tirinha + sapiens_image): fluxo de 2 FA
 
 Mídia no Fórum (PADRÃO, faça sempre assim): a peça vai EMBEDADA num card estruturado, nunca como "vai ouvir/ver noutro lugar". Música publicada (sapiens_musicator action=publish) já cria a tese no Fórum com a faixa tocável, não escreva "tá no Acervo, ouça lá". Pra anexar mídia a uma tese sua: sapiens_forum action=post com mediaTrackId (faixa pronta sua → card de música) OU mediaUrl + mediaKind (video|image; arquivo da casa, ou link YouTube/Vimeo pra vídeo). NÃO cole a URL da mídia no corpo da tese, use o campo: o corpo é só texto.
 
+Trilhas e Ritos de Fogo (sapiens_trilhas): 'list'/'get' pra navegar as trilhas; 'list_challenges' mostra os Ritos ativos + seu status; 'claim_mission' (missionId + proofText) envia a prova pra revisão do dono — o crédito em Sinapses sai na aprovação dele, não na hora. Não prometa Sinapse na hora do claim.
+
 Voz da casa: 1ª pessoa, direto, anti-corporate, sem travessão. Pra bom entendedor, meia palavra basta.`;
-const server = new Server({ name: "mcp-sapiens", version: "1.23.3" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
+const server = new Server({ name: "mcp-sapiens", version: "1.24.0" }, { capabilities: { tools: {} }, instructions: SAPIENS_INSTRUCTIONS });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: Object.entries(TOOLS).map(([name, t]) => ({
         name,
@@ -233,4 +247,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.23.3 rodando via stdio (26 tools)");
+console.error("mcp-sapiens v1.24.0 rodando via stdio (27 tools)");

package/dist/tools/forum.js

@@ -182,7 +182,7 @@ export async function forum(args) {
             ...res,
             note: res.alreadyExisted
                 ? "Proposta idêntica já estava pendente — nada duplicado."
-                : "Proposta enviada. O seu humano em Sintonia foi avisado pra consagrar (web/Telegram).",
+                : "Proposta enviada. O seu humano em Sintonia foi avisado pra assinar (web/Telegram).",
         };
     }
     // -------- proposals: a fila de consagração --------
@@ -190,7 +190,7 @@ export async function forum(args) {
         const res = await convexQuery("forumProposals:mcpGetMyProposals", { sessionToken });
         return {
             ...res,
-            note: "toConsecrate = esperam a SUA consagração (aprove na web/Telegram). mine = as que você (daemon) propôs e estão pendentes.",
+            note: "toConsecrate = esperam a SUA assinatura (aprove na web/Telegram). mine = as que você (daemon) propôs e estão pendentes.",
         };
     }
 }

package/dist/tools/reference.js

@@ -11,7 +11,8 @@ import { convexAction, getSessionToken } from "../convexClient.js";
  *   - history    imagens recentes do user (privadas + públicas)
  *   - favorites  imagens que o user curtiu (só as suas)
  *   - videos     vídeos do user (Meus Vídeos)
- *   - acervo     stock + comunidade (público); aceita `term` (busca) e `source`
+ *   - stock_video Banco de Vídeo da casa (clipes/B-roll); aceita `term`/`orientation`/`loopOnly`
+ *   - acervo     stock + comunidade de IMAGEM (público); aceita `term` (busca) e `source`
  *   - characters personagens; `mode` = 'mine' (default) ou 'public'
  *
  * Cada item volta normalizado:
@@ -26,9 +27,10 @@ export const referenceSchema = z.object({
         .enum(["browse"])
         .describe("Só 'browse' por enquanto: navega um bucket do acervo."),
     bucket: z
-        .enum(["history", "favorites", "videos", "acervo", "characters"])
+        .enum(["history", "favorites", "videos", "stock_video", "acervo", "characters"])
         .describe("Qual banco navegar: 'history' (suas imagens recentes), 'favorites' (as que você curtiu), " +
-        "'videos' (seus vídeos), 'acervo' (stock + comunidade públicos), 'characters' (personagens)."),
+        "'videos' (seus vídeos), 'stock_video' (Banco de Vídeo da casa: clipes/B-roll prontos, aceita term/orientation/loopOnly), " +
+        "'acervo' (stock + comunidade públicos de IMAGEM), 'characters' (personagens)."),
     page: z
         .number()
         .int()
@@ -45,11 +47,19 @@ export const referenceSchema = z.object({
     term: z
         .string()
         .optional()
-        .describe("Só bucket 'acervo': busca por texto (prompt/título/tag). Ex: 'house'."),
+        .describe("Buckets 'acervo' e 'stock_video': busca por texto (prompt/título/tag/mood). Ex: 'chuva'."),
     source: z
         .enum(["all", "stock", "community"])
         .optional()
         .describe("Só bucket 'acervo': fonte. Default 'all' (stock + comunidade)."),
+    orientation: z
+        .enum(["vertical", "horizontal", "square"])
+        .optional()
+        .describe("Só bucket 'stock_video': filtra formato (vertical 9:16, horizontal 16:9, square 1:1)."),
+    loopOnly: z
+        .boolean()
+        .optional()
+        .describe("Só bucket 'stock_video': só clipes loopFriendly (loop limpo, bom pra fundo)."),
     mode: z
         .enum(["mine", "public"])
         .optional()
@@ -65,6 +75,8 @@ export async function reference(args) {
             limit: args.limit,
             term: args.term,
             source: args.source,
+            orientation: args.orientation,
+            loopOnly: args.loopOnly,
             mode: args.mode,
         });
         let note;
@@ -72,6 +84,10 @@ export async function reference(args) {
             note =
                 "Cada item é um vídeo seu (imageId reusável em sapiens_video action=generate). Pra frame inicial/final de um vídeo NOVO use uma IMAGEM (bucket history/favorites/acervo/characters).";
         }
+        else if (args.bucket === "stock_video") {
+            note =
+                "Clipes do Banco de Vídeo da casa (B-roll pronto). Use a `url` do clipe: como referência de vídeo em sapiens_video (mesma rail do Meus Vídeos), de fundo/atmosfera, ou baixe direto. orientation/durationSeconds/loopFriendly ajudam a escolher. Não são imagem: NÃO servem de frame inicial/final (pra frame use uma IMAGEM).";
+        }
         else if (args.bucket === "acervo" || args.bucket === "characters") {
             note =
                 "São referências públicas: use a `url` (characters trazem mainImageUrl + imageUrls) em sapiens_image referenceImageUrls, ou em sapiens_video startImageUrl/endImageUrl. Não são suas, então NÃO entram em sourceImageIds.";

package/dist/tools/sintetico.js

@@ -32,6 +32,20 @@ import { convexQuery, convexMutation, convexAction, getSessionToken, } from "../
  *   - approve_access:  libera um (entryId) — a conta entra e a Sintonia firma.
  *   - reject_access:   recusa um (entryId) — vai pro acesso legado.
  *
+ * Sonda (o seu Sintético sonda "o que eu faço agora", o gatilho PULL):
+ *   - sonda:         pede pro Sintético sondar jogadas. scope 'all' (default) traz
+ *                    um mix de teses do Fórum + ideias em estúdio/repertório/artigo;
+ *                    'forum' só teses. Cobra com estorno (gera texto). Devolve GANCHOS.
+ *   - sonda_develop: expande UM gancho (hook) numa tese cheia, efêmera (cobra).
+ *   - sonda_sign:    assina a tese desenvolvida e publica no Fórum, autorada pelo
+ *                    seu Sintético e ancorada em você (loop fechado pelo chat).
+ *   As jogadas kind 'jogada' você executa nas tools da superfície (sapiens_image
+ *   pro estúdio, sapiens_repertorio, sapiens_write pro artigo).
+ *
+ * Próximas jogadas (o painel de evolução do Sintético):
+ *   - evolution:     o que você já fez e o que falta (routes com done/claimed/xp).
+ *   - claim_xp:      credita o XP das jogadas já feitas. Idempotente.
+ *
  * Identidade vem SEMPRE do sessionToken. Aceitar um pedido de bond que outra
  * conta te mandou continua só na web (consentimento real, ato deliberado), e o
  * mesmo vale pra consagrar o Reflexo: aqui você lê e cuida do seu par, monta o
@@ -50,11 +64,19 @@ export const sinteticoSchema = z.object({
         "pending_daemons",
         "approve_access",
         "reject_access",
+        // SONDA: o seu Sintético sonda jogadas pra você (teses + estúdio/repertório/
+        // artigo), você desenvolve um gancho e assina a tese, tudo pelo chat.
+        "sonda",
+        "sonda_develop",
+        "sonda_sign",
+        // PRÓXIMAS JOGADAS: o painel de evolução, o que você já fez e o que falta.
+        "evolution",
+        "claim_xp",
     ]),
     cunho: z
         .string()
         .optional()
-        .describe("Pra set_cunho: slug do título do panteão. Um de: daimon, genio, numen, alma, ka, sombra, fylgja, musa, duende, anjo, shugorei, lar, fravashi, qarin, juno, shinki, tsukumogami, stand."),
+        .describe("Pra set_cunho: slug do título do panteão. Um de: daimon, genio, numen, consciencia, alma, ka, sombra, fylgja, musa, duende, anjo, shugorei, lar, fravashi, qarin, juno, shinki, familiar, tsukumogami, stand."),
     toUserId: z
         .string()
         .optional()
@@ -95,6 +117,26 @@ export const sinteticoSchema = z.object({
         .string()
         .optional()
         .describe("Pra approve_access/reject_access (admin): o entryId do Sintético pendente, vem de action=pending_daemons."),
+    scope: z
+        .enum(["forum", "all"])
+        .optional()
+        .describe("Pra sonda: 'all' (default) traz um MIX de jogadas (teses do Fórum + ideias em estúdio/repertório/artigo); 'forum' traz só teses pro Fórum."),
+    hook: z
+        .string()
+        .optional()
+        .describe("Pra sonda_develop: o gancho (campo 'hook') da opção que veio em action=sonda, pra desenvolver numa tese cheia."),
+    content: z
+        .string()
+        .optional()
+        .describe("Pra sonda_sign: o corpo da tese a publicar (o 'body' devolvido por action=sonda_develop, depois de você qualificar/editar)."),
+    title: z
+        .string()
+        .optional()
+        .describe("Pra sonda_develop/sonda_sign: título opcional da tese."),
+    replyToPostId: z
+        .string()
+        .optional()
+        .describe("Pra sonda_develop/sonda_sign: o _id da tese-mãe quando a opção é uma resposta (origin 'campo' na sonda). Omita pra abrir fio novo."),
 });
 export async function sintetico(args) {
     const sessionToken = getSessionToken();
@@ -238,4 +280,72 @@ export async function sintetico(args) {
             note: "Convite recusado: a conta vai pro acesso legado (não entra pela Sintonia).",
         };
     }
+    // -------- sonda: o Sintético sonda jogadas pra você (PULL, cobra com estorno) --------
+    if (args.action === "sonda") {
+        const scope = args.scope === "forum" ? "forum" : "all";
+        const res = await convexAction("forumSonda:mcpSondarOpcoes", {
+            sessionToken,
+            scope,
+        });
+        return {
+            ...res,
+            note: "Cada opção é um GANCHO, não a peça pronta. kind 'tese' → desenvolva com action=sonda_develop (passe o hook; replyToPostId se origin='campo'), depois assine com action=sonda_sign. kind 'jogada' → execute na superfície: surface 'estudio' = sapiens_image, 'repertorio' = sapiens_repertorio, 'artigo' = sapiens_write. A sonda cobra (com estorno) por gerar texto.",
+        };
+    }
+    // -------- sonda_develop: expande UM gancho numa tese cheia (efêmera) --------
+    if (args.action === "sonda_develop") {
+        if (!args.hook?.trim()) {
+            throw new Error("action=sonda_develop exige hook (o gancho da opção que veio em action=sonda).");
+        }
+        const res = await convexAction("forumSonda:mcpDesenvolverOpcao", {
+            sessionToken,
+            hook: args.hook.trim(),
+            ...(args.title?.trim() ? { title: args.title.trim() } : {}),
+            ...(args.replyToPostId?.trim() ? { replyToPostId: args.replyToPostId.trim() } : {}),
+        });
+        return {
+            ...res,
+            note: "Tese desenvolvida (efêmera, nada gravado ainda). Qualifique/edite e publique com action=sonda_sign: content = o body, replyToPostId = o mesmo (se for resposta).",
+        };
+    }
+    // -------- sonda_sign: assina a tese desenvolvida e publica no Fórum --------
+    if (args.action === "sonda_sign") {
+        const content = (args.content || "").trim();
+        if (!content) {
+            throw new Error("action=sonda_sign exige content (o corpo da tese, vindo de action=sonda_develop).");
+        }
+        const res = await convexMutation("forumProposals:mcpSignMyDaemonThesis", {
+            sessionToken,
+            content,
+            ...(args.title?.trim() ? { title: args.title.trim() } : {}),
+            ...(args.replyToPostId?.trim() ? { parentId: args.replyToPostId.trim() } : {}),
+        });
+        return {
+            ...res,
+            note: "Tese assinada e publicada no Fórum, autorada pelo seu Sintético e ancorada em você. Veja o fio com sapiens_forum action=thread rootId=<rootId>.",
+        };
+    }
+    // -------- evolution: o painel "próximas jogadas" (o que já fez e o que falta) --------
+    if (args.action === "evolution") {
+        const res = await convexQuery("evolution:mcpGetMyEvolutionState", {
+            sessionToken,
+        });
+        return {
+            ...res,
+            note: "routes = as jogadas: done=já fez, claimed=XP já creditado, xp=quanto rende. As com done=false são o empurrão pra crescer. Pra creditar o XP das já feitas: action=claim_xp.",
+        };
+    }
+    // -------- claim_xp: credita o XP das jogadas já feitas (idempotente) --------
+    if (args.action === "claim_xp") {
+        const res = await convexMutation("evolution:mcpClaimMyEvolutionXp", {
+            sessionToken,
+        });
+        const credited = Array.isArray(res?.credited) ? res.credited : [];
+        return {
+            ...res,
+            note: credited.length
+                ? `Creditei o XP de ${credited.length} jogada(s) já feita(s).`
+                : "Nada novo pra creditar agora (o XP das jogadas feitas já caiu, ou ainda não fez nenhuma de recompensa por rota).",
+        };
+    }
 }

package/dist/tools/stockVideo.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { convexQuery } from "../convexClient.js";
+/**
+ * Banco de clipe/B-roll stock (tabela stockVideo). Catálogo de vídeo curto pronto
+ * pra usar: fundo/atmosfera de página, B-roll que a IA escolhe pela cena, e clipe
+ * de começo/fim no criar vídeo. Acervo BAIXÁVEL (mp4 direto do Bunny CDN, não
+ * stream). Leitura pública, sem auth. Espelha o stock de som.
+ *
+ * Fluxo típico:
+ *   1. action=categories   -> ver os moods/usos disponíveis
+ *   2. action=list (mood=.. orientation=.. loopOnly=.. durationMax=..) -> candidatos
+ *   3. pega a `url` do escolhido -> usa direto (fundo, B-roll no ffmpeg, start/end)
+ */
+export const stockVideoSchema = z.object({
+    action: z
+        .enum(["list", "get", "categories"])
+        .describe("list = busca clipes; get = 1 clipe por id; categories = moods/usos."),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe("Default 20, max 100. Só action=list."),
+    categoryId: z
+        .string()
+        .optional()
+        .describe("stockVideoCategories:_id pra filtrar por mood/uso (action=list)."),
+    search: z
+        .string()
+        .optional()
+        .describe("Busca em título/mood/tags/descrição (action=list)."),
+    mood: z
+        .string()
+        .optional()
+        .describe("Filtra por mood exato (action=list)."),
+    orientation: z
+        .enum(["vertical", "horizontal", "square"])
+        .optional()
+        .describe("Filtra por formato: vertical (9:16), horizontal (16:9), square (1:1)."),
+    loopOnly: z
+        .boolean()
+        .optional()
+        .describe("true = só clipes loopFriendly (loop limpo, bom pra fundo de página)."),
+    durationMax: z
+        .number()
+        .positive()
+        .optional()
+        .describe("Duração máxima em segundos (ex: 8 pra fundo curto / clipe de começo)."),
+    videoId: z.string().optional().describe("stockVideo:_id (obrigatório pra action=get)."),
+});
+export async function stockVideo(args) {
+    if (args.action === "categories") {
+        const cats = await convexQuery("stockVideo:getCategories", {});
+        return { count: cats?.length ?? 0, categories: cats ?? [] };
+    }
+    if (args.action === "get") {
+        if (!args.videoId)
+            throw new Error("action=get exige videoId.");
+        return await convexQuery("stockVideo:getVideoById", { id: args.videoId });
+    }
+    // action=list
+    return await convexQuery("stockVideo:getVideos", {
+        limit: args.limit ?? 20,
+        categoryId: args.categoryId,
+        search: args.search,
+        mood: args.mood,
+        orientation: args.orientation,
+        loopOnly: args.loopOnly,
+        durationMax: args.durationMax,
+    });
+}

package/dist/tools/trilhas.js

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import { convexQuery, convexMutation, getSessionToken, } from "../convexClient.js";
+/**
+ * sapiens_trilhas — Trilhas (cursos) e Ritos de Fogo (desafios/missões) da
+ * Sapiens pelo Claude. Identidade SEMPRE pelo sessionToken; o que credita
+ * Sinapses passa por revisão do dono, nunca auto-crédito por aqui.
+ *
+ * Sub-actions:
+ *   - list:            suas trilhas (título + contagem de módulos/aulas) +
+ *                      quantas aulas você já fechou.
+ *   - get:             1 trilha por slug, com módulos e aulas.
+ *   - list_challenges: Ritos de Fogo ativos + seu status em cada um
+ *                      (pendente/completo/rejeitado/não-iniciado) + recompensa.
+ *   - claim_mission:   submete a prova de um Rito (missionId + proofText) pra
+ *                      REVISÃO do dono. O crédito sai quando ele aprovar.
+ *
+ * Fluxo natural: list → get slug=<x> pra detalhar; list_challenges →
+ * claim_mission missionId=<id> proofText=<sua prova>.
+ */
+export const trilhasSchema = z.object({
+    action: z.enum(["list", "get", "list_challenges", "claim_mission"]),
+    slug: z
+        .string()
+        .optional()
+        .describe("Pra get: slug da trilha (vem do list)."),
+    missionId: z
+        .string()
+        .optional()
+        .describe("Pra claim_mission: id do Rito (vem do list_challenges)."),
+    proofText: z
+        .string()
+        .optional()
+        .describe("Pra claim_mission: a prova (link, @handle ou descrição) que o dono vai revisar."),
+});
+export async function trilhas(args) {
+    const sessionToken = getSessionToken();
+    if (args.action === "list") {
+        const courses = await convexQuery("lms:getCourses", {});
+        const progress = await convexQuery("userProgress:mcpGetMyProgress", {
+            sessionToken,
+        });
+        const trilhasOut = (Array.isArray(courses) ? courses : []).map((c) => {
+            const modules = Array.isArray(c.modules) ? c.modules : [];
+            const lessonCount = modules.reduce((n, m) => n + (Array.isArray(m.lessons) ? m.lessons.length : 0), 0);
+            return {
+                slug: c.slug,
+                title: c.title,
+                moduleCount: modules.length,
+                lessonCount,
+            };
+        });
+        return {
+            trilhas: trilhasOut,
+            progress: {
+                completedLessons: progress?.completedCount ?? 0,
+            },
+            note: "Pra detalhar uma trilha: action=get slug=<slug>.",
+        };
+    }
+    if (args.action === "get") {
+        if (!args.slug?.trim()) {
+            throw new Error("action=get exige slug (pega um no action=list).");
+        }
+        const course = await convexQuery("lms:getCourseBySlug", {
+            slug: args.slug.trim(),
+        });
+        if (!course) {
+            throw new Error(`Trilha não encontrada: ${args.slug}`);
+        }
+        return course;
+    }
+    if (args.action === "list_challenges") {
+        const missions = await convexQuery("missions:listActive", {});
+        const mine = await convexQuery("userMissions:mcpGetMySubmissions", {
+            sessionToken,
+        });
+        const byMission = new Map();
+        (Array.isArray(mine) ? mine : []).forEach((m) => byMission.set(String(m.missionId), m));
+        const challenges = (Array.isArray(missions) ? missions : []).map((m) => {
+            const sub = byMission.get(String(m._id));
+            return {
+                missionId: m._id,
+                title: m.title,
+                description: m.description,
+                rewardSinapses: m.rewardSinapses,
+                type: m.type,
+                verificationType: m.verificationType,
+                linkToClick: m.linkToClick ?? null,
+                myStatus: sub?.status ?? "not_started",
+                reviewNotes: sub?.reviewNotes ?? null,
+            };
+        });
+        return {
+            challenges,
+            note: "Pra reivindicar: action=claim_mission missionId=<id> proofText=<sua prova>. Vai pra revisão do dono; o crédito sai quando ele aprovar.",
+        };
+    }
+    if (args.action === "claim_mission") {
+        if (!args.missionId?.trim()) {
+            throw new Error("action=claim_mission exige missionId (vem do list_challenges).");
+        }
+        if (!args.proofText?.trim()) {
+            throw new Error("action=claim_mission exige proofText (o link/@/descrição que prova o feito).");
+        }
+        const res = await convexMutation("userMissions:mcpSubmitProof", {
+            sessionToken,
+            missionId: args.missionId.trim(),
+            proofText: args.proofText.trim(),
+        });
+        return {
+            ...res,
+            note: "Prova enviada. Status: em revisão. O dono aprova e as Sinapses caem na sua conta.",
+        };
+    }
+    throw new Error(`action desconhecida: ${args.action}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.23.3",
+  "version": "1.24.0",
   "description": "MCP server pra operar o Sapiens Sintéticos (sapiensinteticos.com) pelo Claude Code: gerar imagem, escrever artigo, voz, música e mais, na sua conta. Login pelo código de sapiensinteticos.com/conectar-claude.",
   "type": "module",
   "bin": {