sapiens-mcp 1.45.1 → 1.46.1

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/prompts.js

@@ -89,8 +89,8 @@ export const SAPIENS_PROMPTS = [
         build: (a) => `Quero uma imagem de: "${a.cena}". Monte o prompt na regra da casa (full-bleed, ` +
             "sujeito oversized 70%+ do frame, sem moldura/margem, sem 'tarot card'). Confira " +
             "modelo e preço com sapiens_image action=models e meu saldo com sapiens_meta " +
-            "action=credits; me diga o custo antes de gerar. Se eu tiver studio montado e " +
-            "pedir 'do meu jeito', use useStudio=true. Depois de gerar, me mostre a url e " +
+            "action=credits; me diga o custo antes de gerar. Se eu pedir 'na minha marca' ou " +
+            "'com fulano', use brandSlug ou influencerId. Depois de gerar, me mostre a url e " +
             "ofereça publicar na galeria (sapiens_gallery action=publish).",
     },
 ];

package/dist/registry.js

@@ -58,7 +58,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 +68,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 +98,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,
     },
@@ -143,12 +143,12 @@ 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). 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.",
+        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 no traço das imagens que ele já tem (exige pelo menos uma), em duas orientações (arg `orientation`): 'portrait' (default) é a página de processo, pose, expressões, trocas de roupa e adereços soltos na folha; 'landscape' é a prancha larga, com a volta completa à esquerda, a figura grande no meio, poses à direita, estudos de silhueta, expressão e detalhe embaixo e um painel CHARACTER ID na ponta. 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 sheetUrls em action=get), nenhuma apaga a anterior, e a ficha já entra na galeria dele como referência das próximas gerações. É 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,
     },
     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,
     },
@@ -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",

package/dist/skills.js

@@ -262,48 +262,40 @@ 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 é o perfil de EMPRESA da pessoa (obra, time, endereço público) e é também a identidade que o useStudio aplica na geração. Puxe quando ela disser 'do meu jeito', 'na minha marca', falar do studio dela, 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 é o **perfil de 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, e não tem níveis: 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.
 
-Duas coisas moram nele, e vale separar:
+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.
 
