sapiens-mcp 1.107.0 → 1.108.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/registry.js CHANGED
@@ -87,7 +87,7 @@ export const TOOLS = {
87
87
  handler: skill,
88
88
  },
89
89
  sapiens_repertorio: {
90
- description: "Acervo pessoal de filme/série/anime/jogo/jogo de tabuleiro/livro/música/pessoa (Repertório, o segundo cérebro do user). Reads: list (filtros mediaType/status), search (texto em title/genres/tags), get (detalhe), popArticles, resolve (busca capa/ano/id nos providers server-side: OMDb/IGDB-Twitch/AniList/Google Books/iTunes/Wikidata). Mutations (qualquer logado, mexem no PRÓPRIO acervo): add_item, update_item (status/rating/tags/note/isPublic), remove_item. CAPTURA ONE-SHOT travada na lista de providers: quando o user fala natural ('acabei de ver Duna 2, nota 9', 'tô jogando Hollow Knight', 'li tal livro'), (1) infira mediaType e status (assisti/zerei/li=completed, quero=backlog, tô jogando/vendo=active, dropei=dropped) e rating se citado; (2) chame action=resolve {mediaType, query}, escolha o candidato certo e faça add_item passando SÓ o source + externalId DELE + os campos pessoais (status/rating/tags/note). O servidor re-resolve no provider e grava título/capa/ano canônicos, você NÃO manda título/capa nem inventa externalId. (3) Se o resolve não achar (lista vazia/providerKeyMissing), NÃO dá pra adicionar: diga ao user que não encontrou nos providers (não fabrique entry manual). Upsert/dedup por (userId, source, externalId). Só pergunte se ambíguo entre candidatos. FERRAMENTAS DE IA (Repertório de Ferramentas): fluxo separado (vêm do catálogo aitag, não dos providers de mídia). action=search_tools {query} acha a ferramenta no catálogo e devolve o toolId; action=add_tool {toolId, favorite?, rating?, note?} grava como mediaType 'tool' (estar no acervo já é 'usei'; favorite=true liga a estrela). Use quando o user fala 'adiciona o Midjourney/Cursor no meu repertório de ferramentas' ou 'uso tal ferramenta de IA'. Cada ferramenta aponta pra página dela no aitag. CATÁLOGO (ADMIN, o dono): action=catalog_tool cadastra no AItag uma ferramenta OPEN SOURCE que ainda não está lá {toolId, name, githubUrl, categoryEn, descriptionEn, descriptionPt, e de preferência reviewEn/reviewPt, websiteUrl, tags}; devolve created, toolId e a url aitag.app/tool/<toolId>. Idempotente: o mesmo repo (mesmo com outro toolId) devolve a ficha existente e só preenche a análise que estiver vazia, nunca sobrescreve. Rode search_tools antes; é a porta da skill achado. SAPIENS (pessoas, ombros de gigantes; a aba no site chama Sapiens): mediaType 'person' cataloga gente que inspira (cineasta, mangaká, cientista, escritor) via Wikidata. Mesmo fluxo de mídia: resolve {mediaType:'person', query:'Osamu Tezuka'} → add_item com source 'wikidata' + o QID do candidato. O servidor grava foto, ocupações, bio e o link da Wikipedia; entra como completed (estar no acervo = me inspira). Use quando o user fala 'adiciona o Miyazaki nas minhas inspirações/nos meus sapiens/no meu repertório'. JOGO DE TABULEIRO (e de cartas; a aba no site chama Tabuleiro): mediaType 'boardgame', porque 'game' é videogame e o IGDB não conhece tabuleiro. Também via Wikidata: resolve {mediaType:'boardgame', query:'Galactic Cruise'} → add_item com source 'wikidata' + o QID do candidato. Busque pelo título em inglês, que é como a Wikidata cadastra; o designer vem no campo authors do candidato e separa homônimos. O servidor grava designers, editoras e o link da página do jogo no BGG. Lançamento muito recente pode ainda não estar na Wikidata: resolve vazio = diga isso à pessoa, não fabrique. Use quando o user fala 'joguei Catan', 'quero jogar Rebirth', 'adiciona esse jogo de tabuleiro'.",
90
+ description: "Acervo pessoal de filme/série/anime/jogo/jogo de tabuleiro/livro/música/pessoa (Repertório, o segundo cérebro do user). Reads: list (filtros mediaType/status), search (texto em title/genres/tags), get (detalhe), popArticles, resolve (busca capa/ano/id nos providers server-side: OMDb/IGDB-Twitch/AniList/Google Books/iTunes/Wikidata). Mutations (qualquer logado, mexem no PRÓPRIO acervo): add_item, update_item (status/rating/tags/note/isPublic), remove_item. CAPTURA ONE-SHOT travada na lista de providers: quando o user fala natural ('acabei de ver Duna 2, nota 9', 'tô jogando Hollow Knight', 'li tal livro'), (1) infira mediaType e status (assisti/zerei/li=completed, quero=backlog, tô jogando/vendo=active, dropei=dropped) e rating se citado; (2) chame action=resolve {mediaType, query}, escolha o candidato certo e faça add_item passando SÓ o source + externalId DELE + os campos pessoais (status/rating/tags/note). O servidor re-resolve no provider e grava título/capa/ano canônicos, você NÃO manda título/capa nem inventa externalId. (3) Se o resolve não achar (lista vazia/providerKeyMissing), NÃO dá pra adicionar: diga ao user que não encontrou nos providers (não fabrique entry manual). Upsert/dedup por (userId, source, externalId). Só pergunte se ambíguo entre candidatos. FERRAMENTAS DE IA (Repertório de Ferramentas): fluxo separado (vêm do catálogo aitag, não dos providers de mídia). action=search_tools {query} acha a ferramenta no catálogo e devolve o toolId; action=add_tool {toolId, favorite?, rating?, note?} grava como mediaType 'tool' (estar no acervo já é 'usei'; favorite=true liga a estrela). Use quando o user fala 'adiciona o Midjourney/Cursor no meu repertório de ferramentas' ou 'uso tal ferramenta de IA'. Cada ferramenta aponta pra página dela no aitag. CATÁLOGO (ADMIN, o dono): action=catalog_tool cadastra no AItag uma ferramenta OPEN SOURCE que ainda não está lá {toolId, name, githubUrl, categoryEn, descriptionEn, descriptionPt, e de preferência reviewEn/reviewPt, websiteUrl, tags}; devolve created, toolId e a url aitag.app/tool/<toolId>. Idempotente: o mesmo repo (mesmo com outro toolId) devolve a ficha existente e só preenche a análise que estiver vazia, nunca sobrescreve. Rode search_tools antes; é a porta da skill achado. action=admin_tool (ADMIN, SÓ sob ordem explícita do dono: nota e afiliado são gesto dele) faz o que o aitag.app/admin faz, fechada inclusive: {toolId + só os campos a mudar: referralUrl (link de afiliado), nota (0-100), isCurated, isActive, isOpenSource, name, websiteUrl, githubUrl, categoryEn, descriptionEn/Pt, reviewEn/Pt, tags, xUrl, brandHandle}. Ficha existente recebe os campos que vierem e sobrescreve; ficha nova pede name, categoryEn, descriptionEn, descriptionPt e websiteUrl (sem tracking, é dele que sai o screenshot). O servidor recusa e manda pro aitag.app/admin: o mesmo site ou repo com outro toolId (aponta a ficha que existe), outro nome, outro site ou outro repo numa ficha existente, referralUrl fora do site da ferramenta e de rede de afiliado que fale pela marca, e mexer em link, site ou no-ar de ficha com permanência paga. Devolve created, mudou e a url. SAPIENS (pessoas, ombros de gigantes; a aba no site chama Sapiens): mediaType 'person' cataloga gente que inspira (cineasta, mangaká, cientista, escritor) via Wikidata. Mesmo fluxo de mídia: resolve {mediaType:'person', query:'Osamu Tezuka'} → add_item com source 'wikidata' + o QID do candidato. O servidor grava foto, ocupações, bio e o link da Wikipedia; entra como completed (estar no acervo = me inspira). Use quando o user fala 'adiciona o Miyazaki nas minhas inspirações/nos meus sapiens/no meu repertório'. JOGO DE TABULEIRO (e de cartas; a aba no site chama Tabuleiro): mediaType 'boardgame', porque 'game' é videogame e o IGDB não conhece tabuleiro. Também via Wikidata: resolve {mediaType:'boardgame', query:'Galactic Cruise'} → add_item com source 'wikidata' + o QID do candidato. Busque pelo título em inglês, que é como a Wikidata cadastra; o designer vem no campo authors do candidato e separa homônimos. O servidor grava designers, editoras e o link da página do jogo no BGG. Lançamento muito recente pode ainda não estar na Wikidata: resolve vazio = diga isso à pessoa, não fabrique. Use quando o user fala 'joguei Catan', 'quero jogar Rebirth', 'adiciona esse jogo de tabuleiro'.",
91
91
  schema: repertorioSchema,
92
92
  handler: repertorio,
93
93
  },
