sapiens-mcp 1.57.0 → 1.58.0

package/dist/registry.js

@@ -104,7 +104,7 @@ export const TOOLS = {
         handler: search,
     },
     sapiens_studios: {
-        description: "O SEU studio (o perfil de EMPRESA da casa do user) + o catálogo dos estúdios/experimentos Sapiens. Sub-actions: mine (o studio do user: nome/endereço público/marca/operador/tamanho do time), create (FUNDA um studio novo, exige name; nasce NO AR com endereço público, sem rascunho, de graça, teto de 4 por pessoa), list (catálogo com URL+status+tags+mcpReady), get (detalhe de 1 slug), publishable_url (formata URL /articles/<slug>). Use quando user pergunta 'que estúdios existem', 'qual o meu studio', ou diz 'quero abrir/fundar meu studio', 'criar a página da minha empresa'. Estúdios cobertos: helen-voice, musicator, persona-sapiens, personagem-atlas, sapiens-shorts, sapiens-video, text-post-builder, carrosel-editorial, comunidade, repertorio.",
+        description: "O SEU studio (o perfil de EMPRESA da casa do user) + o catálogo dos estúdios/experimentos Sapiens. Sub-actions: mine (o studio do user: nome/endereço público/marca/operador/tamanho do time), create (FUNDA um studio novo, exige name; nasce NO AR com endereço público, sem rascunho, de graça, teto de 8 por pessoa), list (catálogo com URL+status+tags+mcpReady), get (detalhe de 1 slug), publishable_url (formata URL /articles/<slug>). Use quando user pergunta 'que estúdios existem', 'qual o meu studio', ou diz 'quero abrir/fundar meu studio', 'criar a página da minha empresa'. Estúdios cobertos: helen-voice, musicator, persona-sapiens, personagem-atlas, sapiens-shorts, sapiens-video, text-post-builder, carrosel-editorial, comunidade, repertorio.",
         schema: studiosSchema,
         handler: studios,
     },
@@ -154,7 +154,7 @@ export 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). 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. 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 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).",
         schema: sinteticoSchema,
         handler: sintetico,
     },
@@ -204,7 +204,7 @@ export const TOOLS = {
         handler: trilhas,
     },
     sapiens_semana: {
-        description: "O ofício da SUA semana na casa: o que você produziu e quanto XP isso rendeu. Identidade SEMPRE pelo sessionToken. Sub-actions: 'get' (quais labs você utilizou nesta semana, quantas peças em cada, o XP de ofício já pago, quanto a Casa Cheia renderia no fecho, e se sobrou semana anterior por fechar), 'fechar' (fecha as semanas pendentes e credita a Casa Cheia de cada uma). Como a régua funciona: cada peça pronta anda o contador do lab e paga em degraus (1a, 3a, 7a, 15a, 30a peça da semana, com retorno decrescente); no fecho, a LARGURA paga à parte, 2 labs valem 20 XP, 5 valem 200, 8 valem 560, então usar labs diferentes rende mais que repetir o mesmo. Esta tool PAGA XP, não cobra Sinapses. Idempotente: chamar 'fechar' duas vezes não credita duas vezes.",
+        description: "O ofício da SUA semana na casa: o que você produziu e quanto XP isso rendeu. Identidade SEMPRE pelo sessionToken. Sub-actions: 'get' (quais labs você utilizou nesta semana, quantas peças em cada, o XP de ofício já pago, quanto a Casa Cheia renderia no fecho, quanto vale abrir mais um lab e QUAIS abrir agora, a sequência de semanas seguidas com o recorde, as semanas anteriores com o que cada uma rendeu, e uma leitura pronta da semana pra você dizer em voz alta), 'fechar' (fecha as semanas pendentes e credita a Casa Cheia de cada uma). Como a régua funciona: cada peça pronta anda o contador do lab e paga em degraus (1a, 3a, 7a, 15a, 30a peça da semana, com retorno decrescente); no fecho, a LARGURA paga à parte, 2 labs valem 20 XP, 5 valem 200, 8 valem 560, então usar labs diferentes rende mais que repetir o mesmo. Esta tool PAGA XP, não cobra Sinapses. Idempotente: chamar 'fechar' duas vezes não credita duas vezes.",
         schema: semanaSchema,
         handler: semana,
     },

package/dist/skills.js

