sapiens-mcp 1.91.0 → 1.91.2

package/dist/registry.js

@@ -267,7 +267,7 @@ O passo a passo travado de cada fluxo mora na tool sapiens_skill, servida por es
 - sapiens_skill action=list -> o índice (slug + quando usar cada uma).
 - sapiens_skill action=get name=<slug> -> a skill inteira.
 Slugs: ${skillMenuLine()}
-Puxe a skill ANTES de: gerar música ou efeito sonoro (musica), escolher modelo de vídeo (video), gerar imagem (imagem), criar personagem ou prompt de Midjourney (personagem), criar na identidade do usuário (studio), postar no Fórum ou no chat (forum-comunidade), redigir qualquer texto publicável (voz-da-casa), incorporar o Sintético (companhia), missão de Desafio (trilhas), montar currículo (curriculo), guardar obra ou ferramenta no acervo (repertorio), gerar em motor de fora com crédito próprio e trazer a peça pro acervo (pontes), publicar peça nas redes da pessoa (publicar). Perdido no começo: primeiros-passos.
+Puxe a skill ANTES de: gerar música ou efeito sonoro (musica), escolher modelo de vídeo (video), gerar imagem (imagem), criar personagem ou prompt de Midjourney (personagem), criar na identidade do usuário (studio), postar no Fórum ou no chat (forum-comunidade), redigir qualquer texto publicável (voz-da-casa), incorporar o Sintético (companhia), missão de Desafio (trilhas), montar currículo (curriculo), guardar obra ou ferramenta no acervo (repertorio), gerar em motor de fora com crédito próprio e trazer a peça pro acervo (pontes), publicar peça nas redes da pessoa (publicar), escrever código que chama a API da conta (sapiens-api). Perdido no começo: primeiros-passos.
 Cliente que lê resources MCP acha o MESMO conteúdo em skill://sapiens/<slug>/SKILL.md.
 
 REGRA DE OURO:

package/dist/skills.js

@@ -917,6 +917,39 @@ O nome no topo, a marca no canto da capa e o @ do fecho saem de \`theme.signatur
 - O carrossel vai até 15 slides. A capa IA entra com dois.
 - Baixar é no editor (o arquivo sai do navegador dela). Aqui você entrega a receita pronta, não o arquivo.`,
     },
+    {
+        name: "sapiens-api",
+        title: "API da conta: texto, imagem e vídeo em código",
+        description: "A API da pessoa (compatível com OpenAI, saldo em dólar, separado das Sinapses) pra quando ela quer chamar os motores da casa de dentro de um script, app ou agente próprio. Puxe antes de escrever código que chama www.sapiensinteticos.com/api/v1 ou quando ela perguntar de chave, saldo da API ou cobrança de uma chamada.",
+        body: `## API ou MCP
+
+Este connector opera a conta pela conversa e cobra em Sinapses. A API é outra porta: a pessoa chama os motores de texto, imagem e vídeo de dentro do código dela, no formato da OpenAI, e paga do saldo em DÓLAR da conta. Os dois saldos não se misturam.
+
+Use a API quando a pessoa quer automatizar fora da conversa (script, app, agente dela, lote). Pra operar a conta aqui, siga com as tools.
+
+## Onde fica
+
+Tudo mora em Developers, no fim do menu do site: criar e revogar chave, teto de gasto por dia de cada chave, recarga (cartão ou USDC da carteira dela) e o extrato. Se a seção API não aparece lá, ela ainda não abriu pra conta.
+
+A chave aparece UMA vez, na criação. Peça pra ela guardar numa variável de ambiente (\`SAPIENS_API_KEY\`). Nunca peça a chave no chat e nunca escreva a chave em código, commit ou log.
+
+## O manual inteiro
+
+O manual de uso, com os campos, o vídeo e a tabela de erros, é servido pela própria API, sem chave:
+
+\`\`\`
+GET https://www.sapiensinteticos.com/api/v1/skill
+\`\`\`
+
+Baixe e leia ANTES de escrever o código. Num agente com pasta de skills, ele entra como \`.claude/skills/sapiens-api/SKILL.md\`. O manual de lá manda sobre este resumo quando os dois divergirem.
+
+## O que vale saber já
+
+- Base: \`https://www.sapiensinteticos.com/api/v1\`, com \`Authorization: Bearer <chave>\`. No SDK da OpenAI, só troque o \`baseURL\`.
+- Preço: abaixo do oficial de quem fez o modelo. Quando a oferta da hora sai mais cara, a chamada paga um pouco mais, nunca acima do máximo que \`GET /models\` mostra. O valor de cada chamada volta no header \`x-sapiens-charge-usd\`.
+- Vídeo cota de graça antes (\`POST /videos/quote\`), aceita \`webhook_url\` pra avisar quando termina e devolve a \`url\` do mp4 guardado. Falha do motor volta pro saldo sozinha.
+- Uma chamada de teste antes de qualquer lote. Nunca vídeo em laço.`,
+    },
 ];
 export const SKILLS = Object.fromEntries(SKILL_LIST.map((s) => [s.name, s]));
 /** Monta o SKILL.md completo (frontmatter do formato aberto + corpo). */