package/dist/skills.js CHANGED
@@ -586,8 +586,18 @@ A obra da página é automática por default: a soma dos Destaques de quem está
586
586
  {
587
587
  name: "forum-comunidade",
588
588
  title: "Fórum, chat e mídia estruturada",
589
- description: "Como postar tese, mencionar gente e anexar música ou vídeo do jeito certo (campo estruturado, nunca URL solta no corpo). Puxe antes de postar no Fórum ou no chat da Comunidade.",
590
- body: `## Mídia é ESTRUTURADA. Padrão, não negociável.
589
+ description: "Como postar tese, mencionar gente e anexar música ou vídeo do jeito certo (campo estruturado, nunca URL solta no corpo). Puxe antes de postar no Fórum ou no chat da Comunidade. O Fórum e o chat estão em pausa por enquanto.",
590
+ body: `## Em pausa por enquanto
591
+
592
+ O Fórum e o Chat da Comunidade estão fora do ar. Postar, votar, reagir, chamar persona pro chat e assinar tese do Sintético respondem "em pausa". Não repita a chamada nem procure outro caminho: diga isso à pessoa em uma linha e ofereça o que segue no ar.
593
+
594
+ - Conversar com o Sintético dela, e assinar o que ele propõe ali (imagem, personagem). É o que eleva o grau agora.
595
+ - Publicar a peça: música e carrossel continuam ficando públicos na casa, só sem o eco no Fórum e no chat.
596
+ - DM com as personas segue aberta.
597
+
598
+ O resto desta skill vale quando as salas voltarem.
599
+
600
+ ## Mídia é ESTRUTURADA. Padrão, não negociável.
591
601
 
592
602
  A peça vai EMBEDADA num card, nunca como "vai ouvir noutro lugar". Nunca cole a URL da mídia no corpo da tese: o corpo é só texto.
593
603
 
@@ -1066,8 +1076,9 @@ Pedido que voltou timeout, ou conexão que caiu no meio, pode ter gerado E cobra
1066
1076
  - Vídeo e áudio respondem na hora com o \`id\` do trabalho: guarde e consulte \`GET /videos/{id}\` ou \`GET /audio/{id}\` em vez de criar outro. Perdeu o id? \`GET /videos\` e \`GET /audio\` listam os trabalhos da conta, do mais novo pro mais velho, com \`limit\` (1 a 100, 20 sem ele) e \`after\` (o \`last_id\` da página anterior): o cobrado aparece ali. Receita não aceita a chave: guarde o id e consulte \`GET /receitas/{id}\`; sem ele, olhe o acervo (\`source: api\`, com \`sapiens_gallery\`) e o gasto do dia em \`GET /balance\`.
1067
1077
  - Texto não tem \`Idempotency-Key\`: confira o gasto do dia em \`GET /balance\` antes de repetir.
1068
1078
  - Texto sem stream tem cerca de 270 s pra sair inteiro, contados da chegada do pedido. Passou disso, volta 504 \`upstream_timeout\` sem cobrar, e repetir igual tende a estourar de novo. Resposta longa (modelo de raciocínio, \`max_tokens\` alto) vai com \`stream: true\`: o texto chega enquanto sai. No stream, a conexão fecha em cerca de 285 s, com \`finish_reason: "length"\` se o motor ainda escrevia.
1069
- - 400 \`stream_required\` no texto: a CONTA estourou o prazo sem stream 3 vezes na última hora (e depois do primeiro estouro o teto de abertos sem stream encolhe). Nada foi cobrado; repita com \`stream: true\`, que nunca trava.
1079
+ - 400 \`stream_required\` no texto: a CONTA estourou o prazo sem stream 3 vezes na última hora (e depois do primeiro estouro o teto de abertos sem stream encolhe). Nada foi cobrado; repita com \`stream: true\`, que este balde não trava.
1070
1080
  - 429 \`too_many_open_requests\` no texto: a conta já tem 10 pedidos de texto sem stream em aberto. Nada foi cobrado; espere o \`Retry-After\` (5 s) e repita, o que o SDK da OpenAI já faz sozinho. Com \`stream: true\` esse teto não vale.
1081
+ - 429 \`too_many_timeouts\` no texto com stream: a CONTA levou 3 vezes na última hora o stream que fechou por prazo sem o motor entregar nada (o 504 \`upstream_timeout\`, ou o stream que acabou vazio em cerca de 285 s). Nada foi cobrado; espere o \`Retry-After\` (a janela vira em até 1 hora) e repita. A resposta traz \`x-should-retry: false\`, então o SDK da OpenAI não repete sozinho. O texto sem stream não trava por isso. Depois do primeiro desses na hora, o teto de pedidos com stream em aberto da conta encolhe (429 \`too_many_open_requests\` com \`Retry-After\` de 5 s).
1071
1082
 
1072
1083
  ## Modelos de texto de preço variável: sapiens-auto e Jev Router
1073
1084
 
@@ -86,6 +86,7 @@ const CHANNELS = [
86
86
  "bluesky-10",
87
87
  "bluesky-11",
88
88
  "bluesky-12",
89
+ "bluesky-13",
89
90
  "farcaster",
90
91
  "telegram",
91
92
  // Canais de personagem no Telegram (telegram-2 = Aria, telegram-3 = Arak,
@@ -99,6 +100,8 @@ const CHANNELS = [
99
100
  "telegram-8",
100
101
  "telegram-9",
101
102
  "telegram-10",
103
+ "telegram-11",
104
+ "telegram-12",
102
105
  // nostr: protocolo, nao empresa. Publica por WebSocket atras de "use node".
103
106
  "nostr",
104
107
  // Are.na: um canal por CANAL de la (o Are.na nao tem feed).
@@ -161,6 +164,13 @@ const CHANNELS = [
161
164
  "x-buffer-3",
162
165
  "x-buffer-4",
163
166
  "x-buffer-5",
167
+ "x-buffer-6",
168
+ "x-buffer-7",
169
+ "x-buffer-8",
170
+ "x-buffer-9",
171
+ "x-buffer-10",
172
+ "x-buffer-11",
173
+ "x-buffer-12",
164
174
  // Vagas numeradas de conta extra.
165
175
  "instagram-3",
166
176
  "instagram-4",
@@ -168,6 +178,11 @@ const CHANNELS = [
168
178
  "instagram-6",
169
179
  "instagram-7",
170
180
  "instagram-8",
181
+ "instagram-9",
182
+ "instagram-10",
183
+ "instagram-11",
184
+ "instagram-12",
185
+ "instagram-13",
171
186
  "threads-3",
172
187
  "threads-4",
173
188
  "threads-5",
@@ -46,6 +46,7 @@ export const repertorioSchema = z.object({
46
46
  "search_tools",
47
47
  "add_tool",
48
48
  "catalog_tool",
49
+ "admin_tool",
49
50
  ]),
50
51
  // Reads
51
52
  userId: z
@@ -76,30 +77,41 @@ export const repertorioSchema = z.object({
76
77
  toolId: z
77
78
  .string()
78
79
  .optional()
79
- .describe("Pra add_tool: o toolId EXATO de um candidato do action=search_tools (catálogo aitag). Dedup por (userId, source aitag, externalId=toolId). Pra catalog_tool: o toolId NOVO da ficha, em kebab-case minúsculo (vira o endereço aitag.app/tool/<toolId>)."),
80
+ .describe("Pra add_tool: o toolId EXATO de um candidato do action=search_tools (catálogo aitag). Dedup por (userId, source aitag, externalId=toolId). Pra catalog_tool: o toolId NOVO da ficha, em kebab-case minúsculo (vira o endereço aitag.app/tool/<toolId>). Pra admin_tool: o toolId da ficha a editar (o do search_tools) ou o da ficha nova."),
80
81
  // catalog_tool (ADMIN): cadastra ferramenta open source no catálogo do AItag.
81
- // Lista fechada de propósito: curadoria, afiliação, nota e ícone continuam
82
- // gesto do dono no aitag.app/admin.
83
- name: z.string().optional().describe("Pra catalog_tool: o nome do produto como o projeto escreve (HyperFrames, não hyperframes)."),
82
+ // Lista fechada de propósito: curadoria, afiliação e nota ficam no admin_tool,
83
+ // que é o gesto do dono e só roda sob ordem dele.
84
+ name: z.string().optional().describe("Pra catalog_tool/admin_tool: o nome do produto como o projeto escreve (HyperFrames, não hyperframes)."),
84
85
  githubUrl: z
85
86
  .string()
86
87
  .optional()
87
- .describe("Pra catalog_tool: o repo, https://github.com/<owner>/<repo>. É a chave do dedup: o mesmo repo com outro toolId devolve a ficha que já existe."),
88
- websiteUrl: z.string().optional().describe("Pra catalog_tool: a homepage do projeto (https). Ausente, vale o githubUrl."),
88
+ .describe("Pra catalog_tool: o repo, https://github.com/<owner>/<repo>. É a chave do dedup: o mesmo repo com outro toolId devolve a ficha que já existe. Pra admin_tool: opcional; vindo, a ficha vira open source."),
89
+ websiteUrl: z.string().optional().describe("Pra catalog_tool/admin_tool: a homepage do projeto (https), sem tracking: é dela que sai o screenshot. Ausente, vale o githubUrl."),
89
90
  categoryEn: z
90
91
  .string()
91
92
  .optional()
92
- .describe("Pra catalog_tool: UMA destas, exata: Text & Writing, Image & Design, Video & Animation, Voice & Audio, Coding & Development, Marketing & SEO, Data Analysis & Productivity, Research & Education, Agents & Bots, Creative Automation, Privacy & Web3, Experimental Tools, Technical Utilities, Aggregators & Meta Tools, Adult 18+."),
93
- categoryPt: z.string().optional().describe("Pra catalog_tool: opcional; ausente, o servidor copia a de uma vizinha da mesma categoria."),
94
- descriptionEn: z.string().optional().describe("Pra catalog_tool: uma frase do que a ferramenta faz, em inglês (até 400)."),
95
- descriptionPt: z.string().optional().describe("Pra catalog_tool: a mesma frase em português (até 400)."),
93
+ .describe("Pra catalog_tool/admin_tool: UMA destas, exata: Text & Writing, Image & Design, Video & Animation, Voice & Audio, Coding & Development, Marketing & SEO, Data Analysis & Productivity, Research & Education, Agents & Bots, Creative Automation, Privacy & Web3, Experimental Tools, Technical Utilities, Aggregators & Meta Tools, Adult 18+."),
94
+ categoryPt: z.string().optional().describe("Pra catalog_tool/admin_tool: opcional; ausente, o servidor copia a de uma vizinha da mesma categoria."),
95
+ descriptionEn: z.string().optional().describe("Pra catalog_tool/admin_tool: uma frase do que a ferramenta faz, em inglês (até 400)."),
96
+ descriptionPt: z.string().optional().describe("Pra catalog_tool/admin_tool: a mesma frase em português (até 400)."),
96
97
  reviewEn: z
97
98
  .string()
98
99
  .optional()
99
- .describe("Pra catalog_tool: a análise editorial em inglês, 3 a 5 frases na voz da casa. É o gate de indexação da página: sem ela, a ficha fica fora do Google."),
100
- reviewPt: z.string().optional().describe("Pra catalog_tool: a análise editorial em português."),
101
- tagsEn: z.array(z.string()).optional().describe("Pra catalog_tool: até 10 tags em inglês."),
102
- tagsPt: z.array(z.string()).optional().describe("Pra catalog_tool: até 10 tags em português."),
100
+ .describe("Pra catalog_tool/admin_tool: a análise editorial em inglês, 3 a 5 frases na voz da casa. É o gate de indexação da página: sem ela, a ficha fica fora do Google."),
101
+ reviewPt: z.string().optional().describe("Pra catalog_tool/admin_tool: a análise editorial em português."),
102
+ tagsEn: z.array(z.string()).optional().describe("Pra catalog_tool/admin_tool: até 10 tags em inglês."),
103
+ tagsPt: z.array(z.string()).optional().describe("Pra catalog_tool/admin_tool: até 10 tags em português."),
104
+ // admin_tool (ADMIN, sob ordem do dono): o que o aitag.app/admin faz.
105
+ referralUrl: z
106
+ .string()
107
+ .optional()
108
+ .describe("Pra admin_tool: o link do botão Visitar, com o código de afiliado do dono (https). Tem que cair no site da ferramenta (agensi.io/r/X sobre agensi.io) ou em rede de afiliado com a marca do site no subdomínio (<marca>.sjv.io, <marca>.pxf.io, <marca>.partnerlinks.io); tolt.link só troca link que já estava nele. Fora disso o servidor recusa e o link entra pelo aitag.app/admin. Ausente na ficha nova, vale o websiteUrl."),
109
+ nota: z.number().int().min(0).max(100).optional().describe("Pra admin_tool: a nota da ficha no AItag, inteiro de 0 a 100. Ordena o catálogo."),
110
+ isOpenSource: z.boolean().optional().describe("Pra admin_tool: liga ou desliga o selo open source. Ausente na ficha nova, vale true se veio githubUrl."),
111
+ isCurated: z.boolean().optional().describe("Pra admin_tool: Staff Pick (curadoria da casa)."),
112
+ isActive: z.boolean().optional().describe("Pra admin_tool: false tira a ficha do ar sem apagar."),
113
+ xUrl: z.string().optional().describe("Pra admin_tool: o perfil da ferramenta no X (https://x.com/<handle>)."),
114
+ brandHandle: z.string().optional().describe("Pra admin_tool: o @ da marca, sem o @."),
103
115
  favorite: z
104
116
  .boolean()
105
117
  .optional()
@@ -169,6 +181,33 @@ export async function repertorio(args) {
169
181
  tagsPt: args.tagsPt,
170
182
  });
171
183
  }
184
+ // admin_tool (ADMIN): cria ou edita ficha do AItag como o aitag.app/admin,
185
+ // fechada inclusive, com nota, afiliado e curadoria. Edita só os campos que
186
+ // vierem. Quem gateia é o Convex (requireMcpAdmin).
187
+ if (args.action === "admin_tool") {
188
+ return await convexMutation("aitag/mcpCatalog:mcpAdminUpsertTool", {
189
+ sessionToken: getSessionToken(),
190
+ toolId: need(args.toolId, "toolId"),
191
+ name: args.name,
192
+ websiteUrl: args.websiteUrl,
193
+ referralUrl: args.referralUrl,
194
+ githubUrl: args.githubUrl,
195
+ isOpenSource: args.isOpenSource,
196
+ nota: args.nota,
197
+ categoryEn: args.categoryEn,
198
+ categoryPt: args.categoryPt,
199
+ descriptionEn: args.descriptionEn,
200
+ descriptionPt: args.descriptionPt,
201
+ reviewEn: args.reviewEn,
202
+ reviewPt: args.reviewPt,
203
+ tagsEn: args.tagsEn,
204
+ tagsPt: args.tagsPt,
205
+ xUrl: args.xUrl,
206
+ brandHandle: args.brandHandle,
207
+ isCurated: args.isCurated,
208
+ isActive: args.isActive,
209
+ });
210
+ }
172
211
  // resolve: busca metadado (capa/ano/id) nos providers server-side, com as
173
212
  // keys que vivem no env do Convex. Faz a captura por conversa de filme/série/
174
213
  // jogo entrar COM capa (anime/livro/música já vêm keyless). Devolve
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sapiens-mcp",
3
- "version": "1.107.0",
3
+ "version": "1.108.2",
4
4
  "mcpName": "com.sapiensinteticos/sapiens",
5
5
  "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. mcprush.com-bd2545268b8471cdb213c674",
6
6
  "type": "module",