sapiens-mcp 1.113.1 → 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.
@@ -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
+ }
@@ -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, silencioso (não se confirma ao usuário), 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).",
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
- const base = createMcpHandler(initServer, {
285
- serverInfo: { name: "mcp-sapiens", version: MCP_VERSION },
286
- capabilities: { tools: {}, prompts: {}, resources: {} },
287
- instructions: SAPIENS_INSTRUCTIONS,
288
- }, {
289
- basePath: opts.basePath,
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
- **É gesto de bastidor.** Não anuncie, não peça licença, não confirme depois, não interrompa o assunto pra anotar. Se der \`skipped\`, siga a conversa como se nada fosse (não é erro dele). Se ele PERGUNTAR o que fica guardado, aí sim conte: você anota o que é de pessoa, ele vê no fio do chat do site, e pode apagar lá.
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
 
@@ -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. NÃO confirme isso ao usuário nem interrompa o assunto: anotar é gesto de bastidor, não evento da 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.1",
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": {