sapiens-mcp 1.46.0 → 1.46.2

package/README.md

@@ -53,6 +53,14 @@ O Claude avisa o custo antes de gastar, e geração que falha é estornada. Publ
 
 O servidor só conversa com o backend público do Sapiens (Convex). Sua identidade vem sempre do token de login, nunca de parâmetros soltos. Cada conta só mexe no que é dela.
 
+## Sobre o Sapiens Sintéticos
+
+O Sapiens Sintéticos é um Studio de IA que constrói Studios: ensino modelo de pensamento na Era Sintética pra cada pessoa montar o próprio sistema de criação, com voz e régua próprias. O método se chama Borderless: 5 pilares, 7 deltas e uma sequência de 7 fases pra tirar ideia do papel (Tesão, Cruzamento, Confronto Crítico, Prototipagem, MVP, Validação, Continuidade).
+
+Em inglês o projeto assina **Synthetic Sapiens**: an AI studio that builds studios. The missing skill is not using AI, it is inventing the system the AI feeds. That system is a studio of your own, the personal computer of 2026.
+
+Site oficial: [sapiensinteticos.com](https://www.sapiensinteticos.com) · Manifesto: [/manifesto](https://www.sapiensinteticos.com/manifesto) · Contexto pra máquina: [/llms.txt](https://www.sapiensinteticos.com/llms.txt)
+
 ---
 
 Feito por [BorderLess](https://sapiensinteticos.com). Licença MIT.

package/dist/registry.js

@@ -1,3 +1,4 @@
+import { ZodError } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { pipeline, pipelineSchema } from "./tools/pipeline.js";
 import { image, imageSchema } from "./tools/image.js";
@@ -58,7 +59,7 @@ export const TOOLS = {
         handler: meta,
     },
     sapiens_skill: {
-        description: "As SKILLS da casa: o passo a passo travado de cada fluxo do Sapiens, servido pelo próprio connector (sem login, sem custo, sem rede). LEIA A SKILL ANTES DE OPERAR O FLUXO — é mais barato que errar uma geração que cobra Sinapses. Sub-actions: 'list' (índice: slug + quando usar cada uma), 'get' (o SKILL.md inteiro, passe name=<slug>). Slugs: primeiros-passos (porta de entrada e as 4 armadilhas: timeout que já cobrou, disjuntor anti-loop, saldo, sessão), voz-da-casa (DNA editorial, leia antes de redigir qualquer texto publicável), musica (Musicator em 4 passos + efeito sonoro), video (qual modelo, iterar barato no Mini, storyboard por referência, sonorize), imagem (prompt full-bleed na régua da casa, multi-referência, templates), studio (o perfil de empresa da casa, o time, e gerar na identidade da pessoa vs base), tirinha (2 fases, a imagem sai SEM texto), forum-comunidade (mídia estruturada, menção, tese), companhia (o Sintético veste você), trilhas (missão e prova). O mesmo conteúdo também sai como resource MCP em skill://sapiens/<slug>/SKILL.md pra quem lê resources.",
+        description: "As SKILLS da casa: o passo a passo travado de cada fluxo do Sapiens, servido pelo próprio connector (sem login, sem custo, sem rede). LEIA A SKILL ANTES DE OPERAR O FLUXO — é mais barato que errar uma geração que cobra Sinapses. Sub-actions: 'list' (índice: slug + quando usar cada uma), 'get' (o SKILL.md inteiro, passe name=<slug>). Slugs: primeiros-passos (porta de entrada e as 4 armadilhas: timeout que já cobrou, disjuntor anti-loop, saldo, sessão), voz-da-casa (DNA editorial, leia antes de redigir qualquer texto publicável), musica (Musicator em 4 passos + efeito sonoro), video (qual modelo, iterar barato no Mini, storyboard por referência, sonorize), imagem (prompt full-bleed na régua da casa, multi-referência, templates), studio (fundar a casa, o perfil de empresa, o time, e por que o studio não entra na geração), tirinha (2 fases, a imagem sai SEM texto), forum-comunidade (mídia estruturada, menção, tese), companhia (o Sintético veste você), trilhas (missão e prova), minha-soul (instala o retrato do usuário como skill do projeto onde vocês estão). O mesmo conteúdo também sai como resource MCP em skill://sapiens/<slug>/SKILL.md pra quem lê resources.",
         schema: skillSchema,
         handler: skill,
     },
@@ -68,7 +69,7 @@ export const TOOLS = {
         handler: repertorio,
     },
     sapiens_gallery: {
-        description: "Browse, publicação e upload das imagens do user. Sub-actions: list (últimas N imagens, com prompt/model/url + isPublic), get (1 imagem com metadados, opcionalmente base64), publish (torna a PRÓPRIA imagem pública: entra na galeria pública + feed Pinterest, e ganha página indexável /imagem/<id> se o modelo não for degen — devolve publicPageUrl), unpublish (volta a privada), upload (traz pra galeria uma peça gerada FORA da casa, por sourceUrl https, filePath local ou base64; ADMIN por ora). Use list/get pra reusar imagem como referência (passe o imageId em sapiens_image mode=edit ou mode=variation) ou pra mostrar pro user o que ele já tem; publish quando o user quer divulgar a imagem dele. IMPORTANTE sobre upload: a peça entra PRIVADA e continua privada — o servidor recusa publicar e recusa compartilhar na comunidade, porque ela é do usuário e a responsabilidade é dele. O caminho pra ela virar coisa pública é usar como referência numa geração daqui e publicar o resultado.",
+        description: "Browse, publicação e upload das imagens do user. Sub-actions: list (últimas N imagens, com prompt/model/url + isPublic), get (1 imagem com metadados, opcionalmente base64), publish (torna a PRÓPRIA imagem pública: entra na galeria pública + feed Pinterest, e ganha página indexável /imagem/<id> se o modelo não for degen — devolve publicPageUrl), unpublish (volta a privada), upload (traz pra galeria uma peça gerada FORA da casa, por sourceUrl https, filePath local ou base64; ADMIN por ora), refs (acopla peças da casa como REFERÊNCIA numa peça que já existe, de upload ou de ingest; ADMIN, e só na própria peça). Use list/get pra reusar imagem como referência (passe o imageId em sapiens_image mode=edit ou mode=variation) ou pra mostrar pro user o que ele já tem; publish quando o user quer divulgar a imagem dele. IMPORTANTE sobre upload: a peça entra PRIVADA e continua privada — o servidor recusa publicar e recusa compartilhar na comunidade, porque ela é do usuário e a responsabilidade é dele. O caminho pra ela virar coisa pública é usar como referência numa geração daqui e publicar o resultado. O refs escreve só proveniência (de que ficha/folha a peça nasceu): não promove nada, e um upload continua sem publicar depois de ganhar referência.",
         schema: gallerySchema,
         handler: gallery,
     },
@@ -98,7 +99,7 @@ export const TOOLS = {
         handler: search,
     },
     sapiens_studios: {
-        description: "Catálogo dos estúdios/experimentos Sapiens + o SEU studio + a Emancipação. Sub-actions: mine (o studio do user, que é o perfil de EMPRESA da casa dele: nome/endereço público/marca/operador/tamanho do time), list (todos com URL+status+tags+mcpReady), get (detalhe de 1 slug), publishable_url (formata URL /articles/<slug>), emancipar (INICIA o Nível 3: blueprint pra construir a casa PRÓPRIA do membro na infra dele, fora do Sapiens), module (guia de um módulo de infra: fundacao/sapiens-connect/telegram/email/auth). Use quando user pergunta 'que estúdios existem', 'qual o meu studio', ou 'quero montar meu site/minha casa própria'. Estúdios cobertos: helen-voice, musicator, persona-sapiens, personagem-atlas, sapiens-shorts, sapiens-video, text-post-builder, comic-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 privado, 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, comic-builder, carrosel-editorial, comunidade, repertorio.",
         schema: studiosSchema,
         handler: studios,
     },
@@ -148,7 +149,7 @@ export const TOOLS = {
         handler: character,
     },
     sapiens_profile: {
-        description: "O 'tudo junto' do perfil do user (/u/<username>), user-tier. Agrega o que mora no perfil mas estava fora do MCP: identidade + nível/XP + saldo, badges (conquistas) e golden tools (favoritos do aitag). Sub-actions de LEITURA: get (card completo: identidade + nível + saldo + badges + golden tools), badges (só as conquistas, lista cheia), golden_tools (só os favoritos do aitag, lista cheia), notifications (suas notificações recentes do sino + contagem de não-lidas), mark_read (marca uma notificationId ou TODAS as não-lidas como lidas). Sub-actions de ESCRITA (mexem na SUA conta; identidade sempre da sessão): follow/unfollow (seguir/deixar de seguir outro user por followingId=users:_id, descoberto via sapiens_community participants/search_users), update_bio (edita a sua bio), update_username (troca o seu @; inválido/tomado volta {success:false,error}). FAVORITOS de ferramentas de IA (Golden Tools do aitag; o toolId vem de sapiens_repertorio action=search_tools): favorite_tool (favorita/desfavorita, estrela), favorite_lists (suas listas), create_favorite_list (listName+emoji/description/isPublic), add_to_favorite_list/remove_from_favorite_list (toolId+listId), delete_favorite_list (listId). As partes grandes do perfil NÃO são duplicadas aqui, têm tool própria: imagens geradas/publicadas=sapiens_gallery, repertório (filmes/séries/jogos/livros/música)=sapiens_repertorio, personagens=sapiens_character, persona/arquétipo MBTI=sapiens_persona action=my_profile, saldo detalhado por bucket=sapiens_meta action=subscription. Monta a partir de queries já em prod (sem custo).",
+        description: "O 'tudo junto' do perfil do user (/u/<username>), user-tier. Agrega o que mora no perfil mas estava fora do MCP: identidade + nível/XP + saldo, badges (conquistas) e golden tools (favoritos do aitag). Sub-actions de LEITURA: get (card completo: identidade + nível + saldo + badges + golden tools), soul (a sapiens-soul: retrato do momento no contrato sapiens.soul/v1, identidade + persona + repertório público + tese, derivado e datado; quando o user pedir 'minha soul' ou 'meu retrato do Sapiens' pro projeto dele, chame e salve como sapiens-soul.json — snapshot, não conexão viva), badges (só as conquistas, lista cheia), golden_tools (só os favoritos do aitag, lista cheia), notifications (suas notificações recentes do sino + contagem de não-lidas), mark_read (marca uma notificationId ou TODAS as não-lidas como lidas). Sub-actions de ESCRITA (mexem na SUA conta; identidade sempre da sessão): follow/unfollow (seguir/deixar de seguir outro user por followingId=users:_id, descoberto via sapiens_community participants/search_users), update_bio (edita a sua bio), update_username (troca o seu @; inválido/tomado volta {success:false,error}). FAVORITOS de ferramentas de IA (Golden Tools do aitag; o toolId vem de sapiens_repertorio action=search_tools): favorite_tool (favorita/desfavorita, estrela), favorite_lists (suas listas), create_favorite_list (listName+emoji/description/isPublic), add_to_favorite_list/remove_from_favorite_list (toolId+listId), delete_favorite_list (listId). As partes grandes do perfil NÃO são duplicadas aqui, têm tool própria: imagens geradas/publicadas=sapiens_gallery, repertório (filmes/séries/jogos/livros/música)=sapiens_repertorio, personagens=sapiens_character, persona/arquétipo MBTI=sapiens_persona action=my_profile, saldo detalhado por bucket=sapiens_meta action=subscription. Monta a partir de queries já em prod (sem custo).",
         schema: profileSchema,
         handler: profile,
     },
@@ -226,9 +227,8 @@ Cliente que lê resources MCP acha o MESMO conteúdo em skill://sapiens/<slug>/S
 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 inteira de 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. Vídeo é o mais caro da casa: confirme com ele antes de disparar.
-- REGRA DO TIMEOUT (vale pra toda geração SÍNCRONA: imagem pesada, artigo, mega-gráfico, carrossel): a chamada pode estourar o teto de ~120s do cliente e voltar 'Timeout' MESMO tendo gerado e COBRADO. Nunca repita às cegas: confira antes onde o resultado cairia (imagem: sapiens_gallery action=list; artigo: sapiens_write action=list; carrossel: sapiens_pipeline action=list_carousels; pipeline: /dashboard/admin/content).
+- REGRA DO TIMEOUT: geração SÍNCRONA pode estourar o teto de ~120s do cliente e voltar 'Timeout' MESMO tendo gerado e COBRADO. Nunca repita às cegas: confira antes onde o resultado cairia (a tabela de onde conferir está na skill 'primeiros-passos').
 - "sessionToken expirado" = refaça login: sapiens_meta action=login com o código de sapiensinteticos.com/conectar-claude.
 - sapiens_meta action=formats devolve os schemas por formato; action=whoami diz tier (user/admin) + saldo. sapiens_image e sapiens_video action=models trazem o catálogo com o preço ATUAL: consulte em vez de chutar custo.
 
@@ -265,7 +265,7 @@ const TOOL_TITLES = {
     sapiens_write: "Artigos do Perfil",
     sapiens_quote_pop: "Coluna Sapiens/Repertório",
     sapiens_search: "Buscar Artigos",
-    sapiens_studios: "Estúdios & Emancipação",
+    sapiens_studios: "Meu Studio & Estúdios",
     sapiens_persona: "Persona (MBTI)",
     sapiens_helen: "Voz Helen (TTS)",
     sapiens_musicator: "Musicator",
@@ -353,8 +353,23 @@ export async function callTool(name, rawArgs) {
     }
     catch (e) {
         return {
-            content: [{ type: "text", text: `Erro: ${describeConvexError(e)}` }],
+            content: [
+                { type: "text", text: `Erro: ${describeConvexError(e)}${retryHint(e)}` },
+            ],
             isError: true,
         };
     }
 }
+/**
+ * A regra do disjuntor viaja NO ERRO, não no handshake. Ela só passa a valer
+ * depois que uma chamada falhou, então cobrar ~300 chars de TODA conversa pra
+ * avisar de algo que talvez nunca aconteça é caro: aqui ela chega no instante
+ * exato em que aplica e custa zero nas outras. Só em erro de validação (Zod):
+ * erro de saldo ou de sessão tem o próprio conserto, e repetir a chamada
+ * idêntica não é o risco deles.
+ */
+function retryHint(e) {
+    if (!(e instanceof ZodError))
+        return "";
+    return " -> Refaça a chamada COM o campo corrigido. NUNCA repita idêntica: 3 falhas seguidas no mesmo tool fazem o cliente marcar o servidor como 'unreachable' por ~56s, e aí parece que o MCP caiu quando foi só argumento faltando.";
+}

package/dist/skills.js

@@ -262,15 +262,24 @@ Aí não é geração base, é o Studio dela. Veja a skill \`studio\`.`,
     },
     {
         name: "studio",
-        title: "Meu Studio e a Emancipação",
-        description: "O studio é a PÁGINA de portfólio da pessoa (obra, time, endereço público). Puxe quando ela falar do studio dela, quiser mostrar a casa, montar time, ou pedir casa própria.",
+        title: "Meu Studio",
+        description: "O studio é a PÁGINA de portfólio da empresa da pessoa (obra, time, endereço público), e você funda o dela pelo chat. Puxe quando ela falar do studio dela, quiser fundar um, mostrar a casa ou montar time.",
         body: `## O que o studio é
 
-O studio é a **página de portfólio** 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.
+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.
 
-Quem edita a página (obra, time, sobre, capa, logo, folha) é o membro, na própria página, no modo edição. Você não edita isso pelo MCP.
+## Fundar
+
+\`sapiens_studios action=create name="<nome da casa>"\` funda. De graça, sem Sinapse.
+
+- **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 **privado**, com ela como fundadora. Publicar é decisão dela, na página.
+- Bateu o teto de 4: 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.
 
 ## O studio NÃO entra na geração
 
@@ -286,15 +295,7 @@ Pergunte qual, não adivinhe.
 
 Gente entra por convite, e o convite exige **follow mútuo**: os dois precisam já se seguir. Personagem do próprio elenco entra sem convite, é posse. Teto de 4 pessoas por casa.
 
-A obra da página é automática por default: a soma dos Destaques de quem está no time. Se alguém empurrar uma peça à mão, ela passa a ser curada. Tudo isso se faz na página, não por aqui.
-
-## Emancipação
-
-O passo grande: quando o membro quer a casa PRÓPRIA dele, site ou produto próprio, FORA do Sapiens.
-
-\`sapiens_studios action=emancipar\` devolve o blueprint pra VOCÊ construir na infra DELE (Vercel, Convex e domínio dele), começando pela Fundação e seguindo um módulo por vez (\`action=module module=<slug>\`: fundacao, sapiens-connect, telegram, email, auth).
-
-Confirme cada passo. Nunca hospede no Sapiens. Siga o gosto dele. É complexo: conduza com calma.`,
+A obra da página é automática por default: a soma dos Destaques de quem está no time. Se alguém empurrar uma peça à mão, ela passa a ser curada. Tudo isso se faz na página, não por aqui.`,
     },
     {
         name: "tirinha",
@@ -402,6 +403,65 @@ Sem bloco companion, opere na voz neutra da casa.`,
 
 **O crédito em Sinapses sai na APROVAÇÃO dele, não na hora.** Não prometa Sinapse no momento do claim. Diga que a prova foi enviada e que o crédito vem quando for aprovada.`,
     },
+    {
+        name: "minha-soul",
+        title: "Instalar a soul do usuário neste projeto",
+        description: "Transforma o retrato do usuário no Sapiens numa skill local do projeto atual, pra toda conversa nesta pasta já saber quem é o dono. Puxe quando ele disser 'instala minha soul', 'meu Claude precisa me conhecer', 'personaliza esse projeto comigo'.",
+        body: `## O que você vai fazer
+
+Escrever a soul da pessoa como skill LOCAL do projeto onde vocês estão. Depois disso, toda conversa nesta pasta abre já sabendo quem é o dono: o gosto, o jeito de pensar, o repertório. Sem MCP no meio, sem chave, sem rede.
+
+## Passo a passo
+
+1. \`sapiens_profile action=soul\` devolve o contrato \`sapiens.soul/v1\`. Não cobra Sinapse.
+2. Escreva \`.claude/skills/sapiens-soul/SKILL.md\` na raiz do projeto atual, no molde abaixo. Pasta que não existe, você cria. Arquivo que já existe, você sobrescreve: é o retrato de hoje.
+3. Confirme em UMA linha: o caminho do arquivo e a data do retrato. Não despeje o JSON na conversa.
+
+Se a pessoa não estiver dentro de um projeto (conversa sem pasta, claude.ai), diga onde o arquivo deveria morar e ofereça o conteúdo pra ela colar.
+
+## O molde
+
+O corpo em prosa é o que o modelo lê rápido; o JSON no fim é pra quem quiser o dado estruturado. Preencha com o que veio da soul e corte a seção que voltou vazia.
+
+\`\`\`\`markdown
+---
+name: sapiens-soul
+description: Quem é o dono deste projeto (nome, @, persona cognitiva, repertório e tese, vindos do Sapiens Sintéticos). Puxe antes de escrever copy, escolher exemplo, nomear coisa, decidir estética ou sugerir referência.
+---
+
+# A soul de <nome ou @handle>
+
+Retrato de <data legível do generatedAt>, contrato sapiens.soul/v1. É um instantâneo, não uma conexão viva.
+
+## Quem é
+<subject: nome, @, bio, nível, badges, link do perfil>
+
+## Como pensa
+<cognition: código, persona, e os quatro eixos com polo e confiança, em uma linha cada>
+
+## Repertório
+<repertorio: total público, gêneros e tags que mais aparecem, nota média, pessoas que ele acompanha, e as obras recentes que dizem alguma coisa sobre o gosto>
+
+## Tese
+<tese, quando veio>
+
+## Como usar isto
+Escrevendo pra essa pessoa ou no lugar dela: puxe a referência do repertório dela antes de inventar uma. O jeito de decidir está nos eixos. Na dúvida entre duas opções, escolha a que combina com o que já está aqui.
+
+## Dados brutos
+\`\`\`json
+<o contrato inteiro, como veio>
+\`\`\`
+\`\`\`\`
+
+## Atualizar
+
+O retrato envelhece. Quando a pessoa pedir, rode a action de novo e sobrescreva o arquivo. Nada mais precisa mudar.
+
+## O que nunca entra
+
+A soul é derivada e já sai filtrada da casa: saldo, transações, e-mail, contatos, conversas e criações privadas não viajam. Não tente completar o retrato com dado de outra tool.`,
+    },
 ];
 export const SKILLS = Object.fromEntries(SKILL_LIST.map((s) => [s.name, s]));
 /** Monta o SKILL.md completo (frontmatter do formato aberto + corpo). */

