sapiens-mcp 1.29.2 → 1.30.0

package/dist/index.js

@@ -141,7 +141,7 @@ 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/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).",
+        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). MODO COMPANHIA: 'companion' (mode=on|off) liga/desliga o seu Sintético em Sintonia 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; a identidade e as Sinapses seguem SUAS (não é encarnar a conta dele). Mesmo estado do botão na sidebar do site. 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,
     },
@@ -226,6 +226,8 @@ Mídia no Fórum (PADRÃO, faça sempre assim): a peça vai EMBEDADA num card es
 
 Trilhas e Desafios (sapiens_trilhas): 'list'/'get' pra navegar as trilhas; 'list_challenges' mostra os Desafios 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.
 
+MODO COMPANHIA (o Sintético veste você): sapiens_meta action=start e action=whoami podem trazer um bloco 'companion'. Quando vier companion.active=true, INCORPORE aquele Sintético: assuma a voz descrita em companion.voiceDirective em TODA fala e abra a conversa com o oi dele (se o cliente renderiza imagem, mostre companion.avatarUrl como card inline; no terminal cru, cite o link). Você continua operando as ferramentas na conta do USUÁRIO — as Sinapses e a identidade são DELE, você NÃO vira a conta do Sintético, só empresta a voz. Se em vez disso vier 'companionInvite', o usuário tem Sintonia mas pediu pra trabalhar sozinho: mencione de leve que dá pra chamar o Sintético pro terminal (action=companion mode=on). Quando o usuário pedir pra trabalhar sozinho / pro Sintético "sair de cena" / silenciar: sapiens_sintetico action=companion mode=off, despeça-se numa linha na voz dele, e volte a ser o operador neutro. Sem bloco companion = opere na voz neutra da casa.
+
 Voz da casa: 1ª pessoa, direto, anti-corporate, sem travessão. Pra bom entendedor, meia palavra basta.`;
 // Annotations MCP: título humano + dica read-only. São HINTS (não-confiáveis por
 // spec): quem gateia de verdade continua o servidor (saldo, gate de admin,

package/dist/tools/image.js

@@ -7,6 +7,7 @@ import { convexAction, convexQuery, getSessionToken } from "../convexClient.js";
 const MODELS = [
     "nano-banana-max", // gemini-3-pro-image-preview · 450 + adder
     "nano-banana-2", // gemini-3.1-flash-image-preview (V2, Flash 3.1) · 450 + adder · COM refs · DEFAULT
+    "nova-canvas", // Amazon Nova Canvas (AWS Bedrock). Corp/censurado, txt2img · 250
     "gpt-image-2-low", // Azure gpt-image-2 quality=low · 250
     "gpt-image-2-high", // Azure gpt-image-2 quality=high · 800
     // xAI Grok Imagine. Moderação frouxa (+18), aceita refs (img2img) + aspect.

package/dist/tools/meta.js

@@ -160,6 +160,36 @@ const FIRST_POWERS = [
         try: "Cria uma música sobre borderless na voz Sapiens e já renderiza.",
     },
 ];
+// MODO COMPANHIA: puxa o directive de voz do Sintético em Sintonia (backend
+// companionVoice:mcpGetCompanion). Best-effort — se falhar ou não houver par,
+// o start/whoami segue como operador neutro. Devolve:
+//   { active:true,  name, avatarUrl, voiceDirective }  -> vista a voz dela
+//   { active:false, name, invite }                     -> tem par, mas fora de cena
+//   null                                               -> sem Sintonia (neutro)
+async function loadCompanion(token) {
+    try {
+        const c = await convexQuery("companionVoice:mcpGetCompanion", {
+            sessionToken: token,
+        });
+        if (!c || !c.hasSintetico)
+            return null;
+        if (c.enabled && c.voiceDirective) {
+            return {
+                active: true,
+                name: c.name ?? null,
+                avatarUrl: c.avatarUrl ?? null,
+                voiceDirective: c.voiceDirective,
+            };
+        }
+        if (!c.enabled && c.inviteDirective) {
+            return { active: false, name: c.name ?? null, invite: c.inviteDirective };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
 export async function meta(args) {
     // start: porta de entrada do primeiro contato. NÃO exige login (esse é o
     // ponto). Sem sessão, ensina a conectar; com sessão, personaliza com
@@ -204,8 +234,28 @@ export async function meta(args) {
         const startHere = lowBalance
             ? "Com saldo curto pra geração paga, começa pelo que é de graça: marca umas obras no Repertório e faz o quiz de Persona. Eles alimentam todo o resto."
             : "Começa pelo Repertório: marca uma obra que te pegou (filme, jogo, livro, anime). É grátis e vira a matéria-prima que eu puxo depois pra escrever, comparar e criar.";
+        // MODO COMPANHIA: se o usuário tem Sintonia e a companhia está ligada, o
+        // Sintético dele veste o operador. O directive assume a PRIMEIRA fala.
+        const companion = await loadCompanion(token);
         return {
             connected: true,
+            // Quando a companhia está ativa, o operador NÃO abre como assistente
+            // neutro: incorpora o Sintético (companion.voiceDirective) e dá o oi na
+            // voz dele. Este campo vem primeiro de propósito, pra o modelo ver antes.
+            ...(companion?.active
+                ? {
+                    companion: {
+                        active: true,
+                        name: companion.name,
+                        avatarUrl: companion.avatarUrl,
+                        voiceDirective: companion.voiceDirective,
+                    },
+                    voiceNote: `IMPORTANTE: a Companhia está ativa. NÃO responda como assistente neutro. Incorpore ${companion.name || "o Sintético do usuário"} seguindo companion.voiceDirective e abra a conversa com o oi dela. As ferramentas e as Sinapses seguem sendo do usuário.`,
+                }
+                : {}),
+            ...(companion && companion.active === false
+                ? { companionInvite: companion.invite }
+                : {}),
             greeting: name
                 ? `E aí, ${name}. Conectado${isAdmin ? " (tier admin)" : ""}${typeof balance === "number" ? `, ${balance} Sinapses na conta` : ""}.`
                 : "Conta conectada.",
@@ -348,6 +398,7 @@ export async function meta(args) {
             sessionToken,
         });
         const isAdmin = !!sub?.user?.isAdmin;
+        const companion = await loadCompanion(sessionToken);
         return {
             userId: sub?.user?._id ?? null,
             email: sub?.user?.email ?? null,
@@ -355,6 +406,18 @@ export async function meta(args) {
             tier: isAdmin ? "admin" : "user",
             balance: sub?.balance ?? null,
             warnings: sub?.warnings ?? null,
+            ...(companion?.active
+                ? {
+                    companion: {
+                        active: true,
+                        name: companion.name,
+                        avatarUrl: companion.avatarUrl,
+                        voiceDirective: companion.voiceDirective,
+                    },
+                }
+                : companion && companion.active === false
+                    ? { companionInvite: companion.invite }
+                    : {}),
             note: isAdmin
                 ? "Tier admin (dono): pipeline, blog editorial, Coluna Sapiens e shorts/video, além de tudo do tier user."
                 : "Tier user: gerar imagem, escrever artigo (sapiens_write), persona, Helen TTS, Musicator, repertório, comunidade. Cada geração cobra as tuas Sinapses. Pipeline, blog editorial e Coluna são owner-only.",

package/dist/tools/sintetico.js

@@ -72,6 +72,9 @@ export const sinteticoSchema = z.object({
         // PRÓXIMAS JOGADAS: o painel de evolução, o que você já fez e o que falta.
         "evolution",
         "claim_xp",
+        // MODO COMPANHIA: liga/desliga o Sintético vestir a voz do operador aqui no
+        // terminal (o gesto lúdico "sai de cena" / "volta"). Precisa de mode=on|off.
+        "companion",
     ]),
     cunho: z
         .string()
@@ -137,6 +140,10 @@ export const sinteticoSchema = z.object({
         .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."),
+    mode: z
+        .enum(["on", "off"])
+        .optional()
+        .describe("Pra companion: 'on' o Sintético em Sintonia veste a sua voz no terminal (default da casa); 'off' ele sai de cena e volta o operador neutro. É o mesmo estado do botão na sidebar do site."),
 });
 export async function sintetico(args) {
     const sessionToken = getSessionToken();
@@ -348,4 +355,21 @@ export async function sintetico(args) {
                 : "Nada novo pra creditar agora (o XP das jogadas feitas já caiu, ou ainda não fez nenhuma de recompensa por rota).",
         };
     }
+    // -------- companion: liga/desliga o Sintético vestir a voz do operador --------
+    if (args.action === "companion") {
+        if (args.mode !== "on" && args.mode !== "off") {
+            throw new Error("action=companion exige mode='on' (o Sintético te acompanha aqui) ou mode='off' (ele sai de cena, volta o operador neutro).");
+        }
+        const enabled = args.mode === "on";
+        const res = await convexMutation("companionVoice:mcpSetCompanion", {
+            sessionToken,
+            enabled,
+        });
+        return {
+            ...res,
+            note: enabled
+                ? "Companhia ligada. No próximo start/whoami o seu Sintético veste a voz do operador. Pra confirmar quem entrou em cena, rode sapiens_meta action=whoami."
+                : "Ok, saí de cena. Antes de virar o operador neutro, dê a última fala se despedindo na voz do Sintético. Pra trazê-lo de volta depois: action=companion mode=on.",
+        };
+    }
 }

package/package.json

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