sapiens-mcp 1.43.0 → 1.43.2

package/dist/registry.js

@@ -28,6 +28,7 @@ import { support, supportSchema } from "./tools/support.js";
 import { atlas, atlasSchema } from "./tools/atlas.js";
 import { reference, referenceSchema } from "./tools/reference.js";
 import { trilhas, trilhasSchema } from "./tools/trilhas.js";
+import { semana, semanaSchema } from "./tools/semana.js";
 import { shareDrop, shareDropSchema } from "./tools/shareDrop.js";
 import { skill, skillSchema } from "./tools/skill.js";
 import { describeConvexError } from "./convexClient.js";
@@ -56,7 +57,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 (gerar na identidade da pessoa vs base, e a Emancipaçã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). 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 (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.",
         schema: skillSchema,
         handler: skill,
     },
@@ -96,7 +97,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 Meu Studio do user: nível/marca/operador/ferramentas), 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: "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.",
         schema: studiosSchema,
         handler: studios,
     },
@@ -121,7 +122,7 @@ export const TOOLS = {
         handler: shorts,
     },
     sapiens_video: {
-        description: "Sapiens Video — gera vídeo (qualquer membro logado; vídeo é caro, cobra as Sinapses da sua conta). Sub-action 'create' (recomendada): escolhe modelo + config e gera num call (cria a row + renderiza). Modelos: 'sapiens-video-seedance' (Seedance 2.0, cena+áudio nativo, 4-15s, 480/720/1080p, t2v/i2v; aceita até 4 imagens de REFERÊNCIA via referenceImageIds/referenceImageUrls/referenceImagePaths (os Veo fast/quality também aceitam, até 3; Lite/Kling/WAN/Omni não), que guiam estilo/personagem/composição SEM virar o 1º frame — é o fluxo STORYBOARD: gere a folha de key poses com sapiens_image templateSlug='storyboard-sapiens-v1', passe folha + personagem como refs num t2v e descreva o take contínuo no prompt, citando as refs por descrição e mandando ignorar o traço do sketch; aceita também 1 VÍDEO DE MOVIMENTO via referenceVideoUrls (role 'refvideo' -> reference_videos, <=15s, host da casa): a coreografia/câmera do clipe guia o take, combinável com a folha), 'sapiens-video-seedance-2-fast' e 'sapiens-video-seedance-2-mini' (os irmãos do 2.0: MESMO repertório completo, incluindo referência, frame final e vídeo de movimento; o Fast custa 20% menos e o Mini METADE, ambos com teto 720p — pedir 1080p neles entrega e cobra 720p. Use o Mini pra iterar enquadramento/prompt barato e feche no 'sapiens-video-seedance' quando o take estiver certo), 'sapiens-video-kling' (Kling 3.0 Pro, anima imagem, 3-15s, sound opcional, i2v/t2v), 'sapiens-video-wan' (WAN 2.5, imagem que fala/canta com áudio+lip-sync, 5/10s, i2v), 'sapiens-video-kling-motion' (Motion transfer: passa o movimento de um vídeo pra uma imagem, PRECISA de pessoa com tronco visível na imagem E no vídeo), 'sapiens-video-shot-mimic' (Shot Mimic: recria o plano/câmera/cortes de um vídeo de referência como cena nova), 'sapiens-video-omni' (Gemini Omni: texto vira vídeo 10s 720p com áudio nativo; NÃO aceita mídia do user, ignora references/durationSec/resolution; editOfImageId aponta um vídeo Omni seu e o prompt edita a MESMA cena, preservando câmera e ambiente), 'sapiens-video-lite/fast/quality' (Veo 3.1). Args create: model, prompt, durationSec, resolution ('480p'/'720p'/'1080p'), audio, aspectRatio. FRAME INICIAL/FINAL POR REFERÊNCIA (recomendado): startImageId/endImageId (id da sua galeria) ou startImageUrl/endImageUrl (url de galeria/Acervo/personagem) — resolvidos server-side igual à imagem, descubra via sapiens_reference. FRAME POR ARQUIVO LOCAL (só no MCP instalado/stdio, não no remoto): startImagePath/endImagePath = caminho absoluto de uma imagem no seu PC (PNG/JPEG/WebP até 8MB); o processo lê o arquivo e sobe como frame inicial/final, igual a subir no gerador do site — 1 imagem inicial + 1 final por vídeo, então pra vários vídeos rode create uma vez por imagem. No remoto use id/url. Alternativa base64: references (role 'start'=imagem i2v, 'end'=frame final, 'driving'=vídeo de movimento do Motion). Suporte a frame final varia por modelo. Custo server-side por config. Sub-action 'generate' (legado): renderiza um imageId de vídeo já criado no site. Retorna {success, url, imageId, cost}. VITRINE (sem custo): sub-action 'demos' lista os SEUS demo films (kind=demo do Estúdio de Vídeo) com slug + estado de vitrine; sub-action 'showcase' põe/tira um demo (por slug) do mini-cinema da /conectar-claude, com showcaseTag (chip de capacidade) e showcaseOrder (ordem asc). Fluxo: 'demos' pra achar o slug, depois 'showcase' com showcase=true. Só entra na vitrine pública se for a conta da casa. VÍDEOS PROGRAMÁTICOS (ADMIN, sem custo): a mesa do Estúdio de Vídeo (/experimentos/films, tabela videoSpecs, 5 kinds: demo | aula-tour | essay | tipografia-musical | dataviz) opera por aqui sem browser — 'film-list' (todos os kinds; filtros filmKind/filmStatus), 'film-get' (spec inteiro por slug), 'film-upsert' (cria/atualiza por slug, idempotente; spec = objeto JSON no shape do 'Copiar spec' da tela, validação no servidor), 'film-status' (produção por slug: filmStatus + videoUrl + durationSecMeasured; o fecho do render é os três num call), 'film-publish' (Acervo aba Fitas + portfólio; exige pronto+URL), 'film-delete' (limpar rascunho). O RENDER do filme segue no agente local (skill /film, repo da casa): o MCP registra e fecha o ciclo, não renderiza. create é ASSÍNCRONA: cria o row, debita e volta NA HORA com {imageId, status:'rendering', cost} (não espera o render, que leva de segundos a minutos). Acompanhe com a sub-action 'status' (imageId) até status='completed' (traz a url) ou 'error'/'blocked'. NÃO chame create de novo enquanto renderiza (cria outro vídeo e cobra de novo); falha de provider refunda sozinha. SOM: 'sonorize' (imageId de vídeo SEU completed + prompt do som da cena) gera uma VARIANTE nova com trilha sincronizada (20 Sinapses/s, o original fica intacto; sonorize sempre o original, nunca uma variante). ADMIN: 'shadows' (videoUrl + title) extrai a sombra/depth-map de um vídeo: entra na sua timeline de vídeos e no Acervo como driving reutilizável; 'shadows-list' lista as sombras prontas. Sub-action 'models' (sem custo, sem login): lista os modelos de vídeo ativos + preço-piso + config (durações/resoluções) + disponibilidade (Omni depende de env).",
+        description: "Sapiens Video — gera vídeo (qualquer membro logado; vídeo é caro, cobra as Sinapses da sua conta). Sub-action 'create' (recomendada): escolhe modelo + config e gera num call (cria a row + renderiza). Modelos: 'sapiens-video-seedance' (Seedance 2.0, cena+áudio nativo, 4-15s, 480/720/1080p, t2v/i2v; aceita até 4 imagens de REFERÊNCIA via referenceImageIds/referenceImageUrls/referenceImagePaths (os Veo fast/quality também aceitam, até 3; Lite/Kling/WAN/Omni não), que guiam estilo/personagem/composição SEM virar o 1º frame — é o fluxo STORYBOARD: gere a folha de key poses com sapiens_image templateSlug='storyboard-sapiens-v1', passe folha + personagem como refs num t2v e descreva o take contínuo no prompt, citando as refs por descrição e mandando ignorar o traço do sketch; aceita também 1 VÍDEO DE MOVIMENTO via referenceVideoUrls (role 'refvideo' -> reference_videos, <=15s, host da casa): a coreografia/câmera do clipe guia o take, combinável com a folha), 'sapiens-video-seedance-2-fast' e 'sapiens-video-seedance-2-mini' (os irmãos do 2.0: MESMO repertório completo, incluindo referência, frame final e vídeo de movimento; o Fast custa 20% menos e o Mini METADE, ambos com teto 720p — pedir 1080p neles entrega e cobra 720p. Use o Mini pra iterar enquadramento/prompt barato e feche no 'sapiens-video-seedance' quando o take estiver certo), 'sapiens-video-kling' (Kling 3.0 Pro, anima imagem, 3-15s, sound opcional, i2v/t2v), 'sapiens-video-wan' (WAN 2.5, imagem que fala/canta com áudio+lip-sync, 5/10s, i2v), 'sapiens-video-kling-motion' (Motion transfer: passa o movimento de um vídeo pra uma imagem, PRECISA de pessoa com tronco visível na imagem E no vídeo), 'sapiens-video-shot-mimic' (Shot Mimic: recria o plano/câmera/cortes de um vídeo de referência como cena nova), 'sapiens-video-omni' (Gemini Omni: texto vira vídeo 10s 720p com áudio nativo; NÃO aceita mídia do user, ignora references/durationSec/resolution; editOfImageId aponta um vídeo Omni seu e o prompt edita a MESMA cena, preservando câmera e ambiente), 'sapiens-video-lite/fast/quality' (Veo 3.1). Args create: model, prompt, durationSec, resolution ('480p'/'720p'/'1080p'), audio, aspectRatio. FRAME INICIAL/FINAL POR REFERÊNCIA (recomendado): startImageId/endImageId (id da sua galeria) ou startImageUrl/endImageUrl (url de galeria/Acervo/personagem) — resolvidos server-side igual à imagem, descubra via sapiens_reference. FRAME POR ARQUIVO LOCAL (só no MCP instalado/stdio, não no remoto): startImagePath/endImagePath = caminho absoluto de uma imagem no seu PC (PNG/JPEG/WebP até 8MB); o processo lê o arquivo e sobe como frame inicial/final, igual a subir no gerador do site — 1 imagem inicial + 1 final por vídeo, então pra vários vídeos rode create uma vez por imagem. No remoto use id/url. Alternativa base64: references (role 'start'=imagem i2v, 'end'=frame final, 'driving'=vídeo de movimento do Motion). Suporte a frame final varia por modelo. Custo server-side por config. Sub-action 'generate' (legado): renderiza um imageId de vídeo já criado no site. Retorna {success, url, imageId, cost}. VITRINE (sem custo): sub-action 'demos' lista os SEUS demo films (kind=demo do Estúdio de Vídeo) com slug + estado de vitrine; sub-action 'showcase' põe/tira um demo (por slug) do mini-cinema da /conectar-claude, com showcaseTag (chip de capacidade) e showcaseOrder (ordem asc). Fluxo: 'demos' pra achar o slug, depois 'showcase' com showcase=true. Só entra na vitrine pública se for a conta da casa. VÍDEOS PROGRAMÁTICOS (ADMIN, sem custo): o Lab do Estúdio de Vídeo (/experimentos/films, tabela videoSpecs, 5 kinds: demo | aula-tour | essay | tipografia-musical | dataviz) opera por aqui sem browser — 'film-list' (todos os kinds; filtros filmKind/filmStatus), 'film-get' (spec inteiro por slug), 'film-upsert' (cria/atualiza por slug, idempotente; spec = objeto JSON no shape do 'Copiar spec' da tela, validação no servidor), 'film-status' (produção por slug: filmStatus + videoUrl + durationSecMeasured; o fecho do render é os três num call), 'film-publish' (Acervo aba Fitas + portfólio; exige pronto+URL), 'film-delete' (limpar rascunho). O RENDER do filme segue no agente local (skill /film, repo da casa): o MCP registra e fecha o ciclo, não renderiza. create é ASSÍNCRONA: cria o row, debita e volta NA HORA com {imageId, status:'rendering', cost} (não espera o render, que leva de segundos a minutos). Acompanhe com a sub-action 'status' (imageId) até status='completed' (traz a url) ou 'error'/'blocked'. NÃO chame create de novo enquanto renderiza (cria outro vídeo e cobra de novo); falha de provider refunda sozinha. SOM: 'sonorize' (imageId de vídeo SEU completed + prompt do som da cena) gera uma VARIANTE nova com trilha sincronizada (20 Sinapses/s, o original fica intacto; sonorize sempre o original, nunca uma variante). ADMIN: 'shadows' (videoUrl + title) extrai o deepshadow (depth-map) de um vídeo: entra na sua timeline de vídeos e no Acervo como driving reutilizável; 'shadows-list' lista os deepshadows prontos. Sub-action 'models' (sem custo, sem login): lista os modelos de vídeo ativos + preço-piso + config (durações/resoluções) + disponibilidade (Omni depende de env).",
         schema: videoSchema,
         handler: video,
     },