-- **A página.** Obra, time, sobre, capa, logo, folha. Quem edita é o membro, na própria página, no modo edição. Você não edita isso pelo MCP.
-- **A identidade de geração.** Marca e personagem-operador, que o \`useStudio\` aplica.
+## Fundar
 
-Uma pessoa pode ter até 4 studios e integrar até 4. O que o \`useStudio\` aplica é o **primário** dela; o servidor resolve pela SESSÃO, você nunca passa id.
+\`sapiens_studios action=create name="<nome da casa>"\` funda. De graça, sem Sinapse.
 
-## Studio vs base: não misture
+- **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.
 
-**Seguindo o studio:** \`sapiens_image\` com \`useStudio=true\`. O servidor acha o studio primário e aplica marca, personagem e vibe sozinho (o que você passar explícito vence). O retorno traz \`studioApplied=true\`.
+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.
 
-Use quando ela disser "no meu studio", "na minha marca", "do meu jeito", "como sempre".
+## O studio NÃO entra na geração
 
-**Geração avulsa:** \`sapiens_image\` SEM \`useStudio\` (\`studioApplied=false\`). Pra teste solto ou pedido fora da identidade.
+Gerar imagem "no studio dela" não existe. Se ela pedir "na minha marca" ou "do meu jeito", o caminho é explícito e é seu:
 
-Ou é studio, ou é base. Não misture na mesma peça.
+- **marca da casa** → \`sapiens_image\` com \`brandSlug\` (veja \`sapiens_brand\`);
+- **personagem dela** → \`influencerId\` (veja \`sapiens_character\`);
+- **o traço da casa** → \`templateSlug\`.
 
-## Antes de criar no studio
-
-\`sapiens_studios action=mine\` mostra nome, endereço público, marca, operador e o tamanho do time.
-
-Se você pediu \`useStudio=true\` e voltou \`studioApplied=false\`, a pessoa ainda não fundou uma casa: avise e aponte /dashboard/studio.
+Pergunte qual, não adivinhe.
 
 ## O time
 
 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",
@@ -411,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/character.js

@@ -24,6 +24,9 @@ import { convexQuery, convexMutation, convexAction, getSessionToken } from "../c
  *   - remove_image: tira UMA imagem do próprio personagem (por url).
  *   - set_main_image: define a principal (por url, entre as que já existem).
  *   - reorder_images: reordena as imagens (posição 0 = principal).
+ *   - generate_sheet: desenha a ficha do personagem (COBRA), vertical ou
+ *                   horizontal (`orientation`). A ficha entra na galeria dele e
+ *                   já serve de referência; elas acumulam.
  *   - delete:       apaga o próprio personagem (permanente).
  *
  * Fluxo típico de criação: create → add_image (1+) → set_card (opcional) →
@@ -72,7 +75,7 @@ export const characterSchema = z.object({
         .describe("Pra create/set_card: a 'alma' do personagem (personalidade, jeito de falar, contexto). Usado no chat e como guia de geração."),
     imageUrl: httpUrl()
         .optional()
-        .describe("Pra add_image: URL pública da imagem (Bunny CDN / Convex storage). Use a `url` que sapiens_image/sapiens_gallery devolvem. Pra remove_image/set_main_image: a url da imagem JÁ no personagem (pegue via action=get, campo imageUrls)."),
+        .describe("Pra add_image: URL pública da imagem (Bunny CDN / Convex storage). Use a `url` que sapiens_image/sapiens_gallery devolvem. Pra remove_image/set_main_image: a url da imagem JÁ no personagem (pegue via action=get, campo imageUrls, ou sheetUrls pra apagar uma ficha)."),
     orderedUrls: z
         .array(z.string())
         .optional()
@@ -89,6 +92,10 @@ export const characterSchema = z.object({
         .boolean()
         .optional()
         .describe("Pra set_visibility: true = público no Explorar (gera slug), false = privado."),
+    orientation: z
+        .enum(["portrait", "landscape"])
+        .optional()
+        .describe("Pra generate_sheet: 'portrait' (default) é a página de processo vertical, composição livre, sem texto. 'landscape' é a prancha larga: volta completa à esquerda, figura grande no meio, poses à direita, estudos de silhueta/expressão/detalhe embaixo e painel CHARACTER ID na ponta. As duas acumulam no personagem, uma não substitui a outra."),
 });
 export async function character(args) {
     // -------- list_public: catálogo global (sessionToken opcional, marca `mine`) --------
@@ -243,7 +250,9 @@ export async function character(args) {
     }
     // -------- 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.
+    // NÃO repita às cegas: confira em action=get (campo imageUrls) se a peça caiu.
+    // A ficha entra na galeria do personagem, então já vira referência das
+    // próximas gerações sem passo extra.
     if (args.action === "generate_sheet") {
         if (!args.characterId)
             throw new Error("action=generate_sheet exige characterId.");
@@ -251,6 +260,7 @@ export async function character(args) {
         return await convexAction("characterSheetActions:mcpGenerateCharacterSheet", {
             sessionToken,
             influencerId: args.characterId,
+            orientation: args.orientation,
         });
     }
     // -------- delete: apaga o próprio personagem (permanente) --------

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/image.js

@@ -77,14 +77,10 @@ export const imageSchema = z.object({
         .string()
         .optional()
         .describe("Slug de um template de imagem (super-prompt travado da casa). Quando setado, o `prompt` vira só a CENA (quem + pose + objeto-conceito) e o template embrulha com o estilo + fundo + enquadramento + ref de traço da casa. Ex: 'retrato-sapiens-v1' = retrato editorial cartoon de UM personagem no grid verde Sapiens (mesma 'mão' dos artigos). O template define model/aspect/size default (sobreponíveis) e injeta a ref da Helen como âncora de traço quando você não passa referenceImageUrls própria (passar refs = trocar quem aparece, mantendo o estilo). Mutuamente exclusivo com brandSlug. Vale em action=generate, mode=create."),
-    useStudio: z
-        .boolean()
-        .optional()
-        .describe("Quando true, gera SEGUINDO o studio do user (o 'Meu Studio', ÚNICO, resolvido pela sessão — você NÃO passa id): marca + personagem-operador + a vibe + os presets do bloco de imagem entram sozinhos (o explícito sempre vence). O retorno traz studioApplied: true se aplicou o studio, false se caiu no Sapiens base (sem studio montado — aí avise o user). É o 'criar no meu studio' do Nível 2, e gerar assim faz o studio evoluir. SEM useStudio = geração base, fora da identidade dele: não misture. Cheque o studio com sapiens_studios action=mine. Vale em action=generate."),
     influencerId: z
         .string()
         .optional()
-        .describe("ID de personagem (influencer) pra character-lock. Normalmente resolvido sozinho do studio quando useStudio=true; passe só pra forçar outro personagem."),
+        .describe("ID de personagem (influencer) pra character-lock: a imagem sai com ESSE personagem. Descubra o id com sapiens_character."),
     loraIntensity: z
         .enum(["suave", "medio", "forte"])
         .optional()
@@ -216,25 +212,14 @@ export async function image(args) {
         brandSlug: args.brandSlug,
         brandMark: args.brandMark,
         templateSlug: args.templateSlug,
-        useStudio: args.useStudio,
         influencerId: args.influencerId,
         loraIntensity: args.loraIntensity,
     });
-    const studioApplied = result?.studioApplied === true;
     return {
         imageId: result?.imageId,
         url: result?.url,
         webUrl: result?.imageId ? `https://sapiensinteticos.com/imagem/${result.imageId}` : undefined,
         mimeType: result?.mimeType,