package/dist/tools/distribution.js

@@ -129,8 +129,11 @@ const CHANNELS = [
     "x-buffer",
     "tiktok-buffer",
     "tiktok-buffer-2",
-    // O TikTok de linhagem pelo upload-post, no profile da linhagem dona do canal.
+    // O TikTok, o YouTube e o Instagram de linhagem pelo upload-post, no profile
+    // da linhagem dona do canal.
     "tiktok-up",
+    "youtube-up",
+    "instagram-up",
     // X e LinkedIn do Obsolete Human, pelo Buffer próprio do selo.
     "x-buffer-2",
     "x-buffer-3",
@@ -215,7 +218,7 @@ export const distributionSchema = z.object({
     assetKind: z
         .enum(["image", "video", "audio"])
         .optional()
-        .describe("queue: o tipo da mídia. Ausente, o servidor infere pela URL. A MÍDIA ESCOLHE O CANAL, e o servidor recusa o par errado com o caminho certo no erro: youtube, youtube-2..5 e bilibili levam só vídeo (foto ou texto no YouTube vai por youtube-community); tiktok sobe só vídeo pro inbox (foto no TikTok vai por tiktok-buffer); tiktok-up (o TikTok de linhagem pelo upload-post) publica e leva só vídeo; pinterest, google-business e youtube-community levam só imagem (vídeo nesses três: manda a capa como imagem, ou muda o canal). Áudio conta como imagem: nenhum canal sobe áudio pela API, a peça empacota pro post manual. O resto leva os três."),
+        .describe("queue: o tipo da mídia. Ausente, o servidor infere pela URL. A MÍDIA ESCOLHE O CANAL, e o servidor recusa o par errado com o caminho certo no erro: youtube, youtube-2..5 e bilibili levam só vídeo (foto ou texto no YouTube vai por youtube-community); tiktok sobe só vídeo pro inbox (foto no TikTok vai por tiktok-buffer); tiktok-up e youtube-up (o TikTok e o YouTube de linhagem pelo upload-post) publicam e levam só vídeo, e instagram-up (o Instagram de linhagem pelo upload-post) leva vídeo (Reel) ou até 10 fotos; pinterest, google-business e youtube-community levam só imagem (vídeo nesses três: manda a capa como imagem, ou muda o canal). Áudio conta como imagem: nenhum canal sobe áudio pela API, a peça empacota pro post manual. O resto leva os três."),
     assetPageAssetId: z
         .string()
         .optional()

package/dist/tools/image.js

@@ -373,10 +373,21 @@ export async function image(args) {
         // Só vai quando veio: servidor de antes do campo recusaria arg desconhecido.
         ...(args.maskRegions ? { maskRegions: args.maskRegions } : {}),
     });
+    // Backend de antes do campo não devolve motor nem ficha: cai no id pedido e
+    // monta a ficha aqui. O nome bonito (modelName) só vem do servidor.
+    const model = result?.model ?? genModel;
+    const acervoUrl = result?.acervoUrl ??
+        (result?.imageId ? `https://sapiensinteticos.com/dashboard/acervo?image=${result.imageId}` : undefined);
     return {
         imageId: result?.imageId,
         url: result?.url,
-        webUrl: result?.imageId ? `https://sapiensinteticos.com/imagem/${result.imageId}` : undefined,
+        model,
+        modelName: result?.modelLabel ?? model,
+        // Ficha PRIVADA: é onde a peça mora até alguém publicar. O /imagem/<id>
+        // (que este campo era antes, como webUrl) dá 404 até pro dono enquanto a
+        // peça não passa por sapiens_gallery action=publish.
+        acervoUrl,
+        entrega: "Ao mostrar a peça, diga o motor pelo modelName e mande o acervoUrl como link 'no acervo'. A peça é PRIVADA: link público só existe depois de sapiens_gallery action=publish (que devolve o endereço público).",
         mimeType: result?.mimeType,
         // Não incluir base64 no retorno (polui contexto). Quem quiser bytes
         // chama sapiens_gallery action=get com includeBase64=true.

package/package.json

@@ -1,64 +1,64 @@
-{
-  "name": "sapiens-mcp",
-  "version": "1.91.0",
-  "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",
-  "bin": {
-    "sapiens-mcp": "./dist/index.js"
-  },
-  "exports": {
-    "./remote": "./dist/remote.js",
-    "./registry": "./dist/registry.js",
-    "./resume": "./dist/resume/template.js"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "homepage": "https://www.sapiensinteticos.com/conectar-claude",
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "sapiens",
-    "claude",
-    "claude-code",
-    "ai",
-    "image-generation"
-  ],
-  "license": "MIT",
-  "author": "BorderLess (Sapiens Sintéticos), sapiensinteticos.com",
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "pretest": "npm run build",
-    "test": "node --test --test-force-exit test/unit.test.mjs test/server.test.mjs test/remote.test.mjs test/remote-protect.test.mjs test/pontes.test.mjs",
-    "prepublishOnly": "npm run build"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/inhabitants/sapiensinteticos.git",
-    "directory": "tools/mcp-sapiens"
-  },
-  "bugs": {
-    "url": "https://github.com/inhabitants/sapiensinteticos/issues"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4",
-    "convex": "^1.41.0",
-    "mcp-handler": "^1.1.0",
-    "zod": "^3.23.8",
-    "zod-to-json-schema": "^3.23.5"
-  },
-  "devDependencies": {
-    "@anthropic-ai/mcpb": "^2.1.2",
-    "@types/node": "^22.10.0",
-    "esbuild": "^0.28.2",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.2"
-  }
-}
+{
+  "name": "sapiens-mcp",
+  "version": "1.91.2",
+  "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",
+  "bin": {
+    "sapiens-mcp": "./dist/index.js"
+  },
+  "exports": {
+    "./remote": "./dist/remote.js",
+    "./registry": "./dist/registry.js",
+    "./resume": "./dist/resume/template.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "homepage": "https://www.sapiensinteticos.com/conectar-claude",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "sapiens",
+    "claude",
+    "claude-code",
+    "ai",
+    "image-generation"
+  ],
+  "license": "MIT",
+  "author": "BorderLess (Sapiens Sintéticos), sapiensinteticos.com",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "pretest": "npm run build",
+    "test": "node --test --test-force-exit test/unit.test.mjs test/server.test.mjs test/remote.test.mjs test/remote-protect.test.mjs test/pontes.test.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/inhabitants/sapiensinteticos.git",
+    "directory": "tools/mcp-sapiens"
+  },
+  "bugs": {
+    "url": "https://github.com/inhabitants/sapiensinteticos/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "convex": "^1.41.0",
+    "mcp-handler": "^1.1.0",
+    "zod": "^3.23.8",
+    "zod-to-json-schema": "^3.23.5"
+  },
+  "devDependencies": {
+    "@anthropic-ai/mcpb": "^2.1.2",
+    "@types/node": "^22.10.0",
+    "esbuild": "^0.28.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}