@@ -141,7 +142,7 @@ export const TOOLS = {
         handler: brand,
     },
     sapiens_character: {
-        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
+        description: "Personagens (character sheets) do Sapiens — a tabela `influencers`: personagem reutilizável com imagens (pra character-lock em geração) + alma (systemPrompt), tudo amarrado à conta do dono do token (sem admin). Sub-actions: list_public (catálogo global de personagens públicos do Explorar; cada um traz mainImageUrl/imageUrls usáveis direto como referenceImageUrls em sapiens_image; sem custo, sem login), get (detalhe de 1 por characterId — público+ativo qualquer um vê, draft/privado só o dono; systemPrompt só volta pro dono), list_mine (os personagens do próprio user, inclui drafts/privados), create (cria rascunho na conta: name + gender + opcional title/systemPrompt), add_image (adiciona imagem ao próprio personagem via imageUrl público OU sourceImageId da galeria; 1ª vira principal), set_card (edita alma/título/nome do próprio), activate (publica, sai de draft, exige ≥1 imagem), set_visibility (isPublic true=Explorar+slug / false=privado). GESTÃO de imagem (por url, pegue as urls atuais em action=get campo imageUrls): remove_image (tira uma), set_main_image (define a principal), reorder_images (nova ordem via orderedUrls, posição 0=principal), e delete (apaga o personagem, permanente). FICHA (generate_sheet, COBRA 450 Sinapses): desenha a página-pôster do personagem, uma folha só com pose, expressões, trocas de roupa e os adereços dele, no traço das imagens que ele já tem (exige pelo menos uma). A personalidade sai da alma (systemPrompt) e é ela que escolhe roupa e objeto, então personagem com alma escrita rende ficha melhor. Cada geração é um estilo NOVO e elas acumulam no personagem (campo sheets em action=get), não se sobrescrevem. É geração síncrona: se voltar Timeout, cheque action=get antes de repetir, senão cobra duas vezes. Fluxo de criação: create → add_image (1+) → set_card (opcional) → activate → set_visibility isPublic=true. Pra usar um personagem público como referência numa geração, pegue mainImageUrl em list_public/get e passe em sapiens_image referenceImageUrls.",
         schema: characterSchema,
         handler: character,
     },