-        // studioApplied=true só quando useStudio achou e aplicou o studio do user.
-        // false = geração base. É o sinal pra não confundir studio com base.
-        studioApplied,
-        // Pediu o studio mas não há um montado: caiu no base, avise o user.
-        ...(args.useStudio && !studioApplied
-            ? {
-                note: "Você pediu o seu studio, mas não há um montado: gerei no Sapiens base. Monte o seu studio em sapiensinteticos.com/dashboard/studio (ferramentas + marca + a vibe).",
-            }
-            : {}),
         // Não incluir base64 no retorno (polui contexto). Quem quiser bytes
         // chama sapiens_gallery action=get com includeBase64=true.
     };

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 (o perfil de empresa da sua casa): nome, endereço público, marca, operador e tamanho do time, pra você gerar com useStudio. 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()
@@ -149,11 +160,11 @@ const STUDIOS = {
     },
 };
 export async function studios(args) {
-    // action=mine: o studio PRIMÁRIO do user logado (o perfil de empresa da casa
-    // dele), resumo non-PII pro Claude saber o que está montado antes de gerar
-    // com useStudio. Os campos `level`/`levelLabel`/`tools` vêm vazios: os níveis
-    // e as ferramentas à la carte morreram quando o studio virou company page, e
-    // eles só continuam no retorno porque pacotes já publicados os imprimem.
+    // action=mine: o studio PRIMÁRIO do user logado (a página de portfólio da casa
+    // dele), resumo non-PII. Os campos `level`/`levelLabel`/`tools`/`imageVibe`/
+    // `studioMcpRuns` vêm vazios: os níveis e as ferramentas à la carte morreram
+    // quando o studio virou página, e a geração ancorada (`useStudio`) morreu com
+    // ela; só continuam no retorno porque pacotes já publicados os imprimem.
     if (args.action === "mine") {
         const sessionToken = getSessionToken();
         const studio = await convexAction("desktopMcp:studioMine", { sessionToken });
@@ -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.45.1",
+  "version": "1.46.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": {