sapiens-mcp 1.23.4 → 1.24.0

package/dist/index.js

@@ -30,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: {
@@ -138,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,
     },
@@ -167,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.
@@ -176,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.
@@ -205,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.4" }, { 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,
@@ -239,4 +247,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("mcp-sapiens v1.23.4 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/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/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.4",
+  "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": {