@@ -166,7 +167,7 @@ export const TOOLS = {
         handler: instagram,
     },
     sapiens_aula: {
-        description: "Aula (deck da Mentoria OPS, servido em /aulas/<slug>) — ADMIN-ONLY (aula é conteúdo de mentor, não de aluno; aluno leva 'restrito ao dono'). Cria e edita aula direto no Convex, sem o script migrate-aulas-to-convex.mjs. Sub-actions: 'list' (slug/título/data/slideCount/voiceWarnings/url), 'get' (1 aula completa por slug, pra editar local), 'upsert' (cria se não existe, senão patch; por slug kebab-case). O `aula` do upsert é o objeto completo: title (obrig) + slides[] (≥1) + subtitle/data/duration/tag/mentorAgenda opcionais. Slides são { type, ...campos }: cover, cover-image/section-image/content-image (imageUrl), agenda (items[]), content (body markdown/HTML + list[]/listType), two-col (cols[]), quote, callout (tone tip|warn|note), comic (panels[]), pause, close (items[]). O servidor re-linta a voz e grava voiceWarnings (1ª pessoa, anti-corporate, SEM travessão). A rota /aulas/<slug> serve sob demanda; slug novo aparece sem rebuild.",
+        description: "Aula (deck servido em /aulas/<slug>) — ADMIN-ONLY (aula é conteúdo de mentor, não de aluno; aluno leva 'restrito ao dono'). Edita direto no Convex, sem script de disco. A aula de hoje é MODULAR: guarda `source = { recipe, modules[] }` e materializa os slides na LEITURA, então gravar slide materializado não adianta (some no próximo materialize) — mexe na FONTE. Fluxo de conteúdo: 'map' (índice BARATO: blocos da receita + ids de módulo + contagem de slides, sem arrastar os 45 slides; SEMPRE comece por ele) -> 'module' (1 módulo inteiro, pronto pra editar) -> 'module-save' (grava o módulo e remonta os slides; módulo NOVO precisa de placeAfter=<id vizinho> ou bloco=<título>; `module` ausente/null REMOVE). Fluxo de roteiro: 'recipe-op' (op=move|remove|add + toIndex/bloco) muda a ORDEM sem tocar no conteúdo. 'meta' edita título/subtítulo/tag/data/duration e o status draft|published (publica e despublica). 'delete' apaga a aula de vez (sem undo: puxe 'get' antes se quiser guardar); aula NO AR é recusada até você tirar de circulação com meta status=draft, ou insistir com force=true. Aula LEGADA (sem source) usa 'get'/'upsert' com o objeto inteiro: title (obrig) + slides[] (≥1) + subtitle/data/duration/tag/mentorAgenda. Slides são { type, ...campos }: cover, cover-image/section-image/content-image (imageUrl), agenda (items[]), content (body markdown/HTML + list[]/listType), two-col (cols[]), video (videoUrl ou videos[] lado a lado), quote, callout (tone tip|warn|note), comic (panels[]), pause, close (items[]). 'list' dá o panorama. Toda escrita re-linta a voz e grava voiceWarnings (1ª pessoa, anti-corporate, SEM travessão). A rota serve sob demanda: slug novo aparece sem rebuild.",
         schema: aulaSchema,
         handler: aula,
     },
@@ -190,8 +191,13 @@ export const TOOLS = {
         schema: trilhasSchema,
         handler: trilhas,
     },
