@speakai/mcp-server 1.34.0 → 1.35.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/index.js +264 -28
- package/package.json +2 -2
package/dist/index.js
CHANGED
|
@@ -245,7 +245,7 @@ function registerSpeakTool(server, name, description, inputSchema, annotations,
|
|
|
245
245
|
})
|
|
246
246
|
);
|
|
247
247
|
}
|
|
248
|
-
var import_zod, passthroughOutputSchema;
|
|
248
|
+
var import_zod, passthroughOutputSchema, fieldIdSchema, SHARED_DASHBOARD_CACHE_NOTE;
|
|
249
249
|
var init_helpers = __esm({
|
|
250
250
|
"src/tools/_helpers.ts"() {
|
|
251
251
|
"use strict";
|
|
@@ -254,6 +254,10 @@ var init_helpers = __esm({
|
|
|
254
254
|
passthroughOutputSchema = {
|
|
255
255
|
data: import_zod.z.unknown().describe("Response payload from the Speak AI API")
|
|
256
256
|
};
|
|
257
|
+
fieldIdSchema = import_zod.z.string().min(1).refine((value) => !/^[0-9a-fA-F]{24}$/.test(value), {
|
|
258
|
+
message: "This looks like the field's database _id. Use the field `id` from list_fields or create_field (12 characters)."
|
|
259
|
+
}).describe("Field `id` from list_fields or create_field (12 characters), never the database `_id`");
|
|
260
|
+
SHARED_DASHBOARD_CACHE_NOTE = "Shared dashboard links cache widget data, so field and media edits can take up to about 5 minutes to show for date ranges that include today (15 at most) and up to about 17 minutes for past ranges (60 at most); any dashboard update refreshes it at once.";
|
|
257
261
|
}
|
|
258
262
|
});
|
|
259
263
|
|
|
@@ -723,6 +727,7 @@ var init_menu = __esm({
|
|
|
723
727
|
MenuItemId2["Developers"] = "developers-manage";
|
|
724
728
|
MenuItemId2["AiAssistant"] = "ai-assistant";
|
|
725
729
|
MenuItemId2["Fields"] = "fields";
|
|
730
|
+
MenuItemId2["Labels"] = "labels";
|
|
726
731
|
MenuItemId2["KnowledgeBase"] = "knowledge-base";
|
|
727
732
|
MenuItemId2["AgentsList"] = "agents-list";
|
|
728
733
|
MenuItemId2["AgentsConversations"] = "agents-conversations";
|
|
@@ -1179,7 +1184,7 @@ var init_prompt = __esm({
|
|
|
1179
1184
|
});
|
|
1180
1185
|
|
|
1181
1186
|
// node_modules/@speakai/shared/dist/enums/recorder.js
|
|
1182
|
-
var RecorderAnswerType, RecorderUploadType, RecordingFeedbackRating;
|
|
1187
|
+
var RecorderAnswerType, RecorderUploadType, RecordingFeedbackRating, RecorderSessionEventType, RecorderSessionEventCategory, RecorderSessionWakeLock, RECORDER_SESSION_EVENTS;
|
|
1183
1188
|
var init_recorder = __esm({
|
|
1184
1189
|
"node_modules/@speakai/shared/dist/enums/recorder.js"() {
|
|
1185
1190
|
"use strict";
|
|
@@ -1203,6 +1208,150 @@ var init_recorder = __esm({
|
|
|
1203
1208
|
RecordingFeedbackRating2["POSITIVE"] = "positive";
|
|
1204
1209
|
RecordingFeedbackRating2["NEGATIVE"] = "negative";
|
|
1205
1210
|
})(RecordingFeedbackRating || (RecordingFeedbackRating = {}));
|
|
1211
|
+
(function(RecorderSessionEventType2) {
|
|
1212
|
+
RecorderSessionEventType2["VISIBILITY_HIDDEN"] = "visibility_hidden";
|
|
1213
|
+
RecorderSessionEventType2["VISIBILITY_VISIBLE"] = "visibility_visible";
|
|
1214
|
+
RecorderSessionEventType2["PAGE_FREEZE"] = "page_freeze";
|
|
1215
|
+
RecorderSessionEventType2["PAGE_RESUME"] = "page_resume";
|
|
1216
|
+
RecorderSessionEventType2["SUSPEND_DETECTED"] = "suspend_detected";
|
|
1217
|
+
RecorderSessionEventType2["WAKELOCK_ACQUIRED"] = "wakelock_acquired";
|
|
1218
|
+
RecorderSessionEventType2["WAKELOCK_RELEASED"] = "wakelock_released";
|
|
1219
|
+
RecorderSessionEventType2["WAKELOCK_DENIED"] = "wakelock_denied";
|
|
1220
|
+
RecorderSessionEventType2["FLOATING_WINDOW_OPENED"] = "floating_window_opened";
|
|
1221
|
+
RecorderSessionEventType2["FLOATING_WINDOW_CLOSED"] = "floating_window_closed";
|
|
1222
|
+
RecorderSessionEventType2["MIC_MUTED"] = "mic_muted";
|
|
1223
|
+
RecorderSessionEventType2["MIC_UNMUTED"] = "mic_unmuted";
|
|
1224
|
+
RecorderSessionEventType2["MIC_ENDED"] = "mic_ended";
|
|
1225
|
+
RecorderSessionEventType2["DEVICE_CHANGE"] = "device_change";
|
|
1226
|
+
RecorderSessionEventType2["RECORDER_ERROR"] = "recorder_error";
|
|
1227
|
+
RecorderSessionEventType2["GAP"] = "gap";
|
|
1228
|
+
RecorderSessionEventType2["ONLINE"] = "online";
|
|
1229
|
+
RecorderSessionEventType2["OFFLINE"] = "offline";
|
|
1230
|
+
RecorderSessionEventType2["POWER_CHANGE"] = "power_change";
|
|
1231
|
+
RecorderSessionEventType2["USER_PAUSE"] = "user_pause";
|
|
1232
|
+
RecorderSessionEventType2["USER_RESUME"] = "user_resume";
|
|
1233
|
+
RecorderSessionEventType2["LIVE_DISCONNECTED"] = "live_disconnected";
|
|
1234
|
+
RecorderSessionEventType2["LIVE_RECONNECTING"] = "live_reconnecting";
|
|
1235
|
+
RecorderSessionEventType2["LIVE_RESUMED"] = "live_resumed";
|
|
1236
|
+
RecorderSessionEventType2["LIVE_FAILED"] = "live_failed";
|
|
1237
|
+
})(RecorderSessionEventType || (RecorderSessionEventType = {}));
|
|
1238
|
+
(function(RecorderSessionEventCategory2) {
|
|
1239
|
+
RecorderSessionEventCategory2["DEVICE_SLEEP"] = "device_sleep";
|
|
1240
|
+
RecorderSessionEventCategory2["SCREEN_TAB"] = "screen_tab";
|
|
1241
|
+
RecorderSessionEventCategory2["AUDIO_CAPTURE"] = "audio_capture";
|
|
1242
|
+
RecorderSessionEventCategory2["LIVE_TRANSCRIPTION"] = "live_transcription";
|
|
1243
|
+
RecorderSessionEventCategory2["NETWORK"] = "network";
|
|
1244
|
+
RecorderSessionEventCategory2["POWER"] = "power";
|
|
1245
|
+
RecorderSessionEventCategory2["USER"] = "user";
|
|
1246
|
+
})(RecorderSessionEventCategory || (RecorderSessionEventCategory = {}));
|
|
1247
|
+
(function(RecorderSessionWakeLock2) {
|
|
1248
|
+
RecorderSessionWakeLock2["ACQUIRED"] = "acquired";
|
|
1249
|
+
RecorderSessionWakeLock2["DENIED"] = "denied";
|
|
1250
|
+
RecorderSessionWakeLock2["UNSUPPORTED"] = "unsupported";
|
|
1251
|
+
RecorderSessionWakeLock2["RELEASED"] = "released";
|
|
1252
|
+
})(RecorderSessionWakeLock || (RecorderSessionWakeLock = {}));
|
|
1253
|
+
RECORDER_SESSION_EVENTS = {
|
|
1254
|
+
[RecorderSessionEventType.SUSPEND_DETECTED]: {
|
|
1255
|
+
category: RecorderSessionEventCategory.DEVICE_SLEEP,
|
|
1256
|
+
description: "The laptop or browser was asleep, so no audio was recorded for that time."
|
|
1257
|
+
},
|
|
1258
|
+
[RecorderSessionEventType.PAGE_FREEZE]: {
|
|
1259
|
+
category: RecorderSessionEventCategory.DEVICE_SLEEP,
|
|
1260
|
+
description: "The browser paused the recorder page to save power."
|
|
1261
|
+
},
|
|
1262
|
+
[RecorderSessionEventType.PAGE_RESUME]: {
|
|
1263
|
+
category: RecorderSessionEventCategory.DEVICE_SLEEP,
|
|
1264
|
+
description: "The browser started running the recorder page again after pausing it."
|
|
1265
|
+
},
|
|
1266
|
+
[RecorderSessionEventType.VISIBILITY_HIDDEN]: {
|
|
1267
|
+
category: RecorderSessionEventCategory.SCREEN_TAB,
|
|
1268
|
+
description: "The recorder tab was hidden, for example another tab or app was in front or the screen locked."
|
|
1269
|
+
},
|
|
1270
|
+
[RecorderSessionEventType.VISIBILITY_VISIBLE]: {
|
|
1271
|
+
category: RecorderSessionEventCategory.SCREEN_TAB,
|
|
1272
|
+
description: "The recorder tab was visible on screen again."
|
|
1273
|
+
},
|
|
1274
|
+
[RecorderSessionEventType.WAKELOCK_ACQUIRED]: {
|
|
1275
|
+
category: RecorderSessionEventCategory.SCREEN_TAB,
|
|
1276
|
+
description: "The recorder asked the browser to keep the screen awake, and the browser agreed."
|
|
1277
|
+
},
|
|
1278
|
+
[RecorderSessionEventType.WAKELOCK_RELEASED]: {
|
|
1279
|
+
category: RecorderSessionEventCategory.SCREEN_TAB,
|
|
1280
|
+
description: "The recorder stopped keeping the screen awake, so the screen could turn off or lock."
|
|
1281
|
+
},
|
|
1282
|
+
[RecorderSessionEventType.WAKELOCK_DENIED]: {
|
|
1283
|
+
category: RecorderSessionEventCategory.SCREEN_TAB,
|
|
1284
|
+
description: "The browser did not allow the recorder to keep the screen awake."
|
|
1285
|
+
},
|
|
1286
|
+
[RecorderSessionEventType.FLOATING_WINDOW_OPENED]: {
|
|
1287
|
+
category: RecorderSessionEventCategory.SCREEN_TAB,
|
|
1288
|
+
description: "The recorder's small floating window was opened to keep the laptop awake."
|
|
1289
|
+
},
|
|
1290
|
+
[RecorderSessionEventType.FLOATING_WINDOW_CLOSED]: {
|
|
1291
|
+
category: RecorderSessionEventCategory.SCREEN_TAB,
|
|
1292
|
+
description: "The recorder's small floating window was closed; the recording continued."
|
|
1293
|
+
},
|
|
1294
|
+
[RecorderSessionEventType.GAP]: {
|
|
1295
|
+
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1296
|
+
description: "No audio was recorded for this stretch."
|
|
1297
|
+
},
|
|
1298
|
+
[RecorderSessionEventType.MIC_MUTED]: {
|
|
1299
|
+
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1300
|
+
description: "The microphone stopped sending sound, for example it was muted by the system or another app."
|
|
1301
|
+
},
|
|
1302
|
+
[RecorderSessionEventType.MIC_UNMUTED]: {
|
|
1303
|
+
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1304
|
+
description: "The microphone started sending sound again."
|
|
1305
|
+
},
|
|
1306
|
+
[RecorderSessionEventType.MIC_ENDED]: {
|
|
1307
|
+
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1308
|
+
description: "The microphone was disconnected or turned off, so the recorder could no longer hear it."
|
|
1309
|
+
},
|
|
1310
|
+
[RecorderSessionEventType.DEVICE_CHANGE]: {
|
|
1311
|
+
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1312
|
+
description: "A microphone, headset or other audio device was plugged in, unplugged or switched."
|
|
1313
|
+
},
|
|
1314
|
+
[RecorderSessionEventType.RECORDER_ERROR]: {
|
|
1315
|
+
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1316
|
+
description: "The browser reported an error while recording audio."
|
|
1317
|
+
},
|
|
1318
|
+
[RecorderSessionEventType.LIVE_DISCONNECTED]: {
|
|
1319
|
+
category: RecorderSessionEventCategory.LIVE_TRANSCRIPTION,
|
|
1320
|
+
description: "Live transcription lost its connection; the recording itself continued."
|
|
1321
|
+
},
|
|
1322
|
+
[RecorderSessionEventType.LIVE_RECONNECTING]: {
|
|
1323
|
+
category: RecorderSessionEventCategory.LIVE_TRANSCRIPTION,
|
|
1324
|
+
description: "Live transcription was trying to reconnect."
|
|
1325
|
+
},
|
|
1326
|
+
[RecorderSessionEventType.LIVE_RESUMED]: {
|
|
1327
|
+
category: RecorderSessionEventCategory.LIVE_TRANSCRIPTION,
|
|
1328
|
+
description: "Live transcription reconnected and continued."
|
|
1329
|
+
},
|
|
1330
|
+
[RecorderSessionEventType.LIVE_FAILED]: {
|
|
1331
|
+
category: RecorderSessionEventCategory.LIVE_TRANSCRIPTION,
|
|
1332
|
+
description: "Live transcription stopped and could not reconnect; the recording itself continued."
|
|
1333
|
+
},
|
|
1334
|
+
[RecorderSessionEventType.ONLINE]: {
|
|
1335
|
+
category: RecorderSessionEventCategory.NETWORK,
|
|
1336
|
+
description: "The internet connection came back."
|
|
1337
|
+
},
|
|
1338
|
+
[RecorderSessionEventType.OFFLINE]: {
|
|
1339
|
+
category: RecorderSessionEventCategory.NETWORK,
|
|
1340
|
+
description: "The internet connection was lost."
|
|
1341
|
+
},
|
|
1342
|
+
[RecorderSessionEventType.POWER_CHANGE]: {
|
|
1343
|
+
category: RecorderSessionEventCategory.POWER,
|
|
1344
|
+
description: "The device was plugged in to charge or unplugged."
|
|
1345
|
+
},
|
|
1346
|
+
[RecorderSessionEventType.USER_PAUSE]: {
|
|
1347
|
+
category: RecorderSessionEventCategory.USER,
|
|
1348
|
+
description: "The recording was paused."
|
|
1349
|
+
},
|
|
1350
|
+
[RecorderSessionEventType.USER_RESUME]: {
|
|
1351
|
+
category: RecorderSessionEventCategory.USER,
|
|
1352
|
+
description: "The recording was resumed after a pause."
|
|
1353
|
+
}
|
|
1354
|
+
};
|
|
1206
1355
|
}
|
|
1207
1356
|
});
|
|
1208
1357
|
|
|
@@ -1480,6 +1629,7 @@ var init_llm = __esm({
|
|
|
1480
1629
|
LLMModels2["GEMINI_3_5_FLASH"] = "gemini-3.5-flash";
|
|
1481
1630
|
LLMModels2["GEMINI_3_7_FLASH"] = "gemini-3.7-flash";
|
|
1482
1631
|
LLMModels2["GEMINI_3_8_FLASH"] = "gemini-3.8-flash";
|
|
1632
|
+
LLMModels2["GEMINI_4_ARGON"] = "gemini-4-argon";
|
|
1483
1633
|
LLMModels2["GROK_4_5"] = "x-ai/grok-4.5";
|
|
1484
1634
|
LLMModels2["GLM_5_2"] = "z-ai/glm-5.2";
|
|
1485
1635
|
})(LLMModels || (LLMModels = {}));
|
|
@@ -1671,10 +1821,22 @@ var init_dashboard_spec = __esm({
|
|
|
1671
1821
|
});
|
|
1672
1822
|
|
|
1673
1823
|
// node_modules/@speakai/shared/dist/interfaces/dashboard.js
|
|
1824
|
+
var DASHBOARD_PROFILE_GROUPS_MAX, DASHBOARD_PROFILE_ENTRIES_MAX, DASHBOARD_PROFILE_NAME_MAX, DASHBOARD_PROFILE_LABEL_MAX, DASHBOARD_PROFILE_DESCRIPTION_MAX, DASHBOARD_PROFILE_LINK_MAX, DASHBOARD_PROFILE_IMAGE_MAX_BYTES, DASHBOARD_PROFILE_IMAGE_KEY_MAX, DASHBOARD_PROFILE_ID_PATTERN, DASHBOARD_PROFILE_IMAGE_TYPES, DASHBOARD_PROFILE_IMAGE_SHAPES;
|
|
1674
1825
|
var init_dashboard = __esm({
|
|
1675
1826
|
"node_modules/@speakai/shared/dist/interfaces/dashboard.js"() {
|
|
1676
1827
|
"use strict";
|
|
1677
1828
|
init_dashboard_spec();
|
|
1829
|
+
DASHBOARD_PROFILE_GROUPS_MAX = 5;
|
|
1830
|
+
DASHBOARD_PROFILE_ENTRIES_MAX = 60;
|
|
1831
|
+
DASHBOARD_PROFILE_NAME_MAX = 80;
|
|
1832
|
+
DASHBOARD_PROFILE_LABEL_MAX = 40;
|
|
1833
|
+
DASHBOARD_PROFILE_DESCRIPTION_MAX = 600;
|
|
1834
|
+
DASHBOARD_PROFILE_LINK_MAX = 2048;
|
|
1835
|
+
DASHBOARD_PROFILE_IMAGE_MAX_BYTES = 2 * 1024 * 1024;
|
|
1836
|
+
DASHBOARD_PROFILE_IMAGE_KEY_MAX = 1024;
|
|
1837
|
+
DASHBOARD_PROFILE_ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
|
|
1838
|
+
DASHBOARD_PROFILE_IMAGE_TYPES = ["image/jpeg", "image/png", "image/webp", "image/gif"];
|
|
1839
|
+
DASHBOARD_PROFILE_IMAGE_SHAPES = ["round", "square"];
|
|
1678
1840
|
}
|
|
1679
1841
|
});
|
|
1680
1842
|
|
|
@@ -2939,7 +3101,8 @@ var init_registry = __esm({
|
|
|
2939
3101
|
label: "Gemini 2.5 Flash",
|
|
2940
3102
|
provider: LLMProvider.GOOGLE,
|
|
2941
3103
|
family: "gemini",
|
|
2942
|
-
|
|
3104
|
+
// Vertex retires it on 2026-10-20; retired so every resolver substitutes 3.7 Flash instead of dispatching it.
|
|
3105
|
+
status: "retired",
|
|
2943
3106
|
replacedBy: LLMModels.GEMINI_3_7_FLASH,
|
|
2944
3107
|
offeredInChat: false,
|
|
2945
3108
|
offeredInVoice: false,
|
|
@@ -2959,7 +3122,8 @@ var init_registry = __esm({
|
|
|
2959
3122
|
label: "Gemini 2.5 Pro",
|
|
2960
3123
|
provider: LLMProvider.GOOGLE,
|
|
2961
3124
|
family: "gemini",
|
|
2962
|
-
|
|
3125
|
+
// Vertex retires it on 2026-10-20.
|
|
3126
|
+
status: "retired",
|
|
2963
3127
|
replacedBy: LLMModels.GEMINI_3_8_FLASH,
|
|
2964
3128
|
offeredInChat: false,
|
|
2965
3129
|
offeredInVoice: false,
|
|
@@ -2981,7 +3145,8 @@ var init_registry = __esm({
|
|
|
2981
3145
|
label: "Gemini 2.5 Flash Lite",
|
|
2982
3146
|
provider: LLMProvider.GOOGLE,
|
|
2983
3147
|
family: "gemini",
|
|
2984
|
-
|
|
3148
|
+
// Vertex retires it on 2026-10-20.
|
|
3149
|
+
status: "retired",
|
|
2985
3150
|
replacedBy: LLMModels.GEMINI_3_7_FLASH,
|
|
2986
3151
|
offeredInChat: false,
|
|
2987
3152
|
offeredInVoice: false,
|
|
@@ -3117,6 +3282,28 @@ var init_registry = __esm({
|
|
|
3117
3282
|
capabilities: GEMINI_THINKING,
|
|
3118
3283
|
openRouterSlug: "google/gemini-3.8-flash"
|
|
3119
3284
|
},
|
|
3285
|
+
// Backup only: reached by provider failover when both Flash models are overloaded, never offered for selection.
|
|
3286
|
+
{
|
|
3287
|
+
id: LLMModels.GEMINI_4_ARGON,
|
|
3288
|
+
label: "Gemini 4 Argon",
|
|
3289
|
+
provider: LLMProvider.GOOGLE,
|
|
3290
|
+
family: "gemini",
|
|
3291
|
+
status: "live",
|
|
3292
|
+
offeredInChat: false,
|
|
3293
|
+
offeredInVoice: false,
|
|
3294
|
+
premium: true,
|
|
3295
|
+
// Google's rate from 2026-12-01 ($2 / $10 until then), billed from day one so a turn is never under-charged.
|
|
3296
|
+
pricing: {
|
|
3297
|
+
inputPerMillion: 4,
|
|
3298
|
+
outputPerMillion: 20,
|
|
3299
|
+
cachedInputPerMillion: 0.2,
|
|
3300
|
+
provider: LLMProvider.GOOGLE
|
|
3301
|
+
},
|
|
3302
|
+
// Google publishes no separate audio rate; audio at 2x input and video at input, the same ratio as Gemini 3.x Flash.
|
|
3303
|
+
modality: { audioPerMillion: 8, videoPerMillion: 4 },
|
|
3304
|
+
maxOutputTokens: GEMINI_MAX_OUTPUT_TOKENS,
|
|
3305
|
+
capabilities: GEMINI_THINKING
|
|
3306
|
+
},
|
|
3120
3307
|
{
|
|
3121
3308
|
id: LLMModels.GROK_4_5,
|
|
3122
3309
|
label: "Grok 4.5",
|
|
@@ -4897,7 +5084,7 @@ function register2(server, client) {
|
|
|
4897
5084
|
callbackUrl: import_zod3.z.string().optional().describe("URL that replaces the workspace webhook's destination for this note's webhook events. It takes effect only when the workspace already has an active webhook for the event; on its own it does not create a webhook or send anything."),
|
|
4898
5085
|
fields: import_zod3.z.array(
|
|
4899
5086
|
import_zod3.z.object({
|
|
4900
|
-
id:
|
|
5087
|
+
id: fieldIdSchema,
|
|
4901
5088
|
value: import_zod3.z.string().min(1).describe("Custom field value")
|
|
4902
5089
|
})
|
|
4903
5090
|
).optional().describe("Custom field values to attach to the text note")
|
|
@@ -5878,7 +6065,7 @@ function register6(server, client) {
|
|
|
5878
6065
|
registerSpeakTool(
|
|
5879
6066
|
server,
|
|
5880
6067
|
"create_embed",
|
|
5881
|
-
"Create an embeddable player/transcript widget for a media file or a set of folders. Provide `mediaId` for a single-media embed, or `folderIds` for a folder/library embed. If an embed already exists for that media or folder set, it is returned instead. A single-media embed is viewable by anyone with the link while the media's privacy mode is public (the default); a folder embed is created with an auto-generated password. Use update_embed to change privacy or the password, or to show labels and comments (meta isLabels, isComments; off by default).",
|
|
6068
|
+
"Create an embeddable player/transcript widget for a media file or a set of folders. Provide `mediaId` for a single-media embed, or `folderIds` for a folder/library embed. If an embed already exists for that media or folder set, it is returned instead. A single-media embed is viewable by anyone with the link while the media's privacy mode is public (the default); a folder embed is created with an auto-generated password. Use update_embed to change privacy or the password, or to show labels and comments (meta isLabels, isComments; off by default), or to brand a shared dashboard (meta logo, logoDark, theme, backgroundColor, primaryColor, titleColor, fontFamily).",
|
|
5882
6069
|
{
|
|
5883
6070
|
mediaId: import_zod7.z.string().optional().describe("Media file to embed (for a single-media embed)"),
|
|
5884
6071
|
folderIds: import_zod7.z.array(import_zod7.z.string()).optional().describe("Folder IDs to embed (for a folder/library embed)")
|
|
@@ -5916,7 +6103,7 @@ function register6(server, client) {
|
|
|
5916
6103
|
),
|
|
5917
6104
|
password: import_zod7.z.string().optional().describe("Password to protect the embed with when privacyMode is private. Only applied when privacyMode is also sent."),
|
|
5918
6105
|
meta: import_zod7.z.record(import_zod7.z.unknown()).optional().describe(
|
|
5919
|
-
`Embed appearance & feature toggles: { backgroundImg, logo, primaryColor, titleColor, chatWelcomeMessage, assistantTemplateId, isTitle, isDescription, isRemarks, isDataVizDownloadable, isSEOIndexing, isPromptAsk, isPromptHistory, isMediaExport, isLabels, isComments, callToActionButtons:[{ url, label }], features:[{ name, isActive, isCustom? }] }. features entry { name: "fieldsFocus", isActive: false } turns off the fields-first media page: by default, when a media page is opened from a shared dashboard and the media has custom fields, the page shrinks the player to about 22% and leads with the fields. isPromptAsk must be on for the chat button of a shared dashboard (and a notes widget openChat action) to work. isLabels and isComments show the media's labels and comments read-only on media and folder embeds; both are off by default and embed viewers can never write them.`
|
|
6106
|
+
`Embed appearance & feature toggles: { backgroundImg, logo, logoDark, theme, backgroundColor, fontFamily, primaryColor, titleColor, chatWelcomeMessage, assistantTemplateId, isTitle, isDescription, isRemarks, isDataVizDownloadable, isSEOIndexing, isPromptAsk, isPromptHistory, isMediaExport, isLabels, isComments, callToActionButtons:[{ url, label }], features:[{ name, isActive, isCustom? }] }. features entry { name: "fieldsFocus", isActive: false } turns off the fields-first media page: by default, when a media page is opened from a shared dashboard and the media has custom fields, the page shrinks the player to about 22% and leads with the fields. Shared-dashboard branding: logo is the image shown in light mode and logoDark the one shown when the viewer is in dark mode (logoDark must be an uploaded logo; this MCP cannot upload images, any other URL is rejected with a 400, and it falls back to logo when unset). theme is "light" or "dark" and forces that theme for every viewer, hiding their toggle; "" lets the viewer choose. backgroundColor is a hex colour (#rgb or #rrggbb) for the page background; pair it with theme so text stays readable. primaryColor is a hex accent used for nav, links, card chips and play buttons. titleColor is a hex colour for the dashboard title and is ignored when its contrast on the page background is below 3:1. fontFamily is a Google Fonts family name (letters, digits and spaces, max 60 chars, for example "Arimo"; anything else is rejected with a 400); it overrides the account font for this embed, and "" falls back to the account font. Send "" for any of these keys to clear it. isPromptAsk must be on for the chat button of a shared dashboard (and a notes widget openChat action) to work. isLabels and isComments show the media's labels and comments read-only on media and folder embeds; both are off by default and embed viewers can never write them.`
|
|
5920
6107
|
)
|
|
5921
6108
|
},
|
|
5922
6109
|
{
|
|
@@ -6724,7 +6911,7 @@ function register9(server, client) {
|
|
|
6724
6911
|
registerSpeakTool(
|
|
6725
6912
|
server,
|
|
6726
6913
|
"list_fields",
|
|
6727
|
-
"List all custom fields defined in the workspace. Each field returns a `slug` (for example `regulator_comment`) alongside its `id`, `name`, and `type`. Put `{{field.<slug>}}` in the prompt text you send and Speak substitutes that field's value for the media before the model sees it. A slug is unique per company and never changes when the field is renamed, so prefer it over the field name. A field with no slug yet resolves by `id` in the same token.",
|
|
6914
|
+
"List all custom fields defined in the workspace. Each field returns a `slug` (for example `regulator_comment`) alongside its `id`, `name`, and `type`. Put `{{field.<slug>}}` in the prompt text you send and Speak substitutes that field's value for the media before the model sees it. A slug is unique per company and never changes when the field is renamed, so prefer it over the field name. A field with no slug yet resolves by `id` in the same token. Every other tool that takes a field id wants this `id` (12 characters), never the database `_id`.",
|
|
6728
6915
|
{},
|
|
6729
6916
|
{
|
|
6730
6917
|
title: "List Custom Fields",
|
|
@@ -6750,7 +6937,7 @@ function register9(server, client) {
|
|
|
6750
6937
|
registerSpeakTool(
|
|
6751
6938
|
server,
|
|
6752
6939
|
"create_field",
|
|
6753
|
-
"Create a new custom field for categorizing and tagging media.",
|
|
6940
|
+
"Create a new custom field for categorizing and tagging media. The response starts with the new field's `id`; use that `id` (not `_id`) wherever a field id is needed.",
|
|
6754
6941
|
{
|
|
6755
6942
|
name: import_zod10.z.string().min(1).describe("Display name for the field"),
|
|
6756
6943
|
type: import_zod10.z.string().describe("Field type (text, number, select, etc.)"),
|
|
@@ -6772,8 +6959,12 @@ function register9(server, client) {
|
|
|
6772
6959
|
async (body) => {
|
|
6773
6960
|
try {
|
|
6774
6961
|
const result = await api.post("/v1/fields", body);
|
|
6962
|
+
const fieldId = result.data?.data?.id;
|
|
6963
|
+
const idLine = fieldId ? `Field id: ${fieldId} (use this id, not _id, in other tools)
|
|
6964
|
+
|
|
6965
|
+
` : "";
|
|
6775
6966
|
return {
|
|
6776
|
-
content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }]
|
|
6967
|
+
content: [{ type: "text", text: idLine + JSON.stringify(result.data, null, 2) }]
|
|
6777
6968
|
};
|
|
6778
6969
|
} catch (err2) {
|
|
6779
6970
|
return {
|
|
@@ -6786,13 +6977,13 @@ function register9(server, client) {
|
|
|
6786
6977
|
registerSpeakTool(
|
|
6787
6978
|
server,
|
|
6788
6979
|
"update_multiple_fields",
|
|
6789
|
-
"Set custom field values across media in a single batch operation, overwriting existing values. Scope the update with `mediaIds`, or with `folderId` to update every media in that folder; when both are given only `mediaIds` is used. Empty values are skipped, so this cannot clear a field. Each value that changes fires your field_updated automations, whose steps can send email, post to Slack, call webhook URLs or run connected third-party app actions.",
|
|
6980
|
+
"Set custom field values across media in a single batch operation, overwriting existing values. Scope the update with `mediaIds`, or with `folderId` to update every media in that folder; when both are given only `mediaIds` is used. Empty values are skipped, so this cannot clear a field. Each value that changes fires your field_updated automations, whose steps can send email, post to Slack, call webhook URLs or run connected third-party app actions. " + SHARED_DASHBOARD_CACHE_NOTE,
|
|
6790
6981
|
{
|
|
6791
6982
|
folderId: import_zod10.z.string().optional().describe("Apply the field values to all media in this folder"),
|
|
6792
6983
|
mediaIds: import_zod10.z.array(import_zod10.z.string()).optional().describe("Apply the field values to these specific media files"),
|
|
6793
6984
|
fields: import_zod10.z.array(
|
|
6794
6985
|
import_zod10.z.object({
|
|
6795
|
-
id:
|
|
6986
|
+
id: fieldIdSchema,
|
|
6796
6987
|
value: import_zod10.z.unknown().describe("Value to set for the field")
|
|
6797
6988
|
})
|
|
6798
6989
|
).describe("Array of field id/value pairs to set")
|
|
@@ -6823,7 +7014,7 @@ function register9(server, client) {
|
|
|
6823
7014
|
"update_field",
|
|
6824
7015
|
"Update a specific custom field by ID. `name` must always be supplied (the server replaces the field config).",
|
|
6825
7016
|
{
|
|
6826
|
-
id:
|
|
7017
|
+
id: fieldIdSchema,
|
|
6827
7018
|
name: import_zod10.z.string().describe("Display name for the field"),
|
|
6828
7019
|
type: import_zod10.z.string().optional().describe("Field type"),
|
|
6829
7020
|
description: import_zod10.z.string().optional().describe("Optional description for the field"),
|
|
@@ -10191,7 +10382,7 @@ function makeWidget(item) {
|
|
|
10191
10382
|
}
|
|
10192
10383
|
return widget;
|
|
10193
10384
|
}
|
|
10194
|
-
var import_crypto, GRID_COLS, WIDGET_TYPES, DATE_RANGE_PRESETS, WIDGET_META, KEBAB_ID, AUTO_LAYOUT, WIDGET_CATALOG, SPEC_VOCABULARY, DESIGN_RULES, DASHBOARD_EXAMPLES;
|
|
10385
|
+
var import_crypto, GRID_COLS, WIDGET_TYPES, DATE_RANGE_PRESETS, SECTION_ICON_DESCRIPTION, WIDGET_META, KEBAB_ID, AUTO_LAYOUT, WIDGET_CATALOG, SPEC_VOCABULARY, DESIGN_RULES, DASHBOARD_EXAMPLES;
|
|
10195
10386
|
var init_dashboard_widgets = __esm({
|
|
10196
10387
|
"src/tools/dashboard-widgets.ts"() {
|
|
10197
10388
|
"use strict";
|
|
@@ -10218,6 +10409,7 @@ var init_dashboard_widgets = __esm({
|
|
|
10218
10409
|
"yearToDate",
|
|
10219
10410
|
"allTime"
|
|
10220
10411
|
];
|
|
10412
|
+
SECTION_ICON_DESCRIPTION = 'Kebab-case lucide icon name. Known good: "dollar-sign", "globe", "users", "trending-up", "message-square", "star", "target", "calendar", "chart-line", "circle-play", "circle-check", "circle-alert". Lucide renamed its "<thing>-circle" icons to "circle-<thing>" (use "circle-play", not "play-circle"); an unknown name shows a blank dot.';
|
|
10221
10413
|
WIDGET_META = {
|
|
10222
10414
|
narrative: { w: GRID_COLS, h: 3, titleDefault: "Insights" },
|
|
10223
10415
|
"stat-cards": { w: GRID_COLS, h: 3, titleDefault: "Usage overview" },
|
|
@@ -10253,7 +10445,7 @@ var init_dashboard_widgets = __esm({
|
|
|
10253
10445
|
{
|
|
10254
10446
|
type: "table",
|
|
10255
10447
|
purpose: "Tabular records or grouped aggregates (full width).",
|
|
10256
|
-
config: 'rowsAre: "records" | "groups"; groupBy?: GroupBy (required when rowsAre="groups", forbidden when "records"); columns: Array<{ header: string (<=40, unique), field: string } | { header: string, metric: Metric }> (1-12; a column is EITHER a raw field OR a metric, never both; thresholds? allowed on both forms); sort?: { column: <one of the headers>, dir: "asc" | "desc" }; limit?: number (1-500); searchable?: boolean; rowClick?: "openMedia" | "none"; display?: "table" | "cards"; card?: { titleColumn?: string, subtitleColumns?: string[] (<=2), detailColumns?: string[] (<=2), showDuration?: boolean }. SESSION CARDS: display "cards" renders each record as a card (poster frame from the video, loaded lazily, plus title, subtitle lines, up to 2 detail lines and duration). Only valid with rowsAre "records"; `card` is only valid with display "cards"; every card value must be an existing column header; set rowClick "openMedia" so a click opens the media page. Example: { rowsAre: "records", rowClick: "openMedia", display: "cards", columns: [{ header: "Session", field: "Title" }, { header: "Speaker", field: "Speaker" }], card: { titleColumn: "Session", subtitleColumns: ["Speaker"], showDuration: true } }'
|
|
10448
|
+
config: 'rowsAre: "records" | "groups"; groupBy?: GroupBy (required when rowsAre="groups", forbidden when "records"); columns: Array<{ header: string (<=40, unique), field: string } | { header: string, metric: Metric }> (1-12; a column is EITHER a raw field OR a metric, never both; thresholds? allowed on both forms); sort?: { column: <one of the headers>, dir: "asc" | "desc" }; limit?: number (1-500); pageSize?: number (1-100, records per page); searchable?: boolean; rowClick?: "openMedia" | "none"; display?: "table" | "cards"; card?: { titleColumn?: string, subtitleColumns?: string[] (<=2), detailColumns?: string[] (<=2), showDuration?: boolean, layout?: "grid" | "rows", rowBy?: string, rowOrder?: string[] (<=50 values, each 1-80 chars), hero?: boolean, imageColumn?: string }. SESSION CARDS: display "cards" renders each record as a card (poster frame from the video, loaded lazily, plus title, subtitle lines, up to 2 detail lines and duration). Only valid with rowsAre "records"; `card` is only valid with display "cards"; every card value must be an existing column header; imageColumn names a raw custom-field column whose field has a profile group in settings.profiles, and the card shows the image of that group\'s entry matching the record\'s value; set rowClick "openMedia" so a click opens the media page. ROWS AND HERO: layout "rows" renders one horizontal snap-scroll row per distinct value of the rowBy column (rowBy is a column header, required with layout "rows" and rejected otherwise); rows are ordered by count desc, or by rowOrder (explicit row VALUES first, the rest by count; rowOrder is only valid with layout "rows"); layout defaults to "grid". hero: true renders the first record after sort as a wide banner above the grid or rows, on the first page only (valid with either layout). Records with a blank rowBy value go in a last "other" row; rows are not paged, so every record up to limit shows. Rows example: { rowsAre: "records", rowClick: "openMedia", display: "cards", columns: [{ header: "Session", field: "Title" }, { header: "Track", field: "Track" }], card: { titleColumn: "Session", layout: "rows", rowBy: "Track", rowOrder: ["Track A"], hero: true } }. Example: { rowsAre: "records", rowClick: "openMedia", display: "cards", columns: [{ header: "Session", field: "Title" }, { header: "Speaker", field: "Speaker" }], card: { titleColumn: "Session", subtitleColumns: ["Speaker"], showDuration: true } }'
|
|
10257
10449
|
},
|
|
10258
10450
|
{
|
|
10259
10451
|
type: "comparison",
|
|
@@ -10308,7 +10500,7 @@ var init_dashboard_widgets = __esm({
|
|
|
10308
10500
|
thresholds: 'Color bands for stat tiles, chart marks, and table columns (max 8): { when: { op: "gte" | "gt" | "lt" | "lte", value: number } | { op: "between", value: [low, high] }, status: "good" | "warn" | "critical" | "neutral", label?: string (<=40) }',
|
|
10309
10501
|
source: 'Dashboard data source: { type: "folders", folderIds: string[] (1-250) } | { type: "team" } | { type: "workspace" }',
|
|
10310
10502
|
dateRangePresets: DATE_RANGE_PRESETS,
|
|
10311
|
-
sections: "Optional named groups of widgets rendered as tabs/sections (max 12): { id: kebab-case string, title: string (<=24), icon:
|
|
10503
|
+
sections: "Optional named groups of widgets rendered as tabs/sections (max 12): { id: kebab-case string, title: string (<=24), icon: string, widgetIds: string[] (<=24) }. icon: " + SECTION_ICON_DESCRIPTION + " Widget ids in sections must match explicit `id`s you set on the widgets; a widget may appear in at most one section; widgets in no section form the implicit Overview group."
|
|
10312
10504
|
};
|
|
10313
10505
|
DESIGN_RULES = [
|
|
10314
10506
|
"Lead with a narrative widget: on a new dashboard, make it the first widget of the first section \u2014 it is the headline insight.",
|
|
@@ -10481,7 +10673,7 @@ function register18(server, client) {
|
|
|
10481
10673
|
registerSpeakTool(
|
|
10482
10674
|
server,
|
|
10483
10675
|
"get_dashboard",
|
|
10484
|
-
"Get a single dashboard's full spec: title, description, source, date range, sections, widgets, and the current `revision` (pass that revision back to update_dashboard).",
|
|
10676
|
+
"Get a single dashboard's full spec: title, description, source, date range, sections, widgets, and the current `revision` (pass that revision back to update_dashboard). Saved viewer settings, including settings.profiles groups (fieldId, label, imageShape, and entries with id, name, description, link, imageKey, and a signed imageUrl preview that is ignored if sent back), are included when the server returns them.",
|
|
10485
10677
|
{
|
|
10486
10678
|
dashboardId: import_zod20.z.string().min(1).describe("Dashboard business id (the dashboardId field from list_dashboards, not the Mongo _id)")
|
|
10487
10679
|
},
|
|
@@ -10543,7 +10735,7 @@ function register18(server, client) {
|
|
|
10543
10735
|
registerSpeakTool(
|
|
10544
10736
|
server,
|
|
10545
10737
|
"create_dashboard",
|
|
10546
|
-
`Create an analytics dashboard. Only \`title\` is required \u2014 source defaults to the whole workspace and dateRange to last30days. Add widgets by listing their types (the MCP assigns ids and lays them out automatically), scope with source ({type:"folders",folderIds} | {type:"team"} | {type:"workspace"}) and dateRange ({preset}), and optionally group widgets into sections. Design guidance: lead with a narrative widget as the first widget; group sections by the QUESTION they answer, not by widget type; don't pad \u2014 every widget earns its place (aim for 4-16 widgets on a full build); if something can't be expressed by the widget catalog, put it in a narrative widget's focus instead of faking it. Call list_dashboard_widgets first for the widget catalog, config vocabulary, design rules, and full examples. Creating a dashboard does not share it publicly; only share_dashboard creates a public link. If settings.feedback.sheetWebhookUrl is set, each Feedback submission made on the shared dashboard is posted to that external Google Apps Script URL. Viewer settings (the settings input):
|
|
10738
|
+
`Create an analytics dashboard. Only \`title\` is required \u2014 source defaults to the whole workspace and dateRange to last30days. Add widgets by listing their types (the MCP assigns ids and lays them out automatically), scope with source ({type:"folders",folderIds} | {type:"team"} | {type:"workspace"}) and dateRange ({preset}), and optionally group widgets into sections. Design guidance: lead with a narrative widget as the first widget; group sections by the QUESTION they answer, not by widget type; don't pad \u2014 every widget earns its place (aim for 4-16 widgets on a full build); if something can't be expressed by the widget catalog, put it in a narrative widget's focus instead of faking it. Call list_dashboard_widgets first for the widget catalog, config vocabulary, design rules, and full examples. Creating a dashboard does not share it publicly; only share_dashboard creates a public link. If settings.feedback.sheetWebhookUrl is set, each Feedback submission made on the shared dashboard is posted to that external Google Apps Script URL. ` + SHARED_DASHBOARD_CACHE_NOTE + " Viewer settings (the settings input): " + SETTINGS_RULES,
|
|
10547
10739
|
{
|
|
10548
10740
|
title: import_zod20.z.string().min(1).max(60).describe("Dashboard name, max 60 chars (the only required field)"),
|
|
10549
10741
|
...specFields,
|
|
@@ -10584,12 +10776,12 @@ function register18(server, client) {
|
|
|
10584
10776
|
registerSpeakTool(
|
|
10585
10777
|
server,
|
|
10586
10778
|
"update_dashboard",
|
|
10587
|
-
"Update a dashboard. Two modes. (1) Metadata-only: pass just icon/assignTo/filters/isDefault/settings, with no spec fields and no revision. (2) Spec update: pass the FULL spec \u2014 title, source, dateRange, sections, widgets \u2014 plus `revision`. Widgets and sections are REPLACED, not merged, so call get_dashboard first and resend everything you want to keep. `revision` is the optimistic-concurrency token from get_dashboard/list_dashboards: the server accepts the write only if it still matches, then increments it. A 409 conflict means another writer saved first \u2014 re-fetch with get_dashboard, rebuild your changes on the fresh spec, and retry with the new revision. If settings.feedback.sheetWebhookUrl is set, each Feedback submission made on the shared dashboard is posted to that external Google Apps Script URL. Viewer settings (the settings input): " + SETTINGS_RULES,
|
|
10779
|
+
"Update a dashboard. Two modes. (1) Metadata-only: pass just icon/assignTo/filters/isDefault/settings, with no spec fields and no revision, except that saving settings.profiles also needs the `revision` from get_dashboard (a stale one returns a 409). (2) Spec update: pass the FULL spec \u2014 title, source, dateRange, sections, widgets \u2014 plus `revision`. Widgets and sections are REPLACED, not merged, so call get_dashboard first and resend everything you want to keep. `revision` is the optimistic-concurrency token from get_dashboard/list_dashboards: the server accepts the write only if it still matches, then increments it. A 409 conflict means another writer saved first \u2014 re-fetch with get_dashboard, rebuild your changes on the fresh spec, and retry with the new revision. If settings.feedback.sheetWebhookUrl is set, each Feedback submission made on the shared dashboard is posted to that external Google Apps Script URL. " + SHARED_DASHBOARD_CACHE_NOTE + " Viewer settings (the settings input): " + SETTINGS_RULES,
|
|
10588
10780
|
{
|
|
10589
10781
|
dashboardId: import_zod20.z.string().min(1).describe("Dashboard business id"),
|
|
10590
10782
|
title: import_zod20.z.string().min(1).max(60).optional().describe("Dashboard name \u2014 required (with revision) when updating the spec"),
|
|
10591
10783
|
revision: import_zod20.z.number().int().nonnegative().optional().describe(
|
|
10592
|
-
"The revision loaded from get_dashboard. Required for spec updates; mismatch returns a 409 conflict."
|
|
10784
|
+
"The revision loaded from get_dashboard. Required for spec updates and for saving settings.profiles; mismatch returns a 409 conflict."
|
|
10593
10785
|
),
|
|
10594
10786
|
...specFields,
|
|
10595
10787
|
...metadataFields
|
|
@@ -10623,6 +10815,14 @@ function register18(server, client) {
|
|
|
10623
10815
|
revision
|
|
10624
10816
|
};
|
|
10625
10817
|
}
|
|
10818
|
+
if (!specTouched && metadata.settings?.profiles !== void 0) {
|
|
10819
|
+
if (revision === void 0) {
|
|
10820
|
+
throw new Error(
|
|
10821
|
+
"Saving settings.profiles can delete replaced images, so pass the `revision` loaded from get_dashboard."
|
|
10822
|
+
);
|
|
10823
|
+
}
|
|
10824
|
+
body.revision = revision;
|
|
10825
|
+
}
|
|
10626
10826
|
if (Object.keys(body).length === 0) {
|
|
10627
10827
|
throw new Error("Nothing to update: pass spec fields (with revision) or metadata fields.");
|
|
10628
10828
|
}
|
|
@@ -10759,7 +10959,7 @@ var init_dashboards = __esm({
|
|
|
10759
10959
|
init_client();
|
|
10760
10960
|
init_dashboard_widgets();
|
|
10761
10961
|
MAX_DASHBOARD_SOURCE_FOLDERS = 250;
|
|
10762
|
-
FILTER_LIST_DESCRIPTION =
|
|
10962
|
+
FILTER_LIST_DESCRIPTION = 'Fixed pre-filter applied to every widget on the dashboard (not a filter bar viewers can change). filters.filterList is an array of { fieldName: field id, fieldOperator: "include", fieldValue: string[] (1 or more), fieldCondition? }; a media file shows only when that field holds one of the values. Shared links apply include filters only. Other keys pass through but only filterList is enforced.';
|
|
10763
10963
|
widgetInputSchema = import_zod20.z.object({
|
|
10764
10964
|
type: import_zod20.z.enum(WIDGET_TYPES).describe(
|
|
10765
10965
|
"Widget type: narrative | stat-cards | metric-chart | table | comparison | field-distribution | sentiment-trend | themes | people | team-activity | notes | chat-history"
|
|
@@ -10786,7 +10986,7 @@ var init_dashboards = __esm({
|
|
|
10786
10986
|
sectionInputSchema = import_zod20.z.object({
|
|
10787
10987
|
id: import_zod20.z.string().min(1).max(64).describe("Section id (kebab-case)"),
|
|
10788
10988
|
title: import_zod20.z.string().min(1).max(24).describe("Section title, max 24 chars"),
|
|
10789
|
-
icon: import_zod20.z.string().min(1).max(40).describe(
|
|
10989
|
+
icon: import_zod20.z.string().min(1).max(40).describe(SECTION_ICON_DESCRIPTION),
|
|
10790
10990
|
widgetIds: import_zod20.z.array(import_zod20.z.string().max(64)).max(24).describe("Widget ids in this section \u2014 must match explicit `id`s set on widgets[]")
|
|
10791
10991
|
});
|
|
10792
10992
|
sourceInputSchema = import_zod20.z.object({
|
|
@@ -10800,8 +11000,8 @@ var init_dashboards = __esm({
|
|
|
10800
11000
|
dateRangeInputSchema = import_zod20.z.object({
|
|
10801
11001
|
preset: import_zod20.z.enum(DATE_RANGE_PRESETS).describe("One of: last7days | last30days | last3months | yearToDate | allTime")
|
|
10802
11002
|
}).describe("Date range \u2014 strict preset only, no free-form start/end dates");
|
|
10803
|
-
settingsFieldIds = import_zod20.z.array(
|
|
10804
|
-
SETTINGS_RULES =
|
|
11003
|
+
settingsFieldIds = import_zod20.z.array(fieldIdSchema);
|
|
11004
|
+
SETTINGS_RULES = `Do not pass settings unless the user explicitly asks to change this dashboard's viewer settings. Saving fields, feedback or fieldEdits moves that dashboard onto the settings flow immediately: its media pages use these groups and this Feedback setup from then on. Each section (fields, feedback, fieldEdits, labels, comments, profiles) replaces that whole section when sent; a section left out keeps its saved value. Call get_dashboard first and resend every key of the section you change; a key left out resets to its default. Get field ids from list_fields. Ids that are not the company's fields are dropped when saving and returned in droppedFieldIds. When feedback.isEnabled is true, pass a non-empty feedback.fieldIds (score fields) rather than leaving it empty. Only set feedback.sheetWebhookUrl when the user gives the Apps Script URL. fieldEdits.fieldIds may list only fields that have allowed values (the server rejects any other field with a 400) and that the dashboard's media pages show; pass an empty fieldIds to turn field editing off. Labels and comments on the shared link are off until the user asks to turn them on. Mode 'apply' (labels) or 'reply' (comments) lets a link viewer write as one of the dashboard's feedback submitter names (feedback.submitters, even while feedback itself is off), or as another typed name only when feedback.allowOtherSubmitter is true. Anyone holding the share link can pick any of those names, because the link has no sign-in (an accepted risk; every entry is marked as made via this dashboard), so confirm the names with the user before saving a write mode. With no submitter names nobody can write. Label groups that are not active refuse the whole save with a 400 rather than being dropped. Saving only settings.profiles does not move media pages onto the settings flow. settings.profiles is a list of up to ${DASHBOARD_PROFILE_GROUPS_MAX} groups, one per custom field (a field may appear only once), each with a label (for example Speakers or Products) and entries that give a value of that field a name, image, description and link. Entry names must equal that field's values (trim, case-insensitive), and a name or id listed twice in a group is rejected with a 400; they are matched by display string, so renaming a value in the media fields orphans its profile. Names, descriptions, links and images are PUBLIC to anyone with the dashboard link: write plain text only, no HTML, and confirm the descriptions and links with the user before saving. This MCP cannot upload images: leave imageKey out, or pass one copied unchanged from get_dashboard. To add an image over the API, POST it (multipart, ${DASHBOARD_PROFILE_IMAGE_TYPES.map((type) => type.replace("image/", "").toUpperCase()).join("/")}, max ${DASHBOARD_PROFILE_IMAGE_MAX_BYTES / (1024 * 1024)} MB) to /v1/dashboards/:dashboardId/profile-image and use the returned imageKey.`;
|
|
10805
11005
|
dashboardSettingsSchema = import_zod20.z.object({
|
|
10806
11006
|
fields: import_zod20.z.object({
|
|
10807
11007
|
includeIds: settingsFieldIds.describe(
|
|
@@ -10867,14 +11067,50 @@ var init_dashboards = __esm({
|
|
|
10867
11067
|
comments: import_zod20.z.object({
|
|
10868
11068
|
isEnabled: import_zod20.z.boolean().describe("Show comments on media pages opened from this shared dashboard"),
|
|
10869
11069
|
mode: import_zod20.z.nativeEnum(DashboardCommentsMode).describe("'view' shows comments read-only; 'reply' also lets a viewer, as a reviewer name, comment and reply")
|
|
10870
|
-
}).optional()
|
|
11070
|
+
}).optional(),
|
|
11071
|
+
profiles: import_zod20.z.array(
|
|
11072
|
+
import_zod20.z.object({
|
|
11073
|
+
fieldId: fieldIdSchema.describe(
|
|
11074
|
+
"Custom field id whose values the entries describe (from list_fields); each field at most once"
|
|
11075
|
+
),
|
|
11076
|
+
label: import_zod20.z.string().trim().min(1).max(DASHBOARD_PROFILE_LABEL_MAX).describe(`Group label shown on the dashboard, 1-${DASHBOARD_PROFILE_LABEL_MAX} chars (for example Speakers)`),
|
|
11077
|
+
imageShape: import_zod20.z.enum(DASHBOARD_PROFILE_IMAGE_SHAPES).optional().describe(`How entry images are cropped: ${DASHBOARD_PROFILE_IMAGE_SHAPES.join(" or ")}`),
|
|
11078
|
+
entries: import_zod20.z.array(
|
|
11079
|
+
import_zod20.z.object({
|
|
11080
|
+
id: import_zod20.z.string().regex(DASHBOARD_PROFILE_ID_PATTERN, "Profile id is lowercase letters, digits and hyphens, max 64 chars").optional().describe("Entry id (lowercase slug, unique in the group); leave out for a new entry and the server generates one"),
|
|
11081
|
+
name: import_zod20.z.string().trim().min(1).max(DASHBOARD_PROFILE_NAME_MAX).describe(`Entry name, 1-${DASHBOARD_PROFILE_NAME_MAX} chars; must equal a value of the group's field (trim, case-insensitive) and be unique within the group`),
|
|
11082
|
+
imageKey: import_zod20.z.string().min(1).max(DASHBOARD_PROFILE_IMAGE_KEY_MAX).optional().describe(
|
|
11083
|
+
"S3 URI of an image in Speak's own bucket, set by the in-app image upload. Only pass a value copied from get_dashboard; this MCP cannot upload images."
|
|
11084
|
+
),
|
|
11085
|
+
description: import_zod20.z.string().max(DASHBOARD_PROFILE_DESCRIPTION_MAX).optional().describe(
|
|
11086
|
+
`Plain-text description, max ${DASHBOARD_PROFILE_DESCRIPTION_MAX} chars, no HTML. Public to anyone with the dashboard link.`
|
|
11087
|
+
),
|
|
11088
|
+
link: import_zod20.z.string().trim().url().max(DASHBOARD_PROFILE_LINK_MAX).refine((value) => /^https?:\/\//i.test(value), "Link must be an http or https URL").optional().describe(`Optional http or https URL, max ${DASHBOARD_PROFILE_LINK_MAX} chars. Public to anyone with the dashboard link.`)
|
|
11089
|
+
})
|
|
11090
|
+
).max(DASHBOARD_PROFILE_ENTRIES_MAX).describe(`Up to ${DASHBOARD_PROFILE_ENTRIES_MAX} entries. Empty removes every entry of the group.`)
|
|
11091
|
+
})
|
|
11092
|
+
).max(DASHBOARD_PROFILE_GROUPS_MAX).refine(
|
|
11093
|
+
(groups) => new Set(groups.map((group) => group.fieldId)).size === groups.length,
|
|
11094
|
+
"Each field can have only one profile group"
|
|
11095
|
+
).optional().describe(
|
|
11096
|
+
`Profile groups (up to ${DASHBOARD_PROFILE_GROUPS_MAX}, one per field) shown on the shared dashboard. Replaces the whole list when sent; an empty list removes every group. Public to anyone with the link; plain text only.`
|
|
11097
|
+
)
|
|
10871
11098
|
}).describe(
|
|
10872
|
-
"Viewer settings for media pages opened from this dashboard's share link: which fields show, how the Fields tab groups them, the Feedback button, which fields Feedback submitters may edit,
|
|
11099
|
+
"Viewer settings for media pages opened from this dashboard's share link: which fields show, how the Fields tab groups them, the Feedback button, which fields Feedback submitters may edit, labels and comments with the reviewer names (feedback submitters) who may write them, and profile groups. " + SETTINGS_RULES
|
|
10873
11100
|
);
|
|
10874
11101
|
metadataFields = {
|
|
10875
11102
|
icon: import_zod20.z.string().max(200).optional().describe("Icon identifier"),
|
|
10876
11103
|
assignTo: import_zod20.z.array(import_zod20.z.string()).max(100).optional().describe('User ids, or group ids in the "<groupId> (G)" convention, to share view access with'),
|
|
10877
|
-
filters: import_zod20.z.
|
|
11104
|
+
filters: import_zod20.z.object({
|
|
11105
|
+
filterList: import_zod20.z.array(
|
|
11106
|
+
import_zod20.z.object({
|
|
11107
|
+
fieldName: fieldIdSchema,
|
|
11108
|
+
fieldOperator: import_zod20.z.literal(FilterOperator.INCLUDE),
|
|
11109
|
+
fieldValue: import_zod20.z.array(import_zod20.z.string().min(1).max(500)).min(1),
|
|
11110
|
+
fieldCondition: import_zod20.z.string().max(50).optional()
|
|
11111
|
+
})
|
|
11112
|
+
).optional()
|
|
11113
|
+
}).passthrough().optional().describe(FILTER_LIST_DESCRIPTION),
|
|
10878
11114
|
isDefault: import_zod20.z.boolean().optional().describe("Make this the owner's default dashboard. Setting true clears the default flag on the owner's other dashboards"),
|
|
10879
11115
|
settings: dashboardSettingsSchema.optional()
|
|
10880
11116
|
};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@speakai/mcp-server",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.35.0",
|
|
4
4
|
"mcpName": "io.github.speakai/mcp-server",
|
|
5
5
|
"description": "Official Speak AI MCP Server — capture meetings, search thousands of recordings, run async voice and video surveys, create clips, and automate workflows from your AI assistant.",
|
|
6
6
|
"homepage": "https://docs.speakai.co/mcp",
|
|
@@ -54,7 +54,7 @@
|
|
|
54
54
|
"zod": "^3.22.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|
|
57
|
-
"@speakai/shared": "^2.1.
|
|
57
|
+
"@speakai/shared": "^2.1.54",
|
|
58
58
|
"@types/node": "^20.0.0",
|
|
59
59
|
"@vitest/coverage-v8": "^4.1.6",
|
|
60
60
|
"tsup": "^8.5.1",
|