@speakai/mcp-server 1.28.2 → 1.28.4
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 +4 -4
- package/dist/index.js +97 -102
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -433,7 +433,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
433
433
|
| `get_chat_history` | List recent AI Chat conversations |
|
|
434
434
|
| `get_chat_messages` | Get full message history for conversations |
|
|
435
435
|
| `delete_chat_message` | Delete a specific chat message |
|
|
436
|
-
| `list_prompts` | List
|
|
436
|
+
| `list_prompts` | List recent AI chat messages with their answers and sources |
|
|
437
437
|
| `get_favorite_prompts` | Get all favorited prompts and answers |
|
|
438
438
|
| `toggle_prompt_favorite` | Mark or unmark a chat message as favorite |
|
|
439
439
|
| `update_chat_title` | Rename a chat conversation |
|
|
@@ -487,7 +487,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
487
487
|
|---|---|
|
|
488
488
|
| `list_automations` | List automation rules with paging and filters |
|
|
489
489
|
| `build_automation` | Create or update an automation from a friendly spec, without the wire format |
|
|
490
|
-
| `list_automation_names` | List automations
|
|
490
|
+
| `list_automation_names` | List names and ids of active automations that have an AI chat step |
|
|
491
491
|
| `get_automation` | Get automation details (trigger + step graph) |
|
|
492
492
|
| `get_automation_runs` | Get an automation's run history |
|
|
493
493
|
| `get_automation_run` | Get one run in full — every step, plus which way each branch went |
|
|
@@ -607,10 +607,10 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
|
|
|
607
607
|
|
|
608
608
|
| Tool | Description |
|
|
609
609
|
|---|---|
|
|
610
|
-
| `create_text_note` | Create a text note for AI analysis |
|
|
610
|
+
| `create_text_note` | Create a text note for AI analysis (uses the plan allowance, then credits) |
|
|
611
611
|
| `get_text_insight` | Get AI insights for a text note |
|
|
612
612
|
| `reanalyze_text` | Re-run AI analysis on a text note |
|
|
613
|
-
| `update_text_note` | Update note content (
|
|
613
|
+
| `update_text_note` | Update a note's name or content (only a note not yet analyzed is analyzed) |
|
|
614
614
|
|
|
615
615
|
</details>
|
|
616
616
|
|
package/dist/index.js
CHANGED
|
@@ -1442,7 +1442,7 @@ function register(server, client) {
|
|
|
1442
1442
|
registerSpeakTool(
|
|
1443
1443
|
server,
|
|
1444
1444
|
"upload_media",
|
|
1445
|
-
`Import an audio or video file into Speak AI from a URL and start transcription. Accepts a direct public file URL, a URL returned by get_signed_upload_url, or a page link from a supported platform, which the server resolves to the underlying media. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES} Requires an active subscription. Creates a media item, bills its duration against the workspace's minutes or credits, and
|
|
1445
|
+
`Import an audio or video file into Speak AI from a URL and start transcription. Accepts a direct public file URL, a URL returned by get_signed_upload_url, or a page link from a supported platform, which the server resolves to the underlying media. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES} Requires an active subscription. Creates a media item, bills its duration against the workspace's minutes or credits, and sends the media.created event to the workspace's webhooks and Slack channels if any are configured. The request fails if the file exceeds the plan's size limit or its duration cannot be read, and no mediaId is returned if the balance is insufficient. Returns mediaId and state right away while processing continues in the background. Use get_media_status until state is 'processed', then get_transcript and get_media_insights.`,
|
|
1446
1446
|
{
|
|
1447
1447
|
name: import_zod2.z.string().min(1).describe("Display name for the media file"),
|
|
1448
1448
|
url: import_zod2.z.string().describe("Direct public media file URL, a URL returned by get_signed_upload_url, or a page link from a platform listed in this tool's description. Page links are resolved server-side, so pass the URL the user gave you as-is."),
|
|
@@ -1462,7 +1462,7 @@ function register(server, client) {
|
|
|
1462
1462
|
{
|
|
1463
1463
|
title: "Upload Media from URL",
|
|
1464
1464
|
readOnlyHint: false,
|
|
1465
|
-
destructiveHint:
|
|
1465
|
+
destructiveHint: true,
|
|
1466
1466
|
idempotentHint: false,
|
|
1467
1467
|
openWorldHint: true
|
|
1468
1468
|
},
|
|
@@ -1710,7 +1710,7 @@ function register(server, client) {
|
|
|
1710
1710
|
registerSpeakTool(
|
|
1711
1711
|
server,
|
|
1712
1712
|
"update_media_metadata",
|
|
1713
|
-
"Update metadata fields (name, description, tags, status) for an existing media file.",
|
|
1713
|
+
"Update metadata fields (name, description, tags, status) for an existing media file. Sends the media.updated event to the workspace's webhooks and Slack channels if any are configured.",
|
|
1714
1714
|
{
|
|
1715
1715
|
mediaId: import_zod2.z.string().min(1).describe("Unique identifier of the media file"),
|
|
1716
1716
|
name: import_zod2.z.string().describe("Display name for the media (required \u2014 the server replaces the metadata)"),
|
|
@@ -1726,7 +1726,7 @@ function register(server, client) {
|
|
|
1726
1726
|
readOnlyHint: false,
|
|
1727
1727
|
destructiveHint: true,
|
|
1728
1728
|
idempotentHint: true,
|
|
1729
|
-
openWorldHint:
|
|
1729
|
+
openWorldHint: true
|
|
1730
1730
|
},
|
|
1731
1731
|
async ({ mediaId, ...body }) => {
|
|
1732
1732
|
try {
|
|
@@ -1747,7 +1747,7 @@ function register(server, client) {
|
|
|
1747
1747
|
registerSpeakTool(
|
|
1748
1748
|
server,
|
|
1749
1749
|
"delete_media",
|
|
1750
|
-
"Permanently delete a media file and all associated transcripts and insights.",
|
|
1750
|
+
"Permanently delete a media file and all associated transcripts and insights. Sends the media.deleted event to the workspace's webhooks and Slack channels if any are configured.",
|
|
1751
1751
|
{
|
|
1752
1752
|
mediaId: import_zod2.z.string().min(1).describe("Unique identifier of the media file to delete")
|
|
1753
1753
|
},
|
|
@@ -1756,7 +1756,7 @@ function register(server, client) {
|
|
|
1756
1756
|
readOnlyHint: false,
|
|
1757
1757
|
destructiveHint: true,
|
|
1758
1758
|
idempotentHint: true,
|
|
1759
|
-
openWorldHint:
|
|
1759
|
+
openWorldHint: true
|
|
1760
1760
|
},
|
|
1761
1761
|
async ({ mediaId }) => {
|
|
1762
1762
|
try {
|
|
@@ -1894,7 +1894,7 @@ function register(server, client) {
|
|
|
1894
1894
|
registerSpeakTool(
|
|
1895
1895
|
server,
|
|
1896
1896
|
"reanalyze_media",
|
|
1897
|
-
"Re-run AI analysis on a media file using the latest models. Choose which parts to re-run via the flags below.",
|
|
1897
|
+
"Re-run AI analysis on a media file using the latest models. Choose which parts to re-run via the flags below. Overwrites the existing results for the selected parts. Sends the media.reanalyzed event to the workspace's webhooks and Slack channels if any are configured.",
|
|
1898
1898
|
{
|
|
1899
1899
|
mediaId: import_zod2.z.string().min(1).describe("Unique identifier of the media file to re-analyze"),
|
|
1900
1900
|
isInsights: import_zod2.z.boolean().optional().describe("Re-run insights analysis"),
|
|
@@ -1907,7 +1907,7 @@ function register(server, client) {
|
|
|
1907
1907
|
readOnlyHint: false,
|
|
1908
1908
|
destructiveHint: true,
|
|
1909
1909
|
idempotentHint: false,
|
|
1910
|
-
openWorldHint:
|
|
1910
|
+
openWorldHint: true
|
|
1911
1911
|
},
|
|
1912
1912
|
async ({ mediaId, ...params }) => {
|
|
1913
1913
|
try {
|
|
@@ -1979,7 +1979,7 @@ function register(server, client) {
|
|
|
1979
1979
|
registerSpeakTool(
|
|
1980
1980
|
server,
|
|
1981
1981
|
"bulk_move_media",
|
|
1982
|
-
"Move multiple media files to a folder in a single operation. Use this for batch reorganization instead of updating media one by one.",
|
|
1982
|
+
"Move multiple media files to a folder in a single operation. Use this for batch reorganization instead of updating media one by one. Sends the media.updated event to the workspace's webhooks and Slack channels if any are configured.",
|
|
1983
1983
|
{
|
|
1984
1984
|
folderId: import_zod2.z.string().min(1).describe("Target folder ID to move media into"),
|
|
1985
1985
|
mediaIds: import_zod2.z.array(import_zod2.z.string().min(1)).min(1).describe("Array of media IDs to move")
|
|
@@ -1989,7 +1989,7 @@ function register(server, client) {
|
|
|
1989
1989
|
readOnlyHint: false,
|
|
1990
1990
|
destructiveHint: true,
|
|
1991
1991
|
idempotentHint: false,
|
|
1992
|
-
openWorldHint:
|
|
1992
|
+
openWorldHint: true
|
|
1993
1993
|
},
|
|
1994
1994
|
async (body) => {
|
|
1995
1995
|
try {
|
|
@@ -2032,14 +2032,14 @@ function register2(server, client) {
|
|
|
2032
2032
|
registerSpeakTool(
|
|
2033
2033
|
server,
|
|
2034
2034
|
"create_text_note",
|
|
2035
|
-
"Create a new text note in Speak AI for analysis. The content will be analyzed for insights, topics, and sentiment.",
|
|
2035
|
+
"Create a new text note in Speak AI for analysis. The content will be analyzed for insights, topics, and sentiment. Uses one text note from the plan allowance, and once the allowance is used up charges credits, the account balance, or the card on file; the request is refused only when none of these can cover it. Sends the text.created and text.analyzed events to the workspace's webhooks and Slack channels if any are configured.",
|
|
2036
2036
|
{
|
|
2037
2037
|
name: import_zod3.z.string().min(1).describe("Title/name for the text note"),
|
|
2038
2038
|
text: import_zod3.z.string().optional().describe("Full text content to analyze"),
|
|
2039
2039
|
description: import_zod3.z.string().optional().describe("Description for the text note"),
|
|
2040
2040
|
folderId: import_zod3.z.string().optional().describe("ID of the folder to place the note in"),
|
|
2041
2041
|
tags: import_zod3.z.string().optional().describe("Comma-separated tags or array of tag strings"),
|
|
2042
|
-
callbackUrl: import_zod3.z.string().optional().describe("
|
|
2042
|
+
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."),
|
|
2043
2043
|
fields: import_zod3.z.array(
|
|
2044
2044
|
import_zod3.z.object({
|
|
2045
2045
|
id: import_zod3.z.string().min(1).describe("Custom field ID"),
|
|
@@ -2050,13 +2050,14 @@ function register2(server, client) {
|
|
|
2050
2050
|
{
|
|
2051
2051
|
title: "Create Text Note",
|
|
2052
2052
|
readOnlyHint: false,
|
|
2053
|
-
destructiveHint:
|
|
2053
|
+
destructiveHint: true,
|
|
2054
2054
|
idempotentHint: false,
|
|
2055
2055
|
openWorldHint: true
|
|
2056
2056
|
},
|
|
2057
2057
|
async (body) => {
|
|
2058
2058
|
try {
|
|
2059
|
-
const
|
|
2059
|
+
const payload = body.text !== void 0 ? { ...body, rawText: body.text } : body;
|
|
2060
|
+
const result = await api.post("/v1/text/create", payload);
|
|
2060
2061
|
return {
|
|
2061
2062
|
content: [
|
|
2062
2063
|
{ type: "text", text: JSON.stringify(result.data, null, 2) }
|
|
@@ -2103,7 +2104,7 @@ function register2(server, client) {
|
|
|
2103
2104
|
registerSpeakTool(
|
|
2104
2105
|
server,
|
|
2105
2106
|
"reanalyze_text",
|
|
2106
|
-
"Trigger a re-analysis of an existing text note to regenerate insights with the latest AI models.",
|
|
2107
|
+
"Trigger a re-analysis of an existing text note to regenerate insights with the latest AI models. Overwrites the note's current insights and sentiment. Sends the text.reanalyzed event to the workspace's webhooks and Slack channels if any are configured.",
|
|
2107
2108
|
{
|
|
2108
2109
|
mediaId: import_zod3.z.string().describe("Unique identifier of the text note to reanalyze")
|
|
2109
2110
|
},
|
|
@@ -2112,11 +2113,13 @@ function register2(server, client) {
|
|
|
2112
2113
|
readOnlyHint: false,
|
|
2113
2114
|
destructiveHint: true,
|
|
2114
2115
|
idempotentHint: false,
|
|
2115
|
-
openWorldHint:
|
|
2116
|
+
openWorldHint: true
|
|
2116
2117
|
},
|
|
2117
2118
|
async ({ mediaId }) => {
|
|
2118
2119
|
try {
|
|
2119
|
-
const result = await api.get(`/v1/media/reanalyze/${mediaId}
|
|
2120
|
+
const result = await api.get(`/v1/media/reanalyze/${mediaId}`, {
|
|
2121
|
+
params: { isInsights: true, isSentiment: true, isFillerWords: true, isEmbeddings: true }
|
|
2122
|
+
});
|
|
2120
2123
|
return {
|
|
2121
2124
|
content: [
|
|
2122
2125
|
{ type: "text", text: JSON.stringify(result.data, null, 2) }
|
|
@@ -2133,13 +2136,12 @@ function register2(server, client) {
|
|
|
2133
2136
|
registerSpeakTool(
|
|
2134
2137
|
server,
|
|
2135
2138
|
"update_text_note",
|
|
2136
|
-
"Update an existing text note's name, content, or metadata.
|
|
2139
|
+
"Update an existing text note's name, content, or metadata. New text replaces the existing text. A note that has not been analyzed yet is analyzed after the update; an already analyzed note is not re-analyzed, so call reanalyze_text afterwards if its insights should reflect the new text. Sends the media.updated event to the workspace's webhooks and Slack channels if any are configured.",
|
|
2137
2140
|
{
|
|
2138
2141
|
mediaId: import_zod3.z.string().min(1).describe("Unique identifier of the text note"),
|
|
2139
2142
|
name: import_zod3.z.string().optional().describe("New name for the text note"),
|
|
2140
|
-
text: import_zod3.z.string().optional().describe("New text content
|
|
2143
|
+
text: import_zod3.z.string().optional().describe("New text content. Replaces the existing text of the note."),
|
|
2141
2144
|
description: import_zod3.z.string().optional().describe("Updated description"),
|
|
2142
|
-
folderId: import_zod3.z.string().optional().describe("Move to a different folder"),
|
|
2143
2145
|
tags: import_zod3.z.string().optional().describe("Updated comma-separated tags")
|
|
2144
2146
|
},
|
|
2145
2147
|
{
|
|
@@ -2147,7 +2149,7 @@ function register2(server, client) {
|
|
|
2147
2149
|
readOnlyHint: false,
|
|
2148
2150
|
destructiveHint: true,
|
|
2149
2151
|
idempotentHint: true,
|
|
2150
|
-
openWorldHint:
|
|
2152
|
+
openWorldHint: true
|
|
2151
2153
|
},
|
|
2152
2154
|
async ({ mediaId, ...body }) => {
|
|
2153
2155
|
try {
|
|
@@ -2190,7 +2192,7 @@ function register3(server, client) {
|
|
|
2190
2192
|
registerSpeakTool(
|
|
2191
2193
|
server,
|
|
2192
2194
|
"export_media",
|
|
2193
|
-
"Export a media file's transcript or insights in various formats (pdf, docx, srt, vtt, txt, csv).",
|
|
2195
|
+
"Export a media file's transcript or insights in various formats (pdf, docx, srt, vtt, txt, csv). Generates the file and returns it without saving or sharing anything.",
|
|
2194
2196
|
{
|
|
2195
2197
|
mediaId: import_zod4.z.string().min(1).describe("Unique identifier of the media file"),
|
|
2196
2198
|
fileType: import_zod4.z.nativeEnum(ExportFormatType).describe("Desired export format"),
|
|
@@ -2203,7 +2205,7 @@ function register3(server, client) {
|
|
|
2203
2205
|
},
|
|
2204
2206
|
{
|
|
2205
2207
|
title: "Export Media Transcript",
|
|
2206
|
-
readOnlyHint:
|
|
2208
|
+
readOnlyHint: true,
|
|
2207
2209
|
destructiveHint: false,
|
|
2208
2210
|
idempotentHint: false,
|
|
2209
2211
|
openWorldHint: false
|
|
@@ -2240,7 +2242,7 @@ function register3(server, client) {
|
|
|
2240
2242
|
isInsightVisualized: import_zod4.z.boolean().optional().describe("Include insight visualizations"),
|
|
2241
2243
|
isRedacted: import_zod4.z.boolean().optional().describe("Apply PII redaction to export"),
|
|
2242
2244
|
isMerged: import_zod4.z.boolean().optional().describe("Merge all exports into a single file"),
|
|
2243
|
-
folderId: import_zod4.z.string().optional().describe("
|
|
2245
|
+
folderId: import_zod4.z.string().optional().describe("Export every media file in this folder instead. Used only when mediaIds is an empty array.")
|
|
2244
2246
|
},
|
|
2245
2247
|
{
|
|
2246
2248
|
title: "Export Multiple Media Files",
|
|
@@ -2352,7 +2354,7 @@ function register4(server, client) {
|
|
|
2352
2354
|
{
|
|
2353
2355
|
folderId: import_zod5.z.string().min(1).describe("Unique identifier of the folder"),
|
|
2354
2356
|
name: import_zod5.z.string().describe("Display name for the view"),
|
|
2355
|
-
isDefault: import_zod5.z.boolean().optional().describe("Whether this view is the folder's default view"),
|
|
2357
|
+
isDefault: import_zod5.z.boolean().optional().describe("Whether this view is the folder's default view. Setting true clears the default flag on the folder's other views"),
|
|
2356
2358
|
columns: import_zod5.z.array(
|
|
2357
2359
|
import_zod5.z.object({
|
|
2358
2360
|
fieldId: import_zod5.z.string().optional().describe("Field ID this column maps to (omit for built-in columns)"),
|
|
@@ -2366,7 +2368,7 @@ function register4(server, client) {
|
|
|
2366
2368
|
{
|
|
2367
2369
|
title: "Create Folder View",
|
|
2368
2370
|
readOnlyHint: false,
|
|
2369
|
-
destructiveHint:
|
|
2371
|
+
destructiveHint: true,
|
|
2370
2372
|
idempotentHint: false,
|
|
2371
2373
|
openWorldHint: false
|
|
2372
2374
|
},
|
|
@@ -2443,12 +2445,12 @@ function register4(server, client) {
|
|
|
2443
2445
|
targetFolderId: import_zod5.z.string().min(1).describe("Folder to copy the view into (must differ from sourceFolderId)"),
|
|
2444
2446
|
viewId: import_zod5.z.string().min(1).describe("Unique identifier of the view to clone"),
|
|
2445
2447
|
name: import_zod5.z.string().describe("Display name for the cloned view"),
|
|
2446
|
-
isDefault: import_zod5.z.boolean().optional().describe("Whether the cloned view becomes the target folder's default")
|
|
2448
|
+
isDefault: import_zod5.z.boolean().optional().describe("Whether the cloned view becomes the target folder's default. Setting true clears the default flag on the target folder's other views")
|
|
2447
2449
|
},
|
|
2448
2450
|
{
|
|
2449
2451
|
title: "Clone Folder View",
|
|
2450
2452
|
readOnlyHint: false,
|
|
2451
|
-
destructiveHint:
|
|
2453
|
+
destructiveHint: true,
|
|
2452
2454
|
idempotentHint: false,
|
|
2453
2455
|
openWorldHint: false
|
|
2454
2456
|
},
|
|
@@ -2564,7 +2566,7 @@ function register4(server, client) {
|
|
|
2564
2566
|
registerSpeakTool(
|
|
2565
2567
|
server,
|
|
2566
2568
|
"clone_folder",
|
|
2567
|
-
"
|
|
2569
|
+
"Create a new folder copied from an existing folder's name and description. Media in the source folder is not copied. Set isSaveDefaultView to also copy the source folder's default view.",
|
|
2568
2570
|
{
|
|
2569
2571
|
folderId: import_zod5.z.string().min(1).describe("ID of the folder to clone"),
|
|
2570
2572
|
name: import_zod5.z.string().optional().describe("Name for the cloned folder"),
|
|
@@ -2630,7 +2632,7 @@ function register4(server, client) {
|
|
|
2630
2632
|
registerSpeakTool(
|
|
2631
2633
|
server,
|
|
2632
2634
|
"delete_folder",
|
|
2633
|
-
"Permanently delete a folder.
|
|
2635
|
+
"Permanently delete a folder. The folder must be empty: the request is refused if it still holds any media or if it is the workspace's last folder, so move or delete its media first.",
|
|
2634
2636
|
{
|
|
2635
2637
|
folderId: import_zod5.z.string().min(1).describe("Unique identifier of the folder to delete")
|
|
2636
2638
|
},
|
|
@@ -2706,7 +2708,7 @@ function register5(server, client) {
|
|
|
2706
2708
|
registerSpeakTool(
|
|
2707
2709
|
server,
|
|
2708
2710
|
"create_recorder",
|
|
2709
|
-
"Create a new recorder or survey for collecting audio/video submissions.",
|
|
2711
|
+
"Create a new recorder or survey for collecting audio/video submissions. The recorder is live as soon as it is created: anyone with its public link can submit. By default each submission emails the recorder owner (if they opted in) and any users in notifyUsers, and emails a confirmation to the respondent when they give an email (see `notification`), and it fires the workspace's embed_recorder.recording_received webhook and recording_received automations. Creating the recorder fires the workspace's embed_recorder.created webhook if one is registered.",
|
|
2710
2712
|
{
|
|
2711
2713
|
name: import_zod6.z.string().describe("Display name for the recorder"),
|
|
2712
2714
|
...recorderConfigShape,
|
|
@@ -2717,7 +2719,7 @@ function register5(server, client) {
|
|
|
2717
2719
|
{
|
|
2718
2720
|
title: "Create Recorder",
|
|
2719
2721
|
readOnlyHint: false,
|
|
2720
|
-
destructiveHint:
|
|
2722
|
+
destructiveHint: true,
|
|
2721
2723
|
idempotentHint: false,
|
|
2722
2724
|
openWorldHint: true
|
|
2723
2725
|
},
|
|
@@ -2768,7 +2770,7 @@ function register5(server, client) {
|
|
|
2768
2770
|
registerSpeakTool(
|
|
2769
2771
|
server,
|
|
2770
2772
|
"clone_recorder",
|
|
2771
|
-
"Duplicate an existing recorder including all its settings and questions.",
|
|
2773
|
+
"Duplicate an existing recorder including all its settings and questions. The copy gets its own public link, accepts submissions right away and sends the same submission emails, webhooks and automations as any recorder. Fires the workspace's embed_recorder.created webhook if one is registered.",
|
|
2772
2774
|
{
|
|
2773
2775
|
recorderId: import_zod6.z.string().min(1).describe("ID of the recorder to clone"),
|
|
2774
2776
|
name: import_zod6.z.string().optional().describe("Name for the cloned recorder"),
|
|
@@ -2778,7 +2780,7 @@ function register5(server, client) {
|
|
|
2778
2780
|
{
|
|
2779
2781
|
title: "Clone Recorder",
|
|
2780
2782
|
readOnlyHint: false,
|
|
2781
|
-
destructiveHint:
|
|
2783
|
+
destructiveHint: true,
|
|
2782
2784
|
idempotentHint: false,
|
|
2783
2785
|
openWorldHint: true
|
|
2784
2786
|
},
|
|
@@ -2883,7 +2885,7 @@ function register5(server, client) {
|
|
|
2883
2885
|
registerSpeakTool(
|
|
2884
2886
|
server,
|
|
2885
2887
|
"update_recorder_settings",
|
|
2886
|
-
"Update configuration settings for a recorder (branding, capture options, etc.). `name` must always be supplied.",
|
|
2888
|
+
"Update configuration settings for a recorder (branding, capture options, etc.). Only the supplied settings change, and they apply to the recorder's live public page right away. `name` must always be supplied.",
|
|
2887
2889
|
{
|
|
2888
2890
|
recorderId: import_zod6.z.string().min(1).describe("Unique identifier of the recorder"),
|
|
2889
2891
|
name: import_zod6.z.string().describe("Display name for the recorder"),
|
|
@@ -2913,7 +2915,7 @@ function register5(server, client) {
|
|
|
2913
2915
|
registerSpeakTool(
|
|
2914
2916
|
server,
|
|
2915
2917
|
"update_recorder_questions",
|
|
2916
|
-
"Update the survey questions and respondent-info settings for a recorder.",
|
|
2918
|
+
"Update the survey questions and respondent-info settings for a recorder. The `questions` array replaces the recorder's existing questions, and changes apply to the recorder's live public page right away.",
|
|
2917
2919
|
{
|
|
2918
2920
|
recorderId: import_zod6.z.string().min(1).describe("Unique identifier of the recorder"),
|
|
2919
2921
|
name: import_zod6.z.boolean().optional().describe("Whether to collect the respondent's name"),
|
|
@@ -2949,7 +2951,7 @@ function register5(server, client) {
|
|
|
2949
2951
|
registerSpeakTool(
|
|
2950
2952
|
server,
|
|
2951
2953
|
"delete_recorder",
|
|
2952
|
-
"Permanently delete a recorder/survey. Existing recordings are preserved.",
|
|
2954
|
+
"Permanently delete a recorder/survey. Its public link stops accepting submissions. Existing recordings are preserved. Fires the workspace's embed_recorder.deleted webhook if one is registered.",
|
|
2953
2955
|
{
|
|
2954
2956
|
recorderId: import_zod6.z.string().min(1).describe("Unique identifier of the recorder to delete")
|
|
2955
2957
|
},
|
|
@@ -3003,7 +3005,7 @@ var init_recorder3 = __esm({
|
|
|
3003
3005
|
options: import_zod6.z.record(import_zod6.z.unknown()).optional().describe(
|
|
3004
3006
|
"Capture options: { audio, video, screenShare, liveTranscription, upload:{ file, text, multiple, url } } \u2014 all booleans"
|
|
3005
3007
|
),
|
|
3006
|
-
notification: import_zod6.z.record(import_zod6.z.unknown()).optional().describe("Notification toggles: { upload, client }
|
|
3008
|
+
notification: import_zod6.z.record(import_zod6.z.unknown()).optional().describe("Notification toggles: { upload, client }, both booleans. upload emails the recorder owner (if they opted in to submission emails) and any users in notifyUsers about each new submission; client emails a confirmation to each respondent who gives an email."),
|
|
3007
3009
|
meta: import_zod6.z.record(import_zod6.z.unknown()).optional().describe(
|
|
3008
3010
|
"Branding/customization: { primaryColor, backgroundImg, logo, fontColor, fontFamily, theme, customCSS, hideWaveform, hideTitle, hideDescription, hideSubmitButton, submitButtonLabel, countdown, hideImages }"
|
|
3009
3011
|
)
|
|
@@ -3021,7 +3023,7 @@ function register6(server, client) {
|
|
|
3021
3023
|
registerSpeakTool(
|
|
3022
3024
|
server,
|
|
3023
3025
|
"create_embed",
|
|
3024
|
-
"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.
|
|
3026
|
+
"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.",
|
|
3025
3027
|
{
|
|
3026
3028
|
mediaId: import_zod7.z.string().optional().describe("Media file to embed (for a single-media embed)"),
|
|
3027
3029
|
folderIds: import_zod7.z.array(import_zod7.z.string()).optional().describe("Folder IDs to embed (for a folder/library embed)")
|
|
@@ -3050,10 +3052,10 @@ function register6(server, client) {
|
|
|
3050
3052
|
registerSpeakTool(
|
|
3051
3053
|
server,
|
|
3052
3054
|
"update_embed",
|
|
3053
|
-
"Update an existing embed widget
|
|
3055
|
+
"Update an existing embed widget: appearance/feature toggles via `meta`, and privacy. Passing `mediaId` with `privacyMode` sets that privacy mode on the media file itself; a public mode makes the media viewable by anyone with the embed link. Setting `privacyMode` clears any existing password unless a new one is supplied in the same call.",
|
|
3054
3056
|
{
|
|
3055
3057
|
embedId: import_zod7.z.string().min(1).describe("Unique identifier of the embed"),
|
|
3056
|
-
mediaId: import_zod7.z.string().optional().describe("Media file the embed points to"),
|
|
3058
|
+
mediaId: import_zod7.z.string().optional().describe("Media file whose privacy mode is set to privacyMode. Does not change which media the embed points to."),
|
|
3057
3059
|
privacyMode: import_zod7.z.string().optional().describe(
|
|
3058
3060
|
"Privacy mode for the embed. Changing this clears the existing password unless `password` is also supplied in the same call."
|
|
3059
3061
|
),
|
|
@@ -3168,7 +3170,9 @@ function register7(server, client) {
|
|
|
3168
3170
|
"Returns a promptId \u2014 save it to continue the conversation with follow-up questions.",
|
|
3169
3171
|
"Set analysisMediaId + analysisInput to have the model listen to the audio or watch the video instead of",
|
|
3170
3172
|
"reading the transcript alone. That is a premium feature and costs credits per hour of media \u2014",
|
|
3171
|
-
"call get_analysis_quote first to check eligibility and price."
|
|
3173
|
+
"call get_analysis_quote first to check eligibility and price.",
|
|
3174
|
+
"Each question is charged to the account's chat usage.",
|
|
3175
|
+
"The assistant can also call other Speak AI tools and actions in the user's connected third-party apps (for example, sending a message), so a prompt can change data or send content outside this chat."
|
|
3172
3176
|
].join(" ");
|
|
3173
3177
|
const askAiChatInputSchema = {
|
|
3174
3178
|
prompt: import_zod8.z.string().min(1).describe("The question or prompt to ask about the media"),
|
|
@@ -3176,7 +3180,7 @@ function register7(server, client) {
|
|
|
3176
3180
|
folderIds: import_zod8.z.array(import_zod8.z.string()).optional().describe("Array of folder IDs to scope the query to. Omit along with mediaIds to search across all media."),
|
|
3177
3181
|
folderId: import_zod8.z.string().optional().describe("Single folder ID to scope the query to. Use folderIds for multiple folders."),
|
|
3178
3182
|
assistantType: import_zod8.z.enum(Object.values(AssistantType)).optional().describe("Assistant persona: 'general' (default), 'researcher' (academic), 'marketer' (content), 'sales' (deals), 'recruiter' (hiring). Use 'custom' with assistantTemplateId."),
|
|
3179
|
-
assistantTemplateId: import_zod8.z.string().optional().describe("Required when assistantType is 'custom'. ID of a custom assistant template
|
|
3183
|
+
assistantTemplateId: import_zod8.z.string().optional().describe("Required when assistantType is 'custom'. ID of a custom assistant template."),
|
|
3180
3184
|
promptId: import_zod8.z.string().optional().describe("ID of an existing conversation to continue. Pass this to maintain chat context across multiple questions."),
|
|
3181
3185
|
speakers: import_zod8.z.array(import_zod8.z.string()).optional().describe("Filter to specific speaker IDs from the transcript"),
|
|
3182
3186
|
tags: import_zod8.z.array(import_zod8.z.string()).optional().describe("Filter media by tags"),
|
|
@@ -3192,9 +3196,9 @@ function register7(server, client) {
|
|
|
3192
3196
|
const askAiChatAnnotations = {
|
|
3193
3197
|
title: "Ask AI Chat",
|
|
3194
3198
|
readOnlyHint: false,
|
|
3195
|
-
destructiveHint:
|
|
3199
|
+
destructiveHint: true,
|
|
3196
3200
|
idempotentHint: false,
|
|
3197
|
-
openWorldHint:
|
|
3201
|
+
openWorldHint: true
|
|
3198
3202
|
};
|
|
3199
3203
|
const ANALYSIS_TIMEOUT_MS = 6 * 60 * 1e3;
|
|
3200
3204
|
const refuse = (message) => ({
|
|
@@ -3264,21 +3268,10 @@ function register7(server, client) {
|
|
|
3264
3268
|
"Check whether a media file can be analysed as audio or video, and what it will cost, before running ask_ai_chat with analysisInput. Returns { eligible, credits, seconds } and, when not eligible, a plain-English reason \u2014 an unavailable file is a normal result here, not an error. This is the only check that accounts for both the account's premium opt-in and the server-wide switch, so call it before committing to an expensive run.",
|
|
3265
3269
|
{
|
|
3266
3270
|
mediaId: import_zod8.z.string().min(1).describe("Media file to price"),
|
|
3267
|
-
|
|
3268
|
-
|
|
3269
|
-
assistantTemplateId: import_zod8.z.string().optional().describe("Required when assistantType is 'custom'. ID of a custom assistant template from list_prompts."),
|
|
3270
|
-
promptId: import_zod8.z.string().optional().describe("ID of an existing conversation to continue. Pass this to maintain chat context across multiple questions."),
|
|
3271
|
-
speakers: import_zod8.z.array(import_zod8.z.string()).optional().describe("Filter to specific speaker IDs from the transcript"),
|
|
3272
|
-
tags: import_zod8.z.array(import_zod8.z.string()).optional().describe("Filter media by tags"),
|
|
3273
|
-
startDate: import_zod8.z.string().optional().describe("Start date for date range filter (ISO 8601, e.g., '2025-01-01')"),
|
|
3274
|
-
endDate: import_zod8.z.string().optional().describe("End date for date range filter (ISO 8601, e.g., '2025-03-31')"),
|
|
3275
|
-
isIndividualPrompt: import_zod8.z.boolean().optional().describe("When true, processes each media file separately instead of combining context. Useful for comparing responses across files."),
|
|
3276
|
-
analysisInput: import_zod8.z.enum(["audio", "video"]).optional().describe(
|
|
3277
|
-
"Send the media itself to a multimodal model, not just its transcript. 'audio' analyses tone, pacing, and delivery; 'video' analyses on-screen visuals, gestures, and slides. Requires analysisMediaId. The workspace must have multimodal analysis enabled and the file must be a supported container within the duration limit, otherwise the turn runs transcript-only."
|
|
3271
|
+
analysisInput: import_zod8.z.enum(["audio", "video"]).describe(
|
|
3272
|
+
"Which pass to price: 'audio' (tone, pacing, delivery) or 'video' (also on-screen visuals, gestures, slides). Required."
|
|
3278
3273
|
),
|
|
3279
|
-
|
|
3280
|
-
"The mediaId to analyse multimodally this turn. Required together with analysisInput, and it must be one of the ids in mediaIds; either field alone is rejected."
|
|
3281
|
-
)
|
|
3274
|
+
modelId: import_zod8.z.string().optional().describe("Optional model id to price against. Omit for the workspace default.")
|
|
3282
3275
|
},
|
|
3283
3276
|
{
|
|
3284
3277
|
title: "Get Analysis Quote",
|
|
@@ -3304,7 +3297,7 @@ function register7(server, client) {
|
|
|
3304
3297
|
registerSpeakTool(
|
|
3305
3298
|
server,
|
|
3306
3299
|
"retry_ai_chat",
|
|
3307
|
-
"Retry a failed or incomplete AI Chat response. Use when a previous ask_ai_chat call returned an error or incomplete answer.",
|
|
3300
|
+
"Retry a failed or incomplete AI Chat response. Use when a previous ask_ai_chat call returned an error or incomplete answer. The turn runs again with its original settings, replaces the earlier answer for that message, and is charged to the account's chat usage again. Like ask_ai_chat, the assistant can call other Speak AI tools and actions in connected third-party apps.",
|
|
3308
3301
|
{
|
|
3309
3302
|
promptId: import_zod8.z.string().min(1).describe("ID of the conversation containing the failed message"),
|
|
3310
3303
|
messageId: import_zod8.z.string().min(1).describe("ID of the specific message to retry")
|
|
@@ -3312,9 +3305,9 @@ function register7(server, client) {
|
|
|
3312
3305
|
{
|
|
3313
3306
|
title: "Retry AI Chat",
|
|
3314
3307
|
readOnlyHint: false,
|
|
3315
|
-
destructiveHint:
|
|
3308
|
+
destructiveHint: true,
|
|
3316
3309
|
idempotentHint: false,
|
|
3317
|
-
openWorldHint:
|
|
3310
|
+
openWorldHint: true
|
|
3318
3311
|
},
|
|
3319
3312
|
async (body) => {
|
|
3320
3313
|
try {
|
|
@@ -3396,9 +3389,9 @@ function register7(server, client) {
|
|
|
3396
3389
|
registerSpeakTool(
|
|
3397
3390
|
server,
|
|
3398
3391
|
"delete_chat_message",
|
|
3399
|
-
"Delete
|
|
3392
|
+
"Delete an entire chat conversation from conversation history, so it and its messages no longer appear. No tool can restore it.",
|
|
3400
3393
|
{
|
|
3401
|
-
promptId: import_zod8.z.string().min(1).describe("ID of the
|
|
3394
|
+
promptId: import_zod8.z.string().min(1).describe("ID of the conversation (promptId) to delete")
|
|
3402
3395
|
},
|
|
3403
3396
|
{
|
|
3404
3397
|
title: "Delete Chat Message",
|
|
@@ -3424,10 +3417,10 @@ function register7(server, client) {
|
|
|
3424
3417
|
registerSpeakTool(
|
|
3425
3418
|
server,
|
|
3426
3419
|
"list_prompts",
|
|
3427
|
-
"List
|
|
3420
|
+
"List recent AI Chat messages across the workspace, newest first, with each prompt, answer, references, and the media or folder it ran on. Returns messages from the 25 most recently updated conversations in the workspace, filtered to those the caller can access, so a member may see fewer.",
|
|
3428
3421
|
{},
|
|
3429
3422
|
{
|
|
3430
|
-
title: "List
|
|
3423
|
+
title: "List Recent Chat Messages",
|
|
3431
3424
|
readOnlyHint: true,
|
|
3432
3425
|
destructiveHint: false,
|
|
3433
3426
|
idempotentHint: true,
|
|
@@ -3535,7 +3528,7 @@ function register7(server, client) {
|
|
|
3535
3528
|
registerSpeakTool(
|
|
3536
3529
|
server,
|
|
3537
3530
|
"submit_chat_feedback",
|
|
3538
|
-
"Submit feedback on a chat response (thumbs up/down).
|
|
3531
|
+
"Submit feedback on a chat response (thumbs up/down). Replaces any earlier feedback on that message, and the score and reason are posted to Speak AI's internal Slack channel for the Speak AI team to review.",
|
|
3539
3532
|
{
|
|
3540
3533
|
promptId: import_zod8.z.string().min(1).describe("ID of the conversation"),
|
|
3541
3534
|
messageId: import_zod8.z.string().min(1).describe("ID of the message to rate"),
|
|
@@ -3545,9 +3538,9 @@ function register7(server, client) {
|
|
|
3545
3538
|
{
|
|
3546
3539
|
title: "Submit Chat Feedback",
|
|
3547
3540
|
readOnlyHint: false,
|
|
3548
|
-
destructiveHint:
|
|
3541
|
+
destructiveHint: true,
|
|
3549
3542
|
idempotentHint: false,
|
|
3550
|
-
openWorldHint:
|
|
3543
|
+
openWorldHint: true
|
|
3551
3544
|
},
|
|
3552
3545
|
async (body) => {
|
|
3553
3546
|
try {
|
|
@@ -3677,7 +3670,7 @@ function register8(server, client) {
|
|
|
3677
3670
|
registerSpeakTool(
|
|
3678
3671
|
server,
|
|
3679
3672
|
"schedule_meeting_event",
|
|
3680
|
-
"Schedule the Speak AI meeting assistant to join and record an
|
|
3673
|
+
"Schedule the Speak AI meeting assistant to join and record an online meeting (Zoom, Google Meet, Microsoft Teams, or Webex). The assistant joins as a participant other attendees can see, at meetingDate or right away when meetingDate is omitted. Recorded minutes are charged to the account, and on trial plans each scheduled meeting uses one meeting from the allowance.",
|
|
3681
3674
|
{
|
|
3682
3675
|
title: import_zod9.z.string().min(1).describe("Display title for the event"),
|
|
3683
3676
|
meetingURL: import_zod9.z.string().min(1).describe("URL of the meeting to join"),
|
|
@@ -3938,7 +3931,7 @@ function register9(server, client) {
|
|
|
3938
3931
|
registerSpeakTool(
|
|
3939
3932
|
server,
|
|
3940
3933
|
"update_multiple_fields",
|
|
3941
|
-
"Set custom field values across media in a single batch operation. Scope the update with `folderId`
|
|
3934
|
+
"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.",
|
|
3942
3935
|
{
|
|
3943
3936
|
folderId: import_zod10.z.string().optional().describe("Apply the field values to all media in this folder"),
|
|
3944
3937
|
mediaIds: import_zod10.z.array(import_zod10.z.string()).optional().describe("Apply the field values to these specific media files"),
|
|
@@ -3954,7 +3947,7 @@ function register9(server, client) {
|
|
|
3954
3947
|
readOnlyHint: false,
|
|
3955
3948
|
destructiveHint: true,
|
|
3956
3949
|
idempotentHint: true,
|
|
3957
|
-
openWorldHint:
|
|
3950
|
+
openWorldHint: true
|
|
3958
3951
|
},
|
|
3959
3952
|
async (body) => {
|
|
3960
3953
|
try {
|
|
@@ -4777,7 +4770,7 @@ function register10(server, client) {
|
|
|
4777
4770
|
registerSpeakTool(
|
|
4778
4771
|
server,
|
|
4779
4772
|
"list_automation_names",
|
|
4780
|
-
"List automations
|
|
4773
|
+
"List the names and ids of active automations that contain an AI chat (magic prompt) step. Inactive automations and automations without an AI chat step are not included; use list_automations for the full list.",
|
|
4781
4774
|
{},
|
|
4782
4775
|
{
|
|
4783
4776
|
title: "List Automation Names",
|
|
@@ -4867,7 +4860,7 @@ function register10(server, client) {
|
|
|
4867
4860
|
{
|
|
4868
4861
|
title: "Create Automation",
|
|
4869
4862
|
readOnlyHint: false,
|
|
4870
|
-
destructiveHint:
|
|
4863
|
+
destructiveHint: true,
|
|
4871
4864
|
idempotentHint: false,
|
|
4872
4865
|
openWorldHint: true
|
|
4873
4866
|
},
|
|
@@ -4942,7 +4935,7 @@ function register10(server, client) {
|
|
|
4942
4935
|
registerSpeakTool(
|
|
4943
4936
|
server,
|
|
4944
4937
|
"toggle_automation_status",
|
|
4945
|
-
"Toggle an automation rule between active and inactive. This flips the current state
|
|
4938
|
+
"Toggle an automation rule between active and inactive. This flips the current state, so call get_automation first if you need to know which way it will flip. An active automation runs on its own every time its trigger fires, and its steps can send email, post to Slack, call webhook URLs, and run actions in connected third-party apps. For a Composio app-event trigger, this also creates or removes the event subscription on the connected third-party account.",
|
|
4946
4939
|
{
|
|
4947
4940
|
automationId: import_zod11.z.string().min(1).describe("Unique identifier of the automation")
|
|
4948
4941
|
},
|
|
@@ -4951,7 +4944,7 @@ function register10(server, client) {
|
|
|
4951
4944
|
readOnlyHint: false,
|
|
4952
4945
|
destructiveHint: true,
|
|
4953
4946
|
idempotentHint: false,
|
|
4954
|
-
openWorldHint:
|
|
4947
|
+
openWorldHint: true
|
|
4955
4948
|
},
|
|
4956
4949
|
async ({ automationId }) => {
|
|
4957
4950
|
try {
|
|
@@ -4970,7 +4963,7 @@ function register10(server, client) {
|
|
|
4970
4963
|
registerSpeakTool(
|
|
4971
4964
|
server,
|
|
4972
4965
|
"bulk_update_automation_status",
|
|
4973
|
-
"Activate or deactivate multiple automations at once.",
|
|
4966
|
+
"Activate or deactivate multiple automations at once. An active automation runs on its own every time its trigger fires, and its steps can send email, post to Slack, call webhook URLs, and run actions in connected third-party apps. For Composio app-event triggers, this also creates or removes the event subscription on the connected third-party account.",
|
|
4974
4967
|
{
|
|
4975
4968
|
automationIds: import_zod11.z.array(import_zod11.z.string().min(1)).min(1).max(100).describe("Automation ids to update"),
|
|
4976
4969
|
isActive: import_zod11.z.boolean().describe("true to activate, false to deactivate, for all listed automations")
|
|
@@ -4980,7 +4973,7 @@ function register10(server, client) {
|
|
|
4980
4973
|
readOnlyHint: false,
|
|
4981
4974
|
destructiveHint: true,
|
|
4982
4975
|
idempotentHint: true,
|
|
4983
|
-
openWorldHint:
|
|
4976
|
+
openWorldHint: true
|
|
4984
4977
|
},
|
|
4985
4978
|
async (body) => {
|
|
4986
4979
|
try {
|
|
@@ -5057,7 +5050,7 @@ function register10(server, client) {
|
|
|
5057
5050
|
registerSpeakTool(
|
|
5058
5051
|
server,
|
|
5059
5052
|
"delete_automation",
|
|
5060
|
-
"Permanently delete an automation rule.",
|
|
5053
|
+
"Permanently delete an automation rule. If it has an inbound webhook URL, that URL stops accepting payloads, and any event subscription it holds on a connected third-party account through Composio is removed.",
|
|
5061
5054
|
{
|
|
5062
5055
|
automationId: import_zod11.z.string().min(1).describe("Unique identifier of the automation to delete")
|
|
5063
5056
|
},
|
|
@@ -5066,7 +5059,7 @@ function register10(server, client) {
|
|
|
5066
5059
|
readOnlyHint: false,
|
|
5067
5060
|
destructiveHint: true,
|
|
5068
5061
|
idempotentHint: true,
|
|
5069
|
-
openWorldHint:
|
|
5062
|
+
openWorldHint: true
|
|
5070
5063
|
},
|
|
5071
5064
|
async ({ automationId }) => {
|
|
5072
5065
|
try {
|
|
@@ -5430,7 +5423,7 @@ function register11(server, client) {
|
|
|
5430
5423
|
registerSpeakTool(
|
|
5431
5424
|
server,
|
|
5432
5425
|
"create_webhook",
|
|
5433
|
-
"Create
|
|
5426
|
+
"Create an outbound webhook. From then on, Speak automatically POSTs a JSON payload to callbackUrl, an external endpoint, for each subscribed event (event type, ids such as mediaId or folderId, state, and for chat events the prompt and answer text).",
|
|
5434
5427
|
{
|
|
5435
5428
|
callbackUrl: import_zod12.z.string().url().describe("HTTPS endpoint URL to receive webhook payloads"),
|
|
5436
5429
|
events: import_zod12.z.array(import_zod12.z.string()).optional().describe("Array of event types to subscribe to"),
|
|
@@ -5439,7 +5432,7 @@ function register11(server, client) {
|
|
|
5439
5432
|
{
|
|
5440
5433
|
title: "Create Webhook",
|
|
5441
5434
|
readOnlyHint: false,
|
|
5442
|
-
destructiveHint:
|
|
5435
|
+
destructiveHint: true,
|
|
5443
5436
|
idempotentHint: false,
|
|
5444
5437
|
openWorldHint: true
|
|
5445
5438
|
},
|
|
@@ -5637,7 +5630,7 @@ function register11(server, client) {
|
|
|
5637
5630
|
registerSpeakTool(
|
|
5638
5631
|
server,
|
|
5639
5632
|
"delete_webhook",
|
|
5640
|
-
"
|
|
5633
|
+
"Permanently delete an outbound webhook and its delivery attempt history; its endpoint stops receiving notifications. Cannot be undone.",
|
|
5641
5634
|
{
|
|
5642
5635
|
webhookId: import_zod12.z.string().min(1).describe("Unique identifier of the webhook to delete")
|
|
5643
5636
|
},
|
|
@@ -5759,7 +5752,8 @@ function register13(server, client) {
|
|
|
5759
5752
|
"Create a highlight clip from one or more media files by specifying time ranges.",
|
|
5760
5753
|
`Clips are processed asynchronously (states: ${Object.values(ClipState).join(", ")}) \u2014 use get_clips to check status.`,
|
|
5761
5754
|
"Maximum total clip duration is 30 minutes.",
|
|
5762
|
-
"Use multiple timeRanges to stitch segments from different media files together."
|
|
5755
|
+
"Use multiple timeRanges to stitch segments from different media files together.",
|
|
5756
|
+
"When the clip finishes processing it fires your clip_created automations, whose steps can send email, post to Slack, call webhook URLs or run connected third-party app actions."
|
|
5763
5757
|
].join(" "),
|
|
5764
5758
|
{
|
|
5765
5759
|
title: import_zod14.z.string().min(1).describe("Title for the clip"),
|
|
@@ -5778,9 +5772,9 @@ function register13(server, client) {
|
|
|
5778
5772
|
{
|
|
5779
5773
|
title: "Create Highlight Clip",
|
|
5780
5774
|
readOnlyHint: false,
|
|
5781
|
-
destructiveHint:
|
|
5775
|
+
destructiveHint: true,
|
|
5782
5776
|
idempotentHint: false,
|
|
5783
|
-
openWorldHint:
|
|
5777
|
+
openWorldHint: true
|
|
5784
5778
|
},
|
|
5785
5779
|
async (body) => {
|
|
5786
5780
|
try {
|
|
@@ -5954,7 +5948,7 @@ function register14(server, client, options = {}) {
|
|
|
5954
5948
|
registerSpeakTool(
|
|
5955
5949
|
server,
|
|
5956
5950
|
"build_automation",
|
|
5957
|
-
"High-level automation builder: create (or update) a Speak automation from a friendly spec without knowing the wire format. Accepts folder/custom-field NAMES (resolved to ids; missing folders are auto-created), payload.<path> shorthand for webhook tokens, and simple step types (filter, branch, upload, ai_chat, translate, notify, call_webhook). For inbound-webhook automations the result includes the receive URL and mappable payload tokens.
|
|
5951
|
+
"High-level automation builder: create (or update) a Speak automation from a friendly spec without knowing the wire format. Accepts folder/custom-field NAMES (resolved to ids; missing folders are auto-created), payload.<path> shorthand for webhook tokens, and simple step types (filter, branch, upload, ai_chat, translate, notify, call_webhook). For inbound-webhook automations the result includes the receive URL and mappable payload tokens. create_automation takes the raw wire format instead. Passing automationId replaces that whole automation. The automation is active by default and then runs on its own every time its trigger fires: upload steps fetch a file from any URL and bill its duration, ai_chat steps use AI credits, slack notify steps post to the workspace's Slack, and call_webhook steps send HTTP requests to any URL. An inbound_webhook trigger creates a public URL that accepts payloads.",
|
|
5958
5952
|
buildAutomationSchema,
|
|
5959
5953
|
{
|
|
5960
5954
|
title: "Build Automation",
|
|
@@ -6283,7 +6277,7 @@ Likely cause: this server rejects filter rules on webhook payload fields (${data
|
|
|
6283
6277
|
registerSpeakTool(
|
|
6284
6278
|
server,
|
|
6285
6279
|
"upload_and_analyze",
|
|
6286
|
-
`Upload and transcribe media from a URL \u2014 a direct/public file URL, OR a shareable social/video page link, which Speak resolves to the underlying media automatically. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES} Returns media_id immediately; after this returns, poll get_media_status until state is 'processed' (typically 1-3 min for under 60min audio), then call get_media_insights for AI summaries. This async pattern is required for remote MCP transports \u2014 long blocking calls die at proxy idle timeouts.`,
|
|
6280
|
+
`Upload and transcribe media from a URL \u2014 a direct/public file URL, OR a shareable social/video page link, which Speak resolves to the underlying media automatically. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES} Each accepted upload creates a media item and bills its duration against the workspace's minutes or credits. Returns media_id immediately; after this returns, poll get_media_status until state is 'processed' (typically 1-3 min for under 60min audio), then call get_media_insights for AI summaries. This async pattern is required for remote MCP transports \u2014 long blocking calls die at proxy idle timeouts.`,
|
|
6287
6281
|
{
|
|
6288
6282
|
// A plain literal, not a template: the docs generator drops a tool's whole parameter
|
|
6289
6283
|
// table when a description interpolates a value it cannot resolve statically.
|
|
@@ -6297,7 +6291,7 @@ Likely cause: this server rejects filter rules on webhook payload fields (${data
|
|
|
6297
6291
|
{
|
|
6298
6292
|
title: "Upload and Analyze Media",
|
|
6299
6293
|
readOnlyHint: false,
|
|
6300
|
-
destructiveHint:
|
|
6294
|
+
destructiveHint: true,
|
|
6301
6295
|
idempotentHint: false,
|
|
6302
6296
|
openWorldHint: true
|
|
6303
6297
|
},
|
|
@@ -6357,7 +6351,7 @@ ${JSON.stringify(uploadRes.data, null, 2)}` }],
|
|
|
6357
6351
|
{
|
|
6358
6352
|
title: "Upload and Analyze Several URLs",
|
|
6359
6353
|
readOnlyHint: false,
|
|
6360
|
-
destructiveHint:
|
|
6354
|
+
destructiveHint: true,
|
|
6361
6355
|
idempotentHint: false,
|
|
6362
6356
|
openWorldHint: true
|
|
6363
6357
|
},
|
|
@@ -6427,6 +6421,7 @@ ${JSON.stringify(uploadRes.data, null, 2)}` }],
|
|
|
6427
6421
|
"Upload a local file to Speak AI for transcription and analysis.",
|
|
6428
6422
|
"Reads the file from disk, gets a pre-signed S3 URL, uploads the file, then creates the media entry.",
|
|
6429
6423
|
"Works with any audio or video file on the local filesystem.",
|
|
6424
|
+
"Each upload creates a media item and bills its duration against the workspace's minutes or credits.",
|
|
6430
6425
|
"After upload, use get_media_status to poll for completion, then get_transcript and get_media_insights."
|
|
6431
6426
|
].join(" "),
|
|
6432
6427
|
{
|
|
@@ -6440,7 +6435,7 @@ ${JSON.stringify(uploadRes.data, null, 2)}` }],
|
|
|
6440
6435
|
{
|
|
6441
6436
|
title: "Upload Local File",
|
|
6442
6437
|
readOnlyHint: false,
|
|
6443
|
-
destructiveHint:
|
|
6438
|
+
destructiveHint: true,
|
|
6444
6439
|
idempotentHint: false,
|
|
6445
6440
|
openWorldHint: true
|
|
6446
6441
|
},
|
|
@@ -6689,7 +6684,7 @@ function register15(server, client) {
|
|
|
6689
6684
|
registerSpeakTool(
|
|
6690
6685
|
server,
|
|
6691
6686
|
"delete_user_group",
|
|
6692
|
-
"
|
|
6687
|
+
"Permanently delete a user group. The users themselves are not deleted, but members lose any access that was shared with the group (for example dashboards assigned to it).",
|
|
6693
6688
|
{
|
|
6694
6689
|
id: import_zod16.z.string().min(1).describe("Group _id to delete (from list_user_groups)")
|
|
6695
6690
|
},
|
|
@@ -7221,7 +7216,7 @@ function register16(server, client) {
|
|
|
7221
7216
|
{
|
|
7222
7217
|
title: "Create Dashboard",
|
|
7223
7218
|
readOnlyHint: false,
|
|
7224
|
-
destructiveHint:
|
|
7219
|
+
destructiveHint: true,
|
|
7225
7220
|
idempotentHint: false,
|
|
7226
7221
|
openWorldHint: true
|
|
7227
7222
|
},
|
|
@@ -7253,7 +7248,7 @@ function register16(server, client) {
|
|
|
7253
7248
|
registerSpeakTool(
|
|
7254
7249
|
server,
|
|
7255
7250
|
"update_dashboard",
|
|
7256
|
-
"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. Viewer settings (the settings input): " + SETTINGS_RULES,
|
|
7251
|
+
"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,
|
|
7257
7252
|
{
|
|
7258
7253
|
dashboardId: import_zod17.z.string().min(1).describe("Dashboard business id"),
|
|
7259
7254
|
title: import_zod17.z.string().min(1).max(60).optional().describe("Dashboard name \u2014 required (with revision) when updating the spec"),
|
|
@@ -7338,7 +7333,7 @@ function register16(server, client) {
|
|
|
7338
7333
|
registerSpeakTool(
|
|
7339
7334
|
server,
|
|
7340
7335
|
"duplicate_dashboard",
|
|
7341
|
-
|
|
7336
|
+
`Clone an existing dashboard into a new dashboard owned by the caller. The copy keeps the source's widgets (same widget ids), sections, filters, and viewer settings, gets a "<name> (copy)" title, has no shared users and no public link, and starts at revision 0. Edit it afterwards with update_dashboard.`,
|
|
7342
7337
|
{
|
|
7343
7338
|
dashboardId: import_zod17.z.string().min(1).describe("Source dashboard business id to clone")
|
|
7344
7339
|
},
|
|
@@ -7526,7 +7521,7 @@ var init_dashboards = __esm({
|
|
|
7526
7521
|
icon: import_zod17.z.string().max(200).optional().describe("Icon identifier"),
|
|
7527
7522
|
assignTo: import_zod17.z.array(import_zod17.z.string()).max(100).optional().describe('User ids, or group ids in the "<groupId> (G)" convention, to share view access with'),
|
|
7528
7523
|
filters: import_zod17.z.record(import_zod17.z.unknown()).optional().describe(FILTER_LIST_DESCRIPTION),
|
|
7529
|
-
isDefault: import_zod17.z.boolean().optional().describe("Make this the
|
|
7524
|
+
isDefault: import_zod17.z.boolean().optional().describe("Make this the owner's default dashboard. Setting true clears the default flag on the owner's other dashboards"),
|
|
7530
7525
|
settings: dashboardSettingsSchema.optional()
|
|
7531
7526
|
};
|
|
7532
7527
|
specFields = {
|
|
@@ -7789,7 +7784,7 @@ function register17(server, client) {
|
|
|
7789
7784
|
"delete_voice_agent",
|
|
7790
7785
|
"Delete a voice agent. Requires the OWNER or ADMIN role. The agent is marked deleted and no tool can restore it: it stops appearing in list_voice_agents, and its share link, embedded widget, questions, and test suite stop working. Its stored data is not erased, past conversations stay in list_voice_conversations, and phone numbers assigned to it are not released.",
|
|
7791
7786
|
{ agentId: import_zod18.z.string().min(1).describe("ID of the voice agent to delete (from list_voice_agents)") },
|
|
7792
|
-
{ title: "Delete Voice Agent", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint:
|
|
7787
|
+
{ title: "Delete Voice Agent", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
|
|
7793
7788
|
async ({ agentId }) => {
|
|
7794
7789
|
try {
|
|
7795
7790
|
const result = await api.delete(`/v1/voice/agents/${agentId}`);
|
|
@@ -7821,7 +7816,7 @@ function register17(server, client) {
|
|
|
7821
7816
|
registerSpeakTool(
|
|
7822
7817
|
server,
|
|
7823
7818
|
"generate_voice_agent_config",
|
|
7824
|
-
"Run the same prompt-to-config generation as create_voice_agent_from_prompt, but against an existing agent instead of creating a new one. Requires the OWNER or ADMIN role. On success the generated config is
|
|
7819
|
+
"Run the same prompt-to-config generation as create_voice_agent_from_prompt, but against an existing agent instead of creating a new one. Requires the OWNER or ADMIN role. On success the generated config is saved onto the agent immediately, overwriting its current name, personality, instructions, chat settings, and voice, speech-to-text, and LLM settings. If the prompt is too thin and manualInstructions was not sent, the response has needsFollowUp: true with a follow-up question instead \u2014 call this again with more detail.",
|
|
7825
7820
|
{
|
|
7826
7821
|
agentId: import_zod18.z.string().min(1).describe("ID of the existing voice agent to generate config for (from list_voice_agents)"),
|
|
7827
7822
|
prompt: import_zod18.z.string().min(1).describe("Plain-English description of what the agent should do."),
|
|
@@ -7987,7 +7982,7 @@ function register18(server, client) {
|
|
|
7987
7982
|
registerSpeakTool(
|
|
7988
7983
|
server,
|
|
7989
7984
|
"generate_voice_test_suite",
|
|
7990
|
-
"Auto-generate a default test suite for a voice agent from its
|
|
7985
|
+
"Auto-generate a default test suite for a voice agent from its configuration (name, personality, instructions, welcome message, topics to avoid), via an LLM call. Requires the OWNER or ADMIN role. Overwrites the suite's existing scenarios.",
|
|
7991
7986
|
{ agentId: import_zod19.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)") },
|
|
7992
7987
|
{ title: "Generate Voice Test Suite", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
|
|
7993
7988
|
async ({ agentId }) => {
|
|
@@ -8050,7 +8045,7 @@ function register18(server, client) {
|
|
|
8050
8045
|
registerSpeakTool(
|
|
8051
8046
|
server,
|
|
8052
8047
|
"resume_voice_test_run",
|
|
8053
|
-
"Resume a paused voice agent test run, transitioning it back to running. Requires the OWNER or ADMIN role. Valid only from paused.",
|
|
8048
|
+
"Resume a paused voice agent test run, transitioning it back to running. Requires the OWNER or ADMIN role. Valid only from paused. Only the run's status changes. The live execution engine is not wired up yet, so no scenarios execute.",
|
|
8054
8049
|
{
|
|
8055
8050
|
agentId: import_zod19.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)"),
|
|
8056
8051
|
runId: import_zod19.z.string().min(1).describe("ID of the run (from get_active_voice_test_run or list_voice_test_runs)")
|
|
@@ -8585,7 +8580,7 @@ function register20(server, client) {
|
|
|
8585
8580
|
registerSpeakTool(
|
|
8586
8581
|
server,
|
|
8587
8582
|
"create_voice_agent_resource",
|
|
8588
|
-
"Add one document/link to a voice agent's knowledge base. Requires the OWNER or ADMIN role. The server
|
|
8583
|
+
"Add one document/link to a voice agent's knowledge base. Requires the OWNER or ADMIN role. The server does not fetch the URL; it embeds the title, description, and URL slug so the agent can retrieve the link during live calls.",
|
|
8589
8584
|
{ agentId: import_zod21.z.string().min(1), ...resourceBodySchema },
|
|
8590
8585
|
{ title: "Create Voice Agent Resource", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
|
|
8591
8586
|
async (body) => {
|
|
@@ -8600,7 +8595,7 @@ function register20(server, client) {
|
|
|
8600
8595
|
registerSpeakTool(
|
|
8601
8596
|
server,
|
|
8602
8597
|
"bulk_create_voice_agent_resources",
|
|
8603
|
-
"Add up to 100 documents/links to a voice agent's knowledge base in one call. Requires the OWNER or ADMIN role.
|
|
8598
|
+
"Add up to 100 documents/links to a voice agent's knowledge base in one call. Requires the OWNER or ADMIN role. The URLs are not fetched; each entry's title, description, and URL slug is embedded independently. Use this instead of calling create_voice_agent_resource in a loop.",
|
|
8604
8599
|
{
|
|
8605
8600
|
agentId: import_zod21.z.string().min(1),
|
|
8606
8601
|
resources: import_zod21.z.array(import_zod21.z.object(resourceBodySchema)).min(1).max(100).describe("1 to 100 entries, each shaped like create_voice_agent_resource's body minus agentId.")
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@speakai/mcp-server",
|
|
3
|
-
"version": "1.28.
|
|
3
|
+
"version": "1.28.4",
|
|
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",
|