+    sapiens_semana: {
+        description: "O ofício da SUA semana na casa: o que você produziu e quanto XP isso rendeu. Identidade SEMPRE pelo sessionToken. Sub-actions: 'get' (quais labs você utilizou nesta semana, quantas peças em cada, o XP de ofício já pago, quanto a Casa Cheia renderia no fecho, e se sobrou semana anterior por fechar), 'fechar' (fecha as semanas pendentes e credita a Casa Cheia de cada uma). Como a régua funciona: cada peça pronta anda o contador do lab e paga em degraus (1a, 3a, 7a, 15a, 30a peça da semana, com retorno decrescente); no fecho, a LARGURA paga à parte, 2 labs valem 20 XP, 5 valem 200, 8 valem 560, então usar labs diferentes rende mais que repetir o mesmo. Esta tool PAGA XP, não cobra Sinapses. Idempotente: chamar 'fechar' duas vezes não credita duas vezes.",
+        schema: semanaSchema,
+        handler: semana,
+    },
     sapiens_share: {
-        description: "Share Drop (ADMIN-ONLY): sobe um HTML single-file (doctype + CSS/JS inline) e recebe o link curto sint.fyi/s/<code> pra mandar pra alguém abrir no navegador sem instalar nada. O PONTO: publicar um artefato e depois RE-PUBLICAR no MESMO link quantas vezes quiser (action=update com o code) — edita o HTML aqui no Claude, joga pro ar, atualiza o mesmo arquivo. Sub-actions: 'list' (links ativos: code + url + título + tamanho + isActive/hasPassword/requireLogin), 'upload' (cria link NOVO a partir de html ou htmlPath → devolve {code, url}), 'update' (re-publica no MESMO code: mesma url, conteúdo novo, apaga o blob antigo), 'delete' (tira do ar — o link vira 404), 'settings' (isActive liga/desliga, password senha string vazia remove, requireLogin exige conta logada). O HTML entra por `html` (conteúdo string, funciona no stdio e no remoto) OU `htmlPath` (caminho absoluto de um .html local, SÓ no MCP instalado/stdio). Título sai do <title> do HTML se não passar `title` (ou keepTitle=true no update pra manter o atual). Sem custo em Sinapses. Espelha a mesa /dashboard/admin/share-drop.",
+        description: "Share Drop (ADMIN-ONLY): sobe um HTML single-file (doctype + CSS/JS inline) e recebe o link curto sint.fyi/s/<code> pra mandar pra alguém abrir no navegador sem instalar nada. O PONTO: publicar um artefato e depois RE-PUBLICAR no MESMO link quantas vezes quiser (action=update com o code) — edita o HTML aqui no Claude, joga pro ar, atualiza o mesmo arquivo. Sub-actions: 'list' (links ativos: code + url + título + tamanho + isActive/hasPassword/requireLogin), 'upload' (cria link NOVO a partir de html ou htmlPath → devolve {code, url}), 'update' (re-publica no MESMO code: mesma url, conteúdo novo, apaga o blob antigo), 'delete' (tira do ar — o link vira 404), 'settings' (isActive liga/desliga, password senha string vazia remove, requireLogin exige conta logada). O HTML entra por `html` (conteúdo string, funciona no stdio e no remoto) OU `htmlPath` (caminho absoluto de um .html local, SÓ no MCP instalado/stdio). Título sai do <title> do HTML se não passar `title` (ou keepTitle=true no update pra manter o atual). Sem custo em Sinapses. Espelha o Lab /dashboard/admin/share-drop.",
         schema: shareDropSchema,
         handler: shareDrop,
     },
@@ -271,6 +277,7 @@ const TOOL_TITLES = {
     sapiens_atlas: "Atlas Ecossistema IA",
     sapiens_reference: "Referências",
     sapiens_trilhas: "Trilhas & Desafios",
+    sapiens_semana: "Minha Semana",
     sapiens_instagram: "Auto-DM Instagram",
     sapiens_share: "Share Drop",
 };

package/dist/skills.js

@@ -92,6 +92,27 @@ Primeira pessoa. Opinião explícita. Conversa, não palestra. Analogia concreta
 - "Neste artigo vamos abordar", "vamos explorar", "sem mais delongas".
 - Tom influencer, promessa de atalho mágico, receita pronta.
 - Fechar tudo com CTA. O texto termina quando a ideia termina.
+- **Definir por negação** ("não é X, é Y", "nada de Z"). A casa só afirma: diz Y direto.
+
+## Tiques de IA que a casa corta
+
+O modelo repete esses porque soam competentes. Todos caem.
+
+- **Falsa revelação**: "o que ninguém te conta", "a parte que todo mundo pula". Corta o setup, a afirmação fica de pé sozinha.
+- **Atribuição vaga**: "especialistas concordam", "estudos mostram". Nomeia a fonte ou corta a frase.
+- **Inflar importância**: "divisor de águas", "marca um momento decisivo". Fala o fato e deixa quem lê julgar o tamanho.
+- **Análise em gerúndio**: "reforçando o compromisso do time", "evidenciando", "destacando". Troca pela consequência concreta.
+- **Revelação com dois-pontos**: "O detalhe que faz funcionar: um agente separado corrige." Vira frase normal.
+- **Setup retórico**: "e se eu te dissesse", "pensa comigo", "plot twist", e pergunta que o próprio texto responde na linha seguinte.
+- **Frase vazia**: "vale destacar", "é importante notar", "no final das contas", "quando se trata de", "nos dias de hoje".
+- **Rodízio de sinônimo**: o agente, depois o assistente, depois a ferramenta, tudo pra mesma coisa. Repetir a palavra certa é precisão.
+- **Kicker de falsa profundidade**: a última linha "funda" que vira aforismo. Deleta, não reescreve numa metáfora melhor. Termina na frase concreta que já estava lá.
+
+Hedge não entra nessa lista: "ao meu ver", "por enquanto", "talvez" assinam a voz e ficam.
+
+## Revisar sem apagar a pessoa
+
+Revisão é a menor edição que resolve. Corrige o tique, o erro e o trecho ilegível, e deixa em paz a frase que já funciona. Não deixa todo parágrafo igualmente arrumado, assimetria é sinal de humano. Não inventa número, exemplo nem opinião que não estava no original.
 
 ## O que manter
 
