@speakai/mcp-server 1.38.2 → 1.39.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/README.md +8 -4
- package/dist/index.js +538 -9
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -242,7 +242,7 @@ For questions about data handling, see [speakai.co/privacy](https://speakai.co/p
|
|
|
242
242
|
|
|
243
243
|
## What you can do once installed
|
|
244
244
|
|
|
245
|
-
Speak AI ships
|
|
245
|
+
Speak AI ships 189 tools your AI assistant can call. You don't memorize them — Claude/ChatGPT pick the right ones based on what you ask. Examples by category:
|
|
246
246
|
|
|
247
247
|
| Ask | Tools used (auto) |
|
|
248
248
|
|---|---|
|
|
@@ -394,7 +394,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
394
394
|
| `SPEAK_ACCESS_TOKEN` | No | Auto-managed | JWT access token (auto-fetched and refreshed) |
|
|
395
395
|
| `SPEAK_BASE_URL` | No | `https://api.speakai.co` | API base URL |
|
|
396
396
|
|
|
397
|
-
### MCP Tools (
|
|
397
|
+
### MCP Tools (189)
|
|
398
398
|
|
|
399
399
|
<details>
|
|
400
400
|
<summary>Media (19 tools)</summary>
|
|
@@ -619,7 +619,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
619
619
|
</details>
|
|
620
620
|
|
|
621
621
|
<details>
|
|
622
|
-
<summary>Embed players (
|
|
622
|
+
<summary>Embed players (7 tools)</summary>
|
|
623
623
|
|
|
624
624
|
| Tool | Description |
|
|
625
625
|
|---|---|
|
|
@@ -627,6 +627,9 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
627
627
|
| `update_embed` | Update embed settings |
|
|
628
628
|
| `check_embed` | Check if embed exists for media |
|
|
629
629
|
| `get_embed_iframe_url` | Get iframe URL for your website |
|
|
630
|
+
| `list_embed_sessions` | Owner analytics: list visits to an embed with viewer, device, country and traffic filters |
|
|
631
|
+
| `get_embed_session_summary` | Owner analytics: an embed's visit KPIs, daily trend, sources and per-media table |
|
|
632
|
+
| `get_embed_session` | Owner analytics: one embed visit in full, with paged events |
|
|
630
633
|
|
|
631
634
|
</details>
|
|
632
635
|
|
|
@@ -661,7 +664,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
661
664
|
</details>
|
|
662
665
|
|
|
663
666
|
<details>
|
|
664
|
-
<summary>Voice agents (
|
|
667
|
+
<summary>Voice agents (34 tools)</summary>
|
|
665
668
|
|
|
666
669
|
| Tool | Description |
|
|
667
670
|
|---|---|
|
|
@@ -677,6 +680,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
677
680
|
| `list_voices` | List the text-to-speech voices available to a voice agent |
|
|
678
681
|
| `list_voice_conversations` | List conversations handled by voice agents (filter by agentId) |
|
|
679
682
|
| `get_voice_conversation` | Get a single conversation by conversationId |
|
|
683
|
+
| `get_agent_analytics` | Owner analytics for one voice agent over a date range (KPIs, audience, outcomes, quality) |
|
|
680
684
|
| `list_voice_questions` | List the questions configured on a voice agent, in ask order |
|
|
681
685
|
| `get_voice_question` | Get a single question by fieldId |
|
|
682
686
|
| `create_voice_question` | Attach a question template to a voice agent |
|
package/dist/index.js
CHANGED
|
@@ -636,7 +636,7 @@ var init_label = __esm({
|
|
|
636
636
|
});
|
|
637
637
|
|
|
638
638
|
// node_modules/@speakai/shared/dist/enums/media.js
|
|
639
|
-
var MediaType, MediaState, MediaPrivacyMode, MediaInsightType, MediaInsightStatus, MediaProcessType;
|
|
639
|
+
var MediaType, MediaState, MediaPrivacyMode, MediaInsightType, MediaInsightStatus, MediaProcessType, ThumbnailStatus, ThumbnailOrigin;
|
|
640
640
|
var init_media = __esm({
|
|
641
641
|
"node_modules/@speakai/shared/dist/enums/media.js"() {
|
|
642
642
|
"use strict";
|
|
@@ -702,6 +702,18 @@ var init_media = __esm({
|
|
|
702
702
|
MediaProcessType2["DUBBING"] = "dubbing";
|
|
703
703
|
MediaProcessType2["TRANSLATION"] = "translation";
|
|
704
704
|
})(MediaProcessType || (MediaProcessType = {}));
|
|
705
|
+
(function(ThumbnailStatus2) {
|
|
706
|
+
ThumbnailStatus2["PENDING"] = "pending";
|
|
707
|
+
ThumbnailStatus2["CREATED"] = "created";
|
|
708
|
+
ThumbnailStatus2["FAILED"] = "failed";
|
|
709
|
+
ThumbnailStatus2["EXPIRED"] = "expired";
|
|
710
|
+
ThumbnailStatus2["REPLACED"] = "replaced";
|
|
711
|
+
ThumbnailStatus2["DELETED"] = "deleted";
|
|
712
|
+
})(ThumbnailStatus || (ThumbnailStatus = {}));
|
|
713
|
+
(function(ThumbnailOrigin2) {
|
|
714
|
+
ThumbnailOrigin2["AUTO"] = "auto";
|
|
715
|
+
ThumbnailOrigin2["CUSTOM"] = "custom";
|
|
716
|
+
})(ThumbnailOrigin || (ThumbnailOrigin = {}));
|
|
705
717
|
}
|
|
706
718
|
});
|
|
707
719
|
|
|
@@ -762,7 +774,7 @@ var init_menu = __esm({
|
|
|
762
774
|
});
|
|
763
775
|
|
|
764
776
|
// node_modules/@speakai/shared/dist/enums/meeting.js
|
|
765
|
-
var MeetingPlatform, MEETING_PLATFORM_LABELS, MeetingStatus, MeetingRecordingMode, ScreenShareRecordingMode, MeetingSummarySettings, MediaPlayerSettings, MeetingFilterEventCondition, MeetingAttendeeType, MeetingAssistantEventSource;
|
|
777
|
+
var MeetingPlatform, MEETING_PLATFORM_LABELS, MeetingStatus, MeetingRecordingMode, ScreenShareRecordingMode, MeetingSummarySettings, MediaPlayerSettings, MeetingFilterEventCondition, MeetingAttendeeType, MeetingAssistantEventSource, MeetingRecorder, DesktopAutoRecord, DesktopConsentNotice, DesktopSystemAudioStatus, DesktopClaimReason;
|
|
766
778
|
var init_meeting = __esm({
|
|
767
779
|
"node_modules/@speakai/shared/dist/enums/meeting.js"() {
|
|
768
780
|
"use strict";
|
|
@@ -771,12 +783,16 @@ var init_meeting = __esm({
|
|
|
771
783
|
MeetingPlatform2["ZOOM"] = "zoom";
|
|
772
784
|
MeetingPlatform2["MICROSOFT_TEAMS"] = "microsoftTeams";
|
|
773
785
|
MeetingPlatform2["WEBEX"] = "webex";
|
|
786
|
+
MeetingPlatform2["SLACK"] = "slack";
|
|
787
|
+
MeetingPlatform2["OTHER"] = "other";
|
|
774
788
|
})(MeetingPlatform || (MeetingPlatform = {}));
|
|
775
789
|
MEETING_PLATFORM_LABELS = {
|
|
776
790
|
[MeetingPlatform.ZOOM]: "Zoom",
|
|
777
791
|
[MeetingPlatform.GOOGLE_MEET]: "Google Meet",
|
|
778
792
|
[MeetingPlatform.MICROSOFT_TEAMS]: "Microsoft Teams",
|
|
779
|
-
[MeetingPlatform.WEBEX]: "Webex"
|
|
793
|
+
[MeetingPlatform.WEBEX]: "Webex",
|
|
794
|
+
[MeetingPlatform.SLACK]: "Slack",
|
|
795
|
+
[MeetingPlatform.OTHER]: "Other"
|
|
780
796
|
};
|
|
781
797
|
(function(MeetingStatus2) {
|
|
782
798
|
MeetingStatus2["WILL_JOIN"] = "willJoin";
|
|
@@ -832,7 +848,37 @@ var init_meeting = __esm({
|
|
|
832
848
|
(function(MeetingAssistantEventSource2) {
|
|
833
849
|
MeetingAssistantEventSource2["INSTANT"] = "instant";
|
|
834
850
|
MeetingAssistantEventSource2["ASSISTANT"] = "assistant";
|
|
851
|
+
MeetingAssistantEventSource2["DESKTOP"] = "desktop";
|
|
835
852
|
})(MeetingAssistantEventSource || (MeetingAssistantEventSource = {}));
|
|
853
|
+
(function(MeetingRecorder2) {
|
|
854
|
+
MeetingRecorder2["DESKTOP_FIRST"] = "desktopFirst";
|
|
855
|
+
MeetingRecorder2["DESKTOP_ONLY"] = "desktopOnly";
|
|
856
|
+
MeetingRecorder2["BOT_ONLY"] = "botOnly";
|
|
857
|
+
})(MeetingRecorder || (MeetingRecorder = {}));
|
|
858
|
+
(function(DesktopAutoRecord2) {
|
|
859
|
+
DesktopAutoRecord2["ALLOW"] = "allow";
|
|
860
|
+
DesktopAutoRecord2["PROMPT_ONLY"] = "promptOnly";
|
|
861
|
+
DesktopAutoRecord2["OFF"] = "off";
|
|
862
|
+
})(DesktopAutoRecord || (DesktopAutoRecord = {}));
|
|
863
|
+
(function(DesktopConsentNotice2) {
|
|
864
|
+
DesktopConsentNotice2["OFF"] = "off";
|
|
865
|
+
DesktopConsentNotice2["REMIND"] = "remind";
|
|
866
|
+
DesktopConsentNotice2["REQUIRE"] = "require";
|
|
867
|
+
})(DesktopConsentNotice || (DesktopConsentNotice = {}));
|
|
868
|
+
(function(DesktopSystemAudioStatus2) {
|
|
869
|
+
DesktopSystemAudioStatus2["CAPTURED"] = "captured";
|
|
870
|
+
DesktopSystemAudioStatus2["UNAVAILABLE"] = "unavailable";
|
|
871
|
+
DesktopSystemAudioStatus2["SILENT"] = "silent";
|
|
872
|
+
})(DesktopSystemAudioStatus || (DesktopSystemAudioStatus = {}));
|
|
873
|
+
(function(DesktopClaimReason2) {
|
|
874
|
+
DesktopClaimReason2["CLAIMED"] = "claimed";
|
|
875
|
+
DesktopClaimReason2["NOT_ENABLED"] = "not-enabled";
|
|
876
|
+
DesktopClaimReason2["NO_CALENDAR_EVENT"] = "no-calendar-event";
|
|
877
|
+
DesktopClaimReason2["OUTSIDE_WINDOW"] = "outside-window";
|
|
878
|
+
DesktopClaimReason2["OTHER_DEVICE"] = "other-device";
|
|
879
|
+
DesktopClaimReason2["BOT_RECORDING"] = "bot-recording";
|
|
880
|
+
DesktopClaimReason2["BOT_SENT"] = "bot-sent";
|
|
881
|
+
})(DesktopClaimReason || (DesktopClaimReason = {}));
|
|
836
882
|
}
|
|
837
883
|
});
|
|
838
884
|
|
|
@@ -1184,7 +1230,7 @@ var init_prompt = __esm({
|
|
|
1184
1230
|
});
|
|
1185
1231
|
|
|
1186
1232
|
// node_modules/@speakai/shared/dist/enums/recorder.js
|
|
1187
|
-
var RecorderAnswerType, RecorderUploadType, RecordingFeedbackRating, RecorderSessionEventType, RecorderSessionEventCategory, RecorderSessionWakeLock, RECORDER_SESSION_EVENTS;
|
|
1233
|
+
var RecorderAnswerType, RecorderUploadType, RecordingFeedbackRating, RecorderSessionEventType, RecordingSessionSource, RecorderSessionEventCategory, RecorderSessionWakeLock, RECORDER_SESSION_EVENTS;
|
|
1188
1234
|
var init_recorder = __esm({
|
|
1189
1235
|
"node_modules/@speakai/shared/dist/enums/recorder.js"() {
|
|
1190
1236
|
"use strict";
|
|
@@ -1234,7 +1280,17 @@ var init_recorder = __esm({
|
|
|
1234
1280
|
RecorderSessionEventType2["LIVE_RECONNECTING"] = "live_reconnecting";
|
|
1235
1281
|
RecorderSessionEventType2["LIVE_RESUMED"] = "live_resumed";
|
|
1236
1282
|
RecorderSessionEventType2["LIVE_FAILED"] = "live_failed";
|
|
1283
|
+
RecorderSessionEventType2["SYSTEM_RESUMED"] = "system_resumed";
|
|
1284
|
+
RecorderSessionEventType2["SYSTEM_AUDIO_RESTARTED"] = "system_audio_restarted";
|
|
1285
|
+
RecorderSessionEventType2["SIDE_SILENT"] = "side_silent";
|
|
1286
|
+
RecorderSessionEventType2["ECHO_CANCELLER_CHANGED"] = "echo_canceller_changed";
|
|
1287
|
+
RecorderSessionEventType2["UPLOAD_RETRY"] = "upload_retry";
|
|
1288
|
+
RecorderSessionEventType2["TAKE_SPLIT"] = "take_split";
|
|
1237
1289
|
})(RecorderSessionEventType || (RecorderSessionEventType = {}));
|
|
1290
|
+
(function(RecordingSessionSource2) {
|
|
1291
|
+
RecordingSessionSource2["EMBED"] = "embed";
|
|
1292
|
+
RecordingSessionSource2["DESKTOP"] = "desktop";
|
|
1293
|
+
})(RecordingSessionSource || (RecordingSessionSource = {}));
|
|
1238
1294
|
(function(RecorderSessionEventCategory2) {
|
|
1239
1295
|
RecorderSessionEventCategory2["DEVICE_SLEEP"] = "device_sleep";
|
|
1240
1296
|
RecorderSessionEventCategory2["SCREEN_TAB"] = "screen_tab";
|
|
@@ -1255,6 +1311,10 @@ var init_recorder = __esm({
|
|
|
1255
1311
|
category: RecorderSessionEventCategory.DEVICE_SLEEP,
|
|
1256
1312
|
description: "The laptop or browser was asleep, so no audio was recorded for that time."
|
|
1257
1313
|
},
|
|
1314
|
+
[RecorderSessionEventType.SYSTEM_RESUMED]: {
|
|
1315
|
+
category: RecorderSessionEventCategory.DEVICE_SLEEP,
|
|
1316
|
+
description: "The computer woke up from sleep."
|
|
1317
|
+
},
|
|
1258
1318
|
[RecorderSessionEventType.PAGE_FREEZE]: {
|
|
1259
1319
|
category: RecorderSessionEventCategory.DEVICE_SLEEP,
|
|
1260
1320
|
description: "The browser paused the recorder page to save power."
|
|
@@ -1311,6 +1371,22 @@ var init_recorder = __esm({
|
|
|
1311
1371
|
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1312
1372
|
description: "A microphone, headset or other audio device was plugged in, unplugged or switched."
|
|
1313
1373
|
},
|
|
1374
|
+
[RecorderSessionEventType.SYSTEM_AUDIO_RESTARTED]: {
|
|
1375
|
+
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1376
|
+
description: "The recorder restarted capture of the computer's sound, for example after a headset switch."
|
|
1377
|
+
},
|
|
1378
|
+
[RecorderSessionEventType.SIDE_SILENT]: {
|
|
1379
|
+
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1380
|
+
description: "One side of the call (your microphone or the other people) was silent while the other side was talking."
|
|
1381
|
+
},
|
|
1382
|
+
[RecorderSessionEventType.ECHO_CANCELLER_CHANGED]: {
|
|
1383
|
+
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1384
|
+
description: "Echo removal was turned on or off, for example when switching between speakers and headphones."
|
|
1385
|
+
},
|
|
1386
|
+
[RecorderSessionEventType.TAKE_SPLIT]: {
|
|
1387
|
+
category: RecorderSessionEventCategory.USER,
|
|
1388
|
+
description: "The recording was split into a new meeting."
|
|
1389
|
+
},
|
|
1314
1390
|
[RecorderSessionEventType.RECORDER_ERROR]: {
|
|
1315
1391
|
category: RecorderSessionEventCategory.AUDIO_CAPTURE,
|
|
1316
1392
|
description: "The browser reported an error while recording audio."
|
|
@@ -1331,6 +1407,10 @@ var init_recorder = __esm({
|
|
|
1331
1407
|
category: RecorderSessionEventCategory.LIVE_TRANSCRIPTION,
|
|
1332
1408
|
description: "Live transcription stopped and could not reconnect; the recording itself continued."
|
|
1333
1409
|
},
|
|
1410
|
+
[RecorderSessionEventType.UPLOAD_RETRY]: {
|
|
1411
|
+
category: RecorderSessionEventCategory.NETWORK,
|
|
1412
|
+
description: "An upload failed and was tried again."
|
|
1413
|
+
},
|
|
1334
1414
|
[RecorderSessionEventType.ONLINE]: {
|
|
1335
1415
|
category: RecorderSessionEventCategory.NETWORK,
|
|
1336
1416
|
description: "The internet connection came back."
|
|
@@ -1636,6 +1716,225 @@ var init_llm = __esm({
|
|
|
1636
1716
|
}
|
|
1637
1717
|
});
|
|
1638
1718
|
|
|
1719
|
+
// node_modules/@speakai/shared/dist/enums/embedSession.js
|
|
1720
|
+
var EmbedSessionEventCategory, EmbedSessionEventType, EmbedSessionEventSource, EmbedSessionEndReason, EmbedSessionMediaOpenSource, EmbedSessionSearchScope, EmbedSessionBotKind, EmbedSessionTrafficFilter, EmbedSessionViewerFilter, EmbedSessionDeviceFilter, EmbedSessionSort, EMBED_SESSION_EVENTS;
|
|
1721
|
+
var init_embedSession = __esm({
|
|
1722
|
+
"node_modules/@speakai/shared/dist/enums/embedSession.js"() {
|
|
1723
|
+
"use strict";
|
|
1724
|
+
(function(EmbedSessionEventCategory2) {
|
|
1725
|
+
EmbedSessionEventCategory2["LIFECYCLE"] = "lifecycle";
|
|
1726
|
+
EmbedSessionEventCategory2["NAVIGATION"] = "navigation";
|
|
1727
|
+
EmbedSessionEventCategory2["PLAYBACK"] = "playback";
|
|
1728
|
+
EmbedSessionEventCategory2["CHAT"] = "chat";
|
|
1729
|
+
EmbedSessionEventCategory2["ENGAGEMENT"] = "engagement";
|
|
1730
|
+
EmbedSessionEventCategory2["IDENTITY"] = "identity";
|
|
1731
|
+
EmbedSessionEventCategory2["SHARING"] = "sharing";
|
|
1732
|
+
})(EmbedSessionEventCategory || (EmbedSessionEventCategory = {}));
|
|
1733
|
+
(function(EmbedSessionEventType2) {
|
|
1734
|
+
EmbedSessionEventType2["SESSION_START"] = "session_start";
|
|
1735
|
+
EmbedSessionEventType2["SESSION_RESUME"] = "session_resume";
|
|
1736
|
+
EmbedSessionEventType2["SESSION_END"] = "session_end";
|
|
1737
|
+
EmbedSessionEventType2["PAGE_VIEW"] = "page_view";
|
|
1738
|
+
EmbedSessionEventType2["DASHBOARD_VIEW"] = "dashboard_view";
|
|
1739
|
+
EmbedSessionEventType2["WIDGET_OPEN"] = "widget_open";
|
|
1740
|
+
EmbedSessionEventType2["MEDIA_OPEN"] = "media_open";
|
|
1741
|
+
EmbedSessionEventType2["MEDIA_CLOSE"] = "media_close";
|
|
1742
|
+
EmbedSessionEventType2["CITATION_OPEN"] = "citation_open";
|
|
1743
|
+
EmbedSessionEventType2["SEARCH"] = "search";
|
|
1744
|
+
EmbedSessionEventType2["TRANSCRIPT_DOWNLOAD"] = "transcript_download";
|
|
1745
|
+
EmbedSessionEventType2["TRANSCRIPT_COPY"] = "transcript_copy";
|
|
1746
|
+
EmbedSessionEventType2["MEDIA_DOWNLOAD"] = "media_download";
|
|
1747
|
+
EmbedSessionEventType2["EXPORT"] = "export";
|
|
1748
|
+
EmbedSessionEventType2["PLAY"] = "play";
|
|
1749
|
+
EmbedSessionEventType2["PAUSE"] = "pause";
|
|
1750
|
+
EmbedSessionEventType2["SEEK"] = "seek";
|
|
1751
|
+
EmbedSessionEventType2["ENDED"] = "ended";
|
|
1752
|
+
EmbedSessionEventType2["RATE_CHANGE"] = "rate_change";
|
|
1753
|
+
EmbedSessionEventType2["CHAT_QUESTION"] = "chat_question";
|
|
1754
|
+
EmbedSessionEventType2["CHAT_FEEDBACK"] = "chat_feedback";
|
|
1755
|
+
EmbedSessionEventType2["HIDDEN"] = "hidden";
|
|
1756
|
+
EmbedSessionEventType2["IDLE"] = "idle";
|
|
1757
|
+
EmbedSessionEventType2["GATE_SHOWN"] = "gate_shown";
|
|
1758
|
+
EmbedSessionEventType2["LEAD_CAPTURED"] = "lead_captured";
|
|
1759
|
+
})(EmbedSessionEventType || (EmbedSessionEventType = {}));
|
|
1760
|
+
(function(EmbedSessionEventSource2) {
|
|
1761
|
+
EmbedSessionEventSource2["CLIENT"] = "client";
|
|
1762
|
+
EmbedSessionEventSource2["SERVER"] = "server";
|
|
1763
|
+
})(EmbedSessionEventSource || (EmbedSessionEventSource = {}));
|
|
1764
|
+
(function(EmbedSessionEndReason2) {
|
|
1765
|
+
EmbedSessionEndReason2["PAGEHIDE"] = "pagehide";
|
|
1766
|
+
EmbedSessionEndReason2["IDLE_TIMEOUT"] = "idle_timeout";
|
|
1767
|
+
EmbedSessionEndReason2["MAX_DURATION"] = "max_duration";
|
|
1768
|
+
})(EmbedSessionEndReason || (EmbedSessionEndReason = {}));
|
|
1769
|
+
(function(EmbedSessionMediaOpenSource2) {
|
|
1770
|
+
EmbedSessionMediaOpenSource2["LIST"] = "list";
|
|
1771
|
+
EmbedSessionMediaOpenSource2["CITATION"] = "citation";
|
|
1772
|
+
EmbedSessionMediaOpenSource2["SEARCH"] = "search";
|
|
1773
|
+
EmbedSessionMediaOpenSource2["WIDGET"] = "widget";
|
|
1774
|
+
EmbedSessionMediaOpenSource2["DIRECT"] = "direct";
|
|
1775
|
+
})(EmbedSessionMediaOpenSource || (EmbedSessionMediaOpenSource = {}));
|
|
1776
|
+
(function(EmbedSessionSearchScope2) {
|
|
1777
|
+
EmbedSessionSearchScope2["LIBRARY"] = "library";
|
|
1778
|
+
EmbedSessionSearchScope2["DASHBOARD"] = "dashboard";
|
|
1779
|
+
EmbedSessionSearchScope2["TRANSCRIPT"] = "transcript";
|
|
1780
|
+
})(EmbedSessionSearchScope || (EmbedSessionSearchScope = {}));
|
|
1781
|
+
(function(EmbedSessionBotKind2) {
|
|
1782
|
+
EmbedSessionBotKind2["RENDER"] = "render";
|
|
1783
|
+
EmbedSessionBotKind2["CRAWLER"] = "crawler";
|
|
1784
|
+
})(EmbedSessionBotKind || (EmbedSessionBotKind = {}));
|
|
1785
|
+
(function(EmbedSessionTrafficFilter2) {
|
|
1786
|
+
EmbedSessionTrafficFilter2["ALL"] = "all";
|
|
1787
|
+
EmbedSessionTrafficFilter2["PEOPLE"] = "people";
|
|
1788
|
+
EmbedSessionTrafficFilter2["BOTS"] = "bots";
|
|
1789
|
+
})(EmbedSessionTrafficFilter || (EmbedSessionTrafficFilter = {}));
|
|
1790
|
+
(function(EmbedSessionViewerFilter2) {
|
|
1791
|
+
EmbedSessionViewerFilter2["ALL"] = "all";
|
|
1792
|
+
EmbedSessionViewerFilter2["IDENTIFIED"] = "identified";
|
|
1793
|
+
EmbedSessionViewerFilter2["ANONYMOUS"] = "anonymous";
|
|
1794
|
+
})(EmbedSessionViewerFilter || (EmbedSessionViewerFilter = {}));
|
|
1795
|
+
(function(EmbedSessionDeviceFilter2) {
|
|
1796
|
+
EmbedSessionDeviceFilter2["ALL"] = "all";
|
|
1797
|
+
EmbedSessionDeviceFilter2["DESKTOP"] = "desktop";
|
|
1798
|
+
EmbedSessionDeviceFilter2["MOBILE"] = "mobile";
|
|
1799
|
+
EmbedSessionDeviceFilter2["TABLET"] = "tablet";
|
|
1800
|
+
})(EmbedSessionDeviceFilter || (EmbedSessionDeviceFilter = {}));
|
|
1801
|
+
(function(EmbedSessionSort2) {
|
|
1802
|
+
EmbedSessionSort2["STARTED_DESC"] = "startedAt:desc";
|
|
1803
|
+
EmbedSessionSort2["STARTED_ASC"] = "startedAt:asc";
|
|
1804
|
+
EmbedSessionSort2["ACTIVE_DESC"] = "activeMs:desc";
|
|
1805
|
+
EmbedSessionSort2["WATCHED_DESC"] = "watchedMs:desc";
|
|
1806
|
+
EmbedSessionSort2["QUESTIONS_DESC"] = "questions:desc";
|
|
1807
|
+
})(EmbedSessionSort || (EmbedSessionSort = {}));
|
|
1808
|
+
EMBED_SESSION_EVENTS = {
|
|
1809
|
+
[EmbedSessionEventType.SESSION_START]: {
|
|
1810
|
+
category: EmbedSessionEventCategory.LIFECYCLE,
|
|
1811
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1812
|
+
description: "The viewer opened the embed and a new session started."
|
|
1813
|
+
},
|
|
1814
|
+
[EmbedSessionEventType.SESSION_RESUME]: {
|
|
1815
|
+
category: EmbedSessionEventCategory.LIFECYCLE,
|
|
1816
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1817
|
+
description: "The viewer came back to the same session, for example after a refresh."
|
|
1818
|
+
},
|
|
1819
|
+
[EmbedSessionEventType.SESSION_END]: {
|
|
1820
|
+
category: EmbedSessionEventCategory.LIFECYCLE,
|
|
1821
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1822
|
+
description: "The viewer left the page or was inactive for too long, so the session ended."
|
|
1823
|
+
},
|
|
1824
|
+
[EmbedSessionEventType.PAGE_VIEW]: {
|
|
1825
|
+
category: EmbedSessionEventCategory.NAVIGATION,
|
|
1826
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1827
|
+
description: "The viewer moved to another page inside the embed."
|
|
1828
|
+
},
|
|
1829
|
+
[EmbedSessionEventType.DASHBOARD_VIEW]: {
|
|
1830
|
+
category: EmbedSessionEventCategory.NAVIGATION,
|
|
1831
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1832
|
+
description: "The viewer opened the dashboard."
|
|
1833
|
+
},
|
|
1834
|
+
[EmbedSessionEventType.WIDGET_OPEN]: {
|
|
1835
|
+
category: EmbedSessionEventCategory.NAVIGATION,
|
|
1836
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1837
|
+
description: "The viewer opened a dashboard widget."
|
|
1838
|
+
},
|
|
1839
|
+
[EmbedSessionEventType.MEDIA_OPEN]: {
|
|
1840
|
+
category: EmbedSessionEventCategory.NAVIGATION,
|
|
1841
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1842
|
+
description: "The viewer opened a media file."
|
|
1843
|
+
},
|
|
1844
|
+
[EmbedSessionEventType.MEDIA_CLOSE]: {
|
|
1845
|
+
category: EmbedSessionEventCategory.NAVIGATION,
|
|
1846
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1847
|
+
description: "The viewer closed a media file."
|
|
1848
|
+
},
|
|
1849
|
+
[EmbedSessionEventType.CITATION_OPEN]: {
|
|
1850
|
+
category: EmbedSessionEventCategory.NAVIGATION,
|
|
1851
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1852
|
+
description: "The viewer opened a citation from an AI answer."
|
|
1853
|
+
},
|
|
1854
|
+
[EmbedSessionEventType.SEARCH]: {
|
|
1855
|
+
category: EmbedSessionEventCategory.NAVIGATION,
|
|
1856
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1857
|
+
description: "The viewer searched the library, dashboard or transcript."
|
|
1858
|
+
},
|
|
1859
|
+
[EmbedSessionEventType.TRANSCRIPT_DOWNLOAD]: {
|
|
1860
|
+
category: EmbedSessionEventCategory.SHARING,
|
|
1861
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1862
|
+
description: "The viewer downloaded a transcript."
|
|
1863
|
+
},
|
|
1864
|
+
[EmbedSessionEventType.TRANSCRIPT_COPY]: {
|
|
1865
|
+
category: EmbedSessionEventCategory.SHARING,
|
|
1866
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1867
|
+
description: "The viewer copied a transcript."
|
|
1868
|
+
},
|
|
1869
|
+
[EmbedSessionEventType.MEDIA_DOWNLOAD]: {
|
|
1870
|
+
category: EmbedSessionEventCategory.SHARING,
|
|
1871
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1872
|
+
description: "The viewer downloaded a media file."
|
|
1873
|
+
},
|
|
1874
|
+
[EmbedSessionEventType.EXPORT]: {
|
|
1875
|
+
category: EmbedSessionEventCategory.SHARING,
|
|
1876
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1877
|
+
description: "The viewer exported an AI answer."
|
|
1878
|
+
},
|
|
1879
|
+
[EmbedSessionEventType.PLAY]: {
|
|
1880
|
+
category: EmbedSessionEventCategory.PLAYBACK,
|
|
1881
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1882
|
+
description: "The viewer started playing a media file."
|
|
1883
|
+
},
|
|
1884
|
+
[EmbedSessionEventType.PAUSE]: {
|
|
1885
|
+
category: EmbedSessionEventCategory.PLAYBACK,
|
|
1886
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1887
|
+
description: "The viewer paused a media file."
|
|
1888
|
+
},
|
|
1889
|
+
[EmbedSessionEventType.SEEK]: {
|
|
1890
|
+
category: EmbedSessionEventCategory.PLAYBACK,
|
|
1891
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1892
|
+
description: "The viewer jumped to another point in a media file."
|
|
1893
|
+
},
|
|
1894
|
+
[EmbedSessionEventType.ENDED]: {
|
|
1895
|
+
category: EmbedSessionEventCategory.PLAYBACK,
|
|
1896
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1897
|
+
description: "A media file played to the end."
|
|
1898
|
+
},
|
|
1899
|
+
[EmbedSessionEventType.RATE_CHANGE]: {
|
|
1900
|
+
category: EmbedSessionEventCategory.PLAYBACK,
|
|
1901
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1902
|
+
description: "The viewer changed the playback speed."
|
|
1903
|
+
},
|
|
1904
|
+
[EmbedSessionEventType.CHAT_QUESTION]: {
|
|
1905
|
+
category: EmbedSessionEventCategory.CHAT,
|
|
1906
|
+
source: EmbedSessionEventSource.SERVER,
|
|
1907
|
+
description: "The viewer asked the AI a question."
|
|
1908
|
+
},
|
|
1909
|
+
[EmbedSessionEventType.CHAT_FEEDBACK]: {
|
|
1910
|
+
category: EmbedSessionEventCategory.CHAT,
|
|
1911
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1912
|
+
description: "The viewer rated an AI answer."
|
|
1913
|
+
},
|
|
1914
|
+
[EmbedSessionEventType.HIDDEN]: {
|
|
1915
|
+
category: EmbedSessionEventCategory.ENGAGEMENT,
|
|
1916
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1917
|
+
description: "The page was in a background tab for more than a minute."
|
|
1918
|
+
},
|
|
1919
|
+
[EmbedSessionEventType.IDLE]: {
|
|
1920
|
+
category: EmbedSessionEventCategory.ENGAGEMENT,
|
|
1921
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1922
|
+
description: "The viewer did nothing on the page for more than a minute."
|
|
1923
|
+
},
|
|
1924
|
+
[EmbedSessionEventType.GATE_SHOWN]: {
|
|
1925
|
+
category: EmbedSessionEventCategory.IDENTITY,
|
|
1926
|
+
source: EmbedSessionEventSource.CLIENT,
|
|
1927
|
+
description: "The viewer was asked for their email before viewing."
|
|
1928
|
+
},
|
|
1929
|
+
[EmbedSessionEventType.LEAD_CAPTURED]: {
|
|
1930
|
+
category: EmbedSessionEventCategory.IDENTITY,
|
|
1931
|
+
source: EmbedSessionEventSource.SERVER,
|
|
1932
|
+
description: "The viewer entered their email to get access."
|
|
1933
|
+
}
|
|
1934
|
+
};
|
|
1935
|
+
}
|
|
1936
|
+
});
|
|
1937
|
+
|
|
1639
1938
|
// node_modules/@speakai/shared/dist/enums/index.js
|
|
1640
1939
|
var init_enums = __esm({
|
|
1641
1940
|
"node_modules/@speakai/shared/dist/enums/index.js"() {
|
|
@@ -1670,6 +1969,7 @@ var init_enums = __esm({
|
|
|
1670
1969
|
init_user();
|
|
1671
1970
|
init_webhook();
|
|
1672
1971
|
init_llm();
|
|
1972
|
+
init_embedSession();
|
|
1673
1973
|
}
|
|
1674
1974
|
});
|
|
1675
1975
|
|
|
@@ -1681,9 +1981,11 @@ var init_api = __esm({
|
|
|
1681
1981
|
});
|
|
1682
1982
|
|
|
1683
1983
|
// node_modules/@speakai/shared/dist/interfaces/media.js
|
|
1984
|
+
var CUSTOM_THUMBNAIL_MAX_BYTES;
|
|
1684
1985
|
var init_media2 = __esm({
|
|
1685
1986
|
"node_modules/@speakai/shared/dist/interfaces/media.js"() {
|
|
1686
1987
|
"use strict";
|
|
1988
|
+
CUSTOM_THUMBNAIL_MAX_BYTES = 10 * 1024 * 1024;
|
|
1687
1989
|
}
|
|
1688
1990
|
});
|
|
1689
1991
|
|
|
@@ -1854,6 +2156,13 @@ var init_notificationEvent2 = __esm({
|
|
|
1854
2156
|
}
|
|
1855
2157
|
});
|
|
1856
2158
|
|
|
2159
|
+
// node_modules/@speakai/shared/dist/interfaces/embedSession.js
|
|
2160
|
+
var init_embedSession2 = __esm({
|
|
2161
|
+
"node_modules/@speakai/shared/dist/interfaces/embedSession.js"() {
|
|
2162
|
+
"use strict";
|
|
2163
|
+
}
|
|
2164
|
+
});
|
|
2165
|
+
|
|
1857
2166
|
// node_modules/@speakai/shared/dist/interfaces/index.js
|
|
1858
2167
|
var init_interfaces = __esm({
|
|
1859
2168
|
"node_modules/@speakai/shared/dist/interfaces/index.js"() {
|
|
@@ -1881,6 +2190,7 @@ var init_interfaces = __esm({
|
|
|
1881
2190
|
init_dashboard();
|
|
1882
2191
|
init_pushNotification2();
|
|
1883
2192
|
init_notificationEvent2();
|
|
2193
|
+
init_embedSession2();
|
|
1884
2194
|
}
|
|
1885
2195
|
});
|
|
1886
2196
|
|
|
@@ -1933,7 +2243,7 @@ var init_billing = __esm({
|
|
|
1933
2243
|
});
|
|
1934
2244
|
|
|
1935
2245
|
// node_modules/@speakai/shared/dist/voice/enums/conversation.js
|
|
1936
|
-
var ConversationEventType, SentimentType, CanonicalEndReason;
|
|
2246
|
+
var ConversationEventType, SentimentType, VoiceCallSource, CanonicalEndReason;
|
|
1937
2247
|
var init_conversation = __esm({
|
|
1938
2248
|
"node_modules/@speakai/shared/dist/voice/enums/conversation.js"() {
|
|
1939
2249
|
"use strict";
|
|
@@ -1977,6 +2287,11 @@ var init_conversation = __esm({
|
|
|
1977
2287
|
SentimentType2["NEUTRAL"] = "neutral";
|
|
1978
2288
|
SentimentType2["NEGATIVE"] = "negative";
|
|
1979
2289
|
})(SentimentType || (SentimentType = {}));
|
|
2290
|
+
(function(VoiceCallSource2) {
|
|
2291
|
+
VoiceCallSource2["WIDGET"] = "widget";
|
|
2292
|
+
VoiceCallSource2["DASHBOARD_TEST"] = "dashboard_test";
|
|
2293
|
+
VoiceCallSource2["PHONE"] = "phone";
|
|
2294
|
+
})(VoiceCallSource || (VoiceCallSource = {}));
|
|
1980
2295
|
(function(CanonicalEndReason2) {
|
|
1981
2296
|
CanonicalEndReason2["USER_GOODBYE"] = "user-goodbye";
|
|
1982
2297
|
CanonicalEndReason2["USER_MANUAL_END"] = "user-manual-end";
|
|
@@ -4373,6 +4688,65 @@ var init_notificationEvent3 = __esm({
|
|
|
4373
4688
|
}
|
|
4374
4689
|
});
|
|
4375
4690
|
|
|
4691
|
+
// node_modules/@speakai/shared/dist/utils/embedSession.js
|
|
4692
|
+
var EMBED_SESSION_ID_PATTERN, EMBED_VIEWER_ID_PATTERN, EMBED_SESSION_LIMITS;
|
|
4693
|
+
var init_embedSession3 = __esm({
|
|
4694
|
+
"node_modules/@speakai/shared/dist/utils/embedSession.js"() {
|
|
4695
|
+
"use strict";
|
|
4696
|
+
init_embedSession();
|
|
4697
|
+
EMBED_SESSION_ID_PATTERN = /^[A-Za-z0-9-]{16,64}$/;
|
|
4698
|
+
EMBED_VIEWER_ID_PATTERN = /^[a-f0-9]{32}$/;
|
|
4699
|
+
EMBED_SESSION_LIMITS = {
|
|
4700
|
+
flushIntervalMs: 3e4,
|
|
4701
|
+
idleAfterMs: 6e4,
|
|
4702
|
+
engagementGapMs: 6e4,
|
|
4703
|
+
sessionTimeoutMs: 18e5,
|
|
4704
|
+
maxSessionMs: 864e5,
|
|
4705
|
+
liveWindowMs: 6e4,
|
|
4706
|
+
maxEventsPerDocument: 1e4,
|
|
4707
|
+
completedPositionPct: 95,
|
|
4708
|
+
eventsPageSize: 200,
|
|
4709
|
+
maxEventsPageSize: 500,
|
|
4710
|
+
listPageSize: 25,
|
|
4711
|
+
maxListPageSize: 100,
|
|
4712
|
+
mediaPageSize: 25,
|
|
4713
|
+
maxMediaPageSize: 100,
|
|
4714
|
+
maxSearchLength: 100,
|
|
4715
|
+
searchDebounceMs: 1e3
|
|
4716
|
+
};
|
|
4717
|
+
}
|
|
4718
|
+
});
|
|
4719
|
+
|
|
4720
|
+
// node_modules/@speakai/shared/dist/embedSession/playback.js
|
|
4721
|
+
var init_playback = __esm({
|
|
4722
|
+
"node_modules/@speakai/shared/dist/embedSession/playback.js"() {
|
|
4723
|
+
"use strict";
|
|
4724
|
+
init_embedSession();
|
|
4725
|
+
init_embedSession3();
|
|
4726
|
+
}
|
|
4727
|
+
});
|
|
4728
|
+
|
|
4729
|
+
// node_modules/@speakai/shared/dist/embedSession/tracker.js
|
|
4730
|
+
var ACTIVITY_NEUTRAL_EVENTS, SESSION_LIFECYCLE_EVENTS;
|
|
4731
|
+
var init_tracker = __esm({
|
|
4732
|
+
"node_modules/@speakai/shared/dist/embedSession/tracker.js"() {
|
|
4733
|
+
"use strict";
|
|
4734
|
+
init_embedSession();
|
|
4735
|
+
init_embedSession3();
|
|
4736
|
+
init_playback();
|
|
4737
|
+
ACTIVITY_NEUTRAL_EVENTS = /* @__PURE__ */ new Set([
|
|
4738
|
+
EmbedSessionEventType.SESSION_END,
|
|
4739
|
+
EmbedSessionEventType.HIDDEN,
|
|
4740
|
+
EmbedSessionEventType.IDLE
|
|
4741
|
+
]);
|
|
4742
|
+
SESSION_LIFECYCLE_EVENTS = /* @__PURE__ */ new Set([
|
|
4743
|
+
EmbedSessionEventType.SESSION_START,
|
|
4744
|
+
EmbedSessionEventType.SESSION_RESUME,
|
|
4745
|
+
EmbedSessionEventType.SESSION_END
|
|
4746
|
+
]);
|
|
4747
|
+
}
|
|
4748
|
+
});
|
|
4749
|
+
|
|
4376
4750
|
// node_modules/@speakai/shared/dist/llm/types.js
|
|
4377
4751
|
var init_types = __esm({
|
|
4378
4752
|
"node_modules/@speakai/shared/dist/llm/types.js"() {
|
|
@@ -4394,6 +4768,8 @@ var init_dist = __esm({
|
|
|
4394
4768
|
init_meetingLink();
|
|
4395
4769
|
init_pushNotification3();
|
|
4396
4770
|
init_notificationEvent3();
|
|
4771
|
+
init_embedSession3();
|
|
4772
|
+
init_tracker();
|
|
4397
4773
|
init_registry();
|
|
4398
4774
|
init_types();
|
|
4399
4775
|
init_modelPricing();
|
|
@@ -6272,14 +6648,126 @@ function register6(server, client) {
|
|
|
6272
6648
|
}
|
|
6273
6649
|
}
|
|
6274
6650
|
);
|
|
6651
|
+
registerSpeakTool(
|
|
6652
|
+
server,
|
|
6653
|
+
"list_embed_sessions",
|
|
6654
|
+
"Owner analytics for an embed: list the visits (sessions) to one embed, newest first by default. Each session has its start and last activity time, whether it is still live, total and active time, media opened, time watched, questions asked, the viewer's email and name when they identified themselves, their country, browser, device and referrer, campaign tags, and whether it was a bot. Returns sessions with totalCount, page and pageSize. Use get_embed_session with a session's _id for its full timeline.",
|
|
6655
|
+
{
|
|
6656
|
+
embedId: embedIdSchema,
|
|
6657
|
+
...embedSessionRangeSchema,
|
|
6658
|
+
page: import_zod7.z.number().int().min(0).optional().describe("0-based page index (default 0)"),
|
|
6659
|
+
pageSize: import_zod7.z.number().int().min(1).max(EMBED_SESSION_LIMITS.maxListPageSize).optional().describe(`Sessions per page (default ${EMBED_SESSION_LIMITS.listPageSize}, max ${EMBED_SESSION_LIMITS.maxListPageSize})`),
|
|
6660
|
+
search: import_zod7.z.string().max(EMBED_SESSION_LIMITS.maxSearchLength).optional().describe("Match a viewer email (any part) or the start of a visitorId"),
|
|
6661
|
+
viewer: import_zod7.z.enum(Object.values(EmbedSessionViewerFilter)).optional().describe("identified keeps viewers who gave their email, anonymous keeps the rest (default all)"),
|
|
6662
|
+
device: import_zod7.z.enum(Object.values(EmbedSessionDeviceFilter)).optional().describe("Filter by device type (default all)"),
|
|
6663
|
+
country: import_zod7.z.string().optional().describe("Exact country name as shown in a session's client.country"),
|
|
6664
|
+
includeLegacy: import_zod7.z.boolean().optional().describe("Also include visits recorded before session tracking started (default false)"),
|
|
6665
|
+
viewerId: import_zod7.z.string().regex(EMBED_VIEWER_ID_PATTERN).optional().describe("Only sessions of one identified viewer (viewerId from a session)"),
|
|
6666
|
+
visitorId: import_zod7.z.string().regex(EMBED_SESSION_ID_PATTERN).optional().describe("Only sessions from one browser (visitorId from a session)"),
|
|
6667
|
+
mediaId: import_zod7.z.string().optional().describe("Only sessions that opened this media file"),
|
|
6668
|
+
sort: import_zod7.z.enum(Object.values(EmbedSessionSort)).optional().describe(`Sort order (default ${EmbedSessionSort.STARTED_DESC})`)
|
|
6669
|
+
},
|
|
6670
|
+
{
|
|
6671
|
+
title: "List Embed Sessions",
|
|
6672
|
+
readOnlyHint: true,
|
|
6673
|
+
destructiveHint: false,
|
|
6674
|
+
idempotentHint: true,
|
|
6675
|
+
openWorldHint: false
|
|
6676
|
+
},
|
|
6677
|
+
async ({ embedId, ...params }) => {
|
|
6678
|
+
try {
|
|
6679
|
+
const result = await api.get(`/v1/embed/sessions/${embedId}`, { params });
|
|
6680
|
+
return {
|
|
6681
|
+
content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }]
|
|
6682
|
+
};
|
|
6683
|
+
} catch (err2) {
|
|
6684
|
+
return {
|
|
6685
|
+
content: [{ type: "text", text: `Error: ${formatAxiosError(err2)}` }],
|
|
6686
|
+
isError: true
|
|
6687
|
+
};
|
|
6688
|
+
}
|
|
6689
|
+
}
|
|
6690
|
+
);
|
|
6691
|
+
registerSpeakTool(
|
|
6692
|
+
server,
|
|
6693
|
+
"get_embed_session_summary",
|
|
6694
|
+
"Owner analytics for an embed: totals across its visits for a date range. Returns KPIs (sessions, unique and returning visitors, identified viewers, average active time, media opens, time watched, questions and sessions with questions), sessions and visitors per day, top traffic sources, and a paged table of media with opens, unique viewers, plays, time watched, completion rate, questions and downloads.",
|
|
6695
|
+
{
|
|
6696
|
+
embedId: embedIdSchema,
|
|
6697
|
+
...embedSessionRangeSchema,
|
|
6698
|
+
tz: import_zod7.z.string().max(100).optional().describe("IANA time zone used to group by day, e.g. America/Toronto (default UTC)"),
|
|
6699
|
+
mediaPage: import_zod7.z.number().int().min(0).optional().describe("0-based page of the media table (default 0)"),
|
|
6700
|
+
mediaPageSize: import_zod7.z.number().int().min(1).max(EMBED_SESSION_LIMITS.maxMediaPageSize).optional().describe(`Media rows per page (default ${EMBED_SESSION_LIMITS.mediaPageSize}, max ${EMBED_SESSION_LIMITS.maxMediaPageSize})`)
|
|
6701
|
+
},
|
|
6702
|
+
{
|
|
6703
|
+
title: "Get Embed Session Summary",
|
|
6704
|
+
readOnlyHint: true,
|
|
6705
|
+
destructiveHint: false,
|
|
6706
|
+
idempotentHint: true,
|
|
6707
|
+
openWorldHint: false
|
|
6708
|
+
},
|
|
6709
|
+
async ({ embedId, ...params }) => {
|
|
6710
|
+
try {
|
|
6711
|
+
const result = await api.get(`/v1/embed/sessions/${embedId}/summary`, { params });
|
|
6712
|
+
return {
|
|
6713
|
+
content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }]
|
|
6714
|
+
};
|
|
6715
|
+
} catch (err2) {
|
|
6716
|
+
return {
|
|
6717
|
+
content: [{ type: "text", text: `Error: ${formatAxiosError(err2)}` }],
|
|
6718
|
+
isError: true
|
|
6719
|
+
};
|
|
6720
|
+
}
|
|
6721
|
+
}
|
|
6722
|
+
);
|
|
6723
|
+
registerSpeakTool(
|
|
6724
|
+
server,
|
|
6725
|
+
"get_embed_session",
|
|
6726
|
+
"Owner analytics for an embed: one visit in full. Returns the session with the media it opened (time watched, plays, seeks, furthest position, completed), the questions asked in chat, and a paged list of its events in time order, plus how many sessions the same viewer or browser has had on this embed. Use eventsPage and eventsPageSize to read long timelines.",
|
|
6727
|
+
{
|
|
6728
|
+
embedId: embedIdSchema,
|
|
6729
|
+
id: objectIdSchema.describe("The session's _id (24 hex characters) from list_embed_sessions, not its sessionId"),
|
|
6730
|
+
eventsPage: import_zod7.z.number().int().min(0).optional().describe("0-based page of events (default 0)"),
|
|
6731
|
+
eventsPageSize: import_zod7.z.number().int().min(1).max(EMBED_SESSION_LIMITS.maxEventsPageSize).optional().describe(`Events per page (default ${EMBED_SESSION_LIMITS.eventsPageSize}, max ${EMBED_SESSION_LIMITS.maxEventsPageSize})`)
|
|
6732
|
+
},
|
|
6733
|
+
{
|
|
6734
|
+
title: "Get Embed Session",
|
|
6735
|
+
readOnlyHint: true,
|
|
6736
|
+
destructiveHint: false,
|
|
6737
|
+
idempotentHint: true,
|
|
6738
|
+
openWorldHint: false
|
|
6739
|
+
},
|
|
6740
|
+
async ({ embedId, id, ...params }) => {
|
|
6741
|
+
try {
|
|
6742
|
+
const result = await api.get(`/v1/embed/sessions/${embedId}/detail/${id}`, { params });
|
|
6743
|
+
return {
|
|
6744
|
+
content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }]
|
|
6745
|
+
};
|
|
6746
|
+
} catch (err2) {
|
|
6747
|
+
return {
|
|
6748
|
+
content: [{ type: "text", text: `Error: ${formatAxiosError(err2)}` }],
|
|
6749
|
+
isError: true
|
|
6750
|
+
};
|
|
6751
|
+
}
|
|
6752
|
+
}
|
|
6753
|
+
);
|
|
6275
6754
|
}
|
|
6276
|
-
var import_zod7;
|
|
6755
|
+
var import_zod7, objectIdSchema, embedIdSchema, embedSessionRangeSchema;
|
|
6277
6756
|
var init_embed3 = __esm({
|
|
6278
6757
|
"src/tools/embed.ts"() {
|
|
6279
6758
|
"use strict";
|
|
6280
6759
|
import_zod7 = require("zod");
|
|
6281
6760
|
init_helpers();
|
|
6282
6761
|
init_client();
|
|
6762
|
+
init_dist();
|
|
6763
|
+
objectIdSchema = import_zod7.z.string().regex(/^[0-9a-fA-F]{24}$/);
|
|
6764
|
+
embedIdSchema = objectIdSchema.describe("The embed's _id (24 hex characters), as returned by create_embed or check_embed");
|
|
6765
|
+
embedSessionRangeSchema = {
|
|
6766
|
+
from: import_zod7.z.string().optional().describe("Only sessions started on or after this time (ISO 8601 date)"),
|
|
6767
|
+
to: import_zod7.z.string().optional().describe("Only sessions started on or before this time (ISO 8601 date)"),
|
|
6768
|
+
traffic: import_zod7.z.enum(Object.values(EmbedSessionTrafficFilter)).optional().describe("people leaves out bots, bots shows only bots (default all)"),
|
|
6769
|
+
includeOwner: import_zod7.z.boolean().optional().describe("Include sessions from people signed in to your own Speak AI workspace (default false)")
|
|
6770
|
+
};
|
|
6283
6771
|
}
|
|
6284
6772
|
});
|
|
6285
6773
|
|
|
@@ -11348,6 +11836,39 @@ function register19(server, client, options = {}) {
|
|
|
11348
11836
|
}
|
|
11349
11837
|
}
|
|
11350
11838
|
);
|
|
11839
|
+
registerSpeakTool(
|
|
11840
|
+
server,
|
|
11841
|
+
"get_agent_analytics",
|
|
11842
|
+
"Owner analytics for one voice agent over a date range. Returns the range used; conversation totals with completion rate, average duration and returning callers; conversations per day split into web and phone; where callers are, their devices, browsers and traffic sources; web callers who left without saying anything and the number of open knowledge gaps (questions the agent could not answer); leads captured, handoffs and action items; engagement, sentiment, top topics, end reasons and satisfaction; busiest hours, weekdays and languages; and web versus phone counts. Test calls are left out unless includeTests is true, and the count of test calls is always returned. Leave start empty for all time; a start more than 5 years before end is moved up to 5 years. A cross-company agentId returns 404.",
|
|
11843
|
+
{
|
|
11844
|
+
agentId: import_zod21.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)"),
|
|
11845
|
+
start: import_zod21.z.string().optional().describe("Start of the range (ISO 8601 date). Omit for all time. Must be before end."),
|
|
11846
|
+
end: import_zod21.z.string().optional().describe("End of the range (ISO 8601 date). Defaults to now."),
|
|
11847
|
+
tz: import_zod21.z.string().max(100).optional().describe("IANA time zone used to group by day, hour and weekday, e.g. America/Toronto (default UTC)."),
|
|
11848
|
+
compare: import_zod21.z.boolean().optional().describe("Also return the same KPIs for the period just before the range (default false). Needs start."),
|
|
11849
|
+
includeTests: import_zod21.z.boolean().optional().describe("Count the agent's test calls in the results (default false).")
|
|
11850
|
+
},
|
|
11851
|
+
{
|
|
11852
|
+
title: "Get Voice Agent Analytics",
|
|
11853
|
+
readOnlyHint: true,
|
|
11854
|
+
destructiveHint: false,
|
|
11855
|
+
idempotentHint: true,
|
|
11856
|
+
openWorldHint: false
|
|
11857
|
+
},
|
|
11858
|
+
async (params) => {
|
|
11859
|
+
try {
|
|
11860
|
+
const result = await api.get("/v1/voice/analytics/agent", { params });
|
|
11861
|
+
return {
|
|
11862
|
+
content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }]
|
|
11863
|
+
};
|
|
11864
|
+
} catch (err2) {
|
|
11865
|
+
return {
|
|
11866
|
+
content: [{ type: "text", text: `Error: ${formatAxiosError(err2)}` }],
|
|
11867
|
+
isError: true
|
|
11868
|
+
};
|
|
11869
|
+
}
|
|
11870
|
+
}
|
|
11871
|
+
);
|
|
11351
11872
|
registerSpeakTool(
|
|
11352
11873
|
server,
|
|
11353
11874
|
"create_voice_agent",
|
|
@@ -11938,7 +12459,7 @@ function register21(server, client) {
|
|
|
11938
12459
|
registerSpeakTool(
|
|
11939
12460
|
server,
|
|
11940
12461
|
"create_voice_question",
|
|
11941
|
-
"Attach a question template to a voice agent. Requires the OWNER or ADMIN role. agentId and templateId are both required and must belong to your company (or, for templateId, be a public system template) \u2014 404 if either isn't found.",
|
|
12462
|
+
"Attach a question template to a voice agent. Requires the OWNER or ADMIN role. agentId and templateId are both required and must belong to your company (or, for templateId, be a public system template) \u2014 404 if either isn't found. Returns 409 if the agent already has an enabled question whose template has the same name (they save to the same answer key); disable or delete that question first, or create this one with enabled: false.",
|
|
11942
12463
|
{
|
|
11943
12464
|
agentId: import_zod23.z.string().min(1),
|
|
11944
12465
|
templateId: import_zod23.z.string().min(1).describe("From list_voice_question_templates."),
|
|
@@ -11964,7 +12485,7 @@ function register21(server, client) {
|
|
|
11964
12485
|
registerSpeakTool(
|
|
11965
12486
|
server,
|
|
11966
12487
|
"update_voice_question",
|
|
11967
|
-
"Partially update a voice agent question \u2014 only the fields you send are changed. Requires the OWNER or ADMIN role. agentId and templateId are fixed after create; sending them is silently dropped.",
|
|
12488
|
+
"Partially update a voice agent question \u2014 only the fields you send are changed. Requires the OWNER or ADMIN role. agentId and templateId are fixed after create; sending them is silently dropped. Returns 409 when setting enabled: true on a disabled question while another enabled question on the same agent has a template with the same name (they save to the same answer key); other edits to an existing duplicate still succeed.",
|
|
11968
12489
|
{
|
|
11969
12490
|
fieldId: import_zod23.z.string().min(1).describe("ID of the question to update (from list_voice_questions)"),
|
|
11970
12491
|
customConfig: customConfigSchema.optional(),
|
|
@@ -12734,6 +13255,9 @@ var init_tool_names = __esm({
|
|
|
12734
13255
|
"update_embed",
|
|
12735
13256
|
"check_embed",
|
|
12736
13257
|
"get_embed_iframe_url",
|
|
13258
|
+
"list_embed_sessions",
|
|
13259
|
+
"get_embed_session_summary",
|
|
13260
|
+
"get_embed_session",
|
|
12737
13261
|
// exports
|
|
12738
13262
|
"export_media",
|
|
12739
13263
|
"export_multiple_media",
|
|
@@ -12865,6 +13389,7 @@ var init_tool_names = __esm({
|
|
|
12865
13389
|
"list_voices",
|
|
12866
13390
|
"list_voice_conversations",
|
|
12867
13391
|
"get_voice_conversation",
|
|
13392
|
+
"get_agent_analytics",
|
|
12868
13393
|
// voice: testing
|
|
12869
13394
|
"get_voice_test_suite",
|
|
12870
13395
|
"update_voice_test_suite",
|
|
@@ -14256,7 +14781,10 @@ var SPEAK_MCP_TOOL_CATEGORIES = [
|
|
|
14256
14781
|
"create_embed",
|
|
14257
14782
|
"update_embed",
|
|
14258
14783
|
"check_embed",
|
|
14259
|
-
"get_embed_iframe_url"
|
|
14784
|
+
"get_embed_iframe_url",
|
|
14785
|
+
"list_embed_sessions",
|
|
14786
|
+
"get_embed_session_summary",
|
|
14787
|
+
"get_embed_session"
|
|
14260
14788
|
]
|
|
14261
14789
|
},
|
|
14262
14790
|
{
|
|
@@ -14301,6 +14829,7 @@ var SPEAK_MCP_TOOL_CATEGORIES = [
|
|
|
14301
14829
|
"list_voices",
|
|
14302
14830
|
"list_voice_conversations",
|
|
14303
14831
|
"get_voice_conversation",
|
|
14832
|
+
"get_agent_analytics",
|
|
14304
14833
|
"list_voice_questions",
|
|
14305
14834
|
"get_voice_question",
|
|
14306
14835
|
"create_voice_question",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@speakai/mcp-server",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.39.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.60",
|
|
58
58
|
"@types/node": "^20.0.0",
|
|
59
59
|
"@vitest/coverage-v8": "^4.1.6",
|
|
60
60
|
"tsup": "^8.5.1",
|