sapiens-mcp 1.46.3 → 1.46.5

package/dist/registry.js

@@ -84,7 +84,7 @@ export const TOOLS = {
         handler: article,
     },
     sapiens_write: {
-        description: "Artigos self-serve do PRÓPRIO usuário (qualquer conta logada, não só admin) — espaço pessoal, aparece em /u/<username>, NÃO é o blog editorial. Sub-actions: generate (gera 1 artigo na voz Sapiens a partir de brief livre, ou reescrevendo um artigo publicado/texto teu; custa 400 Sinapses, reembolsa se falhar; salva como rascunho. Capa: por padrão gera uma capa-cortesia grátis; se você JÁ tem a imagem (gerou via sapiens_image, ou o artigo é sobre ela), passe coverImageId (id da tua galeria) ou coverImageUrl (host Sapiens) pra ELA virar a capa em vez da cortesia), list (teus artigos), get (1 artigo teu por id, corpo completo), update (edita title/content/excerpt/tldr), publish (publish=true publica no teu perfil, false volta pra rascunho). Identidade vem do sessionToken; cobra as Sinapses do dono do token. Pra blog editorial curado (owner-only) use sapiens_article. NOTA (generate): é SÍNCRONA (texto + capa) e cai na REGRA DO TIMEOUT; sem idempotência, repetir às cegas cria um 2º rascunho e cobra 400 de novo (cheque action=list antes; o artigo do timeout fica salvo como rascunho).",
+        description: "Artigos self-serve do PRÓPRIO usuário (qualquer conta logada, não só admin): espaço pessoal, aparece em /u/<username>, NÃO é o blog editorial. ESCOLHA A PORTA CERTA: texto que a PESSOA já escreveu vai em create (GRÁTIS, nada reescrito); IA só entra em generate (400 Sinapses). Gerar e depois sobrescrever com o texto original é queimar 400 à toa. Sub-actions: create (salva o texto pronto do autor: title obrigatório + content markdown; nasce rascunho, custo 0; brandSlug veste a peça com um design system (omitido, herda o padrão da conta) e é o que faz capa e imagens saírem no estilo DELE, não no da casa; coverImageId/coverImageUrl anexam uma capa que ele já tem, também de graça), generate (gera 1 artigo na voz Sapiens a partir de brief livre, ou reescrevendo um artigo publicado/texto teu; custa 400 Sinapses, reembolsa se falhar; salva como rascunho. Capa: por padrão gera uma capa-cortesia grátis, já no design system do autor quando ele tem um; se você JÁ tem a imagem (gerou via sapiens_image, ou o artigo é sobre ela), passe coverImageId (id da tua galeria) ou coverImageUrl (host Sapiens) pra ELA virar a capa em vez da cortesia), list (teus artigos), get (1 artigo teu por id, corpo completo), update (edita title/content/excerpt/tldr), publish (publish=true publica no teu perfil, false volta pra rascunho). Identidade vem do sessionToken; cobra as Sinapses do dono do token. Pra blog editorial curado (owner-only) use sapiens_article. NOTA (generate): é SÍNCRONA (texto + capa) e cai na REGRA DO TIMEOUT; sem idempotência, repetir às cegas cria um 2º rascunho e cobra 400 de novo (cheque action=list antes; o artigo do timeout fica salvo como rascunho).",
         schema: writeSchema,
         handler: write,
     },
@@ -99,7 +99,7 @@ export const TOOLS = {
         handler: search,
     },
     sapiens_studios: {
-        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.",
+        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 NO AR com endereço público, sem rascunho, 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,
     },

package/dist/skills.js

@@ -114,6 +114,14 @@ Hedge não entra nessa lista: "ao meu ver", "por enquanto", "talvez" assinam a v
 
 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.
 