@@ -185,15 +206,15 @@ NÃO chame create de novo enquanto renderiza: cria outro vídeo e cobra de novo.
 
 Sonorize sempre o ORIGINAL, nunca uma variante. Acompanhe com \`action=status\` no imageId NOVO que o sonorize devolve.
 
-## Extrair a sombra (ADMIN)
+## Extrair o deepshadow (ADMIN)
 
 \`action=shadows\` com \`videoUrl\` (URL pública) e \`title\` extrai o mapa de profundidade de um vídeo: 200 Sinapses/segundo, com refund na falha. Passe \`durationSec\` quando souber, pra cobrar proporcional; sem ela vai no flat ~2000.
 
-A sombra cai na SUA timeline de vídeos (quem extrai vira dono) e vira ficha no Acervo como driving reutilizável pro Shot Mimic e o Kling Motion. \`action=shadows-list\` lista as prontas.
+O deepshadow cai na SUA timeline de vídeos (quem extrai vira dono) e vira ficha no Acervo como driving reutilizável pro Shot Mimic e o Kling Motion. \`action=shadows-list\` lista os prontos.
 
 ## Vídeos Programáticos são outra coisa
 
-A mesa de filmes-de-código da casa (/experimentos/films) tem cinco tipos: demo (UI clonada mais câmera), aula-tour (telas reais mais narração), essay (fita-ensaio abstrata), tipografia-musical (a música dirige o corte) e dataviz (números no tempo).
+O Lab de filmes-de-código da casa (/experimentos/films) tem cinco tipos: demo (UI clonada mais câmera), aula-tour (telas reais mais narração), essay (fita-ensaio abstrata), tipografia-musical (a música dirige o corte) e dataviz (números no tempo).
 
 O RENDER não sai deste connector: um agente local no repo da casa produz o mp4. Mas o CICLO na plataforma fecha por aqui, sem custo: \`film-list\`, \`film-get\`, \`film-upsert\`, \`film-status\`, \`film-publish\`. Membro pedindo "fita-ensaio" ou "demo film": aponte pra tela e pro agente local.`,
     },
@@ -231,7 +252,7 @@ Refs valem pros modelos robustos (nano-banana-2, gpt-image-2-*, grok-2-image*).
 
 ## Cuidados
 
