sapiens-mcp 1.113.1 → 1.114.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/carrosselConnector.js +230 -0
- package/dist/convexClient.js +7 -4
- package/dist/registry.js +2 -2
- package/dist/remote.js +56 -6
- package/dist/skills.js +1 -1
- package/dist/tools/distribution.js +100 -3
- 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
|
},
|
|
@@ -238,7 +238,7 @@ export const TOOLS = {
|
|
|
238
238
|
handler: trilhas,
|
|
239
239
|
},
|
|
240
240
|
sapiens_distribution: {
|
|
241
|
-
description: "Despachar peças (Distribution Workflow): a peça pronta entra na FILA com canal, copy e a aba de quem ela é. ADMIN-ONLY: despacho depende de rede conectada e hoje só a casa tem. queue não posta: a peça entra na FILA. MARCAR HORA É APROVAR: status=agendado com scheduledFor faz o tique de 15 min publicar a peça SOZINHO na hora em todo canal da casa e em todo canal por login, menos o Instagram da casa (instagram), o X do Borderless (x, x-buffer) e o YouTube da casa (youtube), onde só toca a campainha pro dono. Então só marque hora no que o dono já aprovou. A ABA (`voice`) responde de quem é a peça: sapiens (a casa), helen-ailith, borderless, ou o slug de um personagem seu, slug livre, então personagem novo ganha aba sozinho na primeira peça dele, sem deploy. Em queue, aba ausente = o servidor deriva do personagem da peça e cai em sapiens quando não há. Sub-actions: queue (põe na fila: title e channel obrigatórios, mais copy/hashtags/assetUrl/notes; replyText é o comentário que sai junto do post, onde vai o link, e só o X (resposta no fio) e a Página do LinkedIn (primeiro comentário) publicam, o resto recusa; num canal do Instagram, format instagram_story faz a peça sair como STORY: uma mídia só, sem legenda nem link, some em 24h; num Reel, videoCoverUrl é a CAPA da casa, que pela API só entra aqui, e o retorno traz `aviso` quando a mesma abertura, a 1a linha da copy, já foi ao ar na mesma rede por qualquer aba: a peça entra mesmo assim, e você mostra o aviso ao dono antes de seguir, porque série de molde abre igual e é outra peça, mas a mesma notícia por duas abas é repetição). Em queue, DOIS campos que parecem opcionais e não são: `lang` diz em que língua a copy já está, e sem ele canal de rede internacional reescreve a sua copy sozinho, dois segundos depois, na voz da casa; `assetPageAssetId` é o imageId da obra da casa, e sem ele a peça só encontra a obra se a assetUrl bater letra a letra, então versão web de um master nasce órfã de ficha; e `categoria` diz o que a peça É (arte, personagem, tecnico, novidade, educativo, mercado, pessoal, o significado de cada uma na descrição do campo): declare sempre que souber, senão a régua chuta pelo título e a peça cai na gaveta errada da fila, list (o que está na fila, filtrável por status, por aba e por categoria ('sem' é a triagem), com copy, hashtags e notas de cada peça; fila maior que o limit se lê inteira pelo cursor antesDe=proximoCursor), voices (as abas que existem hoje com a contagem de cada uma), status (move a peça de lane: fila, agendado, postado, descartado; postado aceita postUrl e fecha o rastro, agendado aceita scheduledFor em ms), edit (reescreve a peça da FILA sem tirar ela do lugar: itemId e só o que muda, copy, title, publicTitle, hashtags, notes, lang, replyText, assetUrl/assetKind, assets, videoCoverUrl ou categoria (esta vale em peça postada também, e null devolve pra régua); é o gesto pra corrigir legenda, nunca descartar e enfileirar de novo; texto de peça postada o servidor recusa), sign (liga ou desliga a ASSINATURA da peça, imagem e vídeo do CDN da casa, com o carimbo da LINHAGEM de quem assina: sint.fyi/<endereço dela> no canto e o fecho de 2s no vídeo, ou a marca própria dela sem nada da casa; itemId, e signed com true de default; o carimbo da casa é recusado em peça +18 e praça adulta, a marca própria passa; o carimbo leva uns 30s e até lá a peça não sai; em queue, signed:true já enfileira assinada), bio (lê ou troca a BIO de uma conta da casa no Bluesky, channel bluesky ou bluesky-2 a bluesky-5: sem texto só lê; bioLine acrescenta uma linha no fim sem mexer no resto e não repete linha que já está lá; bio reescreve a inteira; teto de 256; ESTA sub-action muda o perfil público na hora, e bio não aceita hiperlink, o endereço aparece escrito), lineages (o CADASTRO das linhagens, o mesmo da aba Teia: de cada personagem, produto e da casa, a mãe no Bluesky onde a peça nasce, as contas próprias, as galerias que a mãe alimenta sozinha, as fichas e o post do dia, mais as regras que a teia desdobra e as vagas de conta ainda sem dona), lineage-new (nasce uma linhagem: nome obrigatório, grupo, artigo, lang; nasce sem mãe, então nada viaja sozinho até o lineage-save dar a mãe), lineage-save (slug e só o que muda: mae, contas rede->canal, galerias, fichaIds, rotina, contaNaCasa, assinatura {estilo casa|propria|nenhuma, marca, padrao}; o servidor recusa conta que já é de outra linhagem e canal de outra rede, e a vaga assumida ganha o nome da linhagem), lineage-archive (slug + arquivada), tree (a ÁRVORE DE CONTAS, o formulário de quem existe onde: linhagem × rede, com o email, o @, o canal e o estado de cada conta, ligada, desligada, fora, falta ou dispensa, mais o passo pra ligar cada rede; slug filtra uma linhagem), tree-mark (slug + celulas [{rede, handle, canal, dispensada}]: registra o email ou o @ que existe lá fora, associa a conta da casa ou dispensa rede opcional, a linhagem inteira de uma vez e tudo ou nada; X, Instagram, Bluesky, email e Telegram são obrigatórias e não se dispensam), garimpo (o ACERVO em famílias pra escolher o que vai pra fila: só as candidatas saem, a versão velha de um corte ou upscale vem marcada como substituída, as irmãs da mesma ideia vêm agrupadas pra escolha no olho, o painel cortado vem em recortes (o original e os quadros em ordem, que só saem juntos em carrossel), e cada família diz por onde já saiu; paraCanal tira o que já foi pro canal pedido, soResumo conta sem listar, página por cursor em antesDe; o passo a passo é a skill distribuir). Sem custo em Sinapses: isto organiza, não gera. A copy segue a voz de QUEM ASSINA a peça, que não é sempre a voz da casa: peça da Helen fala como a Helen. E a peça sai pela CONTA de quem assina ela: conta extra da mesma rede é um canal próprio (bluesky-2 é outra conta no Bluesky, instagram-pro outra no Instagram), então case o canal com a aba antes de despachar.",
|
|
241
|
+
description: "Despachar peças (Distribution Workflow): a peça pronta entra na FILA com canal, copy e a aba de quem ela é. ADMIN-ONLY: despacho depende de rede conectada e hoje só a casa tem. queue não posta: a peça entra na FILA. MARCAR HORA É APROVAR: status=agendado com scheduledFor faz o tique de 15 min publicar a peça SOZINHO na hora em todo canal da casa e em todo canal por login, menos o Instagram da casa (instagram), o X do Borderless (x, x-buffer) e o YouTube da casa (youtube), onde só toca a campainha pro dono. Então só marque hora no que o dono já aprovou. A ABA (`voice`) responde de quem é a peça: sapiens (a casa), helen-ailith, borderless, ou o slug de um personagem seu, slug livre, então personagem novo ganha aba sozinho na primeira peça dele, sem deploy. Em queue, aba ausente = o servidor deriva do personagem da peça e cai em sapiens quando não há. Sub-actions: queue (põe na fila: title e channel obrigatórios, mais copy/hashtags/assetUrl/notes; replyText é o comentário que sai junto do post, onde vai o link, e só o X (resposta no fio) e a Página do LinkedIn (primeiro comentário) publicam, o resto recusa; num canal do Instagram, format instagram_story faz a peça sair como STORY: uma mídia só, sem legenda nem link, some em 24h; num Reel, videoCoverUrl é a CAPA da casa, que pela API só entra aqui, e a ação capa a monta no molde sem você renderizar nada; igCollaborators são as contas que assinam o post do Instagram junto, até 3, e o retorno traz `aviso` quando a mesma abertura, a 1a linha da copy, já foi ao ar na mesma rede por qualquer aba: a peça entra mesmo assim, e você mostra o aviso ao dono antes de seguir, porque série de molde abre igual e é outra peça, mas a mesma notícia por duas abas é repetição). Em queue, DOIS campos que parecem opcionais e não são: `lang` diz em que língua a copy já está, e sem ele canal de rede internacional reescreve a sua copy sozinho, dois segundos depois, na voz da casa; `assetPageAssetId` é o imageId da obra da casa, e sem ele a peça só encontra a obra se a assetUrl bater letra a letra, então versão web de um master nasce órfã de ficha; e `categoria` diz o que a peça É (arte, personagem, tecnico, novidade, educativo, mercado, pessoal, o significado de cada uma na descrição do campo): declare sempre que souber, senão a régua chuta pelo título e a peça cai na gaveta errada da fila, list (o que está na fila, filtrável por status, por aba e por categoria ('sem' é a triagem), com copy, hashtags e notas de cada peça; em peça postada vem também o RETORNO que a rede contou, em reach: views, likes, comments e reposts de YouTube, Instagram, Bluesky, Farcaster e Tumblr, onde null é métrica que a rede não expõe ou que ainda não foi lida, nunca zero, e fetchedAt diz de quando é o número, que só renova quando o dono abre o painel; fila maior que o limit se lê inteira pelo cursor antesDe=proximoCursor), voices (as abas que existem hoje com a contagem de cada uma), status (move a peça de lane: fila, agendado, postado, descartado; postado aceita postUrl e fecha o rastro, agendado aceita scheduledFor em ms), edit (reescreve a peça da FILA sem tirar ela do lugar: itemId e só o que muda, copy, title, publicTitle, hashtags, notes, lang, replyText, assetUrl/assetKind, assets, videoCoverUrl, igCollaborators ou categoria (esta vale em peça postada também, e null devolve pra régua); é o gesto pra corrigir legenda, nunca descartar e enfileirar de novo; texto de peça postada o servidor recusa), capa (monta a CAPA DE REEL no molde da casa e grava na peça, numa chamada: itemId de uma peça com vídeo, capaDestaque (linha de cima, verde) e capaTitulo (linha de baixo), em inglês, 2 a 4 palavras cada; a base é um quadro do vídeo no segundo capaFrameAt, ou a imagem de capaBaseUrl; sem itemId só monta e devolve a url pra entrar no queue como videoCoverUrl; não custa Sinapse; todo Reel novo da casa sai com capa, então depois de enfileirar um Reel chame capa, ABRA a imagem que volta e mostre ao dono), sign (liga ou desliga a ASSINATURA da peça, imagem e vídeo do CDN da casa, com o carimbo da LINHAGEM de quem assina: sint.fyi/<endereço dela> no canto e o fecho de 2s no vídeo, ou a marca própria dela sem nada da casa; itemId, e signed com true de default; o carimbo da casa é recusado em peça +18 e praça adulta, a marca própria passa; o carimbo leva uns 30s e até lá a peça não sai; em queue, signed:true já enfileira assinada), bio (lê ou troca a BIO de uma conta da casa no Bluesky, channel bluesky ou bluesky-2 a bluesky-5: sem texto só lê; bioLine acrescenta uma linha no fim sem mexer no resto e não repete linha que já está lá; bio reescreve a inteira; teto de 256; ESTA sub-action muda o perfil público na hora, e bio não aceita hiperlink, o endereço aparece escrito), lineages (o CADASTRO das linhagens, o mesmo da aba Teia: de cada personagem, produto e da casa, a mãe no Bluesky onde a peça nasce, as contas próprias, as galerias que a mãe alimenta sozinha, as fichas e o post do dia, mais as regras que a teia desdobra e as vagas de conta ainda sem dona), lineage-new (nasce uma linhagem: nome obrigatório, grupo, artigo, lang; nasce sem mãe, então nada viaja sozinho até o lineage-save dar a mãe), lineage-save (slug e só o que muda: mae, contas rede->canal, galerias, fichaIds, rotina, contaNaCasa, assinatura {estilo casa|propria|nenhuma, marca, padrao}; o servidor recusa conta que já é de outra linhagem e canal de outra rede, e a vaga assumida ganha o nome da linhagem), lineage-archive (slug + arquivada), tree (a ÁRVORE DE CONTAS, o formulário de quem existe onde: linhagem × rede, com o email, o @, o canal e o estado de cada conta, ligada, desligada, fora, falta ou dispensa, mais o passo pra ligar cada rede; slug filtra uma linhagem), tree-mark (slug + celulas [{rede, handle, canal, dispensada}]: registra o email ou o @ que existe lá fora, associa a conta da casa ou dispensa rede opcional, a linhagem inteira de uma vez e tudo ou nada; X, Instagram, Bluesky, email e Telegram são obrigatórias e não se dispensam), garimpo (o ACERVO em famílias pra escolher o que vai pra fila: só as candidatas saem, a versão velha de um corte ou upscale vem marcada como substituída, as irmãs da mesma ideia vêm agrupadas pra escolha no olho, o painel cortado vem em recortes (o original e os quadros em ordem, que só saem juntos em carrossel), e cada família diz por onde já saiu; paraCanal tira o que já foi pro canal pedido, soResumo conta sem listar, página por cursor em antesDe; o passo a passo é a skill distribuir). Sem custo em Sinapses: isto organiza, não gera. A copy segue a voz de QUEM ASSINA a peça, que não é sempre a voz da casa: peça da Helen fala como a Helen. E a peça sai pela CONTA de quem assina ela: conta extra da mesma rede é um canal próprio (bluesky-2 é outra conta no Bluesky, instagram-pro outra no Instagram), então case o canal com a aba antes de despachar.",
|
|
242
242
|
schema: distributionSchema,
|
|
243
243
|
handler: distribution,
|
|
244
244
|
},
|
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
|
|
|
@@ -204,6 +204,7 @@ export const distributionSchema = z.object({
|
|
|
204
204
|
"voices",
|
|
205
205
|
"status",
|
|
206
206
|
"edit",
|
|
207
|
+
"capa",
|
|
207
208
|
"sign",
|
|
208
209
|
"bio",
|
|
209
210
|
"lineages",
|
|
@@ -249,7 +250,52 @@ export const distributionSchema = z.object({
|
|
|
249
250
|
videoCoverUrl: z
|
|
250
251
|
.string()
|
|
251
252
|
.optional()
|
|
252
|
-
.describe("queue/edit: a CAPA do vídeo, a imagem que o perfil do Instagram mostra no lugar de um quadro qualquer do Reel. Pela API ela só entra na hora de postar: Reel publicado só troca de capa à mão no app, então a capa nasce com a peça.
|
|
253
|
+
.describe("queue/edit: a CAPA do vídeo, a imagem que o perfil do Instagram mostra no lugar de um quadro qualquer do Reel. Pela API ela só entra na hora de postar: Reel publicado só troca de capa à mão no app, então a capa nasce com a peça. O caminho curto é action=capa, que monta o molde da casa no servidor e já grava na peça: use este campo só quando a capa já existe como arquivo (o molde renderizado na skill thumbnail, --formato reel, 1080x1920, subido com sapiens_gallery action=upload filePath=<o .jpg>). Imagem (jpg, png, webp) num host da casa, e só em peça que leva vídeo; o servidor recusa o resto. Só o Reels do Instagram publica (instagram, instagram-pro, instagram-3..8 e instagram-up*); story e carrossel ignoram. Nas outras redes o campo viaja sem efeito: ponha a capa na MÃE do Bluesky e a teia leva até a filha do Instagram. Em edit, string vazia tira a capa."),
|
|
254
|
+
capaDestaque: z
|
|
255
|
+
.string()
|
|
256
|
+
.max(40)
|
|
257
|
+
.optional()
|
|
258
|
+
.describe("capa: a linha de CIMA do título, no verde da casa. Em inglês, 2 a 4 palavras, que afirma (ex: 'She keeps'). Caixa alta é do molde: escreva normal. Linha larga encolhe sozinha até caber. Ao menos uma das duas linhas (capaDestaque ou capaTitulo) é obrigatória."),
|
|
259
|
+
capaTitulo: z
|
|
260
|
+
.string()
|
|
261
|
+
.max(40)
|
|
262
|
+
.optional()
|
|
263
|
+
.describe("capa: a linha de BAIXO do título, em off-white (ex: 'The voice'). Mesma régua da de cima. Nada de nome de motor nem de 'AI' na capa: a copy da casa não declara IA."),
|
|
264
|
+
capaBaseUrl: z
|
|
265
|
+
.string()
|
|
266
|
+
.optional()
|
|
267
|
+
.describe("capa: a IMAGEM que vai por baixo do título, quando não deve ser um quadro do vídeo (a arte do take, um quadro que você escolheu e subiu). Imagem jpg, png ou webp no CDN da casa, a url que sapiens_gallery devolve. Ausente, a base é um quadro do vídeo da peça."),
|
|
268
|
+
capaVideoUrl: z
|
|
269
|
+
.string()
|
|
270
|
+
.optional()
|
|
271
|
+
.describe("capa, SEM itemId: o vídeo de onde sai o quadro da base (mp4, mov ou webm no CDN da casa). Com itemId não precisa: o servidor usa o vídeo da peça."),
|
|
272
|
+
capaFrameAt: z
|
|
273
|
+
.number()
|
|
274
|
+
.min(0)
|
|
275
|
+
.max(600)
|
|
276
|
+
.optional()
|
|
277
|
+
.describe("capa: o SEGUNDO do vídeo de onde sai o quadro da base. Default 1 (muito take abre em preto no 0). Escolha o segundo em que o sujeito está inteiro e legível na metade de cima do quadro: o título ocupa a faixa de baixo."),
|
|
278
|
+
capaAssinatura: z
|
|
279
|
+
.enum(["sint", "borderless"])
|
|
280
|
+
.optional()
|
|
281
|
+
.describe("capa: quem assina em cima do título. 'sint' (default) escreve Sint.fyi, a conta da casa; 'borderless' escreve Borderless, só pro Instagram do dono."),
|
|
282
|
+
capaPatina: z
|
|
283
|
+
.enum(["leve", "media", "forte"])
|
|
284
|
+
.optional()
|
|
285
|
+
.describe("capa: a camada que apaga, desbota e desfoca a peça pra o título ser o que se lê primeiro. 'media' (default) é a da casa e é ela que faz o grid ler como série. 'leve' e 'forte' existem pra peça que já nasce muito escura ou muito clara, não pra variar o grid."),
|
|
286
|
+
capaEncaixe: z
|
|
287
|
+
.enum(["auto", "cobre", "inteira"])
|
|
288
|
+
.optional()
|
|
289
|
+
.describe("capa: como a peça entra no quadro 9:16. 'auto' (default) decide pelo formato: peça em pé cobre o quadro inteiro, peça deitada ou 4:5 entra inteira acima do título, sobre ela mesma desfocada. 'cobre' e 'inteira' forçam."),
|
|
290
|
+
capaFoco: z
|
|
291
|
+
.string()
|
|
292
|
+
.optional()
|
|
293
|
+
.describe("capa, só quando a peça cobre o quadro: de onde o corte olha, no formato do object-position do CSS, 'X% Y%'. Default '50% 50%'. Sujeito que fugiu pro alto: '50% 35%'."),
|
|
294
|
+
igCollaborators: z
|
|
295
|
+
.array(z.string())
|
|
296
|
+
.max(3)
|
|
297
|
+
.optional()
|
|
298
|
+
.describe("queue/edit, só canal do Instagram por login (instagram, instagram-pro, instagram-3 em diante): os COLABORADORES do post, as contas que assinam junto. A Meta manda o convite, a conta aceita e o post passa a aparecer no feed dela também, pros seguidores dela. Até 3 usernames, com ou sem @ (o servidor limpa), e a conta convidada precisa ser pública. Vale em foto, carrossel e Reel; story sai sozinho. O post vai ao ar na hora mesmo com convite pendente, e quem aceitou não se lê pela API. É estrutura, não marcação: marcar alguém na legenda é texto da copy. Em edit, lista vazia tira todo mundo. Colaborador é convite a uma conta de verdade: só ponha quem o dono nomeou. Ex: ['helenai.wtf']."),
|
|
253
299
|
assetUrl: z
|
|
254
300
|
.string()
|
|
255
301
|
.optional()
|
|
@@ -321,7 +367,7 @@ export const distributionSchema = z.object({
|
|
|
321
367
|
.boolean()
|
|
322
368
|
.optional()
|
|
323
369
|
.describe("sign: true liga (o default), false desliga. queue: true enfileira a peça já com a assinatura ligada. A ASSINATURA carimba a IMAGEM e o VÍDEO da peça que moram no CDN da casa (o que sapiens_image/sapiens_video/sapiens_gallery devolvem), com o carimbo da LINHAGEM de quem assina a peça (a aba dela, ver lineages): no estilo casa, sint.fyi/<conta da linhagem na casa, ou o dono> no canto e, no vídeo, o fecho de 2 segundos no fim (o vídeo fica 2s mais longo); no estilo propria, só a marca da linhagem (ex: Velourie), sem nada da casa e sem fecho; no estilo nenhuma, o servidor recusa. O carimbo da casa é RECUSADO em peça +18 e em praça com teto adulto (fanvue, fanvue-dm, pornhub, redgifs, sexcom, civitai-red), porque sint.fyi é endereço da casa; a marca própria passa. A imagem do feed do Instagram é carimbada já recortada pra 4:5 a 1.91:1. O carimbo leva uns 30s na primeira vez (na hora quando a mídia já foi assinada antes), e enquanto ele não fica pronto a peça NÃO sai: o botão de postar da tela devolve o motivo."),
|
|
324
|
-
itemId: z.string().optional().describe("status/sign/edit: o id da peça (vem do list ou do queue)."),
|
|
370
|
+
itemId: z.string().optional().describe("status/sign/edit/capa: o id da peça (vem do list ou do queue). Em capa, é a peça que recebe a capa montada; sem ele a capa só é montada e devolvida."),
|
|
325
371
|
status: z
|
|
326
372
|
.enum(["fila", "agendado", "postado", "descartado"])
|
|
327
373
|
.optional()
|
|
@@ -514,6 +560,8 @@ export async function distribution(args) {
|
|
|
514
560
|
captionTracks: args.captionTracks,
|
|
515
561
|
localizations: args.localizations,
|
|
516
562
|
videoCoverUrl: args.videoCoverUrl,
|
|
563
|
+
// Só vai quando declarado: servidor anterior a 10/11/2026 não conhece o arg na fila.
|
|
564
|
+
igCollaborators: args.igCollaborators,
|
|
517
565
|
assetUrl: args.assetUrl,
|
|
518
566
|
assetKind: args.assetKind,
|
|
519
567
|
assets: args.assets,
|
|
@@ -607,12 +655,13 @@ export async function distribution(args) {
|
|
|
607
655
|
assetKind: args.assetKind,
|
|
608
656
|
assets: args.assets,
|
|
609
657
|
videoCoverUrl: args.videoCoverUrl,
|
|
658
|
+
igCollaborators: args.igCollaborators,
|
|
610
659
|
// null viaja: é o gesto de devolver a peça pra régua.
|
|
611
660
|
categoria: args.categoria,
|
|
612
661
|
};
|
|
613
662
|
const mudou = Object.entries(campos).filter(([, v]) => v !== undefined);
|
|
614
663
|
if (mudou.length === 0) {
|
|
615
|
-
throw new Error("action=edit: mande ao menos um campo pra trocar (copy, title, publicTitle, hashtags, notes, lang, replyText, assetUrl/assetKind, assets, videoCoverUrl ou categoria).");
|
|
664
|
+
throw new Error("action=edit: mande ao menos um campo pra trocar (copy, title, publicTitle, hashtags, notes, lang, replyText, assetUrl/assetKind, assets, videoCoverUrl, igCollaborators ou categoria).");
|
|
616
665
|
}
|
|
617
666
|
await convexMutation("distributionMcp:mcpUpdateItem", {
|
|
618
667
|
sessionToken,
|
|
@@ -626,6 +675,54 @@ export async function distribution(args) {
|
|
|
626
675
|
instruction: "A peça continua na mesma lane e na mesma posição da fila, só com o que mudou. Texto de peça já postada o servidor recusa: o post na rede não muda junto. A categoria vale em qualquer lane.",
|
|
627
676
|
};
|
|
628
677
|
}
|
|
678
|
+
if (args.action === "capa") {
|
|
679
|
+
if (!args.capaDestaque?.trim() && !args.capaTitulo?.trim()) {
|
|
680
|
+
throw new Error("action=capa exige ao menos uma linha: capaDestaque (a de cima, em verde) ou capaTitulo (a de baixo).");
|
|
681
|
+
}
|
|
682
|
+
if (!args.itemId && !args.capaBaseUrl && !args.capaVideoUrl) {
|
|
683
|
+
throw new Error("action=capa exige a peça de baixo: itemId de uma peça com vídeo (a capa já fica gravada nela), ou capaBaseUrl / capaVideoUrl pra só montar e receber a url.");
|
|
684
|
+
}
|
|
685
|
+
const r = await convexAction("distributionMcp:mcpCapaDoReel", {
|
|
686
|
+
sessionToken,
|
|
687
|
+
itemId: args.itemId,
|
|
688
|
+
destaque: args.capaDestaque,
|
|
689
|
+
titulo: args.capaTitulo,
|
|
690
|
+
baseUrl: args.capaBaseUrl,
|
|
691
|
+
videoUrl: args.capaVideoUrl,
|
|
692
|
+
frameAt: args.capaFrameAt,
|
|
693
|
+
assinatura: args.capaAssinatura,
|
|
694
|
+
patina: args.capaPatina,
|
|
695
|
+
encaixe: args.capaEncaixe,
|
|
696
|
+
foco: args.capaFoco,
|
|
697
|
+
}, {
|
|
698
|
+
ondeConferir: args.itemId
|
|
699
|
+
? "sapiens_distribution action=list (o videoCoverUrl da peça diz se a capa entrou)"
|
|
700
|
+
: "nada foi gravado em peça nenhuma: pode repetir a chamada, o resultado é o mesmo arquivo",
|
|
701
|
+
});
|
|
702
|
+
return {
|
|
703
|
+
ok: true,
|
|
704
|
+
videoCoverUrl: r.videoCoverUrl,
|
|
705
|
+
itemId: r.itemId,
|
|
706
|
+
gravada: r.gravada,
|
|
707
|
+
encaixe: r.encaixe,
|
|
708
|
+
base: r.base,
|
|
709
|
+
corpos: r.corpos,
|
|
710
|
+
instruction: [
|
|
711
|
+
!r.gravada
|
|
712
|
+
? "A capa está montada e NÃO está em peça nenhuma: passe esta url em videoCoverUrl no queue (ou no edit)."
|
|
713
|
+
: r.publicaCapa === false
|
|
714
|
+
? "A capa está gravada nesta peça, que NÃO é de Instagram: aqui ela só fica guardada. Ela desce pras filhas do Instagram que nascerem DEPOIS pela teia; filha que já está na fila não recebe, e pede action=capa com o itemId dela."
|
|
715
|
+
: "A capa está gravada na peça e sai junto com o Reel.",
|
|
716
|
+
"ABRA a imagem e olhe antes de seguir: o sujeito tem que estar legível acima do título, e o título não pode cobrir o rosto. Fora do lugar, chame de novo com outro capaFrameAt, capaFoco ou capaEncaixe: a capa nova substitui a anterior na peça.",
|
|
717
|
+
r.corpos?.titulo === 60 || r.corpos?.destaque === 60
|
|
718
|
+
? "Uma das linhas caiu no corpo mínimo (60): está comprida demais pro molde. Encurte pra 2 a 4 palavras."
|
|
719
|
+
: null,
|
|
720
|
+
"Mostre a capa ao dono como imagem. Reel que já foi ao ar não troca de capa pela API.",
|
|
721
|
+
]
|
|
722
|
+
.filter(Boolean)
|
|
723
|
+
.join(" "),
|
|
724
|
+
};
|
|
725
|
+
}
|
|
629
726
|
if (args.action === "voices") {
|
|
630
727
|
return await convexQuery("distributionMcp:mcpVoices", { sessionToken });
|
|
631
728
|
}
|
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.
|
|
3
|
+
"version": "1.114.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",
|
|
@@ -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": {
|