sapiens-mcp 1.73.0 → 1.75.0

package/dist/prompts.js

@@ -19,7 +19,7 @@ export const SAPIENS_PROMPTS = [
     {
         name: "capturar-repertorio",
         title: "Capturar obra no Repertório",
-        description: "Grava um filme/série/anime/jogo/livro/música no seu acervo pessoal (grátis).",
+        description: "Grava um filme/série/anime/jogo/jogo de tabuleiro/livro/música no seu acervo pessoal (grátis).",
         arguments: [
             {
                 name: "obra",

package/dist/registry.js

@@ -71,7 +71,7 @@ export const TOOLS = {
         handler: skill,
     },
     sapiens_repertorio: {
-        description: "Acervo pessoal de filme/série/anime/jogo/livro/música/pessoa (Repertório, o segundo cérebro do user). Reads: list (filtros mediaType/status), search (texto em title/genres/tags), get (detalhe), popArticles, resolve (busca capa/ano/id nos providers server-side: OMDb/IGDB-Twitch/AniList/Google Books/iTunes/Wikidata). Mutations (qualquer logado, mexem no PRÓPRIO acervo): add_item, update_item (status/rating/tags/note/isPublic), remove_item. CAPTURA ONE-SHOT travada na lista de providers: quando o user fala natural ('acabei de ver Duna 2, nota 9', 'tô jogando Hollow Knight', 'li tal livro'), (1) infira mediaType e status (assisti/zerei/li=completed, quero=backlog, tô jogando/vendo=active, dropei=dropped) e rating se citado; (2) chame action=resolve {mediaType, query}, escolha o candidato certo e faça add_item passando SÓ o source + externalId DELE + os campos pessoais (status/rating/tags/note). O servidor re-resolve no provider e grava título/capa/ano canônicos — você NÃO manda título/capa nem inventa externalId. (3) Se o resolve não achar (lista vazia/providerKeyMissing), NÃO dá pra adicionar: diga ao user que não encontrou nos providers (não fabrique entry manual). Upsert/dedup por (userId, source, externalId). Só pergunte se ambíguo entre candidatos. FERRAMENTAS DE IA (Repertório de Ferramentas): fluxo separado (vêm do catálogo aitag, não dos providers de mídia). action=search_tools {query} acha a ferramenta no catálogo e devolve o toolId; action=add_tool {toolId, favorite?, rating?, note?} grava como mediaType 'tool' (estar no acervo já é 'usei'; favorite=true liga a estrela). Use quando o user fala 'adiciona o Midjourney/Cursor no meu repertório de ferramentas' ou 'uso tal ferramenta de IA'. Cada ferramenta aponta pra página dela no aitag. SAPIENS (pessoas, ombros de gigantes; a aba no site chama Sapiens): mediaType 'person' cataloga gente que inspira (cineasta, mangaká, cientista, escritor) via Wikidata. Mesmo fluxo de mídia: resolve {mediaType:'person', query:'Osamu Tezuka'} → add_item com source 'wikidata' + o QID do candidato. O servidor grava foto, ocupações, bio e o link da Wikipedia; entra como completed (estar no acervo = me inspira). Use quando o user fala 'adiciona o Miyazaki nas minhas inspirações/nos meus sapiens/no meu repertório'.",
+        description: "Acervo pessoal de filme/série/anime/jogo/jogo de tabuleiro/livro/música/pessoa (Repertório, o segundo cérebro do user). Reads: list (filtros mediaType/status), search (texto em title/genres/tags), get (detalhe), popArticles, resolve (busca capa/ano/id nos providers server-side: OMDb/IGDB-Twitch/AniList/Google Books/iTunes/Wikidata). Mutations (qualquer logado, mexem no PRÓPRIO acervo): add_item, update_item (status/rating/tags/note/isPublic), remove_item. CAPTURA ONE-SHOT travada na lista de providers: quando o user fala natural ('acabei de ver Duna 2, nota 9', 'tô jogando Hollow Knight', 'li tal livro'), (1) infira mediaType e status (assisti/zerei/li=completed, quero=backlog, tô jogando/vendo=active, dropei=dropped) e rating se citado; (2) chame action=resolve {mediaType, query}, escolha o candidato certo e faça add_item passando SÓ o source + externalId DELE + os campos pessoais (status/rating/tags/note). O servidor re-resolve no provider e grava título/capa/ano canônicos — você NÃO manda título/capa nem inventa externalId. (3) Se o resolve não achar (lista vazia/providerKeyMissing), NÃO dá pra adicionar: diga ao user que não encontrou nos providers (não fabrique entry manual). Upsert/dedup por (userId, source, externalId). Só pergunte se ambíguo entre candidatos. FERRAMENTAS DE IA (Repertório de Ferramentas): fluxo separado (vêm do catálogo aitag, não dos providers de mídia). action=search_tools {query} acha a ferramenta no catálogo e devolve o toolId; action=add_tool {toolId, favorite?, rating?, note?} grava como mediaType 'tool' (estar no acervo já é 'usei'; favorite=true liga a estrela). Use quando o user fala 'adiciona o Midjourney/Cursor no meu repertório de ferramentas' ou 'uso tal ferramenta de IA'. Cada ferramenta aponta pra página dela no aitag. SAPIENS (pessoas, ombros de gigantes; a aba no site chama Sapiens): mediaType 'person' cataloga gente que inspira (cineasta, mangaká, cientista, escritor) via Wikidata. Mesmo fluxo de mídia: resolve {mediaType:'person', query:'Osamu Tezuka'} → add_item com source 'wikidata' + o QID do candidato. O servidor grava foto, ocupações, bio e o link da Wikipedia; entra como completed (estar no acervo = me inspira). Use quando o user fala 'adiciona o Miyazaki nas minhas inspirações/nos meus sapiens/no meu repertório'. JOGO DE TABULEIRO (e de cartas; a aba no site chama Tabuleiro): mediaType 'boardgame', porque 'game' é videogame e o IGDB não conhece tabuleiro. Também via Wikidata: resolve {mediaType:'boardgame', query:'Galactic Cruise'} → add_item com source 'wikidata' + o QID do candidato. Busque pelo título em inglês, que é como a Wikidata cadastra; o designer vem no campo authors do candidato e separa homônimos. O servidor grava designers, editoras e o link da página do jogo no BGG. Lançamento muito recente pode ainda não estar na Wikidata: resolve vazio = diga isso à pessoa, não fabrique. Use quando o user fala 'joguei Catan', 'quero jogar Rebirth', 'adiciona esse jogo de tabuleiro'.",
         schema: repertorioSchema,
         handler: repertorio,
     },
@@ -206,7 +206,7 @@ export const TOOLS = {
         handler: trilhas,
     },
     sapiens_distribution: {
-        description: "Despachar peças (Distribution Workflow) — a peça pronta entra na FILA com canal, copy e a aba de quem ela é. ADMIN-ONLY: despacho depende de rede conectada e hoje só a casa tem. NADA aqui posta em rede nenhuma; quem despacha é a tela em /experimentos/distribution-workflow, que é onde a conta conectada mora. A ABA (`voice`) responde de quem é a peça: sapiens (a casa), helen-ailith, borderless, ou o slug de um personagem seu — slug livre, então personagem novo ganha aba sozinho na primeira peça dele, sem deploy. Em queue, aba ausente = o servidor deriva do personagem da peça e cai em sapiens quando não há. Sub-actions: queue (põe na fila: title e channel obrigatórios, mais copy/hashtags/assetUrl/notes). Em queue, DOIS campos que parecem opcionais e não são: `lang` diz em que língua a copy já está, e sem ele canal de rede internacional reescreve a sua copy sozinho, dois segundos depois, na voz da casa; `assetPageAssetId` é o imageId da obra da casa, e sem ele a peça só encontra a obra se a assetUrl bater letra a letra, então versão web de um master nasce órfã de ficha, list (o que está na fila, filtrável por status e por aba), voices (as abas que existem hoje com a contagem de cada uma), status (move a peça de lane: fila, agendado, postado, descartado; postado aceita postUrl e fecha o rastro, agendado aceita scheduledFor em ms), bio (lê ou troca a BIO de uma conta da casa no Bluesky, channel bluesky ou bluesky-2 a bluesky-5: sem texto só lê; bioLine acrescenta uma linha no fim sem mexer no resto e não repete linha que já está lá; bio reescreve a inteira; teto de 256; ESTA sub-action muda o perfil público na hora, e bio não aceita hiperlink, o endereço aparece escrito). Sem custo em Sinapses: isto organiza, não gera. A copy segue a voz de QUEM ASSINA a peça, que não é sempre a voz da casa: peça da Helen fala como a Helen. E a peça sai pela CONTA de quem assina ela: conta extra da mesma rede é um canal próprio (bluesky-2 é outra conta no Bluesky, instagram-pro outra no Instagram), então case o canal com a aba antes de despachar.",
+        description: "Despachar peças (Distribution Workflow) — a peça pronta entra na FILA com canal, copy e a aba de quem ela é. ADMIN-ONLY: despacho depende de rede conectada e hoje só a casa tem. NADA aqui posta em rede nenhuma; quem despacha é a tela em /experimentos/distribution-workflow, que é onde a conta conectada mora. A ABA (`voice`) responde de quem é a peça: sapiens (a casa), helen-ailith, borderless, ou o slug de um personagem seu — slug livre, então personagem novo ganha aba sozinho na primeira peça dele, sem deploy. Em queue, aba ausente = o servidor deriva do personagem da peça e cai em sapiens quando não há. Sub-actions: queue (põe na fila: title e channel obrigatórios, mais copy/hashtags/assetUrl/notes). Em queue, DOIS campos que parecem opcionais e não são: `lang` diz em que língua a copy já está, e sem ele canal de rede internacional reescreve a sua copy sozinho, dois segundos depois, na voz da casa; `assetPageAssetId` é o imageId da obra da casa, e sem ele a peça só encontra a obra se a assetUrl bater letra a letra, então versão web de um master nasce órfã de ficha, list (o que está na fila, filtrável por status e por aba), voices (as abas que existem hoje com a contagem de cada uma), status (move a peça de lane: fila, agendado, postado, descartado; postado aceita postUrl e fecha o rastro, agendado aceita scheduledFor em ms), bio (lê ou troca a BIO de uma conta da casa no Bluesky, channel bluesky ou bluesky-2 a bluesky-5: sem texto só lê; bioLine acrescenta uma linha no fim sem mexer no resto e não repete linha que já está lá; bio reescreve a inteira; teto de 256; ESTA sub-action muda o perfil público na hora, e bio não aceita hiperlink, o endereço aparece escrito), lineages (o CADASTRO das linhagens, o mesmo da aba Teia: de cada personagem, produto e da casa, a mãe no Bluesky onde a peça nasce, as contas próprias, as galerias que a mãe alimenta sozinha, as fichas e o post do dia, mais as regras que a teia desdobra e as vagas de conta ainda sem dona), lineage-new (nasce uma linhagem: nome obrigatório, grupo, artigo, lang; nasce sem mãe, então nada viaja sozinho até o lineage-save dar a mãe), lineage-save (slug e só o que muda: mae, contas rede->canal, galerias, fichaIds, rotina, contaNaCasa; o servidor recusa conta que já é de outra linhagem e canal de outra rede, e a vaga assumida ganha o nome da linhagem), lineage-archive (slug + arquivada). Sem custo em Sinapses: isto organiza, não gera. A copy segue a voz de QUEM ASSINA a peça, que não é sempre a voz da casa: peça da Helen fala como a Helen. E a peça sai pela CONTA de quem assina ela: conta extra da mesma rede é um canal próprio (bluesky-2 é outra conta no Bluesky, instagram-pro outra no Instagram), então case o canal com a aba antes de despachar.",
         schema: distributionSchema,
         handler: distribution,
     },

package/dist/skills.js

@@ -137,7 +137,7 @@ Condensa a informação num framework com nome, ancora numa analogia concreta, e
     {
         name: "repertorio",
         title: "Repertório: guardar obra e ferramenta no acervo",
-        description: "Guardar filme, série, anime, jogo, livro, música, pessoa ou ferramenta de IA no Repertório. Puxe ANTES de qualquer sapiens_repertorio: a gravação é travada num fluxo de dois passos e tentar guardar direto falha sempre.",
+        description: "Guardar filme, série, anime, jogo, jogo de tabuleiro, livro, música, pessoa ou ferramenta de IA no Repertório. Puxe ANTES de qualquer sapiens_repertorio: a gravação é travada num fluxo de dois passos e tentar guardar direto falha sempre.",
         body: `## A regra que faz este fluxo falhar
 
 Você NÃO grava uma obra passando o título. O servidor não aceita metadado vindo de você (título, capa, ano) de propósito: é anti-fabricação. Você identifica a obra num provider, e o servidor re-resolve por id e grava o canônico.
@@ -150,9 +150,11 @@ São sempre DOIS passos. Pular o primeiro falha sempre, e é o erro número um d
 2. Escolha o candidato certo. Em dúvida entre dois, PERGUNTE em vez de chutar: obra errada no acervo é a pessoa quem vai ter que apagar.
 3. **\`action=add_item\`** com o \`source\` e o \`externalId\` **exatos** daquele candidato, mais o que é pessoal: \`status\`, \`rating\` (0-10), \`tags\`, \`note\`, \`containsSpoilers\`, \`isPublic\`.
 
-\`mediaType\`: movie, series, anime, game, book, music, tool, person.
+\`mediaType\`: movie, series, anime, game, book, music, tool, person, boardgame.
 \`status\`: backlog (quer ver), active (vendo agora), completed (viu), paused, dropped.
 
+Jogo de tabuleiro (e de cartas) é \`boardgame\`: \`game\` é videogame, e o provider dele não conhece tabuleiro. A busca do tabuleiro é na Wikidata e acha pelo título em inglês; o designer vem em \`authors\` no candidato e separa homônimos. Lançamento muito recente pode ainda não estar cadastrado: resolve vazio quer dizer que o jogo não está na base, então diga isso à pessoa.
+
 Nunca invente um \`externalId\` nem reaproveite um de outra busca: id que não resolve no provider é rejeitado. A dedup é por (você, source, externalId), então repetir o mesmo par não duplica.
 
 ## Guardar uma ferramenta de IA

package/dist/tools/distribution.js

@@ -22,6 +22,11 @@ import { convexQuery, convexMutation, convexAction, getSessionToken } from "../c
  *   - list:    o que está na fila, filtrável por status e por aba.
  *   - voices:  as abas que existem hoje, com a contagem de cada uma.
  *   - status:  move a peça de lane (fila, agendado, postado, descartado).
+ *   - lineages / lineage-new / lineage-save / lineage-archive: o CADASTRO das
+ *     linhagens (personagens, produtos, a casa), o mesmo que a aba Teia edita:
+ *     a mãe no Bluesky, as contas próprias, as galerias que a mãe alimenta, as
+ *     fichas e o post do dia. É ele que decide por qual conta cada peça sai e
+ *     o que viaja sozinho depois.
  *
  * Sem custo em Sinapses: isto organiza, não gera.
  */
@@ -119,7 +124,17 @@ const CHANNELS = [
     "youtube-5",
 ];
 export const distributionSchema = z.object({
-    action: z.enum(["queue", "list", "voices", "status", "bio"]),
+    action: z.enum([
+        "queue",
+        "list",
+        "voices",
+        "status",
+        "bio",
+        "lineages",
+        "lineage-new",
+        "lineage-save",
+        "lineage-archive",
+    ]),
     title: z
         .string()
         .optional()
@@ -160,7 +175,7 @@ export const distributionSchema = z.object({
     lang: z
         .enum(["pt", "en"])
         .optional()
-        .describe("queue: em que LÍNGUA a copy JÁ ESTÁ. Declare sempre que escrever a copy você mesmo. Sem este campo, canal de rede internacional (bluesky, x, linkedin, farcaster, civitai, pinterest, reddit, medium, tumblr, deviantart) presume que a copy chegou em português e agenda uma vertida automática que SOBRESCREVE o que você mandou, dois segundos depois de enfileirar. Copy que já estava em inglês volta reescrita, e na voz da CASA em vez da voz de quem assina a peça, o que estraga copy de personagem. Declarar o idioma desliga a vertida e o texto fica exatamente como você mandou."),
+        .describe("lineage-new/lineage-save: a língua em que a linhagem fala. queue: em que LÍNGUA a copy JÁ ESTÁ. Declare sempre que escrever a copy você mesmo. Sem este campo, canal de rede internacional (bluesky, x, linkedin, farcaster, civitai, pinterest, reddit, medium, tumblr, deviantart) presume que a copy chegou em português e agenda uma vertida automática que SOBRESCREVE o que você mandou, dois segundos depois de enfileirar. Copy que já estava em inglês volta reescrita, e na voz da CASA em vez da voz de quem assina a peça, o que estraga copy de personagem. Declarar o idioma desliga a vertida e o texto fica exatamente como você mandou."),
     voice: z
         .string()
         .optional()
@@ -200,6 +215,60 @@ export const distributionSchema = z.object({
         .string()
         .optional()
         .describe("bio: UMA linha acrescentada no fim da bio atual, sem mexer no resto (ex: o CTA com t.me/<handle> do Telegram da personagem). Linha que já está na bio não entra de novo. Bio NÃO aceita hiperlink: o endereço aparece escrito e o app pinta de azul."),
+    slug: z
+        .string()
+        .optional()
+        .describe("lineage-save/lineage-archive: a linhagem (o slug que lineages devolve: sapiens, borderless, helen-inbt, aria, arak, giants...). lineage-new: opcional, sai do nome quando ausente."),
+    nome: z.string().optional().describe("lineage-new: o nome da linhagem (obrigatório). lineage-save: renomeia."),
+    grupo: z
+        .enum(["casa", "personagens", "produtos"])
+        .optional()
+        .describe("lineage-new/lineage-save: a gaveta. casa é só da casa e do dono. Default produtos."),
+    artigo: z.enum(["a", "o"]).optional().describe("lineage-new/lineage-save: o artigo do nome (a Aria, o Arak)."),
+    ordem: z.number().optional().describe("lineage-save: a posição na lista."),
+    quem: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("lineage-save: como a tela diz de quem é (\"da casa\", \"do dono\"). null limpa."),
+    mae: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("lineage-save: a MÃE da linhagem, a conta do Bluesky onde a peça nasce e de onde a teia desdobra pro resto (bluesky-2..9). Vaga livre sai de lineages (vagasLivres.bluesky). null tira a mãe. A mãe da casa e a do dono não trocam."),
+    contas: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe("lineage-save: as contas PRÓPRIAS da linhagem, rede -> canal, ex: {\"telegram\":\"telegram-6\",\"instagram\":\"instagram-6\",\"x\":\"x-buffer-3\"}. Substitui o mapa inteiro. O servidor recusa canal de outra rede e canal que já é de outra linhagem."),
+    galerias: z
+        .object({
+        telegram: z.boolean(),
+        arena: z.boolean(),
+        tumblr: z.boolean(),
+        deviantart: z.boolean(),
+        civitai: z.boolean(),
+        proprias: z.array(z.string()),
+    })
+        .optional()
+        .describe("lineage-save: o que a mãe alimenta sozinha quando a peça dela vai ao ar. telegram exige conta de telegram em contas; proprias lista as redes de contas (instagram, x...) que também recebem. Manda o objeto inteiro."),
+    fichaIds: z
+        .array(z.string())
+        .optional()
+        .describe("lineage-save: as fichas de personagem da linhagem (ids de sapiens_character), a principal primeiro, até 6. É o que trava a peça dela fora das contas dela e o que dá a ficha ao post de texto na conta dela."),
+    contaNaCasa: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("lineage-save: o username da conta dela aqui na casa (o perfil público). null limpa."),
+    rotina: z
+        .object({ ligada: z.boolean(), canais: z.array(z.string()) })
+        .nullable()
+        .optional()
+        .describe("lineage-save: o post do dia da linhagem, ligado ou não, e por quais canais sai. null volta ao padrão."),
+    arquivada: z
+        .boolean()
+        .optional()
+        .describe("lineage-archive: true arquiva, false devolve. A casa e o dono não se arquivam."),
 });
 export async function distribution(args) {
     const sessionToken = getSessionToken();
@@ -280,5 +349,67 @@ export async function distribution(args) {
                     : "Nada mudou: a linha já estava na bio (ou o texto é igual ao atual).",
         };
     }
+    if (args.action === "lineages") {
+        const r = await convexQuery("distributionMcp:mcpLinhagens", { sessionToken });
+        return {
+            ...r,
+            instruction: "Cada linhagem: mae (a conta do Bluesky onde a peça nasce), contas (as próprias, rede -> canal), galerias (o que a mãe alimenta sozinha), fichaIds, rotina (post do dia). regras é o que a teia desdobra desse cadastro. vagasLivres são as contas que existem no código e ainda não têm dona. semeada=false quer dizer que a tabela ainda roda a fábrica do código; a primeira edição grava.",
+        };
+    }
+    if (args.action === "lineage-new") {
+        if (!args.nome)
+            throw new Error("action=lineage-new exige nome.");
+        const r = await convexMutation("distributionMcp:mcpCriarLinhagem", {
+            sessionToken,
+            nome: args.nome,
+            slug: args.slug,
+            grupo: args.grupo,
+            artigo: args.artigo,
+            lang: args.lang,
+        });
+        return {
+            ...r,
+            instruction: r.voltou
+                ? "A linhagem estava arquivada e voltou com o cadastro que tinha."
+                : "A linhagem nasceu sem mãe e sem regra: nada viaja sozinho a partir dela até lineage-save dar a mãe (vaga livre em lineages).",
+        };
+    }
+    if (args.action === "lineage-save") {
+        if (!args.slug)
+            throw new Error("action=lineage-save exige slug.");
+        await convexMutation("distributionMcp:mcpSalvarLinhagem", {
+            sessionToken,
+            slug: args.slug,
+            nome: args.nome,
+            grupo: args.grupo,
+            artigo: args.artigo,
+            lang: args.lang,
+            ordem: args.ordem,
+            quem: args.quem,
+            mae: args.mae,
+            contas: args.contas,
+            galerias: args.galerias,
+            fichaIds: args.fichaIds,
+            contaNaCasa: args.contaNaCasa,
+            rotina: args.rotina,
+        });
+        return {
+            ok: true,
+            slug: args.slug,
+            instruction: "Cadastro salvo. A teia já lê o novo (a próxima peça da mãe desdobra pelas regras novas). Vaga de reserva que a linhagem assumiu ganhou o nome dela; a credencial da conta (env do Convex) continua sendo do dono.",
+        };
+    }
+    if (args.action === "lineage-archive") {
+        if (!args.slug)
+            throw new Error("action=lineage-archive exige slug.");
+        if (args.arquivada === undefined)
+            throw new Error("action=lineage-archive exige arquivada (true ou false).");
+        await convexMutation("distributionMcp:mcpArquivarLinhagem", {
+            sessionToken,
+            slug: args.slug,
+            arquivada: args.arquivada,
+        });
+        return { ok: true, slug: args.slug, arquivada: args.arquivada };
+    }
     throw new Error(`action desconhecida: ${args.action}`);
 }

package/dist/tools/gallery.js

@@ -154,6 +154,11 @@ export const gallerySchema = z.object({
         .boolean()
         .optional()
         .describe("action=refs: false (default) SOMA às referências que já existem; true troca a lista inteira. Pra limpar tudo, mande a lista vazia com replace=true."),
+    // Mesma tolerância a lista serializada como texto do referenceImageIds.
+    skills: z
+        .union([z.array(z.string()), z.string()])
+        .optional()
+        .describe("action=ingest: COMO A PEÇA FOI FEITA, os slugs das skills da casa que dirigiram o take (ex: ['clipe'], ['rasante','storyboard']). Aparece como 'Feito com /clipe' na ficha e na página pública da peça. No Claude Code com o plugin Sapiens o hook carimba sozinho; em outro cliente, passe sempre que o take saiu de uma skill da casa. Re-ingerir SOMA às que já estavam, nunca apaga. Metadado puro: não muda custo nem alcance."),
     uploadedSource: z
         .string()
         .optional()
@@ -343,7 +348,7 @@ async function ingestPelaPonte(sessionToken, args, ficha) {
         throw new Error(`Subir a peça pro storage falhou: HTTP ${subida.status}. Tente de novo; se repetir, peça outra uploadUrl (ela vale 1h).`);
     }
     const { storageId } = (await subida.json());
-    return await convexAction("externalIngestNode:mcpIngestFromStorage", {
+    return await semSkillsSeRecusar(ficha, (f) => convexAction("externalIngestNode:mcpIngestFromStorage", {
         sessionToken,
         storageId,
         mimeType,
@@ -352,8 +357,24 @@ async function ingestPelaPonte(sessionToken, args, ficha) {
         // mover ou apagar qualquer byte.
         contentSha256: sha256,
         unfiltered: args.unfiltered,
-        ...ficha,
-    });
+        ...f,
+    }));
+}
+/**
+ * Servidor de antes do carimbo de skill (deploy atrasado em relação ao pacote)
+ * recusa o arg que não conhece, e recusa ANTES do handler, sem tocar em nada.
+ * A peça vale mais que o carimbo: tenta de novo sem ele.
+ */
+async function semSkillsSeRecusar(ficha, chamar) {
+    try {
+        return await chamar(ficha);
+    }
+    catch (e) {
+        if (!ficha.skills || !/extra field `?skills`?/i.test(describeConvexError(e)))
+            throw e;
+        const { skills: _semCarimbo, ...resto } = ficha;
+        return await chamar(resto);
+    }
 }
 /**
  * Normaliza `referenceImageIds` pro formato que o Convex espera (lista).
@@ -400,6 +421,19 @@ function normalizePartIds(raw) {
         .filter(Boolean)
         .slice(0, 16);
 }
+/**
+ * E pras skills: lista ou texto com vírgula vira lista, vazio vira undefined
+ * (campo que o servidor nem recebe). Quem limpa o slug é o servidor
+ * (convex/shared/skillSlugs.ts), aqui só o formato.
+ */
+function normalizeSkills(raw) {
+    if (!raw)
+        return undefined;
+    const lista = (Array.isArray(raw) ? raw : raw.split(","))
+        .map((s) => s.trim().replace(/^["'[]+|["'\]]+$/g, ""))
+        .filter(Boolean);
+    return lista.length ? lista.slice(0, 8) : undefined;
+}
 export async function gallery(args) {
     const sessionToken = getSessionToken();
     if (args.action === "list") {
@@ -492,14 +526,15 @@ export async function gallery(args) {
             characterIds: normalizeCastIds(args.characterIds).length
                 ? normalizeCastIds(args.characterIds)
                 : undefined,
+            skills: normalizeSkills(args.skills),
         };
         if (args.sourceUrl && !temBytesLocais) {
             try {
-                const result = await convexAction("externalIngest:mcpIngestExternal", {
+                const result = await semSkillsSeRecusar(ficha, (f) => convexAction("externalIngest:mcpIngestExternal", {
                     sessionToken,
                     sourceUrl: args.sourceUrl,
-                    ...ficha,
-                });
+                    ...f,
+                }));
                 return { ...result, aviso: AVISO_INGEST };
             }
             catch (e) {

package/dist/tools/repertorio.js

@@ -24,7 +24,7 @@ import { need } from "../schema.js";
  *
  * Action-based design (memoria: consolidar tools via args).
  */
-const mediaTypeEnum = z.enum(["movie", "series", "anime", "game", "book", "music", "tool", "person"]);
+const mediaTypeEnum = z.enum(["movie", "series", "anime", "game", "book", "music", "tool", "person", "boardgame"]);
 const statusEnum = z.enum([
     "backlog",
     "active",
@@ -62,7 +62,7 @@ export const repertorioSchema = z.object({
     // add_item — só identifica o item; o servidor re-resolve e grava o metadado.
     source: sourceEnum
         .optional()
-        .describe("Pra add_item: o source EXATO de um candidato do action=resolve (manual=filme/série via OMDb, anilist, twitch=jogo, googlebooks, itunes, wikidata=pessoa). Não invente."),
+        .describe("Pra add_item: o source EXATO de um candidato do action=resolve (manual=filme/série via OMDb, anilist, twitch=jogo, googlebooks, itunes, wikidata=pessoa ou jogo de tabuleiro). Não invente."),
     externalId: z
         .string()
         .optional()

package/package.json

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