-- \`generate\` é SÍNCRONA e cobra ao concluir. Modelo pesado (Pro, gpt-image-2-high, Grok quality, 2K/4K) cai na regra do timeout: cheque \`sapiens_gallery action=list\` antes de repetir, senão cobra duas vezes.
+- \`generate\` é SÍNCRONA e cobra ao concluir. Modelo pesado (Pro, gpt-image-2-high, Grok quality, Seedream 5.0 Pro, 2K/4K) cai na regra do timeout: cheque \`sapiens_gallery action=list\` antes de repetir, senão cobra duas vezes. O \`seedream-5-0-pro\` foi medido em ~140s, ACIMA do teto de 120s do cliente, então o Timeout nele é o esperado e a imagem está lá.
 - \`request_generation\` NÃO gera imagem: só cria a row pendente e debita, pra modelos \`sapiens-video-*\` antes de chamar vídeo ou shorts.
 - Uma imagem só vira pública (e ganha página indexável) com \`sapiens_gallery action=publish\`.
 
@@ -242,12 +263,21 @@ Aí não é geração base, é o Studio dela. Veja a skill \`studio\`.`,
     {
         name: "studio",
         title: "Meu Studio e a Emancipação",
-        description: "A diferença entre gerar na identidade da pessoa (useStudio) e gerar na base Sapiens, e o que é a Emancipação de Nível 3. Puxe quando a pessoa disser 'do meu jeito', 'na minha marca', ou pedir casa própria.",
-        body: `## Studio vs base: não misture
+        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.",
+        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.
 
-A pessoa tem UM "Meu Studio", único, que o servidor resolve pela SESSÃO. Você NUNCA passa id de studio: é sempre o dela. É a identidade configurada: marca, personagem-operador, e por ferramenta os presets e a "vibe" (o estilo afinado).
+Duas coisas moram nele, e vale separar:
 
-**Seguindo o studio:** \`sapiens_image\` com \`useStudio=true\`. O servidor acha o studio e aplica marca, personagem, vibe e presets sozinho (o que você passar explícito vence). O retorno traz \`studioApplied=true\`.
+- **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.
+
+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.
+
+## Studio vs base: não misture
+
+**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\`.
 
 Use quando ela disser "no meu studio", "na minha marca", "do meu jeito", "como sempre".
 
@@ -257,11 +287,17 @@ Ou é studio, ou é base. Não misture na mesma peça.
 
 ## Antes de criar no studio
 
-\`sapiens_studios action=mine\` mostra nível, marca, operador, ferramentas e a vibe da imagem.
+\`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.
+
+## 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.
 
-Se você pediu \`useStudio=true\` e voltou \`studioApplied=false\`, a pessoa não tem studio montado: avise e aponte /dashboard/studio. Gerar no studio faz ele evoluir de nível.
+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 (Nível 3)
+## Emancipação
 
 O passo grande: quando o membro quer a casa PRÓPRIA dele, site ou produto próprio, FORA do Sapiens.
 

package/dist/tools/aula.js

@@ -2,26 +2,84 @@ import { z } from "zod";
 import { convexMutation, convexQuery, getSessionToken } from "../convexClient.js";
 import { need } from "../schema.js";
 /**
- * sapiens_aula — CRUD do deck de aula (Mentoria OPS) via session token.
+ * sapiens_aula — CRUD do deck de aula via session token.
  * ADMIN-ONLY (requireMcpAdmin no Convex): aula é conteúdo de mentor, não de
- * aluno. Substitui o script migrate-aulas-to-convex.mjs: o Claude gera o deck
- * e publica direto no Convex, fonte de verdade que o /aulas/<slug> lê.
+ * aluno. Substitui os scripts de disco: o Claude edita e publica direto no
+ * Convex, fonte de verdade que o /aulas/<slug> lê.
  *
- * Sub-actions:
- *   - list: lista as aulas (slug/título/data/slideCount/voiceWarnings/url)
- *   - get: lê 1 aula completa por slug (pra editar local)
- *   - upsert: cria ou atualiza por slug (insere se não existe, senão patch)
+ * Duas famílias de sub-action, porque existem dois tipos de aula:
+ *
+ *   AULA MODULAR (tem `source = { recipe, modules[] }`, o padrão hoje): os
+ *   slides são MATERIALIZADOS na leitura a partir da fonte. Editar o slide
+ *   materializado não adianta, some no próximo materialize. Fluxo certo:
+ *     map -> module -> module-save   (conteúdo)
+ *     recipe-op                       (ordem dos módulos na aula)
+ *   O `map` é o índice barato: dá os blocos e os ids de módulo sem arrastar os
+ *   45 slides junto. Só depois dele você sabe qual `moduleId` pedir.
+ *
+ *   AULA LEGADA (sem source): o `slides` É a fonte, e o caminho é get/upsert
+ *   com o objeto inteiro.
+ *
+ * `meta` (título, série, data, duração, draft/published) e `delete` valem pras
+ * duas.
  */
 export const aulaSchema = z.object({
-    action: z.enum(["list", "get", "upsert"]),
+    action: z.enum([
+        "list",
+        "get",
+        "map",
+        "module",
+        "module-save",
+        "recipe-op",
+        "meta",
+        "upsert",
+        "delete",
+    ]),
     slug: z
         .string()
         .optional()
-        .describe("kebab-case (a-z, 0-9, hífen), ex: 2026-06-25-minha-aula. Obrigatório pra get e upsert."),
+        .describe("kebab-case (a-z, 0-9, hífen), ex: 2026-06-25-minha-aula. Obrigatório em tudo menos list."),
     aula: z
         .any()
         .optional()
-        .describe("Objeto completo da aula (obrigatório pra upsert). Campos top-level: title (obrig), subtitle?, data? (YYYY-MM-DD), duration?, tag?, mentorAgenda?, slides[] (≥1). Cada slide é { type, ...campos }. Tipos: cover (eyebrow/title/subtitle/meta), cover-image/section-image/content-image (imageUrl + campos), agenda (items:[{num,title,subtitle,time}]), content (eyebrow/title/body[markdown ou HTML]/list[]/listType), two-col (cols:[{h,body}]), quote (text/attribution), callout (tone:tip|warn|note/tag/body), comic (panels:[{imageUrl,caption}]), pause, close (eyebrow/title/items[]). Voz Sapiens: 1ª pessoa, anti-corporate, SEM travessão (—). O servidor re-linta a voz e grava voiceWarnings."),
+        .describe("Objeto completo da aula (obrigatório pra upsert). Campos top-level: title (obrig), subtitle?, data? (YYYY-MM-DD), duration?, tag?, mentorAgenda?, slides[] (≥1). Cada slide é { type, ...campos }. Tipos: cover (eyebrow/title/subtitle/meta), cover-image/section-image/content-image (imageUrl + campos), agenda (items:[{num,title,subtitle,time}]), content (eyebrow/title/body[markdown ou HTML]/list[]/listType), two-col (cols:[{h,body}]), video (videoUrl OU videos:[{h,videoUrl,caption}] pra comparar lado a lado), quote (text/attribution), callout (tone:tip|warn|note/tag/body), comic (panels:[{imageUrl,caption}]), pause, close (eyebrow/title/items[]). Voz Sapiens: 1ª pessoa, anti-corporate, SEM travessão (—). O servidor re-linta a voz e grava voiceWarnings."),
+    moduleId: z
+        .string()
+        .optional()
+        .describe("id do módulo dentro da fonte (kebab-case, ex: folha-tres-takes). Obrigatório pra module, module-save e recipe-op. Descubra os ids com action=map."),
+    module: z
+        .any()
+        .optional()
+        .describe("action=module-save: o módulo inteiro { id, title, concept, audience[], slides[] }. Mesmo shape de slide do `aula.slides`. Omita (ou mande null) pra REMOVER o módulo da fonte e de todos os blocos."),
+    placeAfter: z
+        .string()
+        .optional()
+        .describe("action=module-save de módulo NOVO: id de um módulo já na receita; o novo entra logo depois dele, no mesmo bloco. Alternativa ao `bloco`."),
+    bloco: z
+        .string()
+        .optional()
+        .describe("Título do bloco da receita (ex: 'A Folha'). Em module-save de módulo novo, entra no fim desse bloco. Em recipe-op, é o bloco de destino."),
+    op: z
+        .enum(["move", "remove", "add"])
+        .optional()
+        .describe("action=recipe-op: 'move' reordena (use toIndex, e bloco pra mudar de bloco), 'remove' tira o módulo da aula sem apagar o conteúdo dele da fonte, 'add' cita na receita um módulo que já existe na fonte."),
+    toIndex: z
+        .number()
+        .optional()
+        .describe("action=recipe-op op=move|add: posição (0 = primeiro do bloco). Sem ele, vai pro fim."),
+    title: z.string().optional().describe("action=meta: novo título."),
+    subtitle: z.string().optional().describe("action=meta: novo subtítulo."),
+    tag: z.string().optional().describe("action=meta: série/etiqueta (ex: 'Produção · Vídeo dirigido')."),
+    data: z.string().optional().describe("action=meta: data YYYY-MM-DD."),
+    duration: z.string().optional().describe("action=meta: duração legível (ex: '3h30')."),
+    status: z
+        .enum(["draft", "published"])
+        .optional()
+        .describe("action=meta: 'draft' tira do ar (só admin vê), 'published' põe no ar."),
+    force: z
+        .boolean()
+        .optional()
+        .describe("action=delete: apaga mesmo estando publicada. Sem isso, aula no ar é recusada e o caminho é tirar de circulação antes (action=meta status=draft)."),
 });
 export async function aula(args) {
     const sessionToken = getSessionToken();
@@ -36,12 +94,62 @@ export async function aula(args) {
             });
             return found ? { found: true, aula: found } : { found: false, slug };
         }
+        case "map":
+            return await convexQuery("mcpExtras:mcpAulaMap", {
+                sessionToken,
+                slug: need(args.slug, "slug"),
+            });
+        case "module":
+            return await convexQuery("mcpExtras:mcpAulaModule", {
+                sessionToken,
+                slug: need(args.slug, "slug"),
+                moduleId: need(args.moduleId, "moduleId"),
+            });
+        case "module-save": {
+            // `module` é z.any(): cliente costuma serializar objeto sem tipo como
+            // string JSON. Normaliza aqui (o servidor também parseia, mas o shape
+            // certo sai daqui). Ausente vira null: é o sinal de remoção.
+            let mod = args.module;
+            if (typeof mod === "string") {
+                try {
+                    mod = JSON.parse(mod);
+                }
+                catch {
+                    throw new Error('Arg "module" veio como string mas não é JSON válido.');
+                }
+            }
+            return await convexMutation("mcpExtras:mcpAulaModuleSave", {
+                sessionToken,
+                slug: need(args.slug, "slug"),
+                moduleId: need(args.moduleId, "moduleId"),
+                module: mod ?? null,
+                placeAfter: args.placeAfter,
+                bloco: args.bloco,
+            });
+        }
+        case "recipe-op":
+            return await convexMutation("mcpExtras:mcpAulaRecipeOp", {
+                sessionToken,
+                slug: need(args.slug, "slug"),
+                op: need(args.op, "op"),
+                moduleId: need(args.moduleId, "moduleId"),
+                bloco: args.bloco,
+                toIndex: args.toIndex,
+            });
+        case "meta":
+            return await convexMutation("mcpExtras:mcpAulaMeta", {
+                sessionToken,
+                slug: need(args.slug, "slug"),
+                title: args.title,
+                subtitle: args.subtitle,
+                tag: args.tag,
+                data: args.data,
+                duration: args.duration,
+                status: args.status,
+            });
         case "upsert": {
             const slug = need(args.slug, "slug");
             const raw = need(args.aula, "aula");
-            // `aula` é z.any(): sem tipo declarado, o cliente costuma serializar o
-            // objeto como string JSON. Normaliza aqui pra mandar objeto sempre (o
-            // servidor também parseia string, mas o shape certo sai daqui).
             let aulaObj = raw;
             if (typeof aulaObj === "string") {
                 try {
@@ -57,5 +165,13 @@ export async function aula(args) {
                 aula: aulaObj,
             });
         }
+        case "delete":
+            // Sem undo do lado do servidor: quem quiser guardar o conteúdo puxa
+            // action=get antes. Aula publicada é recusada até vir force.
+            return await convexMutation("mcpExtras:mcpDeleteAula", {
+                sessionToken,
+                slug: need(args.slug, "slug"),
+                force: args.force,
+            });
     }
 }

package/dist/tools/character.js

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

package/dist/tools/reference.js

@@ -7,13 +7,19 @@ import { convexAction, convexQuery, getSessionToken } from "../convexClient.js";
  * navegar os bancos e pegar o que vira referência em imagem (sapiens_image) ou
  * vídeo (sapiens_video).
  *
- * Buckets (os 4 tabs do popup, completos):
+ * As duas são a MESMA porta em transportes diferentes (browser e agente), e a
+ * lei das duas mora em `apps/sapiens/PICKER_PATTERNS.md`. A invariante que
+ * importa aqui: banco novo no picker web nasce com bucket irmão neste arquivo,
+ * senão o agente enxerga menos que o browser e a paridade quebra em silêncio.
+ *
+ * Buckets (as abas do popup, completas):
  *   - history    imagens recentes do user (privadas + públicas)
  *   - favorites  imagens que o user curtiu (só as suas)
  *   - videos     vídeos do user (Meus Vídeos)
  *   - stock_video Banco de Vídeo da casa (clipes/B-roll); aceita `term`/`orientation`/`loopOnly`
  *   - acervo     stock + comunidade de IMAGEM (público); aceita `term` (busca) e `source`
  *   - characters personagens; `mode` = 'mine' (default) ou 'public'
+ *   - deepshadow guias de movimento; `shadowSource` = 'house' (banco curado, default) ou 'mine'
  *
  * Cada item volta normalizado:
  *   - imagem PRÓPRIA (history/favorites): `imageId` + `url` → use imageId em
@@ -28,11 +34,12 @@ export const referenceSchema = z.object({
         .describe("'browse' navega um bucket do acervo; 'resolve' acha UM asset pelo ID citável (handle <tipo>_<id>) " +
         "e diz se é seu / público + devolve a url pra usar de referência."),
     bucket: z
-        .enum(["history", "favorites", "videos", "stock_video", "acervo", "characters"])
+        .enum(["history", "favorites", "videos", "stock_video", "acervo", "characters", "deepshadow"])
         .optional()
         .describe("Só 'browse': qual banco navegar: 'history' (suas imagens recentes), 'favorites' (as que você curtiu), " +
         "'videos' (seus vídeos), 'stock_video' (Banco de Vídeo da casa: clipes/B-roll prontos, aceita term/orientation/loopOnly), " +
-        "'acervo' (stock + comunidade públicos de IMAGEM), 'characters' (personagens)."),
+        "'acervo' (stock + comunidade públicos de IMAGEM), 'characters' (personagens), " +
+        "'deepshadow' (guias de movimento: os SEUS com shadowSource='mine', ou o banco curado da casa por default)."),
     handle: z
         .string()
         .optional()
@@ -60,6 +67,10 @@ export const referenceSchema = z.object({
         .enum(["all", "stock", "community"])
         .optional()
         .describe("Só bucket 'acervo': fonte. Default 'all' (stock + comunidade)."),
+    shadowSource: z
+        .enum(["mine", "house"])
+        .optional()
+        .describe("Só bucket 'deepshadow': 'mine' (os que VOCÊ extraiu) ou 'house' (o banco curado da casa, default)."),
     orientation: z
         .enum(["vertical", "horizontal", "square"])
         .optional()
@@ -97,7 +108,7 @@ export async function reference(args) {
     if (args.action === "browse") {
         if (!args.bucket) {
             return {
-                error: "browse exige `bucket` (history | favorites | videos | stock_video | acervo | characters).",
+                error: "browse exige `bucket` (history | favorites | videos | stock_video | acervo | characters | deepshadow).",
             };
         }
         const res = await convexAction("mcpReferences:referenceBrowse", {
@@ -110,6 +121,7 @@ export async function reference(args) {
             orientation: args.orientation,
             loopOnly: args.loopOnly,
             mode: args.mode,
+            shadowSource: args.shadowSource,
         });
         let note;
         if (args.bucket === "videos") {
@@ -120,6 +132,10 @@ export async function reference(args) {
             note =
                 "Clipes do Banco de Vídeo da casa (B-roll pronto). Use a `url` do clipe: como referência de vídeo em sapiens_video (mesma rail do Meus Vídeos), de fundo/atmosfera, ou baixe direto. orientation/durationSeconds/loopFriendly ajudam a escolher. Não são imagem: NÃO servem de frame inicial/final (pra frame use uma IMAGEM).";
         }
+        else if (args.bucket === "deepshadow") {
+            note =
+                "Guias de movimento (mapa de profundidade). Use a `url` em sapiens_video referenceVideoUrls: a coreografia e a câmera do clipe guiam o take. `thumbnailUrl` é só preview (a soma com esqueleto), nunca mande ela como driving. Teto de duração varia por motor.";
+        }
         else if (args.bucket === "acervo" || args.bucket === "characters") {
             note =
                 "São referências públicas: use a `url` (characters trazem mainImageUrl + imageUrls) em sapiens_image referenceImageUrls, ou em sapiens_video startImageUrl/endImageUrl. Não são suas, então NÃO entram em sourceImageIds.";

package/dist/tools/semana.js

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

package/dist/tools/studios.js

@@ -15,7 +15,7 @@ import { convexAction, convexQuery, getSessionToken } from "../convexClient.js";
 export const studiosSchema = z.object({
     action: z
         .enum(["list", "get", "publishable_url", "mine", "emancipar", "module"])
-        .describe("mine = o SEU studio ('Meu Studio', singular): nível, marca, operador e ferramentas, pra você gerar com useStudio. list/get = catálogo de estúdios da casa. publishable_url = URL de artigo. " +
+        .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)."),
     studio: z
@@ -149,15 +149,18 @@ const STUDIOS = {
     },
 };
 export async function studios(args) {
-    // action=mine: o STUDIO do user logado (o "Meu Studio", singular), resumo
-    // non-PII pro Claude saber o que está montado antes de gerar com useStudio.
+    // 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.
     if (args.action === "mine") {
         const sessionToken = getSessionToken();
         const studio = await convexAction("desktopMcp:studioMine", { sessionToken });
         if (!studio) {
             return {
                 studio: null,
-                note: "Você ainda não tem um studio. Crie em sapiensinteticos.com/dashboard/studio, escolha as ferramentas e ancore a sua marca.",
+                note: "Você ainda não fundou um studio. Funde o seu em sapiensinteticos.com/dashboard/studio: ele vira uma página pública com a sua obra e o seu time.",
             };
         }
         return { studio };

package/dist/tools/video.js

@@ -18,7 +18,7 @@ import { httpUrl } from "../schema.js";
  *               URL e guarda no Acervo (Corpo) como deepshadow reutilizável.
  *               200 Sinapses/segundo (durationSec; sem ela, flat 2000). Refund se falhar.
  *   - shadows-list: (ADMIN) lista o banco de motion (deepshadows + guias de corpo)
- *               com as duas views por ficha: url = sombra pura (driving pros
+ *               com as duas views por ficha: url = deepshadow puro (driving pros
  *               geradores) e skeletonUrl = a soma (sombras + esqueleto, preview
  *               humano que separa personagem de objeto). Sem custo.
  *   - sonorize: dá som a um clipe SEU já gerado (MMAudio v2): imageId + prompt do
@@ -26,7 +26,7 @@ import { httpUrl } from "../schema.js";
  *               fica intacto). Cobra por segundo do clipe; poll via action=status.
  *
  * Vídeos Programáticos (Estúdio de Vídeo, /experimentos/films) — ADMIN, sem custo.
- * A mesa de specs da casa (tabela videoSpecs, 5 kinds: demo | aula-tour | essay |
+ * O Lab de specs da casa (tabela videoSpecs, 5 kinds: demo | aula-tour | essay |
  * tipografia-musical | dataviz). A PRODUÇÃO do mp4 segue no agente local (skill
  * /film, repo films/); estas actions fecham o CICLO na plataforma sem browser:
  *   - film-list:    lista os specs (todos os kinds; filtros filmKind/filmStatus).
@@ -67,12 +67,20 @@ import { httpUrl } from "../schema.js";
  *                                   seu e o prompt edita a MESMA cena (troca item/personagem preservando
  *                                   o resto). Não aceita mídia do user (ignora references/durationSec/resolution).
  *
+ * FORA DE PROPÓSITO: o `sapiens-video-seedance-fast` (Seedance 1.0 Fast, piso 600)
+ * está ativo no catálogo do backend mas NÃO entra neste enum. Ele é geração velha:
+ * sem áudio, sem referência e sem frame final. Economiza 200 sinapses no piso contra
+ * o 1.5 Pro e perde três capacidades. Quem quer queimar tentativa barata usa o
+ * `sapiens-video-seedance-2-mini`, que custa metade do 2.0 com o repertório inteiro.
+ * Não "conserte" essa ausência: ela é decisão (29/jul/2026).
+ *
  * Custo: server-side por config (duração x resolução [x áudio]). i2v/motion usam
  * `references` em base64 (role 'start' = imagem inicial, 'end' = frame final,
  * 'driving' = vídeo de movimento do Motion).
  *
  * Retorna `{ success, url, imageId, cost }` ou `{ success: false, error }`.
  */
+// "sapiens-video-seedance-fast" (1.0 Fast) fica de fora de propósito, ver bloco acima.
 const VIDEO_MODELS = [
     "sapiens-video-seedance-15",
     "sapiens-video-seedance",
@@ -107,7 +115,7 @@ export const videoSchema = z.object({
         "film-publish",
         "film-delete",
     ]),
-    // --- Vídeos Programáticos (film-*): mesa de specs da casa, ADMIN, sem custo ---
+    // --- Vídeos Programáticos (film-*): Lab de specs da casa, ADMIN, sem custo ---
     filmKind: z
         .enum(FILM_KINDS)
         .optional()
@@ -144,7 +152,7 @@ export const videoSchema = z.object({
     search: z
         .string()
         .optional()
-        .describe("action=shadows-list: filtro de busca opcional (título/tags). Sem ele, lista o banco inteiro (até 300). Cada item traz url (sombra pura, driving) e skeletonUrl (soma com esqueleto, preview humano) quando existe."),
+        .describe("action=shadows-list: filtro de busca opcional (título/tags). Sem ele, lista o banco inteiro (até 300). Cada item traz url (deepshadow puro, driving) e skeletonUrl (soma com esqueleto, preview humano) quando existe."),
     // --- action=showcase (curadoria da vitrine /conectar-claude) ---
     slug: z
         .string()
@@ -262,7 +270,7 @@ export const videoSchema = z.object({
         .describe("action=create (só Seedance): 1 URL pública (host da casa) de um VÍDEO DE MOVIMENTO (role 'refvideo' -> reference_videos, <=15s): " +
         "a coreografia/câmera do clipe GUIA o take sem ser recriado plano a plano (isso é o Shot Mimic). " +
         "Combina com o fluxo storyboard: folha = beats, vídeo = movimento, personagem = identidade. " +
-        "Sombras do banco de motion servem direto (ADMIN: descubra com action=shadows-list)."),
+        "Deepshadows do banco de motion servem direto (ADMIN: descubra com action=shadows-list)."),
     // Frame inicial/final por ARQUIVO LOCAL (paridade com o upload do gerador do
     // site). Só no MCP instalado (stdio): o processo lê o arquivo do disco e sobe
     // como reference role 'start'/'end', sem o base64 passar pelo contexto do
@@ -390,7 +398,7 @@ export async function video(args) {
     if (args.action === "demos") {
         return await convexQuery("videoSpecs:mcpListMyDemoFilms", { sessionToken });
     }
-    // --- Vídeos Programáticos (mesa de specs, ADMIN, sem custo) ---
+    // --- Vídeos Programáticos (Lab de specs, ADMIN, sem custo) ---
     if (args.action === "film-list") {
         return await convexQuery("videoSpecs:mcpListMyVideoSpecs", {
             sessionToken,

package/package.json

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