sapiens-mcp 1.33.0 → 1.35.0

package/dist/registry.js

@@ -38,7 +38,7 @@ import { describeConvexError } from "./convexClient.js";
  */
 export const TOOLS = {
     sapiens_pipeline: {
-        description: "CRUD do content pipeline Sapiens (sources/productions/publishables). Sub-actions: list_sources, list_articles (use includeDrafts pra incluir drafts; onlyAvailable pra esconder os já virados em source), get_source, get_production, list_versions, add_article_as_source, create_draft_article_and_source (seed), create_production (sourceId+format → productionId draft), update_production (substitui payload, opcionalmente muda status), finalize_production (cria publishable v1, v2... com snapshot), remove_production, remove_source, set_source_done, update_source_notes, restore_version (volta payload duma versão antiga), set_publishable_title (renomeia um publishable), backfill_via (rotula em lote o campo 'via' das productions antigas; dryRun=true só lista), propose_mega_grafico_plan (granular: só gera plano via Gemini, devolve fullPrompt+spec), run_mega_grafico_full (ONE-SHOT, recomendado: cria production+propõe plano+gera imagem+aplica selo Sapiens+finaliza publishable numa chamada só), generate_carousel (gera um carrossel editorial standalone a partir de brief OU articleId — 7-9 slides na voz Sapiens + imagens do banco; devolve id + url do editor pro humano abrir, ajustar e exportar; admin-only, cobra Sinapses, reembolsa se falhar). Pra mega_grafico, SEMPRE prefira run_mega_grafico_full em vez de sequenciar manualmente (menos drift). Idempotente só na production (passa productionId pra reusar a MESMA row), mas cada run RE-GERA a imagem e cobra de novo (~900 Sinapses): não é grátis re-rodar. OBRIGATÓRIO perguntar ao user antes se withHelen=true (cartoon Helen interage com tema, ~15-25% do poster) ou false (poster 100% diagramático). Custo ~900-1000 sinapses por geração. run_mega_grafico_full e generate_carousel são SÍNCRONAS e pesadas: vale a REGRA DO TIMEOUT (podem cobrar mesmo voltando 'Timeout'; cheque /dashboard/admin/content antes de repetir). Use skipFinalize=true se quiser deixar production em 'ready' pro admin revisar antes de publishable. Payload livre por formato — chame sapiens_meta action=formats pra ver schemas sugeridos.",
+        description: "CRUD do content pipeline Sapiens (sources/productions/publishables). Sub-actions: list_sources, list_articles (use includeDrafts pra incluir drafts; onlyAvailable pra esconder os já virados em source), get_source, get_production, list_versions, add_article_as_source, create_draft_article_and_source (seed), create_production (sourceId+format → productionId draft), update_production (substitui payload, opcionalmente muda status), finalize_production (cria publishable v1, v2... com snapshot), remove_production, remove_source, set_source_done, update_source_notes, restore_version (volta payload duma versão antiga), set_publishable_title (renomeia um publishable), backfill_via (rotula em lote o campo 'via' das productions antigas; dryRun=true só lista), propose_mega_grafico_plan (granular: só gera plano via Gemini, devolve fullPrompt+spec), run_mega_grafico_full (ONE-SHOT, recomendado: cria production+propõe plano+gera imagem+aplica selo Sapiens+finaliza publishable numa chamada só), generate_carousel (gera um carrossel editorial standalone a partir de brief OU articleId — 7-9 slides na voz Sapiens + imagens do banco; devolve id + url do editor pro humano abrir, ajustar e exportar; admin-only, cobra Sinapses, reembolsa se falhar). CARROSSEL FINO (edição sem tela, admin-only): list_carousels (seus carrosséis standalone), get_carousel (payload completo + catálogo de templates com slots/limites + paletas — tudo pra VOCÊ escrever os slides), update_carousel (payload inteiro de volta, sanitizado no servidor; preserve os campos image dos slides que não mexeu), carousel_auto_images (IA escolhe imagens do banco pros slides de foto, 60 Sinapses; makeVisual=true converte slides de texto pra layouts de foto antes — ritmo visual; generateMissing=true gera imagem nova pros que o banco não cobrir, ~450 Sinapses cada, até 4, avise o custo antes), carousel_generate_image (imagem nova pra UM slide, ~450 Sinapses, customPrompt opcional). Fluxo confortável: generate_carousel → get_carousel → update_carousel (afia os textos) → carousel_auto_images → humano abre a url pra exportar. Pra mega_grafico, SEMPRE prefira run_mega_grafico_full em vez de sequenciar manualmente (menos drift). Idempotente só na production (passa productionId pra reusar a MESMA row), mas cada run RE-GERA a imagem e cobra de novo (~900 Sinapses): não é grátis re-rodar. OBRIGATÓRIO perguntar ao user antes se withHelen=true (cartoon Helen interage com tema, ~15-25% do poster) ou false (poster 100% diagramático). Custo ~900-1000 sinapses por geração. run_mega_grafico_full, generate_carousel, carousel_auto_images (com generateMissing) e carousel_generate_image são SÍNCRONAS e pesadas: vale a REGRA DO TIMEOUT (podem cobrar mesmo voltando 'Timeout'; cheque get_carousel/dashboard antes de repetir). Use skipFinalize=true se quiser deixar production em 'ready' pro admin revisar antes de publishable. Payload livre por formato — chame sapiens_meta action=formats pra ver schemas sugeridos.",
         schema: pipelineSchema,
         handler: pipeline,
     },
@@ -113,7 +113,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), '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. 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. 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 pro 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), '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. 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 pro 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).",
         schema: videoSchema,
         handler: video,
     },
