@speakai/mcp-server 1.34.1 → 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.
Files changed (2) hide show
  1. package/dist/index.js +231 -13
  2. package/package.json +2 -2
package/dist/index.js CHANGED
@@ -727,6 +727,7 @@ var init_menu = __esm({
727
727
  MenuItemId2["Developers"] = "developers-manage";
728
728
  MenuItemId2["AiAssistant"] = "ai-assistant";
729
729
  MenuItemId2["Fields"] = "fields";
730
+ MenuItemId2["Labels"] = "labels";
730
731
  MenuItemId2["KnowledgeBase"] = "knowledge-base";
731
732
  MenuItemId2["AgentsList"] = "agents-list";
732
733
  MenuItemId2["AgentsConversations"] = "agents-conversations";
@@ -1183,7 +1184,7 @@ var init_prompt = __esm({
1183
1184
  });
1184
1185
 
1185
1186
  // node_modules/@speakai/shared/dist/enums/recorder.js
1186
- var RecorderAnswerType, RecorderUploadType, RecordingFeedbackRating;
1187
+ var RecorderAnswerType, RecorderUploadType, RecordingFeedbackRating, RecorderSessionEventType, RecorderSessionEventCategory, RecorderSessionWakeLock, RECORDER_SESSION_EVENTS;
1187
1188
  var init_recorder = __esm({
1188
1189
  "node_modules/@speakai/shared/dist/enums/recorder.js"() {
1189
1190
  "use strict";
@@ -1207,6 +1208,150 @@ var init_recorder = __esm({
1207
1208
  RecordingFeedbackRating2["POSITIVE"] = "positive";
1208
1209
  RecordingFeedbackRating2["NEGATIVE"] = "negative";
1209
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
+ };
1210
1355
  }
1211
1356
  });
1212
1357
 
@@ -1484,6 +1629,7 @@ var init_llm = __esm({
1484
1629
  LLMModels2["GEMINI_3_5_FLASH"] = "gemini-3.5-flash";
1485
1630
  LLMModels2["GEMINI_3_7_FLASH"] = "gemini-3.7-flash";
1486
1631
  LLMModels2["GEMINI_3_8_FLASH"] = "gemini-3.8-flash";
1632
+ LLMModels2["GEMINI_4_ARGON"] = "gemini-4-argon";
1487
1633
  LLMModels2["GROK_4_5"] = "x-ai/grok-4.5";
1488
1634
  LLMModels2["GLM_5_2"] = "z-ai/glm-5.2";
1489
1635
  })(LLMModels || (LLMModels = {}));
@@ -1675,10 +1821,22 @@ var init_dashboard_spec = __esm({
1675
1821
  });
1676
1822
 
1677
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;
1678
1825
  var init_dashboard = __esm({
1679
1826
  "node_modules/@speakai/shared/dist/interfaces/dashboard.js"() {
1680
1827
  "use strict";
1681
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"];
1682
1840
  }
1683
1841
  });
1684
1842
 
@@ -2943,7 +3101,8 @@ var init_registry = __esm({
2943
3101
  label: "Gemini 2.5 Flash",
2944
3102
  provider: LLMProvider.GOOGLE,
2945
3103
  family: "gemini",
2946
- status: "deprecated",
3104
+ // Vertex retires it on 2026-10-20; retired so every resolver substitutes 3.7 Flash instead of dispatching it.
3105
+ status: "retired",
2947
3106
  replacedBy: LLMModels.GEMINI_3_7_FLASH,
2948
3107
  offeredInChat: false,
2949
3108
  offeredInVoice: false,
@@ -2963,7 +3122,8 @@ var init_registry = __esm({
2963
3122
  label: "Gemini 2.5 Pro",
2964
3123
  provider: LLMProvider.GOOGLE,
2965
3124
  family: "gemini",
2966
- status: "deprecated",
3125
+ // Vertex retires it on 2026-10-20.
3126
+ status: "retired",
2967
3127
  replacedBy: LLMModels.GEMINI_3_8_FLASH,
2968
3128
  offeredInChat: false,
2969
3129
  offeredInVoice: false,
@@ -2985,7 +3145,8 @@ var init_registry = __esm({
2985
3145
  label: "Gemini 2.5 Flash Lite",
2986
3146
  provider: LLMProvider.GOOGLE,
2987
3147
  family: "gemini",
2988
- status: "deprecated",
3148
+ // Vertex retires it on 2026-10-20.
3149
+ status: "retired",
2989
3150
  replacedBy: LLMModels.GEMINI_3_7_FLASH,
2990
3151
  offeredInChat: false,
2991
3152
  offeredInVoice: false,
@@ -3121,6 +3282,28 @@ var init_registry = __esm({
3121
3282
  capabilities: GEMINI_THINKING,
3122
3283
  openRouterSlug: "google/gemini-3.8-flash"
3123
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
+ },
3124
3307
  {
3125
3308
  id: LLMModels.GROK_4_5,
3126
3309
  label: "Grok 4.5",
@@ -5882,7 +6065,7 @@ function register6(server, client) {
5882
6065
  registerSpeakTool(
5883
6066
  server,
5884
6067
  "create_embed",
5885
- "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).",
5886
6069
  {
5887
6070
  mediaId: import_zod7.z.string().optional().describe("Media file to embed (for a single-media embed)"),
5888
6071
  folderIds: import_zod7.z.array(import_zod7.z.string()).optional().describe("Folder IDs to embed (for a folder/library embed)")
@@ -5920,7 +6103,7 @@ function register6(server, client) {
5920
6103
  ),
5921
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."),
5922
6105
  meta: import_zod7.z.record(import_zod7.z.unknown()).optional().describe(
5923
- `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.`
5924
6107
  )
5925
6108
  },
5926
6109
  {
@@ -10262,7 +10445,7 @@ var init_dashboard_widgets = __esm({
10262
10445
  {
10263
10446
  type: "table",
10264
10447
  purpose: "Tabular records or grouped aggregates (full width).",
10265
- 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 } }'
10266
10449
  },
10267
10450
  {
10268
10451
  type: "comparison",
@@ -10490,7 +10673,7 @@ function register18(server, client) {
10490
10673
  registerSpeakTool(
10491
10674
  server,
10492
10675
  "get_dashboard",
10493
- "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.",
10494
10677
  {
10495
10678
  dashboardId: import_zod20.z.string().min(1).describe("Dashboard business id (the dashboardId field from list_dashboards, not the Mongo _id)")
10496
10679
  },
@@ -10593,12 +10776,12 @@ function register18(server, client) {
10593
10776
  registerSpeakTool(
10594
10777
  server,
10595
10778
  "update_dashboard",
10596
- "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. " + SHARED_DASHBOARD_CACHE_NOTE + " 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,
10597
10780
  {
10598
10781
  dashboardId: import_zod20.z.string().min(1).describe("Dashboard business id"),
10599
10782
  title: import_zod20.z.string().min(1).max(60).optional().describe("Dashboard name \u2014 required (with revision) when updating the spec"),
10600
10783
  revision: import_zod20.z.number().int().nonnegative().optional().describe(
10601
- "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."
10602
10785
  ),
10603
10786
  ...specFields,
10604
10787
  ...metadataFields
@@ -10632,6 +10815,14 @@ function register18(server, client) {
10632
10815
  revision
10633
10816
  };
10634
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
+ }
10635
10826
  if (Object.keys(body).length === 0) {
10636
10827
  throw new Error("Nothing to update: pass spec fields (with revision) or metadata fields.");
10637
10828
  }
@@ -10810,7 +11001,7 @@ var init_dashboards = __esm({
10810
11001
  preset: import_zod20.z.enum(DATE_RANGE_PRESETS).describe("One of: last7days | last30days | last3months | yearToDate | allTime")
10811
11002
  }).describe("Date range \u2014 strict preset only, no free-form start/end dates");
10812
11003
  settingsFieldIds = import_zod20.z.array(fieldIdSchema);
10813
- 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) 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.";
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.`;
10814
11005
  dashboardSettingsSchema = import_zod20.z.object({
10815
11006
  fields: import_zod20.z.object({
10816
11007
  includeIds: settingsFieldIds.describe(
@@ -10876,9 +11067,36 @@ var init_dashboards = __esm({
10876
11067
  comments: import_zod20.z.object({
10877
11068
  isEnabled: import_zod20.z.boolean().describe("Show comments on media pages opened from this shared dashboard"),
10878
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")
10879
- }).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
+ )
10880
11098
  }).describe(
10881
- "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, and labels and comments with the reviewer names (feedback submitters) who may write them. " + SETTINGS_RULES
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
10882
11100
  );
10883
11101
  metadataFields = {
10884
11102
  icon: import_zod20.z.string().max(200).optional().describe("Icon identifier"),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@speakai/mcp-server",
3
- "version": "1.34.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.49",
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",