sapiens-mcp 1.107.0 → 1.108.0
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 +1 -1
- package/dist/tools/repertorio.js +53 -14
- package/package.json +1 -1
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/tools/repertorio.js
CHANGED
|
@@ -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
|
|
82
|
-
// gesto do dono
|
|
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.
|
|
3
|
+
"version": "1.108.0",
|
|
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",
|