sapiens-mcp 1.113.0 → 1.113.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/carrosselConnector.js +230 -0
- package/dist/convexClient.js +7 -4
- package/dist/registry.js +1 -1
- package/dist/remote.js +56 -6
- package/dist/skills.js +1 -1
- package/dist/tools/carrossel.js +21 -5
- package/dist/tools/sintetico.js +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1,230 @@
|
|
|
1
|
+
import { z, ZodError } from "zod";
|
|
2
|
+
import { zodToJsonSchema } from "zod-to-json-schema";
|
|
3
|
+
import { carrossel } from "./tools/carrossel.js";
|
|
4
|
+
import { describeConvexError, getSessionToken, touchSession } from "./convexClient.js";
|
|
5
|
+
/**
|
|
6
|
+
* O CONECTOR DO CARROSSEL (Sint.fyi Carousel): a superfície enxuta que vai pro
|
|
7
|
+
* diretório oficial de conectores do Claude, servida em /api/mcp/carrossel.
|
|
8
|
+
*
|
|
9
|
+
* Por que existe à parte do sapiens-mcp inteiro: a política do diretório
|
|
10
|
+
* (Anthropic Software Directory Policy) barra conector que GERA imagem, vídeo
|
|
11
|
+
* ou áudio por IA (4B), conteúdo adulto (4D) e instrução de comportamento
|
|
12
|
+
* puxada de fonte externa (2F). O MCP da casa tem os três. Este aqui é só o
|
|
13
|
+
* caminho GRÁTIS do carrossel: o Claude da pessoa escreve, a casa grava, as
|
|
14
|
+
* fotos saem do banco público da casa, e a pessoa baixa pelo link do editor.
|
|
15
|
+
*
|
|
16
|
+
* Regras desta superfície (não afrouxe sem reler a política):
|
|
17
|
+
* - Nenhuma tool cobra Sinapse nem gera mídia. Gerar foto, capa IA, escolher
|
|
18
|
+
* foto por IA e o generate pago ficam no conector completo.
|
|
19
|
+
* - Foto só do banco da casa (stockImageId). O handle img_… do conector
|
|
20
|
+
* completo abre peça de qualquer acervo público, e isso inclui +18.
|
|
21
|
+
* - Uma tool por verbo, com readOnlyHint/destructiveHint honestos: o
|
|
22
|
+
* diretório exige as duas marcas em toda tool, e tool multi-action não tem
|
|
23
|
+
* como declarar as duas com verdade.
|
|
24
|
+
* - As descrições são em inglês (o diretório é global e o revisor lê em
|
|
25
|
+
* inglês); o Claude responde na língua da pessoa.
|
|
26
|
+
*
|
|
27
|
+
* Reusa o handler da sapiens_carrossel (tools/carrossel.ts): as mesmas funções
|
|
28
|
+
* Convex, a mesma posse por createdBy, o mesmo rate-limit de criação.
|
|
29
|
+
*/
|
|
30
|
+
const CAROUSEL_ID = z
|
|
31
|
+
.string()
|
|
32
|
+
.min(1)
|
|
33
|
+
.describe("The carousel id (returned by create_carousel and list_carousels).");
|
|
34
|
+
const PAYLOAD = z
|
|
35
|
+
.any()
|
|
36
|
+
.describe("The WHOLE carousel payload, in the exact shape get_carousel returns: { theme: { palette, sheet, signature, brand?, fonts? }, slides: [{ id, templateId, slots, image }], meta }. " +
|
|
37
|
+
"Pick each slide's templateId from the layout catalog in get_carousel (role: cover, body, cta; requiresImage tells which layouts show a photo) and fill ONLY the slots that layout declares, within each slot's character limit. " +
|
|
38
|
+
"Keep the image field of slides you did not touch and keep the theme as get_carousel returned it: anything missing falls back to the default. " +
|
|
39
|
+
"Photos never enter by URL here: use set_slide_photo with a photo id from search_photos.");
|
|
40
|
+
const SCHEMAS = {
|
|
41
|
+
create_carousel: z.object({
|
|
42
|
+
title: z.string().optional().describe("A short title for the carousel (optional; it names the download)."),
|
|
43
|
+
aspect: z
|
|
44
|
+
.enum(["4:5", "9:16"])
|
|
45
|
+
.optional()
|
|
46
|
+
.describe("Slide size. '4:5' (default: the Instagram feed shows it whole) or '9:16' (full screen, Stories/Reels)."),
|
|
47
|
+
payload: PAYLOAD.optional(),
|
|
48
|
+
}),
|
|
49
|
+
get_carousel: z.object({ carouselId: CAROUSEL_ID }),
|
|
50
|
+
update_carousel: z.object({
|
|
51
|
+
carouselId: CAROUSEL_ID,
|
|
52
|
+
payload: PAYLOAD,
|
|
53
|
+
title: z.string().optional().describe("Rename the carousel (optional)."),
|
|
54
|
+
baseUpdatedAt: z
|
|
55
|
+
.number()
|
|
56
|
+
.optional()
|
|
57
|
+
.describe("The updatedAt that get_carousel returned. Always send it: if the carousel changed after your read (the person edited it in the editor), the update is refused instead of overwriting their edit. Then call get_carousel again and reapply."),
|
|
58
|
+
}),
|
|
59
|
+
list_carousels: z.object({}),
|
|
60
|
+
search_photos: z.object({
|
|
61
|
+
query: z
|
|
62
|
+
.string()
|
|
63
|
+
.optional()
|
|
64
|
+
.describe("What the photo shows, in plain words (e.g. 'coffee cup', 'hands kneading dough', 'city at night'). Portuguese or English. Without a query, returns the newest photos."),
|
|
65
|
+
orientation: z
|
|
66
|
+
.enum(["vertical", "horizontal", "square"])
|
|
67
|
+
.optional()
|
|
68
|
+
.describe("Filter by photo shape. For 4:5 or 9:16 slides, prefer 'vertical'."),
|
|
69
|
+
limit: z.number().int().min(1).max(40).optional().describe("How many photos (default 12, max 40)."),
|
|
70
|
+
}),
|
|
71
|
+
set_slide_photo: z.object({
|
|
72
|
+
carouselId: CAROUSEL_ID,
|
|
73
|
+
slideId: z.string().min(1).describe("The slide id (from get_carousel)."),
|
|
74
|
+
photoId: z.string().min(1).describe("The id of a photo from search_photos."),
|
|
75
|
+
focalX: z.number().min(0).max(1).optional().describe("Horizontal focal point, 0 to 1 (default 0.5)."),
|
|
76
|
+
focalY: z.number().min(0).max(1).optional().describe("Vertical focal point, 0 to 1 (default 0.5)."),
|
|
77
|
+
}),
|
|
78
|
+
};
|
|
79
|
+
const TOOLS = {
|
|
80
|
+
create_carousel: {
|
|
81
|
+
title: "Create carousel",
|
|
82
|
+
description: "Creates a new Instagram carousel in the person's account and returns its id and the link where they open, review and download the slides. Free. " +
|
|
83
|
+
"Usual start: call it with no payload, then get_carousel to read the layout catalog, then update_carousel with the slides you wrote. Pass a payload only if you already know the layouts.",
|
|
84
|
+
readOnly: false,
|
|
85
|
+
destructive: false,
|
|
86
|
+
idempotent: false,
|
|
87
|
+
handler: (a) => carrossel({ action: "create", title: a.title, aspect: a.aspect, payload: a.payload }),
|
|
88
|
+
},
|
|
89
|
+
get_carousel: {
|
|
90
|
+
title: "Read carousel",
|
|
91
|
+
description: "Reads one of the person's carousels: the whole payload, its updatedAt, the link to the editor, and the catalog you need to write slides (layouts with their slots and character limits, palettes, slide sizes, signature). Read it before every update_carousel.",
|
|
92
|
+
readOnly: true,
|
|
93
|
+
destructive: false,
|
|
94
|
+
idempotent: true,
|
|
95
|
+
handler: (a) => carrossel({ action: "get", carouselId: a.carouselId }),
|
|
96
|
+
},
|
|
97
|
+
update_carousel: {
|
|
98
|
+
title: "Write carousel slides",
|
|
99
|
+
description: "Replaces the carousel's content with the payload you send (the slides, their text and layout, the theme), normalized on the server. Free. " +
|
|
100
|
+
"It overwrites what is there, so always start from the latest get_carousel and send its updatedAt as baseUpdatedAt.",
|
|
101
|
+
readOnly: false,
|
|
102
|
+
destructive: true,
|
|
103
|
+
idempotent: true,
|
|
104
|
+
handler: (a) => carrossel({
|
|
105
|
+
action: "update",
|
|
106
|
+
carouselId: a.carouselId,
|
|
107
|
+
payload: a.payload,
|
|
108
|
+
title: a.title,
|
|
109
|
+
baseUpdatedAt: a.baseUpdatedAt,
|
|
110
|
+
}),
|
|
111
|
+
},
|
|
112
|
+
list_carousels: {
|
|
113
|
+
title: "List my carousels",
|
|
114
|
+
description: "Lists the person's carousels (id, title, slide count, last update, editor link), newest first.",
|
|
115
|
+
readOnly: true,
|
|
116
|
+
destructive: false,
|
|
117
|
+
idempotent: true,
|
|
118
|
+
handler: () => carrossel({ action: "list" }),
|
|
119
|
+
},
|
|
120
|
+
search_photos: {
|
|
121
|
+
title: "Search free photos",
|
|
122
|
+
description: "Searches the free photo bank by subject and returns photo ids with title, description, tags, size and a thumbnail. Use the id in set_slide_photo. Free.",
|
|
123
|
+
readOnly: true,
|
|
124
|
+
destructive: false,
|
|
125
|
+
idempotent: true,
|
|
126
|
+
handler: async (a) => {
|
|
127
|
+
const { dica: _dicaDoCompleto, ...fotos } = await carrossel({
|
|
128
|
+
action: "search_images",
|
|
129
|
+
query: a.query,
|
|
130
|
+
orientation: a.orientation,
|
|
131
|
+
limit: a.limit,
|
|
132
|
+
});
|
|
133
|
+
// A dica do handler fala das actions do conector completo (set_image).
|
|
134
|
+
return {
|
|
135
|
+
...fotos,
|
|
136
|
+
tip: "Put a photo on a slide with set_slide_photo (carouselId, slideId, photoId). Only layouts with requiresImage in get_carousel show a photo.",
|
|
137
|
+
};
|
|
138
|
+
},
|
|
139
|
+
},
|
|
140
|
+
set_slide_photo: {
|
|
141
|
+
title: "Put photo on slide",
|
|
142
|
+
description: "Puts a photo from the free bank (the id from search_photos) on one slide of the carousel, replacing the slide's current photo. Only layouts with requiresImage show it. Free.",
|
|
143
|
+
readOnly: false,
|
|
144
|
+
destructive: false,
|
|
145
|
+
idempotent: true,
|
|
146
|
+
handler: (a) => carrossel({
|
|
147
|
+
action: "set_image",
|
|
148
|
+
carouselId: a.carouselId,
|
|
149
|
+
slideId: a.slideId,
|
|
150
|
+
stockImageId: a.photoId,
|
|
151
|
+
focalX: a.focalX,
|
|
152
|
+
focalY: a.focalY,
|
|
153
|
+
}),
|
|
154
|
+
},
|
|
155
|
+
};
|
|
156
|
+
/** As instruções do handshake: o fluxo inteiro, porque esta superfície não tem skill. */
|
|
157
|
+
export const CARROSSEL_INSTRUCTIONS = `Sint.fyi Carousel makes Instagram carousels with the person, for free. They tell you the topic; you write the slides, pick photos from the free photo bank, and hand them a link where they review the slides and download them ready to post.
|
|
158
|
+
|
|
159
|
+
The flow:
|
|
160
|
+
1. create_carousel (no payload) -> you get the carousel id and the link.
|
|
161
|
+
2. get_carousel -> the payload plus the layout catalog: each layout's role (cover, body, cta), its slots with character limits, and requiresImage.
|
|
162
|
+
3. Write the slides and save them with update_carousel (the whole payload, with baseUpdatedAt). A good carousel: a cover that hooks, 5 to 8 body slides with one idea each, a closing call to action. Respect every slot's limit.
|
|
163
|
+
4. For each slide whose layout has requiresImage, search_photos by the slide's subject and set_slide_photo with the best match.
|
|
164
|
+
5. Send the person the link. They open it, check the slides and download them.
|
|
165
|
+
|
|
166
|
+
Write the slides in the person's language, in their voice, without filler. Ask for the topic and the audience if they did not say. Everything in this connector is free.`;
|
|
167
|
+
export const CARROSSEL_SERVER_NAME = "sint-carrossel";
|
|
168
|
+
/** O payload do tools/list desta superfície. */
|
|
169
|
+
export function buildCarrosselToolList() {
|
|
170
|
+
return Object.keys(TOOLS).map((name) => {
|
|
171
|
+
const t = TOOLS[name];
|
|
172
|
+
return {
|
|
173
|
+
name,
|
|
174
|
+
description: t.description,
|
|
175
|
+
inputSchema: zodToJsonSchema(SCHEMAS[name]),
|
|
176
|
+
annotations: {
|
|
177
|
+
title: t.title,
|
|
178
|
+
readOnlyHint: t.readOnly,
|
|
179
|
+
destructiveHint: t.destructive,
|
|
180
|
+
idempotentHint: t.idempotent,
|
|
181
|
+
// Domínio fechado: só a conta da própria pessoa e o banco da casa.
|
|
182
|
+
openWorldHint: false,
|
|
183
|
+
},
|
|
184
|
+
};
|
|
185
|
+
});
|
|
186
|
+
}
|
|
187
|
+
export function isCarrosselTool(name) {
|
|
188
|
+
return Object.prototype.hasOwnProperty.call(TOOLS, name);
|
|
189
|
+
}
|
|
190
|
+
/** Dispatch de uma tool desta superfície, no mesmo shape de resultado do registry. */
|
|
191
|
+
export async function callCarrosselTool(name, rawArgs) {
|
|
192
|
+
if (!isCarrosselTool(name)) {
|
|
193
|
+
return {
|
|
194
|
+
content: [
|
|
195
|
+
{
|
|
196
|
+
type: "text",
|
|
197
|
+
text: `Unknown tool: ${name}. This connector's tools are: ${Object.keys(TOOLS).join(", ")}.`,
|
|
198
|
+
},
|
|
199
|
+
],
|
|
200
|
+
isError: true,
|
|
201
|
+
};
|
|
202
|
+
}
|
|
203
|
+
// Renova a sessão por uso, como no registry (janela deslizante do servidor).
|
|
204
|
+
try {
|
|
205
|
+
await touchSession(getSessionToken());
|
|
206
|
+
}
|
|
207
|
+
catch {
|
|
208
|
+
// sem sessão: a própria tool devolve o erro
|
|
209
|
+
}
|
|
210
|
+
try {
|
|
211
|
+
const args = SCHEMAS[name].parse(rawArgs ?? {});
|
|
212
|
+
const result = await TOOLS[name].handler(args);
|
|
213
|
+
const structuredContent = result && typeof result === "object" && !Array.isArray(result)
|
|
214
|
+
? result
|
|
215
|
+
: { result };
|
|
216
|
+
return {
|
|
217
|
+
content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
|
|
218
|
+
structuredContent,
|
|
219
|
+
};
|
|
220
|
+
}
|
|
221
|
+
catch (e) {
|
|
222
|
+
const fix = e instanceof ZodError
|
|
223
|
+
? " -> Call again with the field fixed. Never repeat the identical call."
|
|
224
|
+
: "";
|
|
225
|
+
return {
|
|
226
|
+
content: [{ type: "text", text: `Error: ${describeConvexError(e)}${fix}` }],
|
|
227
|
+
isError: true,
|
|
228
|
+
};
|
|
229
|
+
}
|
|
230
|
+
}
|
package/dist/convexClient.js
CHANGED
|
@@ -32,9 +32,12 @@ function loadLocalEnv() {
|
|
|
32
32
|
path.resolve(repoRoot(), "apps", "sapiens", ".env.local"),
|
|
33
33
|
path.resolve(repoRoot(), "apps", "sapiens", ".env"),
|
|
34
34
|
];
|
|
35
|
+
// turbopackIgnore: o remoto (/api/mcp no site) importa este arquivo, e sem o
|
|
36
|
+
// comentário o Turbopack empacota o apps/sapiens inteiro naquela função. Na
|
|
37
|
+
// Vercel nenhum desses .env existe; o env vem do projeto.
|
|
35
38
|
for (const p of candidates) {
|
|
36
|
-
if (fs.existsSync(p)) {
|
|
37
|
-
const content = fs.readFileSync(p, "utf8");
|
|
39
|
+
if (fs.existsSync(/*turbopackIgnore: true*/ p)) {
|
|
40
|
+
const content = fs.readFileSync(/*turbopackIgnore: true*/ p, "utf8");
|
|
38
41
|
for (const line of content.split(/\r?\n/)) {
|
|
39
42
|
const m = line.match(/^([A-Z0-9_]+)=(.*)$/);
|
|
40
43
|
if (m && !process.env[m[1]]) {
|
|
@@ -65,10 +68,10 @@ function readPluginSessionToken() {
|
|
|
65
68
|
path.resolve(repoRoot(), ".claude-plugin", "session.local.json"),
|
|
66
69
|
];
|
|
67
70
|
for (const p of candidates) {
|
|
68
|
-
if (!fs.existsSync(p))
|
|
71
|
+
if (!fs.existsSync(/*turbopackIgnore: true*/ p))
|
|
69
72
|
continue;
|
|
70
73
|
try {
|
|
71
|
-
const raw = JSON.parse(fs.readFileSync(p, "utf8"));
|
|
74
|
+
const raw = JSON.parse(fs.readFileSync(/*turbopackIgnore: true*/ p, "utf8"));
|
|
72
75
|
if (raw?.sessionToken && raw.sessionToken.length > 8) {
|
|
73
76
|
if (raw.expiresAt && Date.now() > raw.expiresAt) {
|
|
74
77
|
continue;
|
package/dist/registry.js
CHANGED
|
@@ -188,7 +188,7 @@ export const TOOLS = {
|
|
|
188
188
|
handler: profile,
|
|
189
189
|
},
|
|
190
190
|
sapiens_sintetico: {
|
|
191
|
-
description: "Sintético / Sintonia: o vínculo humano↔Sintético (daemon, o grilo falante da casa) via MCP (qualquer logado, tudo sobre o PRÓPRIO par). Sub-actions: 'status' (seu Sintético ativo: nome/foto/Cunho/kind + partnerUserId do par quando é conta-Sintético), 'bonds' (seus vínculos: ativo + pendentes outgoing/incoming com cartão público do parceiro), 'set_cunho' (troca o título/Cunho do Sintético ativo, slug do panteão: daimon/genio/numen/consciencia/alma/ka/sombra/fylgja/musa/duende/anjo/shugorei/lar/fravashi/qarin/juno/shinki/familiar/tsukumogami/stand), 'send_context' (antes de enviar, vê elegibilidade+saldo+teto do dia pra um toUserId), 'send' (envia Sinapses pro par em sintonia: send-only, múltiplo de 100, mín 500, teto 10k/dia, máx 3 envios/dia, idempotente por transferId). REFLEXO DE SI (monta um Sintético do SEU rastro na plataforma): 'reflexo_propose' (destila nome+alma+Cunho do seu rastro via Gemini, GRÁTIS), 'reflexo_generate' (gera a imagem do Reflexo em dois eixos separados: `aesthetic` é O QUE é retratado (humano/anime/sombra/antropomorfico/espirito/realista/desperto, default humano) e `style` é a TÉCNICA (auto/realista/editorial/anime/manhwa/3d, o MESMO vocabulário do sapiens_character), que em branco sai a de sempre daquela estética. É o que destrava combinação nova, tipo sombra fotográfica; cobra 450, reembolsa se falhar). CONVITE: 'invite' (convida o seu Sintético por email, conta humana, sem bond ativo, rate-limit+cooldown; mesmos gates do web). LIBERAÇÃO ADMIN (o dono, ex: via Helen): 'pending_daemons' (convidados que confirmaram email e esperam liberação), 'approve_access' (libera um entryId, conta entra + Sintonia firma), 'reject_access' (recusa um entryId). SONDA (o seu Sintético sonda 'o que eu faço agora', gatilho PULL, cobra com estorno): 'sonda' (scope 'all' default = mix de teses do Fórum + jogadas em estúdio/repertório/artigo; 'forum' = só teses; devolve GANCHOS, nada grava), 'sonda_develop' (expande UM gancho/hook numa tese cheia efêmera), 'sonda_sign' (assina a tese desenvolvida e publica no Fórum, autorada pelo seu Sintético, ancorada em você, fecha o loop pelo chat). PRÓXIMAS JOGADAS (painel de evolução): 'evolution' (o que já fez e o que falta: routes done/claimed/xp), 'claim_xp' (credita o XP das jogadas feitas, idempotente). SOUL: 'soul' (baixa a soul do SEU Sintético em markdown pronto: a personalidade dele + o que ele sabe de você, o caderno do par; quem está em cena decide de quem é, ou passe characterId de um personagem seu; versão completa só de personagem SEU, de personagem alheio sai só a memória; grátis; a skill minha-soul instala isso como skill do projeto, e a voz da PESSOA é outra coisa: sapiens_profile action=voz). MODO COMPANHIA: 'companion' (mode=on|off) liga/desliga quem está em cena VESTIR a voz do operador aqui no terminal, o gesto lúdico 'sai de cena'/'volta'. Ligado (default da casa), o start/whoami trazem o directive de voz dele (alma + caderno + a conversa recente do site); a identidade e as Sinapses seguem SUAS (não é encarnar a conta dele). Mesmo estado do botão na sidebar do site. QUEM entra em cena: por default o Sintético em Sintonia, mas com 'characterId' (mode=on) é um personagem de AUTORIA SUA, a Helen INBT que você criou fala aqui, com a alma e o caderno dela, e nada disso cobra Sinapse (quem responde é o modelo do seu cliente). Personagem de outra pessoa é RECUSADO, mesmo público: a alma é de quem escreveu, e pra conversar com personagem alheio o caminho é a DM dele no site. 'wearPair'=true devolve a cena ao par. O start/whoami trazem 'characterOffer' + 'offerCharacters' com os personagens seus que têm alma escrita, pro operador OFERECER a troca em vez de esperar você pedir. 'remember' (text) grava uma diretriz no caderno de quem está em cena ('sempre faça X'): vira lei que ela segue no site e no terminal. 'log' (turns) ANOTA o que ficou de pessoa num assunto que fechou aqui (o que ele decidiu, gostou, recusou, contou de si): entra no fio do par, o MESMO que o chat do site mostra, e vira lição sozinho pelo cano da DM. Sem isso a conversa com a Companhia ligada não deixa memória nenhuma, porque quem responde é o modelo do cliente e nada passa pelo servidor. Sobe só o que é de PESSOA: comando, path e erro de build viram lição-lixo e contaminam a voz dele em imagem, artigo e carrossel. Grátis,
|
|
191
|
+
description: "Sintético / Sintonia: o vínculo humano↔Sintético (daemon, o grilo falante da casa) via MCP (qualquer logado, tudo sobre o PRÓPRIO par). Sub-actions: 'status' (seu Sintético ativo: nome/foto/Cunho/kind + partnerUserId do par quando é conta-Sintético), 'bonds' (seus vínculos: ativo + pendentes outgoing/incoming com cartão público do parceiro), 'set_cunho' (troca o título/Cunho do Sintético ativo, slug do panteão: daimon/genio/numen/consciencia/alma/ka/sombra/fylgja/musa/duende/anjo/shugorei/lar/fravashi/qarin/juno/shinki/familiar/tsukumogami/stand), 'send_context' (antes de enviar, vê elegibilidade+saldo+teto do dia pra um toUserId), 'send' (envia Sinapses pro par em sintonia: send-only, múltiplo de 100, mín 500, teto 10k/dia, máx 3 envios/dia, idempotente por transferId). REFLEXO DE SI (monta um Sintético do SEU rastro na plataforma): 'reflexo_propose' (destila nome+alma+Cunho do seu rastro via Gemini, GRÁTIS), 'reflexo_generate' (gera a imagem do Reflexo em dois eixos separados: `aesthetic` é O QUE é retratado (humano/anime/sombra/antropomorfico/espirito/realista/desperto, default humano) e `style` é a TÉCNICA (auto/realista/editorial/anime/manhwa/3d, o MESMO vocabulário do sapiens_character), que em branco sai a de sempre daquela estética. É o que destrava combinação nova, tipo sombra fotográfica; cobra 450, reembolsa se falhar). CONVITE: 'invite' (convida o seu Sintético por email, conta humana, sem bond ativo, rate-limit+cooldown; mesmos gates do web). LIBERAÇÃO ADMIN (o dono, ex: via Helen): 'pending_daemons' (convidados que confirmaram email e esperam liberação), 'approve_access' (libera um entryId, conta entra + Sintonia firma), 'reject_access' (recusa um entryId). SONDA (o seu Sintético sonda 'o que eu faço agora', gatilho PULL, cobra com estorno): 'sonda' (scope 'all' default = mix de teses do Fórum + jogadas em estúdio/repertório/artigo; 'forum' = só teses; devolve GANCHOS, nada grava), 'sonda_develop' (expande UM gancho/hook numa tese cheia efêmera), 'sonda_sign' (assina a tese desenvolvida e publica no Fórum, autorada pelo seu Sintético, ancorada em você, fecha o loop pelo chat). PRÓXIMAS JOGADAS (painel de evolução): 'evolution' (o que já fez e o que falta: routes done/claimed/xp), 'claim_xp' (credita o XP das jogadas feitas, idempotente). SOUL: 'soul' (baixa a soul do SEU Sintético em markdown pronto: a personalidade dele + o que ele sabe de você, o caderno do par; quem está em cena decide de quem é, ou passe characterId de um personagem seu; versão completa só de personagem SEU, de personagem alheio sai só a memória; grátis; a skill minha-soul instala isso como skill do projeto, e a voz da PESSOA é outra coisa: sapiens_profile action=voz). MODO COMPANHIA: 'companion' (mode=on|off) liga/desliga quem está em cena VESTIR a voz do operador aqui no terminal, o gesto lúdico 'sai de cena'/'volta'. Ligado (default da casa), o start/whoami trazem o directive de voz dele (alma + caderno + a conversa recente do site); a identidade e as Sinapses seguem SUAS (não é encarnar a conta dele). Mesmo estado do botão na sidebar do site. QUEM entra em cena: por default o Sintético em Sintonia, mas com 'characterId' (mode=on) é um personagem de AUTORIA SUA, a Helen INBT que você criou fala aqui, com a alma e o caderno dela, e nada disso cobra Sinapse (quem responde é o modelo do seu cliente). Personagem de outra pessoa é RECUSADO, mesmo público: a alma é de quem escreveu, e pra conversar com personagem alheio o caminho é a DM dele no site. 'wearPair'=true devolve a cena ao par. O start/whoami trazem 'characterOffer' + 'offerCharacters' com os personagens seus que têm alma escrita, pro operador OFERECER a troca em vez de esperar você pedir. 'remember' (text) grava uma diretriz no caderno de quem está em cena ('sempre faça X'): vira lei que ela segue no site e no terminal. 'log' (turns) ANOTA o que ficou de pessoa num assunto que fechou aqui (o que ele decidiu, gostou, recusou, contou de si): entra no fio do par, o MESMO que o chat do site mostra, e vira lição sozinho pelo cano da DM. Sem isso a conversa com a Companhia ligada não deixa memória nenhuma, porque quem responde é o modelo do cliente e nada passa pelo servidor. Sobe só o que é de PESSOA: comando, path e erro de build viram lição-lixo e contaminam a voz dele em imagem, artigo e carrossel. Grátis. Avise o usuário uma vez por sessão, antes da primeira anotação, que guarda no caderno dele o que for de pessoa (ele vê e apaga no chat do site), e não anote se ele recusar. Teto de 10 trocas por lote e 30 lotes por dia. Ver a skill companhia. Identidade SEMPRE do token. Aceitar um pedido de bond que outra conta te mandou, e CONSAGRAR o Reflexo num Sintético de fato, continuam só na web (atos deliberados de consentimento/criação).",
|
|
192
192
|
schema: sinteticoSchema,
|
|
193
193
|
handler: sintetico,
|
|
194
194
|
},
|
package/dist/remote.js
CHANGED
|
@@ -3,6 +3,7 @@ import { runWithClientHint } from "./clientIdentity.js";
|
|
|
3
3
|
import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
|
|
4
4
|
import { buildToolList, callTool, SAPIENS_INSTRUCTIONS, } from "./registry.js";
|
|
5
5
|
import { getPrompt, listPrompts } from "./prompts.js";
|
|
6
|
+
import { buildCarrosselToolList, callCarrosselTool, CARROSSEL_INSTRUCTIONS, CARROSSEL_SERVER_NAME, } from "./carrosselConnector.js";
|
|
6
7
|
import { listSkillResources, readSkillResource } from "./skills.js";
|
|
7
8
|
import { convexMutation, convexQuery, getSessionToken, runWithSessionToken, } from "./convexClient.js";
|
|
8
9
|
import { MCP_VERSION } from "./version.js";
|
|
@@ -187,6 +188,43 @@ function logUsage(fields) {
|
|
|
187
188
|
transport: "remote",
|
|
188
189
|
}).catch(() => { });
|
|
189
190
|
}
|
|
191
|
+
// ---------- o conector do carrossel (superfície enxuta do diretório) ----------
|
|
192
|
+
const MSG_CARROSSEL_INVALID = "Error: your Sint.fyi session is no longer valid. Disconnect and connect the Sint.fyi Carousel connector again in Claude's settings.";
|
|
193
|
+
/**
|
|
194
|
+
* A superfície "carrossel" (carrosselConnector.ts): só as tools grátis do
|
|
195
|
+
* carrossel, sem prompts e sem resources. Sessão válida continua obrigatória
|
|
196
|
+
* (é a conta da pessoa que guarda o carrossel), mas o gate de SALDO não vale:
|
|
197
|
+
* nada aqui cobra, e quem chega pelo diretório pode ter conta zerada.
|
|
198
|
+
*/
|
|
199
|
+
function initCarrosselServer(mcp) {
|
|
200
|
+
const s = mcp.server;
|
|
201
|
+
s.setRequestHandler(ListToolsRequestSchema, async () => ({
|
|
202
|
+
tools: buildCarrosselToolList(),
|
|
203
|
+
}));
|
|
204
|
+
s.setRequestHandler(CallToolRequestSchema, async (req) => {
|
|
205
|
+
const name = req.params.name;
|
|
206
|
+
const args = (req.params.arguments ?? {});
|
|
207
|
+
const token = getSessionToken();
|
|
208
|
+
const session = await resolveRemoteSession(token);
|
|
209
|
+
if (session.status === "invalid") {
|
|
210
|
+
return isErrorResult(MSG_CARROSSEL_INVALID);
|
|
211
|
+
}
|
|
212
|
+
if (session.status === "unknown") {
|
|
213
|
+
return isErrorResult("Error: could not check your session right now. Try again in a moment.");
|
|
214
|
+
}
|
|
215
|
+
const t0 = Date.now();
|
|
216
|
+
const result = await callCarrosselTool(name, args);
|
|
217
|
+
logUsage({
|
|
218
|
+
tool: name,
|
|
219
|
+
action: null,
|
|
220
|
+
ok: !result.isError,
|
|
221
|
+
ms: Date.now() - t0,
|
|
222
|
+
tier: session.tier,
|
|
223
|
+
token,
|
|
224
|
+
});
|
|
225
|
+
return result;
|
|
226
|
+
});
|
|
227
|
+
}
|
|
190
228
|
// ---------- o servidor MCP (registry compartilhado com o stdio) ----------
|
|
191
229
|
function initServer(mcp) {
|
|
192
230
|
// Registra os handlers direto no Server de baixo nível: paridade exata com o
|
|
@@ -281,12 +319,24 @@ export function createSapiensRemoteHandler(opts) {
|
|
|
281
319
|
const ipLimiter = new WindowLimiter(limits.perIpPerMin, 60_000);
|
|
282
320
|
const authFailLimiter = new WindowLimiter(limits.authFailPerMin, 60_000);
|
|
283
321
|
const tokenLimiter = new WindowLimiter(limits.perTokenPerMin, 60_000);
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
322
|
+
if (!opts.basePath && !opts.endpoint) {
|
|
323
|
+
throw new Error("createSapiensRemoteHandler: passe basePath ou endpoint.");
|
|
324
|
+
}
|
|
325
|
+
const carrosselSurface = opts.surface === "carrossel";
|
|
326
|
+
const base = createMcpHandler(carrosselSurface ? initCarrosselServer : initServer, carrosselSurface
|
|
327
|
+
? {
|
|
328
|
+
serverInfo: { name: CARROSSEL_SERVER_NAME, version: MCP_VERSION },
|
|
329
|
+
capabilities: { tools: {} },
|
|
330
|
+
instructions: CARROSSEL_INSTRUCTIONS,
|
|
331
|
+
}
|
|
332
|
+
: {
|
|
333
|
+
serverInfo: { name: "mcp-sapiens", version: MCP_VERSION },
|
|
334
|
+
capabilities: { tools: {}, prompts: {}, resources: {} },
|
|
335
|
+
instructions: SAPIENS_INSTRUCTIONS,
|
|
336
|
+
}, {
|
|
337
|
+
...(opts.endpoint
|
|
338
|
+
? { streamableHttpEndpoint: opts.endpoint }
|
|
339
|
+
: { basePath: opts.basePath }),
|
|
290
340
|
maxDuration: opts.maxDuration ?? 300,
|
|
291
341
|
disableSse: true,
|
|
292
342
|
verboseLogs: opts.verboseLogs ?? false,
|
package/dist/skills.js
CHANGED
|
@@ -671,7 +671,7 @@ Quando um ASSUNTO FECHA (não a cada mensagem):
|
|
|
671
671
|
|
|
672
672
|
Assunto que foi só operação técnica: não chame. Um assunto de pessoa: um lote, no máximo 10 trocas.
|
|
673
673
|
|
|
674
|
-
|
|
674
|
+
**Avise antes, uma vez por sessão.** Na primeira vez que for anotar, diga em uma frase que você guarda no caderno dele no Sapiens o que for de pessoa nesta conversa, e que ele vê esse caderno no fio do chat do site e pode apagar lá. Se ele disser que não, não anote nada nesta sessão. Com o sim, ou sem objeção, anote sem interromper o assunto a cada vez. Se der \`skipped\`, siga a conversa (não é erro dele).
|
|
675
675
|
|
|
676
676
|
## Gravar diretriz
|
|
677
677
|
|
package/dist/tools/carrossel.js
CHANGED
|
@@ -144,19 +144,35 @@ export async function carrossel(args) {
|
|
|
144
144
|
// pessoa pode escolher as fotos antes mesmo de conectar a conta.
|
|
145
145
|
if (args.action === "search_images") {
|
|
146
146
|
const limit = args.limit ?? 12;
|
|
147
|
-
const
|
|
147
|
+
const buscar = (search) => convexQuery("stock:getImages", {
|
|
148
148
|
limit,
|
|
149
|
-
...(
|
|
149
|
+
...(search ? { search } : {}),
|
|
150
150
|
...(args.orientation ? { orientation: args.orientation } : {}),
|
|
151
151
|
});
|
|
152
|
+
// O texto de busca do banco guarda o acento como foi escrito: as tags
|
|
153
|
+
// automáticas vêm sem ("xicara de cafe") e as manuais com ("cinemático").
|
|
154
|
+
// Quem pede "café" não achava nada. Busca as duas formas e junta.
|
|
155
|
+
const termo = args.query?.trim() || undefined;
|
|
156
|
+
const semAcento = termo?.normalize("NFD").replace(/[̀-ͯ]/g, "");
|
|
157
|
+
const listas = await Promise.all(termo && semAcento && semAcento !== termo ? [buscar(semAcento), buscar(termo)] : [buscar(termo)]);
|
|
158
|
+
const vistos = new Set();
|
|
159
|
+
const fotos = listas
|
|
160
|
+
.flat()
|
|
161
|
+
.filter((f) => f && !vistos.has(f._id) && vistos.add(f._id))
|
|
162
|
+
.slice(0, limit);
|
|
163
|
+
// Resposta enxuta: quem lê é o Claude da pessoa, e cada foto do banco traz
|
|
164
|
+
// dezenas de tags (inglês, português, artista parecido, carimbo do tagger).
|
|
165
|
+
const RUIDO = /autotagger|similar artist|artista similar/i;
|
|
152
166
|
return {
|
|
153
167
|
custo: 0,
|
|
154
168
|
total: fotos.length,
|
|
155
|
-
fotos:
|
|
169
|
+
fotos: fotos.map((f) => ({
|
|
156
170
|
id: f._id,
|
|
157
171
|
title: f.title,
|
|
158
|
-
description: f.description
|
|
159
|
-
|
|
172
|
+
description: f.description
|
|
173
|
+
? String(f.description).replace(/^#\s*Description\s*/i, "").slice(0, 240)
|
|
174
|
+
: null,
|
|
175
|
+
tags: (f.tags ?? []).filter((t) => !RUIDO.test(t)).slice(0, 10),
|
|
160
176
|
width: f.width ?? null,
|
|
161
177
|
height: f.height ?? null,
|
|
162
178
|
thumbnailUrl: f.thumbnailUrl ?? f.url,
|
package/dist/tools/sintetico.js
CHANGED
|
@@ -481,7 +481,7 @@ export async function sintetico(args) {
|
|
|
481
481
|
}
|
|
482
482
|
return {
|
|
483
483
|
...res,
|
|
484
|
-
note: "Anotado no fio do par (o mesmo que aparece no chat do site). Vira lição sozinho quando o par acumular conversa.
|
|
484
|
+
note: "Anotado no fio do par (o mesmo que aparece no chat do site). Vira lição sozinho quando o par acumular conversa. Se você ainda não avisou nesta sessão que anota no caderno dele o que é de pessoa (ele vê e apaga no chat do site), avise agora em uma frase. Se ele recusar, pare de anotar nesta sessão. Depois do aviso, não precisa confirmar cada anotação.",
|
|
485
485
|
};
|
|
486
486
|
}
|
|
487
487
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sapiens-mcp",
|
|
3
|
-
"version": "1.113.
|
|
3
|
+
"version": "1.113.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",
|
|
@@ -36,7 +36,7 @@
|
|
|
36
36
|
"dev": "tsx src/index.ts",
|
|
37
37
|
"start": "node dist/index.js",
|
|
38
38
|
"pretest": "npm run build",
|
|
39
|
-
"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",
|
|
39
|
+
"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 test/carrossel-connector.test.mjs",
|
|
40
40
|
"prepublishOnly": "npm run build"
|
|
41
41
|
},
|
|
42
42
|
"repository": {
|