@@ -212,7 +212,7 @@ Efeito sonoro (sapiens_stock_audio): primeiro procure pronto (action=list kind=s
 
 Sonorizar clipe (sapiens_video action=sonorize): dá som a um vídeo SEU já gerado (status completed). Passe imageId + prompt descrevendo o som da cena (ambiente, materiais, impactos); sai uma VARIANTE nova com trilha sincronizada ao movimento (MMAudio, 20 Sinapses/s do clipe, mín 100), o original fica intacto. Acompanhe com action=status no imageId NOVO que o sonorize devolve. Não re-sonorize uma variante: sonorize sempre o original.
 
-Vídeo (sapiens_video) action=create EXIGE 'model': sapiens-video-seedance | kling | wan | kling-motion | lite | fast | quality | omni. Sem model, falha de cara. O 'omni' (Gemini Omni) gera clipe de 10s 720p com áudio nativo a partir de TEXTO (não aceita imagem/vídeo do user, ignora duração/resolução) e EDITA os próprios vídeos: passe editOfImageId com o imageId de um vídeo Omni já gerado e o prompt vira instrução de edição sobre a MESMA cena (troca item/personagem, preserva câmera e ambiente; cada edição debita como geração nova). É o caminho pra variações com continuidade: gera a base uma vez, edita N vezes. Vídeo é o mais caro: confirme com o usuário antes. action=shadows (ADMIN, 200 Sinapses/segundo, refund na falha): passa videoUrl (URL pública) + title (+ durationSec se souber, pra cobrar proporcional; sem ela, flat ~2000) e o servidor extrai a SOMBRA (mapa de profundidade) do vídeo e guarda no Acervo (Corpo) como deepshadow reutilizável (driving pro Shot Mimic/Kling Motion). FILMES DA CASA (Estúdio de Vídeo, tela /experimentos/films): são OUTRA coisa, três kinds na tabela videoSpecs: demo (UI clonada + câmera), aula-tour (telas reais + narração) e essay (fita-ensaio abstrata: partícula/tinta vira símbolo, com a logo explodindo no fim; narração da casa OPCIONAL, sai em 16:9 ou 9:16 vertical, e o filme final é limpo, sem rótulos de produção). Eles NÃO são gerados por este MCP: o user monta o spec na tela e um agente local (Claude Code, skill /film) produz o mp4 no repo da casa. Se o user pedir 'fita-ensaio' ou 'demo film' aqui, aponte pra tela e pro agente local.
+Vídeo (sapiens_video) action=create EXIGE 'model': sapiens-video-seedance | kling | wan | kling-motion | lite | fast | quality | omni. Sem model, falha de cara. O 'omni' (Gemini Omni) gera clipe de 10s 720p com áudio nativo a partir de TEXTO (não aceita imagem/vídeo do user, ignora duração/resolução) e EDITA os próprios vídeos: passe editOfImageId com o imageId de um vídeo Omni já gerado e o prompt vira instrução de edição sobre a MESMA cena (troca item/personagem, preserva câmera e ambiente; cada edição debita como geração nova). É o caminho pra variações com continuidade: gera a base uma vez, edita N vezes. Vídeo é o mais caro: confirme com o usuário antes. action=shadows (ADMIN, 200 Sinapses/segundo, refund na falha): passa videoUrl (URL pública) + title (+ durationSec se souber, pra cobrar proporcional; sem ela, flat ~2000) e o servidor extrai a SOMBRA (mapa de profundidade) do vídeo e guarda no Acervo (Corpo) como deepshadow reutilizável (driving pro Shot Mimic/Kling Motion). VÍDEOS PROGRAMÁTICOS (Estúdio de Vídeo, tela /experimentos/films): são OUTRA coisa, a mesa de filmes-de-código da casa, CINCO kinds na tabela videoSpecs: demo (UI clonada + câmera), aula-tour (telas reais + narração), essay (fita-ensaio abstrata: partícula/tinta vira símbolo; narração opcional, 16:9 ou 9:16), tipografia-musical (clipe tipográfico, a música dirige o corte) e dataviz (barras/números no tempo). O RENDER não sai deste MCP: um agente local (Claude Code, skill /film) produz o mp4 no repo da casa. Mas o CICLO na plataforma fecha por aqui (ADMIN, sem custo): film-list/film-get puxam os specs, film-upsert registra/atualiza, film-status cola a URL do render e marca pronto, film-publish põe no Acervo. User comum pedindo 'fita-ensaio'/'demo film': aponte pra tela e pro agente local.
 
 Imagem (sapiens_image) action=generate: prompt + model + aspectRatio. Referência via referenceImageUrls (galeria/Acervo/personagens) e/ou sourceImageIds. templateSlug aplica um super-prompt travado da casa. PROMPT na regra da casa: full-bleed, sujeito oversized (70%+ do frame), sem "tarot card"/"intimate scale"/moldura/margem. action=models (sem custo, sem login) lista os modelos ativos com o preço atual: consulte quando não tiver certeza do modelo ou do custo.
 

package/dist/tools/pipeline.js

@@ -43,6 +43,11 @@ export const pipelineSchema = z.object({
         "propose_mega_grafico_plan",
         "run_mega_grafico_full",
         "generate_carousel",
+        "list_carousels",
+        "get_carousel",
+        "update_carousel",
+        "carousel_auto_images",
+        "carousel_generate_image",
     ]),
     // propose_mega_grafico_plan / run_mega_grafico_full
     withHelen: z
@@ -83,6 +88,31 @@ export const pipelineSchema = z.object({
         .boolean()
         .optional()
         .describe("generate_carousel: se TRUE, a voz do Sintético do dono dirige o copy (amplificar). Default false = estilo do dono."),
+    // carrossel standalone (get/update/imagens)
+    carouselId: z
+        .string()
+        .optional()
+        .describe("carousels_standalone:_id — get_carousel/update_carousel/carousel_auto_images/carousel_generate_image. Vem de generate_carousel ou list_carousels."),
+    slideId: z
+        .string()
+        .optional()
+        .describe("carousel_generate_image: id do slide (ex: 'slide-3'), do payload do get_carousel."),
+    force: z
+        .boolean()
+        .optional()
+        .describe("carousel_auto_images: TRUE substitui as imagens já aplicadas por escolhas novas. Default false = preenche só o que falta."),
+    makeVisual: z
+        .boolean()
+        .optional()
+        .describe("carousel_auto_images: TRUE converte slides de texto pra layouts de foto antes de escolher (ritmo visual pro carrossel texto-pesado). O texto fica, muda a moldura."),
+    generateMissing: z
+        .boolean()
+        .optional()
+        .describe("carousel_auto_images: TRUE gera imagem NOVA (nanoBanana, ~450 Sinapses cada, até 4) pros slides que o banco não cobriu. O fallback stock→gerador. Avise o usuário do custo antes."),
+    customPrompt: z
+        .string()
+        .optional()
+        .describe("carousel_generate_image: direção extra da cena (opcional; sem ela a IA usa o texto do slide)."),
     // list_articles
     includeDrafts: z.boolean().optional(),
     includeArchived: z.boolean().optional(),
@@ -353,5 +383,46 @@ export async function pipeline(args) {
                 useSintetico: args.useSintetico,
             });
         }
+        case "list_carousels":
+            // Carrosséis standalone do dono (id + título + url do editor).
+            return await convexQuery("carouselMcp:mcpListCarousels", { sessionToken });
+        case "get_carousel":
+            // Devolve payload completo + catálogo de templates (id/slots/limites) +
+            // paletas válidas: tudo que você precisa pra ESCREVER os slides direto.
+            return await convexQuery("carouselMcp:mcpGetCarousel", {
+                sessionToken,
+                carouselId: need(args.carouselId, "carouselId"),
+            });
+        case "update_carousel":
+            // Payload INTEIRO (mesmo shape do get_carousel). Sanitizado no servidor.
+            // Preserve os campos image dos slides que você não mexeu — mandar slide
+            // sem image derruba a foto dele.
+            return await convexMutation("carouselMcp:mcpUpdateCarousel", {
+                sessionToken,
+                carouselId: need(args.carouselId, "carouselId"),
+                payload: coercePayloadArg(need(args.payload, "payload")),
+                ...(args.title ? { title: args.title } : {}),
+            });
+        case "carousel_auto_images":
+            // IA escolhe imagens do banco pros slides de foto sem imagem (60 Sinapses).
+            // makeVisual dá ritmo a carrossel texto-pesado; generateMissing gera as que
+            // o banco não cobriu (custo por imagem). SÍNCRONA e pesada com
+            // generateMissing: vale a REGRA DO TIMEOUT.
+            return await convexAction("carouselAutofill:mcpCarouselAutoImages", {
+                sessionToken,
+                carouselId: need(args.carouselId, "carouselId"),
+                force: args.force,
+                makeVisual: args.makeVisual,
+                generateMissing: args.generateMissing,
+            });
+        case "carousel_generate_image":
+            // Gera imagem NOVA pra UM slide (nanoBanana, ~450 Sinapses) e salva no
+            // carrossel. SÍNCRONA (~20-60s): vale a REGRA DO TIMEOUT.
+            return await convexAction("carouselAutofill:mcpCarouselGenerateImage", {
+                sessionToken,
+                carouselId: need(args.carouselId, "carouselId"),
+                slideId: need(args.slideId, "slideId"),
+                ...(args.customPrompt ? { customPrompt: args.customPrompt } : {}),
+            });
     }
 }

