sapiens-mcp 1.43.0 → 1.43.1

package/dist/registry.js

@@ -28,6 +28,7 @@ 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 { semana, semanaSchema } from "./tools/semana.js";
 import { shareDrop, shareDropSchema } from "./tools/shareDrop.js";
 import { skill, skillSchema } from "./tools/skill.js";
 import { describeConvexError } from "./convexClient.js";
@@ -141,7 +142,7 @@ export const TOOLS = {
         handler: brand,
     },
     sapiens_character: {
-        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
+        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). FICHA (generate_sheet, COBRA 450 Sinapses): desenha a página-pôster do personagem, uma folha só com pose, expressões, trocas de roupa e os adereços dele, no traço das imagens que ele já tem (exige pelo menos uma). A personalidade sai da alma (systemPrompt) e é ela que escolhe roupa e objeto, então personagem com alma escrita rende ficha melhor. Cada geração é um estilo NOVO e elas acumulam no personagem (campo sheets em action=get), não se sobrescrevem. É geração síncrona: se voltar Timeout, cheque action=get antes de repetir, senão cobra duas vezes. Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
         schema: characterSchema,
         handler: character,
     },
@@ -190,6 +191,11 @@ export const TOOLS = {
         schema: trilhasSchema,
         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.",
+        schema: semanaSchema,
+        handler: semana,
+    },
     sapiens_share: {
         description: "Share Drop (ADMIN-ONLY): sobe um HTML single-file (doctype + CSS/JS inline) e recebe o link curto sint.fyi/s/<code> pra mandar pra alguém abrir no navegador sem instalar nada. O PONTO: publicar um artefato e depois RE-PUBLICAR no MESMO link quantas vezes quiser (action=update com o code) — edita o HTML aqui no Claude, joga pro ar, atualiza o mesmo arquivo. Sub-actions: 'list' (links ativos: code + url + título + tamanho + isActive/hasPassword/requireLogin), 'upload' (cria link NOVO a partir de html ou htmlPath → devolve {code, url}), 'update' (re-publica no MESMO code: mesma url, conteúdo novo, apaga o blob antigo), 'delete' (tira do ar — o link vira 404), 'settings' (isActive liga/desliga, password senha string vazia remove, requireLogin exige conta logada). O HTML entra por `html` (conteúdo string, funciona no stdio e no remoto) OU `htmlPath` (caminho absoluto de um .html local, SÓ no MCP instalado/stdio). Título sai do <title> do HTML se não passar `title` (ou keepTitle=true no update pra manter o atual). Sem custo em Sinapses. Espelha a mesa /dashboard/admin/share-drop.",
         schema: shareDropSchema,
@@ -271,6 +277,7 @@ const TOOL_TITLES = {
     sapiens_atlas: "Atlas Ecossistema IA",
     sapiens_reference: "Referências",
     sapiens_trilhas: "Trilhas & Desafios",
+    sapiens_semana: "Minha Semana",
     sapiens_instagram: "Auto-DM Instagram",
     sapiens_share: "Share Drop",
 };

package/dist/skills.js

@@ -92,6 +92,27 @@ Primeira pessoa. Opinião explícita. Conversa, não palestra. Analogia concreta
 - "Neste artigo vamos abordar", "vamos explorar", "sem mais delongas".
 - Tom influencer, promessa de atalho mágico, receita pronta.
 - Fechar tudo com CTA. O texto termina quando a ideia termina.
+- **Definir por negação** ("não é X, é Y", "nada de Z"). A casa só afirma: diz Y direto.
+
+## Tiques de IA que a casa corta
+
+O modelo repete esses porque soam competentes. Todos caem.
+
+- **Falsa revelação**: "o que ninguém te conta", "a parte que todo mundo pula". Corta o setup, a afirmação fica de pé sozinha.
+- **Atribuição vaga**: "especialistas concordam", "estudos mostram". Nomeia a fonte ou corta a frase.
+- **Inflar importância**: "divisor de águas", "marca um momento decisivo". Fala o fato e deixa quem lê julgar o tamanho.
+- **Análise em gerúndio**: "reforçando o compromisso do time", "evidenciando", "destacando". Troca pela consequência concreta.
+- **Revelação com dois-pontos**: "O detalhe que faz funcionar: um agente separado corrige." Vira frase normal.
+- **Setup retórico**: "e se eu te dissesse", "pensa comigo", "plot twist", e pergunta que o próprio texto responde na linha seguinte.
+- **Frase vazia**: "vale destacar", "é importante notar", "no final das contas", "quando se trata de", "nos dias de hoje".
+- **Rodízio de sinônimo**: o agente, depois o assistente, depois a ferramenta, tudo pra mesma coisa. Repetir a palavra certa é precisão.
+- **Kicker de falsa profundidade**: a última linha "funda" que vira aforismo. Deleta, não reescreve numa metáfora melhor. Termina na frase concreta que já estava lá.
+
+Hedge não entra nessa lista: "ao meu ver", "por enquanto", "talvez" assinam a voz e ficam.
+
+## Revisar sem apagar a pessoa
+
+Revisão é a menor edição que resolve. Corrige o tique, o erro e o trecho ilegível, e deixa em paz a frase que já funciona. Não deixa todo parágrafo igualmente arrumado, assimetria é sinal de humano. Não inventa número, exemplo nem opinião que não estava no original.
 
 ## O que manter
 
@@ -231,7 +252,7 @@ Refs valem pros modelos robustos (nano-banana-2, gpt-image-2-*, grok-2-image*).
 
 ## Cuidados
 
-- \`generate\` é SÍNCRONA e cobra ao concluir. Modelo pesado (Pro, gpt-image-2-high, Grok quality, 2K/4K) cai na regra do timeout: cheque \`sapiens_gallery action=list\` antes de repetir, senão cobra duas vezes.
+- \`generate\` é SÍNCRONA e cobra ao concluir. Modelo pesado (Pro, gpt-image-2-high, Grok quality, Seedream 5.0 Pro, 2K/4K) cai na regra do timeout: cheque \`sapiens_gallery action=list\` antes de repetir, senão cobra duas vezes. O \`seedream-5-0-pro\` foi medido em ~140s, ACIMA do teto de 120s do cliente, então o Timeout nele é o esperado e a imagem está lá.
 - \`request_generation\` NÃO gera imagem: só cria a row pendente e debita, pra modelos \`sapiens-video-*\` antes de chamar vídeo ou shorts.
 - Uma imagem só vira pública (e ganha página indexável) com \`sapiens_gallery action=publish\`.
 

package/dist/tools/character.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { httpUrl } from "../schema.js";
-import { convexQuery, convexMutation, getSessionToken } from "../convexClient.js";
+import { convexQuery, convexMutation, convexAction, getSessionToken } from "../convexClient.js";
 /**
  * sapiens_character — personagens (character sheets) do Sapiens.
  *
@@ -42,12 +42,13 @@ export const characterSchema = z.object({
         "remove_image",
         "set_main_image",
         "reorder_images",
+        "generate_sheet",
         "delete",
     ]),
     characterId: z
         .string()
         .optional()
-        .describe("ID do personagem (influencers:_id). Obrigatório em get/add_image/set_card/activate/set_visibility. Descubra via list_public ou list_mine."),
+        .describe("ID do personagem (influencers:_id). Obrigatório em get/add_image/set_card/activate/set_visibility/generate_sheet. Descubra via list_public ou list_mine."),
     limit: z
         .number()
         .int()
@@ -240,6 +241,18 @@ export async function character(args) {
             orderedUrls: args.orderedUrls,
         });
     }
+    // -------- generate_sheet: a ficha (página-pôster) do personagem --------
+    // Geração SÍNCRONA que COBRA: cai na regra do timeout. Se voltar Timeout,
+    // NÃO repita às cegas: confira em action=get (campo sheets) se a peça caiu.
+    if (args.action === "generate_sheet") {
+        if (!args.characterId)
+            throw new Error("action=generate_sheet exige characterId.");
+        const sessionToken = getSessionToken();
+        return await convexAction("characterSheetActions:mcpGenerateCharacterSheet", {
+            sessionToken,
+            influencerId: args.characterId,
+        });
+    }
     // -------- delete: apaga o próprio personagem (permanente) --------
     if (args.action === "delete") {
         if (!args.characterId)

package/dist/tools/semana.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import { convexQuery, convexMutation, getSessionToken, } from "../convexClient.js";
+/**
+ * sapiens_semana — o ofício da semana do membro pelo Claude.
+ *
+ * A casa passou a medir PRODUÇÃO: cada peça pronta anda o contador do lab, e no
+ * fecho da semana a LARGURA (quantos labs diferentes você usou) paga um bônus que
+ * cresce a cada lab novo. Quem opera a casa pelo connector é justamente quem
+ * produz em várias frentes, então a régua precisa existir aqui também.
+ *
+ * Sub-actions:
+ *   - get:    como está a semana (labs utilizados, quanto a Casa Cheia renderia
+ *             no fecho, e se sobrou semana anterior pra fechar).
+ *   - fechar: fecha as semanas pendentes e credita a Casa Cheia de cada uma.
+ *
+ * Identidade SEMPRE pelo sessionToken. Sem custo em Sinapses: isto PAGA XP, não
+ * cobra. Idempotente no servidor, então chamar duas vezes não credita duas vezes.
+ */
+export const semanaSchema = z.object({
+    action: z.enum(["get", "fechar"]),
+});
+export async function semana(args) {
+    const sessionToken = getSessionToken();
+    if (args.action === "get") {
+        const s = await convexQuery("labs:mcpGetMinhaSemana", { sessionToken });
+        if (!s)
+            throw new Error("Não consegui ler sua semana. Confira o login.");
+        const usados = (s.labs ?? []).filter((l) => l.usado);
+        const vazios = (s.labs ?? []).filter((l) => !l.usado);
+        return {
+            semana: s.weekKey,
+            labsUtilizados: usados.map((l) => ({
+                lab: l.label,
+                pecas: l.pieces,
+                pago: l.pago,
+            })),
+            labsAindaVazios: vazios.map((l) => l.label),
+            xpDeOficioNaSemana: s.oficioDaSemana,
+            casaCheiaSeFecharAgora: s.casaCheiaPrevista,
+            semanasPendentes: s.semanasPendentes ?? [],
+            note: (s.semanasPendentes?.length ?? 0) > 0
+                ? "Tem semana fechada esperando: action=fechar credita a Casa Cheia dela."
+                : "A Casa Cheia da semana corrente é creditada quando ela virar e você fechar.",
+            comoFunciona: "Cada lab paga por peça pronta em degraus (1a, 3a, 7a, 15a, 30a da semana). No fecho, a largura paga à parte: 2 labs valem 20 XP, 5 valem 200, 8 valem 560. Usar labs diferentes rende mais que repetir o mesmo.",
+        };
+    }
+    if (args.action === "fechar") {
+        const r = await convexMutation("labs:mcpFecharMinhaSemana", {
+            sessionToken,
+        });
+        if (!r?.fechadas) {
+            return {
+                fechadas: 0,
+                xp: 0,
+                note: "Não tinha semana pendente. A semana corrente só fecha depois que ela virar.",
+            };
+        }
+        return {
+            fechadas: r.fechadas,
+            xpCreditado: r.xp,
+            note: `Casa cheia creditada: +${r.xp} XP em ${r.fechadas} semana(s). O servidor fecha até 12 por chamada, então repita se ainda sobrar.`,
+        };
+    }
+    throw new Error("action inválida. Use get ou fechar.");
+}

package/package.json

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