package/dist/tools/gallery.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { readFile } from "node:fs/promises";
-import { convexAction, getSessionToken, isRemoteContext } from "../convexClient.js";
+import { convexAction, convexMutation, getSessionToken, isRemoteContext, } from "../convexClient.js";
 /**
  * Galeria do usuário: browse, publicação e UPLOAD de peça de fora.
  * Wrapper sobre `desktopMcp.galleryList` / `galleryGet` / `gallerySetPublic` e
@@ -27,7 +27,15 @@ import { convexAction, getSessionToken, isRemoteContext } from "../convexClient.
  * e um motor terceiro só renderizou é ingest.
  */
 export const gallerySchema = z.object({
-    action: z.enum(["list", "get", "publish", "unpublish", "upload", "ingest"]),
+    action: z.enum([
+        "list",
+        "get",
+        "publish",
+        "unpublish",
+        "upload",
+        "ingest",
+        "refs",
+    ]),
     limit: z
         .number()
         .int()
@@ -42,7 +50,7 @@ export const gallerySchema = z.object({
     imageId: z
         .string()
         .optional()
-        .describe("generatedImages:_id (obrigatório pra action=get/publish/unpublish)"),
+        .describe("generatedImages:_id (obrigatório pra action=get/publish/unpublish/refs)"),
     includeBase64: z
         .boolean()
         .optional()
@@ -89,11 +97,18 @@ export const gallerySchema = z.object({
         .string()
         .optional()
         .describe("action=ingest: resolução ('720p', '1080p'). Default 720p."),
+    // Aceita lista OU string com os ids separados por vírgula. O segundo formato
+    // existe porque alguns clientes MCP serializam array como texto ao repassar a
+    // chamada, e aí o servidor recusava com "Expected array, received string" sem
+    // que houvesse nada de errado com o pedido. Normalizado logo abaixo.
     referenceImageIds: z
-        .array(z.string())
-        .max(8)
+        .union([z.array(z.string()), z.string()])
         .optional()
-        .describe("action=ingest: generatedImages:_id das peças DA CASA que serviram de referência (folha de storyboard, ficha de personagem, frame inicial). Ficam acopladas à peça ingerida e aparecem na ficha dela: é o que prova que a receita saiu daqui. Só peça sua entra."),
+        .describe("action=ingest/refs: generatedImages:_id das peças DA CASA que serviram de referência (folha de storyboard, ficha de personagem, frame inicial). Ficam acopladas à peça e aparecem na ficha dela: é o que prova que a receita saiu daqui. Só peça sua entra, no máximo 8. Aceita lista ou os ids separados por vírgula."),
+    replace: z
+        .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."),
     uploadedSource: z
         .string()
         .optional()
@@ -190,6 +205,23 @@ async function resolveUploadBytes(args) {
     }
     throw new Error("action=upload exige a peça: sourceUrl (https), filePath (local, stdio) ou base64.");
 }
+/**
+ * Normaliza `referenceImageIds` pro formato que o Convex espera (lista).
+ *
+ * O schema aceita lista ou string com vírgulas porque cliente MCP que serializa
+ * array como texto existe de verdade, e o erro que ele produzia ("Expected
+ * array, received string") não dizia nada sobre como consertar. Aqui a diferença
+ * morre, e o backend continua recebendo sempre uma lista.
+ */
+function normalizeRefIds(raw) {
+    if (!raw)
+        return [];
+    const lista = Array.isArray(raw) ? raw : raw.split(",");
+    return lista
+        .map((id) => id.trim().replace(/^["'[]+|["'\]]+$/g, ""))
+        .filter(Boolean)
+        .slice(0, 8);
+}
 export async function gallery(args) {
     const sessionToken = getSessionToken();
     if (args.action === "list") {
@@ -257,11 +289,30 @@ export async function gallery(args) {
             externalCost: args.externalCost,
             aspectRatio: args.aspectRatio,
             size: args.size,
-            referenceImageIds: args.referenceImageIds,
+            referenceImageIds: normalizeRefIds(args.referenceImageIds),
         });
         return {
             ...result,
             aviso: "Peça NATIVA: entra na timeline, publica e vai pra comunidade como qualquer geração da casa. Custo em Sinapses é 0 e ela NÃO leva assinatura C2PA, porque o motor rodou fora. Use ingest só quando a receita (folha, personagem, prompt) foi da casa; peça achada pronta é action=upload.",
         };
     }
+    // refs: acopla peças da casa a uma peça que JÁ existe (upload ou ingest).
+    // A ingestão aceita refs no nascimento, mas quem sobe raramente tem os ids em
+    // mãos na hora; e o upload não tinha lugar nenhum pra dizer de onde veio a
+    // direção. Escreve proveniência e nada mais: upload continua sem publicar.
+    if (args.action === "refs") {
+        if (!args.imageId) {
+            throw new Error("action=refs exige imageId: a peça que RECEBE as referências. Use action=list pra achar.");
+        }
+        const referenceImageIds = normalizeRefIds(args.referenceImageIds);
+        if (!referenceImageIds.length && !args.replace) {
+            throw new Error("action=refs exige referenceImageIds: os ids das peças da casa que serviram de referência. Pra LIMPAR as referências, mande replace=true com a lista vazia.");
+        }
+        return await convexMutation("externalIngest:mcpAttachReferences", {
+            sessionToken,
+            imageId: args.imageId,
+            referenceImageIds,
+            replace: args.replace,
+        });
+    }
 }

package/dist/tools/profile.js

@@ -18,6 +18,10 @@ import { convexQuery, convexMutation, getSessionToken } from "../convexClient.js
  *
  * Sub-actions:
  *   - get:          card completo (identidade + nível + saldo + badges + golden tools).
+ *   - soul:         a sapiens-soul: retrato do momento (contrato sapiens.soul/v1,
+ *                   identidade + persona + repertório + tese, derivado e datado).
+ *                   Salve como sapiens-soul.json no projeto do usuário quando ele
+ *                   pedir "pega minha soul / meu retrato do Sapiens".
  *   - badges:       só as conquistas (lista cheia).
  *   - golden_tools: só os favoritos do aitag (lista cheia).
  *   - notifications: suas notificações recentes (sino) + contagem de não-lidas.
@@ -33,6 +37,7 @@ import { convexQuery, convexMutation, getSessionToken } from "../convexClient.js
 export const profileSchema = z.object({
     action: z.enum([
         "get",
+        "soul",
         "badges",
         "golden_tools",
         "notifications",
@@ -119,6 +124,15 @@ function mapTools(rows) {
 }
 export async function profile(args) {
     const sessionToken = getSessionToken();
+    // A soul: retrato do momento (contrato sapiens.soul/v1). Autentica pelo
+    // próprio sessionToken; token de membro tem acesso total, então vem inteira.
+    if (args.action === "soul") {
+        const soul = await convexQuery("soulContract:getForToken", { sessionToken });
+        return {
+            ...soul,
+            note: "Snapshot datado (generatedAt), não é conexão viva. Salve como sapiens-soul.json no projeto do usuário; pra atualizar, rode a action de novo e sobrescreva o arquivo.",
+        };
+    }
     // notifications/mark_read autenticam pelo próprio sessionToken (requireMcpUser
     // no Convex), não precisam do resolveUser — atalham antes.
     if (args.action === "notifications") {

package/dist/tools/studios.js

@@ -1,31 +1,42 @@
 import { z } from "zod";
-import { convexAction, convexQuery, getSessionToken } from "../convexClient.js";
+import { convexAction, convexMutation, getSessionToken } from "../convexClient.js";
 /**
- * Catálogo dos estúdios/experimentos Sapiens (v1.3).
+ * Duas coisas com o mesmo nome, e o `action` separa as duas:
  *
- * Versão minimal: retorna info estática sobre os experimentos disponíveis no
- * app. Cada entry tem URL do dashboard, descrição curta, status (estável /
- * beta / experimental), e tags. Útil pro Claude rotear o user pro lugar
- * certo quando ele pede coisa que não está coberta no plugin v1.x.
+ * 1. O CATÁLOGO dos estúdios/experimentos da casa (`list`/`get`): info estática
+ *    com URL do dashboard, status e tags, pro Claude rotear o user pro lugar
+ *    certo quando ele pede coisa que o plugin não cobre.
+ * 2. O STUDIO DO MEMBRO (`mine`/`create`): a página de portfólio da empresa
+ *    dele. Fundar é aqui; vestir a página (capa, logo, sobre, seções) e montar
+ *    o time é na própria página, no modo edição.
  *
- * v1.4 vai adicionar wrappers session-token-auth pros estúdios que justificam
- * (Helen Voice TTS, Musicator letras, Sapiens Shorts render, Persona Sapiens).
- * Por hora skills usam Claude-side + dashboard URL.
+ * A Emancipação (o antigo "Nível 3", blueprint pra construir a casa própria na
+ * infra do membro) saiu em ago/2026 junto com os níveis: o studio virou perfil
+ * de empresa, não uma jornada. As queries `studioBlueprints:mcp*` seguem no
+ * backend só como aviso pra pacote publicado que ainda chama.
  */
 export const studiosSchema = z.object({
     action: z
-        .enum(["list", "get", "publishable_url", "mine", "emancipar", "module"])
-        .describe("mine = o SEU studio (a página de portfólio da sua casa): nome, endereço público, marca, operador e tamanho do time. list/get = catálogo de estúdios da casa. publishable_url = URL de artigo. " +
-        "emancipar = INICIA a Emancipação (Nível 3 do Studio): puxa o blueprint-mestre pra VOCÊ (Claude) construir a casa PRÓPRIA do membro, na infra DELE (Vercel + Convex + domínio dele), FORA do Sapiens. Devolve a identidade do studio dele já hidratada + o índice de módulos + o guia da Fundação. " +
-        "module = puxa o guia de UM módulo de infra pra continuar a construção (ex: fundacao, sapiens-connect, midia, telegram, email, auth)."),
+        .enum(["list", "get", "publishable_url", "mine", "create"])
+        .describe("mine = o SEU studio (a página de portfólio da sua casa): nome, endereço público, marca, operador e tamanho do time. " +
+        "create = FUNDA um studio novo na conta do user (exige 'name'). Nasce privado, com ele como fundador; publicar e vestir a página é na própria página. Teto de 4 por pessoa. " +
+        "list/get = catálogo de estúdios da casa. publishable_url = URL de artigo."),
     studio: z
         .string()
         .optional()
         .describe("Pra action=get: slug do estúdio (ex 'helen-voice', 'musicator', 'persona-sapiens', 'sapiens-shorts')."),
-    module: z
+    name: z
         .string()
         .optional()
-        .describe("Pra action=module: slug do módulo de infra da emancipação. Prontos (com guia): fundacao, sapiens-connect, midia, telegram, email, auth. Chegando (no índice, sem guia ainda): pagamentos, analytics."),
+        .describe("Pra action=create: o nome da casa (obrigatório). O endereço público sai daí, em kebab-case. Pergunte ao user, não invente."),
+    description: z
+        .string()
+        .optional()
+        .describe("Pra action=create: uma linha do que a casa faz (até 200 chars). Opcional, mas é o que aparece embaixo do nome na página."),
+    brandSlug: z
+        .string()
+        .optional()
+        .describe("Pra action=create: marca da casa (slug de sapiens_brand). Opcional. Só passa marca que é do user."),
     publishableId: z
         .string()
         .optional()
@@ -202,28 +213,24 @@ export async function studios(args) {
                 : "publishableId lookup ainda não suportado v1.3. Passe slug.",
         };
     }
-    // action=emancipar: o blueprint-mestre da Emancipação (Nível 3). O membro sai
-    // da casa do Sapiens e monta a PRÓPRIA, na infra dele, guiado pelo Claude dele.
-    if (args.action === "emancipar") {
-        const sessionToken = getSessionToken();
-        const res = await convexQuery("studioBlueprints:mcpEmanciparBlueprint", { sessionToken });
-        if (!res?.ok)
-            return res; // { ok:false, error } — ex: sem studio montado ainda
-        return {
-            ...res,
-            howto: "Blueprint-mestre da Emancipação (Nível 3). VOCÊ (o Claude do membro) constrói a casa dele NUMA PASTA NOVA, fora deste projeto, com Vercel + Convex + domínio DO MEMBRO. O Sapiens NÃO hospeda a casa. Conduza assim: (1) leia o `blueprint` (guia da Fundação) e execute passo a passo, confirmando com o membro ANTES de criar conta ou gastar (domínio); (2) o selo <meta name=\"sapiens-studio\"> é OBRIGATÓRIO pra verificação; (3) com a casa no ar, o membro submete a URL no Sapiens (Rito 'Studio no Ar', que paga Sinapses); (4) pra cada próximo módulo do `modules` que estiver 'ready', chame sapiens_studios action=module module=<slug>. Um módulo por vez, sem atropelar. É um passo grande: vá com calma e no gosto do membro.",
-        };
-    }
-    // action=module: o guia de UM módulo de infra, hidratado com a identidade do
-    // studio do membro. Chame depois da fundacao, um por vez.
-    if (args.action === "module") {
-        if (!args.module) {
-            throw new Error("action=module exige 'module' (slug do módulo de infra: fundacao, sapiens-connect, telegram, email, auth).");
+    // action=create: funda a casa. O servidor resolve o dono pelo sessionToken e
+    // devolve o endereço público já montado (quem chama não tem tela pra procurar).
+    if (args.action === "create") {
+        const name = (args.name ?? "").trim();
+        if (!name) {
+            throw new Error("action=create exige 'name' (o nome da casa). Pergunte ao user antes de inventar.");
         }
         const sessionToken = getSessionToken();
-        return await convexQuery("studioBlueprints:mcpModuleBlueprint", {
+        const res = await convexMutation("studios:mcpCreateStudio", {
             sessionToken,
-            module: args.module,
+            name,
+            description: args.description,
+            brandSlug: args.brandSlug,
         });
+        return {
+            ...res,
+            note: "Studio fundado, privado por enquanto. O user publica e veste a página (capa, logo, sobre, time, obra) em " +
+                `${APP}/studios/${res.slug} no modo edição. Convidar gente exige follow mútuo.`,
+        };
     }
 }

package/package.json

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