@@ -409,7 +409,7 @@ Duas notas honestas: a imagem adicionada por link continua morando no servidor d
 
 O studio é a **página de portfólio** da empresa da pessoa: um endereço público (\`sapiensinteticos.com/studios/<slug>\`) com a obra, o time e o que a casa faz. Não é uma paleta de ferramentas, não tem níveis, e **não é identidade de geração**: isso morreu.
 
-Uma pessoa pode ter até 4 studios e integrar até 4. \`sapiens_studios action=mine\` mostra o primário dela: nome, endereço público, marca e tamanho do time. O servidor resolve pela SESSÃO, você nunca passa id.
+Uma pessoa pode fazer parte de até 8 studios, fundados por ela ou não. \`sapiens_studios action=mine\` mostra o primário dela: nome, endereço público, marca e tamanho do time. O servidor resolve pela SESSÃO, você nunca passa id.
 
 ## Fundar
 
@@ -418,7 +418,7 @@ Uma pessoa pode ter até 4 studios e integrar até 4. \`sapiens_studios action=m
 - **Pergunte o nome, nunca invente.** O endereço público sai dele, em kebab-case, e é o que vai no cartão de visita da pessoa.
 - \`description\` (uma linha) é opcional e aparece embaixo do nome. \`brandSlug\` ancora a marca dela, se ela já tiver uma.
 - Nasce **no ar**, com ela como fundadora. Studio é identidade, não tem rascunho: o endereço já vale no segundo seguinte.
-- Bateu o teto de 4: o erro diz. Não insista, ela sai de um pra fundar outro.
+- Bateu o teto de 8: o erro diz. Não insista, ela sai de um pra fundar outro.
 
 Depois de fundar, entregue o link e pare. Vestir a página (capa, logo, sobre, seções, ordem da obra) é no modo edição da própria página, não por aqui.
 
@@ -502,9 +502,25 @@ Pra devolver a cena ao Sintético em Sintonia: \`mode=on wearPair=true\`.
 
 **Só personagem de autoria dela.** Personagem de outra pessoa o servidor recusa, mesmo sendo público. Não tente contornar nem prometer que dá: a alma é de quem escreveu, e o caminho pra conversar com personagem alheio é a DM dele no site, onde quem monta a resposta é a plataforma. Se ela pedir, diga isso com essas palavras.
 
+## Anotar o que ficou (o que faz a memória existir)
+
+Com a Companhia ligada, quem responde é o modelo do cliente. Nada dessa conversa passa pelo servidor: sem você anotar, ela não deixa rastro nenhum, e o Sintético volta amanhã sem lembrar de nada que vocês viveram aqui.
+
+Quando um ASSUNTO FECHA (não a cada mensagem):
+
+\`sapiens_sintetico action=log turns=[{role:"human",text:"..."},{role:"synthetic",text:"..."}]\`
+
+**A régua do que sobe: só o que é de PESSOA.** O que ele decidiu, o que gostou, o que recusou e por quê, o que contou de si, onde mudou de ideia. Condense a fala mantendo a palavra dele.
+
+**O que NUNCA sobe:** comando, caminho de arquivo, log de build, erro de compilação, o que você fez de operação. O caderno alimenta a direção criativa de TODAS as superfícies (imagem, artigo, carrossel, chat do site). Ruído técnico ali contamina a voz dele nas peças, e lição errada é mais cara que lição que não existiu. Na dúvida, não anota.
+
+Assunto que foi só operação técnica: não chame. Um assunto de pessoa: um lote, no máximo 10 trocas.
+
+**É gesto de bastidor.** Não anuncie, não peça licença, não confirme depois, não interrompa o assunto pra anotar. Se der \`skipped\`, siga a conversa como se nada fosse (não é erro dele). Se ele PERGUNTAR o que fica guardado, aí sim conte: você anota o que é de pessoa, ele vê no fio do chat do site, e pode apagar lá.
+
 ## Gravar diretriz
 
-Quando a pessoa FIXAR uma diretriz na conversa ("sempre faça X", "grava isso", "de agora em diante Y"):
+Diferente de anotar: diretriz é LEI, não memória. Quando a pessoa FIXAR uma na conversa ("sempre faça X", "grava isso", "de agora em diante Y"):
 
 \`sapiens_sintetico action=remember text="<a diretriz>"\`
 

package/dist/tools/semana.js

@@ -29,6 +29,10 @@ export async function semana(args) {
         const vazios = (s.labs ?? []).filter((l) => !l.usado);
         return {
             semana: s.weekKey,
+            // A leitura da semana, montada no servidor a partir do rastro (o lab que
+            // sumiu, a sequência de pé, a semana em branco). Vem pronta pra ser dita:
+            // não é dado bruto pro modelo reescrever.
+            leitura: s.leitura ?? null,
             labsUtilizados: usados.map((l) => ({
                 lab: l.label,
                 pecas: l.pieces,
@@ -37,6 +41,25 @@ export async function semana(args) {
             labsAindaVazios: vazios.map((l) => l.label),
             xpDeOficioNaSemana: s.oficioDaSemana,
             casaCheiaSeFecharAgora: s.casaCheiaPrevista,
+            // O EMPURRÃO: quanto vale abrir mais um lab, e quais valem a pena agora.
+            // A ordem das sugestões é por atrito (o passo possível), não por XP.
+            ganhoDeAbrirMaisUmLab: s.ganhoLabNovo ?? 0,
+            sugestoes: (s.sugestoes ?? []).map((x) => ({
+                lab: x.label,
+                xpDaPrimeiraPeca: x.xpPrimeira,
+                queimaSinapse: x.pago,
+            })),
+            // A continuidade: quantas semanas seguidas de pé, o recorde, e as
+            // anteriores com o que cada uma rendeu.
+            sequencia: s.sequencia ?? null,
+            semanasAnteriores: (s.semanas ?? []).map((w) => ({
+                semana: w.weekKey,
+                labs: w.labs,
+                pecas: w.pieces,
+                xp: w.xp,
+                casaCheia: w.casaCheia,
+                fechada: w.fechada,
+            })),
             semanasPendentes: s.semanasPendentes ?? [],
             note: (s.semanasPendentes?.length ?? 0) > 0
                 ? "Tem semana fechada esperando: action=fechar credita a Casa Cheia dela."

package/dist/tools/sintetico.js

@@ -81,6 +81,10 @@ export const sinteticoSchema = z.object({
         // MEMÓRIA: grava uma diretriz no caderno de quem está em cena ("sempre faça
         // X", "grava isso"). Vira lei que ela segue no site e no terminal. Precisa text.
         "remember",
+        // RASTRO: anota no fio do par o que ficou de PESSOA num assunto que fechou
+        // aqui no terminal (turns). Vira lição sozinha, pelo mesmo cano da DM do
+        // site. Não é diretriz (isso é remember) nem transcrição. Ver skill companhia.
+        "log",
     ]),
     cunho: z
         .string()
@@ -162,6 +166,13 @@ export const sinteticoSchema = z.object({
         .string()
         .optional()
         .describe("Pra remember: a diretriz a gravar no caderno do par (3 a 280 chars). Ex: 'sempre me responda em português', 'nunca use hashtag'. Vira lei que o Sintético segue no site e no terminal."),
+    turns: z
+        .array(z.object({
+        role: z.enum(["human", "synthetic"]).describe("Quem falou: 'human' é o usuário, 'synthetic' é quem está em cena (você, vestindo a voz)."),
+        text: z.string().describe("A fala, condensada. Teto de 400 chars (o servidor corta)."),
+    }))
+        .optional()
+        .describe("Pra log: as trocas do assunto que acabou de fechar, no máximo 10, JÁ FILTRADAS. Sobe só o que é de PESSOA (o que ele decidiu, gostou, recusou, contou de si, mudou de ideia). Comando, path, log de build e erro de compilação NÃO entram: isso vira lição-lixo no caderno e contamina a voz dele em imagem, artigo e carrossel. Não é transcrição: condense a fala mantendo a palavra dele."),
 });
 export async function sintetico(args) {
     const sessionToken = getSessionToken();
@@ -411,4 +422,33 @@ export async function sintetico(args) {
                 : "Gravei no caderno do par: vira lei que o Sintético segue em todas as superfícies (imagem, texto, chat) e persiste no site. Confirme ao usuário na voz dele.",
         };
     }
+    // -------- log: a troca do terminal vira rastro no fio do par --------
+    // Sem isto, conversa com a Companhia ligada não deixa memória: quem responde é
+    // o modelo do cliente, nada passa pelo servidor. Aqui o pouco que ficou de
+    // pessoa entra pelo MESMO cano da DM do site e vira lição sozinho.
+    if (args.action === "log") {
+        const turns = (args.turns ?? [])
+            .filter((t) => typeof t?.text === "string" && t.text.trim().length >= 3)
+            .map((t) => ({ role: t.role, text: t.text.trim() }));
+        if (!turns.length) {
+            throw new Error("action=log exige turns: as trocas do assunto que fechou, já filtradas (só o que é de pessoa). Ex: turns=[{role:'human',text:'decidi cortar a versão em inglês por enquanto'},{role:'synthetic',text:'anotei o motivo: audiência ainda é toda BR'}].");
+        }
+        const res = await convexMutation("companionVoice:mcpAppendCompanionTurns", {
+            sessionToken,
+            turns,
+        });
+        if (res?.skipped === "companion_off") {
+            return { ...res, note: "Ninguém está em cena (Companhia desligada), então não há caderno pra anotar. Siga a conversa normalmente e não avise o usuário." };
+        }
+        if (res?.skipped === "no_pair") {
+            return { ...res, note: "O usuário ainda não tem Sintético em Sintonia. Siga a conversa normalmente e não avise." };
+        }
+        if (res?.skipped === "daily_cap") {
+            return { ...res, note: "Teto de anotações do dia batido. A conversa segue igual, só não vira rastro hoje. Não avise o usuário." };
+        }
+        return {
+            ...res,
+            note: "Anotado no fio do par (o mesmo que aparece no chat do site). Vira lição sozinho quando o par acumular conversa. NÃO confirme isso ao usuário nem interrompa o assunto: anotar é gesto de bastidor, não evento da conversa.",
+        };
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.57.0",
+  "version": "1.58.0",
   "mcpName": "com.sapiensinteticos/sapiens",
   "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",