package/dist/tools/video.js

@@ -25,6 +25,17 @@ import { httpUrl } from "../schema.js";
  *               som da cena -> VARIANTE nova com trilha sincronizada (o original
  *               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 |
+ * 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).
+ *   - film-get:     um spec inteiro por slug (payload pronto pra produção).
+ *   - film-upsert:  cria/atualiza spec por slug (idempotente; validação server).
+ *   - film-status:  status/URL do render/duração por slug (fecho: pronto+URL).
+ *   - film-publish: publica/despublica no Acervo (aba Fitas) + portfólio.
+ *   - film-delete:  apaga um spec (limpar rascunho/duplicata).
+ *
  * Modelos (action=create):
  *   - sapiens-video-seedance       Seedance 2.0 — cena com áudio nativo, 4-15s, 480/720/1080p (t2v/i2v)
  *   - sapiens-video-kling          Kling 3.0 Pro — dá vida a uma imagem, 3-15s, sound opcional (i2v/t2v)
@@ -56,12 +67,56 @@ const VIDEO_MODELS = [
     "sapiens-video-quality",
     "sapiens-video-omni",
 ];
+const FILM_KINDS = ["demo", "aula-tour", "essay", "tipografia-musical", "dataviz"];
+const FILM_STATUSES = ["rascunho", "na_fila", "renderizando", "pronto"];
 export const videoSchema = z.object({
-    action: z.enum(["create", "generate", "status", "models", "demos", "showcase", "shadows", "shadows-list", "sonorize"]),
+    action: z.enum([
+        "create",
+        "generate",
+        "status",
+        "models",
+        "demos",
+        "showcase",
+        "shadows",
+        "shadows-list",
+        "sonorize",
+        "film-list",
+        "film-get",
+        "film-upsert",
+        "film-status",
+        "film-publish",
+        "film-delete",
+    ]),
+    // --- Vídeos Programáticos (film-*): mesa de specs da casa, ADMIN, sem custo ---
+    filmKind: z
+        .enum(FILM_KINDS)
+        .optional()
+        .describe("film-list: filtra por kind (demo | aula-tour | essay | tipografia-musical | dataviz)."),
+    filmStatus: z
+        .enum(FILM_STATUSES)
+        .optional()
+        .describe("film-status: novo status de produção (rascunho | na_fila | renderizando | pronto). " +
+        "film-list: filtra por status. O fecho do render é film-status com filmStatus='pronto' + videoUrl + durationSec."),
+    spec: z
+        .record(z.any())
+        .optional()
+        .describe("film-upsert: o spec inteiro como objeto JSON (validação fica no servidor, fonte única). " +
+        "Shape: { kind, musicMode ('default'|'file'|'track'), musicRef?, aulaSlug? (só aula-tour), " +
+        "e o payload do kind: demo | aulaTour | essay | tipoMusical | dataviz }. " +
+        "Mesmo shape do 'Copiar spec' da tela /experimentos/films; descubra um exemplo real com film-get."),
+    published: z
+        .boolean()
+        .optional()
+        .describe("film-publish: true publica no Acervo (aba Fitas) + portfólio (exige pronto + videoUrl), false despublica."),
+    durationSecMeasured: z
+        .number()
+        .optional()
+        .describe("film-status: duração MEDIDA do render em segundos (ffprobe), vira a duração do card."),
     // --- action=shadows (deepshadows: extrai o mapa de profundidade de um vídeo) ---
     videoUrl: httpUrl()
         .optional()
-        .describe("action=shadows: URL pública (http/https) do vídeo-fonte. O servidor extrai a SOMBRA (depth) e guarda no Acervo (Corpo). ADMIN, 200 Sinapses/segundo (refund na falha)."),
+        .describe("action=shadows: URL pública (http/https) do vídeo-fonte. O servidor extrai a SOMBRA (depth) e guarda no Acervo (Corpo). ADMIN, 200 Sinapses/segundo (refund na falha). " +
+        "film-status: a URL https do render no CDN (Bunny), o que acende o player do card."),
     title: z
         .string()
         .optional()
@@ -74,7 +129,9 @@ export const videoSchema = z.object({
     slug: z
         .string()
         .optional()
-        .describe("action=showcase: slug do demo film a curar (descubra via action=demos)."),
+        .describe("action=showcase: slug do demo film a curar (descubra via action=demos). " +
+        "film-get/film-status/film-publish/film-delete: slug do spec (descubra via film-list). " +
+        "film-upsert: slug fixo do filme no repo films/ (idempotente: existe = atualiza, não existe = cria com esse slug); omita pra criar com slug gerado."),
     showcase: z
         .boolean()
         .optional()
@@ -196,6 +253,69 @@ 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) ---
+    if (args.action === "film-list") {
+        return await convexQuery("videoSpecs:mcpListMyVideoSpecs", {
+            sessionToken,
+            kind: args.filmKind,
+            status: args.filmStatus,
+        });
+    }
+    if (args.action === "film-get") {
+        if (!args.slug)
+            throw new Error("film-get exige slug (descubra via film-list).");
+        return await convexQuery("videoSpecs:mcpGetVideoSpec", { sessionToken, slug: args.slug });
+    }
+    if (args.action === "film-upsert") {
+        if (!args.spec || typeof args.spec !== "object") {
+            throw new Error("film-upsert exige spec (objeto JSON com kind + musicMode + payload do kind: demo | aulaTour | essay | tipoMusical | dataviz).");
+        }
+        const { kind, musicMode, musicRef, aulaSlug, demo, aulaTour, essay, tipoMusical, dataviz } = args.spec;
+        return await convexMutation("videoSpecs:mcpUpsertVideoSpec", {
+            sessionToken,
+            slug: args.slug,
+            kind,
+            musicMode: musicMode ?? "default",
+            musicRef,
+            aulaSlug,
+            demo,
+            aulaTour,
+            essay,
+            tipoMusical,
+            dataviz,
+        });
+    }
+    if (args.action === "film-status") {
+        if (!args.slug)
+            throw new Error("film-status exige slug (descubra via film-list).");
+        if (args.filmStatus === undefined && args.videoUrl === undefined && args.durationSecMeasured === undefined) {
+            throw new Error("film-status: passe filmStatus, videoUrl e/ou durationSecMeasured (o fecho do render é os três).");
+        }
+        return await convexMutation("videoSpecs:mcpSetVideoStatus", {
+            sessionToken,
+            slug: args.slug,
+            status: args.filmStatus,
+            videoUrl: args.videoUrl,
+            durationSec: args.durationSecMeasured,
+        });
+    }
+    if (args.action === "film-publish") {
+        if (!args.slug)
+            throw new Error("film-publish exige slug (descubra via film-list).");
+        if (typeof args.published !== "boolean") {
+            throw new Error("film-publish exige published (true publica no Acervo, false despublica).");
+        }
+        return await convexMutation("videoSpecs:mcpSetVideoPublished", {
+            sessionToken,
+            slug: args.slug,
+            published: args.published,
+        });
+    }
+    if (args.action === "film-delete") {
+        if (!args.slug)
+            throw new Error("film-delete exige slug (descubra via film-list).");
+        return await convexMutation("videoSpecs:mcpDeleteVideoSpec", { sessionToken, slug: args.slug });
+    }
     if (args.action === "showcase") {
         if (!args.slug) {
             throw new Error("action=showcase exige slug (descubra via action=demos).");

package/package.json

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