+## Texto que a pessoa já trouxe pronto
+
+Vai pro perfil como está: \`sapiens_write action=create\` (title + content), de graça e sem uma linha reescrita. Depois \`action=publish\`.
+
+Gerar com IA e sobrescrever com o original queima 400 Sinapses por nada. \`action=generate\` é pra quando ela pede pra ESCREVER, não pra publicar o que ela escreveu.
+
+Quem tem design system (\`sapiens_brand action=list\`) já vê a capa sair na paleta dele: o \`brandSlug\` da conta veste a peça sozinho, e passar \`brandSlug\` no create troca de sistema por peça.
+
 ## O que manter
 
 - Léxico próprio: borderless, degen, farmei, "ombros dos gigantes", "fala ai".
@@ -276,7 +284,7 @@ Uma pessoa pode ter até 4 studios e integrar até 4. \`sapiens_studios action=m
 
 - **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.
+- Nasce **no ar**, com ela como fundadora. Studio é identidade, não tem rascunho: o endereço já vale no segundo seguinte.
 - Bateu o teto de 4: o erro diz. Não insista, ela sai de um pra fundar outro.
 
 Depois de fundar, entregue o link e pare. Vestir a página (capa, logo, sobre, seções, ordem da obra) é no modo edição da própria página, não por aqui.

package/dist/tools/image.js

@@ -68,7 +68,7 @@ export const imageSchema = z.object({
     brandSlug: z
         .string()
         .optional()
-        .describe("Slug do brand (design system) pra aplicar estilo visual. Fonte única: tabela `brands` (ex: 'sapiens', 'solarpunk', 'editorial-duotone', 'brutalista-mono'). Default: nenhum (prompt cru). Vale em action=generate (mode=create) e request_generation."),
+        .describe("Slug do brand (design system) pra aplicar estilo visual. Fonte única: tabela `brands` (ex: 'sapiens', 'solarpunk', 'editorial-duotone', 'brutalista-mono'). Default: nenhum (prompt cru). NÃO herda o padrão da conta de propósito: aqui o estilo é escolha do momento, e quem só quer uma imagem pra outra coisa não deve nascer preso num visual. O padrão da pessoa (quando existe) vem em sapiens_meta action=start, campo designSystem: OFEREÇA quando a peça for da marca dela, deixe cru no resto. Vale em action=generate (mode=create) e request_generation."),
     brandMark: z
         .enum(["persona", "logo", "none"])
         .optional()

package/dist/tools/meta.js

@@ -316,6 +316,19 @@ export async function meta(args) {
                 : {}),
             firstPowers: FIRST_POWERS,
             startHere,
+            // Design system da conta: OFERTA, não default. Imagem avulsa continua
+            // saindo crua (quem só quer uma imagem não deve nascer preso num estilo);
+            // o artigo do perfil é que já herda o padrão sozinho, porque ali a peça é
+            // autoral por definição. Só aparece pra quem realmente tem um.
+            ...(who?.designSystem
+                ? {
+                    designSystem: {
+                        slug: who.designSystem.slug,
+                        name: who.designSystem.name,
+                        note: `O design system "${who.designSystem.name}" é o padrão da conta. Artigo do perfil já sai vestido nele. Em imagem avulsa NÃO é automático: ofereça (brandSlug="${who.designSystem.slug}") quando a peça for da marca da pessoa, e deixe cru quando ela só quer uma imagem.`,
+                    },
+                }
+                : {}),
             moreOnDemand: "Isso é só a porta de entrada. Tem também personagens (character-lock), voz (Helen TTS), vídeo, brand/design system, comunidade, fórum e suporte. Peça 'o que mais você faz?' que eu listo, ou já manda o que você quer fazer.",
             ...(isAdmin
                 ? {

package/dist/tools/studios.js

@@ -19,7 +19,7 @@ export const studiosSchema = z.object({
     action: z
         .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. " +
+        "create = FUNDA um studio novo na conta do user (exige 'name'). Nasce NO AR, com endereço público e ele como fundador (studio não tem rascunho); 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()
@@ -229,7 +229,7 @@ export async function studios(args) {
         });
         return {
             ...res,
-            note: "Studio fundado, privado por enquanto. O user publica e veste a página (capa, logo, sobre, time, obra) em " +
+            note: "Studio fundado e JÁ NO AR nesse endereço. O user 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/dist/tools/write.js

@@ -9,6 +9,9 @@ import { convexQuery, convexMutation, convexAction, getSessionToken, } from "../
  * /u/<username>), gastando as Sinapses dele. Identidade vem do sessionToken.
  *
  * Sub-actions:
+ *   - create: salva um texto que VOCÊ já escreveu. De graça, sem IA no caminho.
+ *     É a porta certa pra "publica esse meu artigo": gerar e depois sobrescrever
+ *     com o original queima 400 Sinapses à toa.
  *   - generate: gera 1 artigo na voz Sapiens a partir de um brief livre
  *     (ou reescrevendo um artigo publicado / um texto teu). Cobra 400 Sinapses,
  *     reembolsa se a geração falhar. Salva como rascunho no teu perfil.
@@ -18,12 +21,26 @@ import { convexQuery, convexMutation, convexAction, getSessionToken, } from "../
  *   - publish: publica no teu perfil (publish=true) ou volta pra rascunho (false).
  */
 export const writeSchema = z.object({
-    action: z.enum(["generate", "list", "get", "update", "publish"]),
+    action: z.enum(["create", "generate", "list", "get", "update", "publish"]),
+    // --- create (texto pronto, GRÁTIS) ---
+    // title/content são compartilhados com update (declarados lá embaixo).
+    category: z
+        .string()
+        .optional()
+        .describe("create: categoria do artigo (ex: 'filosofia-tech'). Opcional."),
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe("create: até 8 tags específicas. Opcional."),
+    brandSlug: z
+        .string()
+        .optional()
+        .describe("create: design system que veste a peça (slug via sapiens_brand action=list). Omitido, herda o padrão da tua conta. É o que faz a capa e as imagens saírem no TEU estilo, não no da casa."),
     // --- generate ---
     brief: z
         .string()
         .optional()
-        .describe("Briefing livre (1 parágrafo, até ~600 palavras). Caminho padrão de 'generate'. A IA expande na voz Sapiens. Custa 400 Sinapses."),
+        .describe("Briefing livre (1 parágrafo, até ~600 palavras). Caminho padrão de 'generate'. A IA expande na voz Sapiens. Custa 400 Sinapses. Pra texto que VOCÊ já escreveu, use action=create (de graça)."),
     sourceKind: z
         .enum(["brief", "published_article", "user_article"])
         .optional()
@@ -56,7 +73,7 @@ export const writeSchema = z.object({
     coverImageId: z
         .string()
         .optional()
-        .describe("Capa PRONTA (opcional, só generate): id de uma imagem da TUA galeria (generatedImages:_id, ache via sapiens_gallery/sapiens_reference) que vira a capa do artigo em vez da capa-cortesia gerada do zero. Use quando você JÁ gerou a imagem (sapiens_image) e o artigo é sobre ela — assim a peça não nasce sem capa se a cortesia falhar."),
+        .describe("Capa PRONTA (opcional, vale em create e generate): id de uma imagem da TUA galeria (generatedImages:_id, ache via sapiens_gallery/sapiens_reference) que vira a capa do artigo em vez da capa-cortesia gerada do zero. Use quando você JÁ gerou a imagem (sapiens_image) e o artigo é sobre ela: assim a peça não nasce sem capa se a cortesia falhar."),
     coverImageUrl: httpUrl()
         .optional()
         .describe("Alternativa a coverImageId: URL de imagem do Sapiens (Bunny CDN / Convex) pra usar como capa pronta. Host fora da allowlist é recusado."),
@@ -73,12 +90,15 @@ export const writeSchema = z.object({
         .string()
         .optional()
         .describe("user_articles:_id (obrigatório pra get/update/publish)."),
-    // --- update ---
-    title: z.string().optional(),
+    // --- create / update ---
+    title: z
+        .string()
+        .optional()
+        .describe("Obrigatório em create. Em update, renomeia."),
     content: z
         .string()
         .optional()
-        .describe("Markdown completo do corpo (substitui o conteúdo)."),
+        .describe("Markdown completo do corpo. Em create, é o teu texto na íntegra (nada é reescrito). Em update, substitui o conteúdo."),
     excerpt: z.string().optional(),
     tldr: z.string().optional(),
     // --- publish ---
@@ -89,6 +109,27 @@ export const writeSchema = z.object({
 });
 export async function write(args) {
     const sessionToken = getSessionToken();
+    if (args.action === "create") {
+        if (!args.title?.trim()) {
+            throw new Error("action=create exige title (o texto é teu, então o título também).");
+        }
+        const res = await convexMutation("mcpExtras:mcpUserCreateArticle", {
+            sessionToken,
+            title: args.title,
+            content: args.content,
+            excerpt: args.excerpt,
+            tldr: args.tldr,
+            category: args.category,
+            tags: args.tags,
+            brandSlug: args.brandSlug,
+            coverImageId: args.coverImageId,
+            coverImageUrl: args.coverImageUrl,
+        });
+        return {
+            ...res,
+            note: "Salvo como RASCUNHO, sem custo e sem uma linha reescrita. Pra ir ao ar no perfil: action=publish com este articleId.",
+        };
+    }
     if (args.action === "generate") {
         const sourceKind = args.sourceKind ?? "brief";
         if (sourceKind === "brief" &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapiens-mcp",
-  "version": "1.46.3",
+  "version": "1.46.5",
   "mcpName": "com.sapiensinteticos/sapiens",
   "description": "MCP server pra operar o Sapiens Sintéticos (sapiensinteticos.com) pelo Claude Code: gerar imagem, escrever artigo, voz, música e mais, na sua conta. Login pelo código de sapiensinteticos.com/conectar-claude.",
   "type": "module",