@speakai/mcp-server 1.28.1 → 1.28.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +10 -10
  2. package/dist/index.js +119 -124
  3. package/package.json +2 -1
package/README.md CHANGED
@@ -402,10 +402,10 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
402
402
  | Tool | Description |
403
403
  |---|---|
404
404
  | `get_signed_upload_url` | Get a pre-signed S3 URL for direct file upload |
405
- | `upload_media` | Upload media from a URL — a direct/public file URL, a pre-signed S3 URL, or a social/video page link resolved automatically (YouTube, TikTok, Instagram, X/Twitter, Facebook, Reddit, SoundCloud, Twitch, Dailymotion, Streamable, Snapchat, Pinterest, Tumblr, Bilibili, VK, OK.ru, Rutube). Vimeo and Loom page links are not supported. |
405
+ | `upload_media` | Import an audio or video file from a direct public URL, a `get_signed_upload_url` URL, or a supported page link (YouTube, TikTok, Instagram, X/Twitter, Facebook, Reddit, SoundCloud, Twitch, Dailymotion, Streamable, Snapchat, Pinterest, Tumblr, Bilibili, VK, OK.ru, Rutube). Vimeo and Loom page links are not supported. Bills the media duration. |
406
406
  | `upload_local_file` | Upload a local file directly from disk (stdio and CLI only, never on the remote server) |
407
407
  | `upload_and_analyze` | Upload media from a URL (direct file, or any social/video page link `upload_media` accepts — resolved automatically) and return its `media_id` immediately. Poll `get_media_status` until `processed`, then call `get_media_insights` for AI summaries. Set `mediaType` when the user has said which they want; leave it off otherwise and the server picks the best available track. |
408
- | `upload_and_analyze_batch` | Upload up to 25 URLs in one call, 5 at a time. Each URL is reported as uploaded or failed with its reason, so one bad link does not sink the batch. Use this instead of calling `upload_and_analyze` in a loop. |
408
+ | `upload_and_analyze_batch` | Upload up to 25 URLs in one call, 5 at a time. Each URL is reported as uploaded or failed with its reason, so one bad link does not sink the batch. |
409
409
  | `list_media` | List and search media files with filters, pagination, and optional inline data (transcripts, speakers, keywords) via `include` param |
410
410
  | `get_media_insights` | Get AI insights — topics, sentiment, summaries, action items |
411
411
  | `get_transcript` | Get full transcript with speaker labels and timestamps |
@@ -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 available AI prompt templates |
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 as lightweight name + id pairs |
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 |
@@ -502,7 +502,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
502
502
  | `bulk_assign_automation_folders` | Set folder scope for multiple automations |
503
503
  | `run_automations` | Manually run automations against media now |
504
504
  | `delete_automation` | Permanently delete an automation |
505
- | `list_automation_apps` | List catalog apps (native + integrations) |
505
+ | `list_automation_apps` | List catalog apps: Speak built-ins plus third-party apps marked connected or not connected (read-only) |
506
506
  | `list_automation_triggers` | List catalog trigger types (optionally by app) |
507
507
  | `list_automation_actions` | List catalog action/step types (optionally by app) |
508
508
 
@@ -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 (triggers re-analysis) |
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
 
@@ -652,8 +652,8 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
652
652
  | `get_voice_agent` | Get a single voice agent by agentId |
653
653
  | `create_voice_agent` | Create a voice agent (name, personality, instructions, and voice are required) |
654
654
  | `update_voice_agent` | Update a voice agent; send only the fields you want to change |
655
- | `delete_voice_agent` | Permanently delete a voice agent and its questions, test suite, and share link |
656
- | `create_voice_agent_from_prompt` | Create a new agent from a plain-English description instead of filling in fields |
655
+ | `delete_voice_agent` | Delete a voice agent; its share link, questions, and test suite stop working (no restore tool) |
656
+ | `create_voice_agent_from_prompt` | Create a new agent from a plain-English description; an LLM generates its name, instructions, and settings |
657
657
  | `generate_voice_agent_config` | Run the same prompt-to-config generation against an existing agent |
658
658
  | `get_voice_agent_setup_guide` | Discovery helper: the build order, which tool covers each piece, common mistakes |
659
659
  | `list_voice_avatars` | List the video avatars available to attach to a voice agent |
@@ -711,7 +711,7 @@ SPEAK_API_KEY=your-key npx @speakai/mcp-server
711
711
  | `get_voice_test_suite` | Get a voice agent's test suite (its scenarios and run settings) |
712
712
  | `update_voice_test_suite` | Create or update a voice agent's test suite (upserts; replaces scenarios) |
713
713
  | `generate_voice_test_suite` | Auto-generate a default test suite from the agent's instructions and knowledge base |
714
- | `start_voice_test_run` | Start a test run against a voice agent's suite |
714
+ | `start_voice_test_run` | Queue a test run of a voice agent's scripted test suite (creates a queued run record; no calls are placed) |
715
715
  | `get_active_voice_test_run` | Get a voice agent's currently active run (queued, running, or paused) |
716
716
  | `pause_voice_test_run` | Pause a running or queued test run |
717
717
  | `resume_voice_test_run` | Resume a paused test run |
package/dist/index.js CHANGED
@@ -1442,27 +1442,27 @@ function register(server, client) {
1442
1442
  registerSpeakTool(
1443
1443
  server,
1444
1444
  "upload_media",
1445
- `Upload media from a URL \u2014 a direct/public file URL, a pre-signed S3 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} Processing is asynchronous \u2014 after uploading, use get_media_status to poll until state is 'processed' (typically 1-3 minutes for audio under 60 min), then use get_transcript and get_media_insights to retrieve results. For a single call that handles everything, use upload_and_analyze instead. For local files, use upload_local_file.`,
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
- url: import_zod2.z.string().describe("Direct/public media file URL, pre-signed S3 URL, or a shareable social/video page link \u2014 page links are resolved to the underlying media server-side. See this tool's description for the platforms accepted. Pass the URL the user gave you as-is; do not try to convert it to a file URL first."),
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."),
1449
1449
  mediaType: import_zod2.z.enum([MediaType.AUDIO, MediaType.VIDEO]).optional().describe('Type of media: "audio" or "video". Send it whenever the user has told you which they want \u2014 if they called it an audio file, or asked for audio only, pass "audio"; if they called it a video, pass "video". Otherwise omit it and the server decides: it inspects the actual file for a direct URL, and picks the best track the platform offers for a page link. Do not guess from the URL, because sending a value stops the server inspecting the file, and a video imported as "audio" can never be analysed as video afterwards.'),
1450
1450
  description: import_zod2.z.string().optional().describe("Description of the media file"),
1451
- sourceLanguage: import_zod2.z.string().optional().describe('BCP-47 language code for transcription, e.g. "en-US" or "he-IL"'),
1451
+ sourceLanguage: import_zod2.z.string().optional().describe('BCP-47 language code for transcription, e.g. "en-US" or "he-IL". Omit to use the default language on the user profile. An unsupported code falls back to automatic detection instead of failing.'),
1452
1452
  tags: import_zod2.z.string().optional().describe("Comma-separated tags for the media"),
1453
- folderId: import_zod2.z.string().optional().describe("ID of the folder to place the media in"),
1454
- callbackUrl: import_zod2.z.string().optional().describe("Webhook callback URL for this specific upload"),
1453
+ folderId: import_zod2.z.string().optional().describe("ID of the folder to place the media in. If the folder is not found, the media goes to the workspace's first folder."),
1454
+ callbackUrl: import_zod2.z.string().optional().describe("URL that replaces the workspace webhook's destination for this media'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."),
1455
1455
  fields: import_zod2.z.array(
1456
1456
  import_zod2.z.object({
1457
1457
  id: import_zod2.z.string().min(1).describe("Custom field ID"),
1458
1458
  value: import_zod2.z.string().min(1).describe("Custom field value")
1459
1459
  })
1460
- ).optional().describe("Custom field values to attach to the media")
1460
+ ).optional().describe("Custom field values to attach to the media. Field IDs that do not belong to the workspace are ignored without an error.")
1461
1461
  },
1462
1462
  {
1463
1463
  title: "Upload Media from URL",
1464
1464
  readOnlyHint: false,
1465
- destructiveHint: false,
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: false
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: false
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: false
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: false
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("Webhook callback URL for completion notification"),
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: false,
2053
+ destructiveHint: true,
2054
2054
  idempotentHint: false,
2055
2055
  openWorldHint: true
2056
2056
  },
2057
2057
  async (body) => {
2058
2058
  try {
2059
- const result = await api.post("/v1/text/create", body);
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: false
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. Updating text content will trigger re-analysis.",
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 (will trigger re-analysis)"),
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: false
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: false,
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("Folder ID for the merged export")
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: false,
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: false,
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
- "Duplicate an existing folder and all of its contents.",
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. Media within the folder will be moved, not deleted.",
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: false,
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: false,
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 } \u2014 booleans"),
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. The embed is publicly viewable by default; use update_embed to set a password or privacy mode.",
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 \u2014 appearance/feature toggles via `meta`, plus scope and privacy. Setting `privacyMode` clears any existing password unless a new one is supplied in the same call.",
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 from list_prompts."),
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: false,
3199
+ destructiveHint: true,
3196
3200
  idempotentHint: false,
3197
- openWorldHint: false
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
- modelId: import_zod8.z.string().optional().describe("Optional model id to price against. Omit for the workspace default."),
3268
- 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."),
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
- analysisMediaId: import_zod8.z.string().optional().describe(
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: false,
3308
+ destructiveHint: true,
3316
3309
  idempotentHint: false,
3317
- openWorldHint: false
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 a specific chat message from conversation history.",
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 message to delete")
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 all available AI Chat templates. Use template IDs with ask_ai_chat's assistantTemplateId parameter when using assistantType 'custom'.",
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 Prompt Templates",
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). Helps improve AI answer quality.",
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: false,
3541
+ destructiveHint: true,
3549
3542
  idempotentHint: false,
3550
- openWorldHint: false
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 upcoming meeting.",
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` (all media in a folder) and/or `mediaIds`.",
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: false
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 as lightweight { name, id } pairs \u2014 useful for pickers without fetching full configs.",
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",
@@ -4862,12 +4855,12 @@ function register10(server, client) {
4862
4855
  registerSpeakTool(
4863
4856
  server,
4864
4857
  "create_automation",
4865
- "Create a new automation rule using the V2 graph model (trigger + ordered steps). Fetch valid step/trigger options with list_automation_triggers / list_automation_actions if unsure. For inbound-webhook automations the response includes inboundWebhook.inboundUrl (where to POST payloads) \u2014 recommended flow: create, send a test payload to the URL with ?test=1, call get_inbound_webhook to see mappable payload tokens, then update_automation to wire tokens/fieldsMap.",
4858
+ "Create an automation: a trigger plus ordered steps (V2 graph model). The automation is active by default and then runs on its own every time its trigger fires. Depending on its steps, each run can send email to any address, post to the workspace's Slack, send HTTP requests to any webhook URL, fetch a file from a URL into Speak, run actions in connected third-party apps through Composio, and use AI credits. An inbound-webhook trigger creates a public URL that accepts payloads (returned as inboundWebhook.inboundUrl). A Composio app-event trigger subscribes to events on the connected third-party account. Valid trigger and step types come from list_automation_triggers and list_automation_actions. To map inbound-webhook payload fields, send a test payload to the URL with ?test=1, read the tokens with get_inbound_webhook, then call update_automation.",
4866
4859
  writeSchema,
4867
4860
  {
4868
4861
  title: "Create Automation",
4869
4862
  readOnlyHint: false,
4870
- destructiveHint: false,
4863
+ destructiveHint: true,
4871
4864
  idempotentHint: false,
4872
4865
  openWorldHint: true
4873
4866
  },
@@ -4901,7 +4894,7 @@ function register10(server, client) {
4901
4894
  registerSpeakTool(
4902
4895
  server,
4903
4896
  "update_automation",
4904
- "Update an existing automation rule. This replaces the whole automation (name, trigger, and steps), so fetch the current values with get_automation first and pass them all back with your changes.",
4897
+ "Update an existing automation rule. This replaces the whole automation (name, trigger, and steps), so fetch the current values with get_automation first and pass them all back with your changes. The saved steps run automatically on later triggers and can send email, post to Slack, call webhook URLs, and run actions in connected third-party apps. Changing a Composio app-event trigger updates the subscription on that third-party account.",
4905
4898
  {
4906
4899
  automationId: import_zod11.z.string().min(1).describe("Unique identifier of the automation"),
4907
4900
  ...writeSchema
@@ -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 \u2014 call get_automation first if you need to know which way it will flip.",
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: false
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: false
4976
+ openWorldHint: true
4984
4977
  },
4985
4978
  async (body) => {
4986
4979
  try {
@@ -5028,7 +5021,7 @@ function register10(server, client) {
5028
5021
  registerSpeakTool(
5029
5022
  server,
5030
5023
  "run_automations",
5031
- "Manually run one or more automations against one or more media items now (outside the normal trigger).",
5024
+ "Manually run one or more automations against one or more media items now (outside the normal trigger). Only active automations run; inactive or unknown automation ids and unknown media ids are skipped without an error. The runs happen in the background and this returns only an acknowledgement, so check results with get_automation_runs. Every step executes for real: it can send email, post to Slack, call webhook URLs, run actions in connected third-party apps, and use AI credits.",
5032
5025
  {
5033
5026
  mediaIds: import_zod11.z.array(import_zod11.z.string().min(1)).min(1).describe("Media ids to run the automations against"),
5034
5027
  automationIds: import_zod11.z.array(import_zod11.z.string().min(1)).min(1).describe("Automation ids to run")
@@ -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: false
5062
+ openWorldHint: true
5070
5063
  },
5071
5064
  async ({ automationId }) => {
5072
5065
  try {
@@ -5148,7 +5141,7 @@ function register10(server, client) {
5148
5141
  registerSpeakTool(
5149
5142
  server,
5150
5143
  "test_automation",
5151
- "Run an automation once against one media item to see which way it branches. THIS HAS REAL SIDE EFFECTS: only Speak's own run notifications are suppressed \u2014 outbound webhooks fire, Composio actions run against the connected third party, and AI steps are billed. Ask the user before calling it on an automation that posts anywhere outside Speak. It also needs a mediaId and sends no webhook payload, so an inbound-webhook automation cannot be meaningfully tested this way \u2014 its payload tokens will resolve to empty. Returns a runId; read the result with get_automation_run.",
5144
+ "Run one automation once against one media item to see which way it branches. This is a real run, not a dry run, and it works on inactive automations too. Only the run's own status notifications are suppressed and translation steps are skipped. Notify steps still send their email or Slack message, outbound webhooks still fire, Composio actions still run against the connected third-party account, and AI steps use credits. Confirm with the user before testing an automation that sends anything outside Speak. It needs a mediaId and sends no webhook payload, so on an inbound-webhook automation the payload tokens resolve to empty. Returns a runId; read the result with get_automation_run.",
5152
5145
  {
5153
5146
  automationId: import_zod11.z.string().min(1).describe("Unique identifier of the automation to test"),
5154
5147
  mediaId: import_zod11.z.string().min(1).describe("Media item to run the automation against")
@@ -5288,7 +5281,7 @@ function register10(server, client) {
5288
5281
  registerSpeakTool(
5289
5282
  server,
5290
5283
  "list_automation_apps",
5291
- "List the apps available in the automation catalog (e.g. Speak native + connected integrations). Use to discover what triggers/actions exist before building an automation.",
5284
+ "List the apps in Speak's automation catalog: Speak's built-in apps plus, when enabled, third-party apps available through Composio, each marked connected or not_connected for this user. Read-only: the list comes from Speak's own catalog and the user's saved connections, and no third-party service is called. Use the app slugs with list_automation_triggers and list_automation_actions.",
5292
5285
  {},
5293
5286
  {
5294
5287
  title: "List Automation Apps",
@@ -5342,7 +5335,7 @@ function register10(server, client) {
5342
5335
  registerSpeakTool(
5343
5336
  server,
5344
5337
  "list_automation_actions",
5345
- "List the action/step types available in the automation catalog. Optionally filter by app.",
5338
+ "List the step types (actions) available in Speak's automation catalog, optionally for one app slug, plus the fields each filter or condition step can test. Read-only: served from Speak's own catalog and the user's saved connections, with no third-party calls. Listing an action does not run it.",
5346
5339
  {
5347
5340
  app: import_zod11.z.string().min(1).max(100).optional().describe("Filter actions to a specific app slug")
5348
5341
  },
@@ -5430,7 +5423,7 @@ function register11(server, client) {
5430
5423
  registerSpeakTool(
5431
5424
  server,
5432
5425
  "create_webhook",
5433
- "Create a new webhook to receive real-time notifications when events occur in Speak AI.",
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: false,
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
- "Delete a webhook and stop receiving notifications at its endpoint.",
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: false,
5775
+ destructiveHint: true,
5782
5776
  idempotentHint: false,
5783
- openWorldHint: false
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. Prefer this over create_automation unless you need raw control.",
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: false,
6294
+ destructiveHint: true,
6301
6295
  idempotentHint: false,
6302
6296
  openWorldHint: true
6303
6297
  },
@@ -6345,9 +6339,9 @@ ${JSON.stringify(uploadRes.data, null, 2)}` }],
6345
6339
  registerSpeakTool(
6346
6340
  server,
6347
6341
  "upload_and_analyze_batch",
6348
- `Upload several URLs in one call \u2014 the batch form of upload_and_analyze, for when someone hands you a list of links. Takes up to ${MAX_BATCH_URLS} URLs and starts at most ${MAX_BATCH_CONCURRENCY} at a time so a long list does not hammer the API. Each URL may be a direct/public file URL or a shareable social/video page link. Supported page links: ${SUPPORTED_URL_SOURCES}. ${UNSUPPORTED_URL_SOURCES} One URL failing does not stop the rest: every URL is reported individually as uploaded or failed, with its reason. Returns as soon as the uploads are accepted, so poll get_media_status per mediaId, or list_media on the folder, to follow processing. Prefer this over calling upload_and_analyze in a loop.`,
6342
+ `Import up to ${MAX_BATCH_URLS} audio or video URLs in one call. Each URL is imported the same way as upload_and_analyze, and transcription starts for each one. At most ${MAX_BATCH_CONCURRENCY} uploads run at once. Each URL may be a direct public file 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} Each accepted upload creates a media item and bills its duration against the workspace's minutes or credits. A failed URL does not stop the others, and the result lists every URL as uploaded (with its mediaId) or failed (with the reason). Returns once the uploads are accepted. Use get_media_status per mediaId, or list_media on the folder, to follow processing.`,
6349
6343
  {
6350
- urls: import_zod15.z.array(import_zod15.z.string().min(1)).min(1).max(MAX_BATCH_URLS).describe("The URLs to import, up to 25. Pass each one exactly as the user gave it; page links are resolved server-side. Duplicates are uploaded once."),
6344
+ urls: import_zod15.z.array(import_zod15.z.string().min(1)).min(1).max(MAX_BATCH_URLS).describe("The URLs to import, up to 25. Pass each one exactly as the user gave it; page links are resolved server-side. Exact duplicate URLs are sent once."),
6351
6345
  mediaType: import_zod15.z.enum([MediaType.AUDIO, MediaType.VIDEO]).optional().describe('Applies to every URL in the batch. Send it only when the user has said which they want for all of them \u2014 "audio" if they asked for audio only, "video" if they called them videos. Otherwise omit it and the server decides per URL. Mixed batches: leave it off, or split into two calls.'),
6352
6346
  folderId: import_zod15.z.string().optional().describe("Folder ID for every upload in the batch"),
6353
6347
  sourceLanguage: import_zod15.z.string().optional().describe('BCP-47 language code applied to every upload, e.g. "en-US"'),
@@ -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: false,
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: false,
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
- "Delete a user group. This removes the group only; it does not delete the users themselves.",
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
  },
@@ -7212,7 +7207,7 @@ function register16(server, client) {
7212
7207
  registerSpeakTool(
7213
7208
  server,
7214
7209
  "create_dashboard",
7215
- `Create an analytics dashboard. Only \`title\` is required \u2014 source defaults to the whole workspace and dateRange to last30days. Add widgets by listing their types (the MCP assigns ids and lays them out automatically), scope with source ({type:"folders",folderIds} | {type:"team"} | {type:"workspace"}) and dateRange ({preset}), and optionally group widgets into sections. Design guidance: lead with a narrative widget as the first widget; group sections by the QUESTION they answer, not by widget type; don't pad \u2014 every widget earns its place (aim for 4-16 widgets on a full build); if something can't be expressed by the widget catalog, put it in a narrative widget's focus instead of faking it. Call list_dashboard_widgets first for the widget catalog, config vocabulary, design rules, and full examples. Viewer settings (the settings input): ` + SETTINGS_RULES,
7210
+ `Create an analytics dashboard. Only \`title\` is required \u2014 source defaults to the whole workspace and dateRange to last30days. Add widgets by listing their types (the MCP assigns ids and lays them out automatically), scope with source ({type:"folders",folderIds} | {type:"team"} | {type:"workspace"}) and dateRange ({preset}), and optionally group widgets into sections. Design guidance: lead with a narrative widget as the first widget; group sections by the QUESTION they answer, not by widget type; don't pad \u2014 every widget earns its place (aim for 4-16 widgets on a full build); if something can't be expressed by the widget catalog, put it in a narrative widget's focus instead of faking it. Call list_dashboard_widgets first for the widget catalog, config vocabulary, design rules, and full examples. Creating a dashboard does not share it publicly; only share_dashboard creates a public link. If settings.feedback.sheetWebhookUrl is set, each Feedback submission made on the shared dashboard is posted to that external Google Apps Script URL. Viewer settings (the settings input): ` + SETTINGS_RULES,
7216
7211
  {
7217
7212
  title: import_zod17.z.string().min(1).max(60).describe("Dashboard name, max 60 chars (the only required field)"),
7218
7213
  ...specFields,
@@ -7221,9 +7216,9 @@ function register16(server, client) {
7221
7216
  {
7222
7217
  title: "Create Dashboard",
7223
7218
  readOnlyHint: false,
7224
- destructiveHint: false,
7219
+ destructiveHint: true,
7225
7220
  idempotentHint: false,
7226
- openWorldHint: false
7221
+ openWorldHint: true
7227
7222
  },
7228
7223
  async ({ title, description, source, dateRange, sections, widgets, ...metadata }) => {
7229
7224
  try {
@@ -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
- 'Clone an existing dashboard. The copy gets fresh widget ids, a "<name> (copy)" title, cleared sharing, and its revision reset to 0. Ideal for cloning a fully-configured dashboard, then tweaking it via update_dashboard.',
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
  },
@@ -7516,7 +7511,7 @@ var init_dashboards = __esm({
7516
7511
  "Per feedback field: a short row label and the allowed score range, used for both the reviewer's score and the approver's score."
7517
7512
  ),
7518
7513
  sheetWebhookUrl: import_zod17.z.string().optional().describe(
7519
- "Google Apps Script web app URL that receives one row per submission. Only script.google.com addresses are posted to. Never shown to viewers."
7514
+ "External Google Apps Script web app URL. Speak posts one row per Feedback submission (call date, media link, scores, submitter name, notes) to it. Only https://script.google.com/macros/s/<id>/exec addresses are called; other values are saved but never called. Never shown to viewers."
7520
7515
  )
7521
7516
  }).optional()
7522
7517
  }).describe(
@@ -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 company default dashboard"),
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 = {
@@ -7787,7 +7782,7 @@ function register17(server, client) {
7787
7782
  registerSpeakTool(
7788
7783
  server,
7789
7784
  "delete_voice_agent",
7790
- "Permanently delete a voice agent. Requires the OWNER or ADMIN role. Irreversible: also removes its questions, test suite, and share link; past conversations are kept for record-keeping but are no longer reachable from this agent.",
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
7787
  { title: "Delete Voice Agent", readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
7793
7788
  async ({ agentId }) => {
@@ -7802,11 +7797,11 @@ function register17(server, client) {
7802
7797
  registerSpeakTool(
7803
7798
  server,
7804
7799
  "create_voice_agent_from_prompt",
7805
- "Create a new voice agent by describing it in plain English instead of filling in name/personality/instructions/voice yourself. Requires the OWNER or ADMIN role. Response always includes the new agentId, plus either the generated agent config, or needsFollowUp: true with a follow-up question if the prompt was too thin to act on \u2014 call generate_voice_agent_config again on that agentId with more detail (or manualInstructions) when that happens.",
7800
+ "Create a new voice agent from a plain-English description, via an LLM call. Requires the OWNER or ADMIN role. Saves a draft agent, then generates and saves its name, personality, instructions, chat settings, and default voice, speech-to-text, and LLM settings. Does not assign a phone number. The response includes the new agentId plus either the generated agent, or needsFollowUp: true with a followUpQuestion when the prompt is too vague. In that case the draft agent still exists with placeholder settings; call generate_voice_agent_config on that agentId with more detail.",
7806
7801
  {
7807
7802
  prompt: import_zod18.z.string().min(1).describe('Plain-English description of the agent to build, e.g. "a friendly dental clinic receptionist that books appointments and answers insurance questions".'),
7808
- name: import_zod18.z.string().optional().describe("Agent name. Defaults to one derived from the prompt if omitted."),
7809
- manualInstructions: import_zod18.z.string().optional().describe("Skip generation and use this as the agent's instructions verbatim.")
7803
+ name: import_zod18.z.string().optional().describe("Initial name for the draft agent. Replaced by the generated name when generation succeeds; kept only if the response asks a follow-up question."),
7804
+ manualInstructions: import_zod18.z.string().optional().describe("Requirements the generated instructions must include. Generation still runs; when this is sent, no follow-up question is returned even if the prompt is vague.")
7810
7805
  },
7811
7806
  { title: "Create Voice Agent From Prompt", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
7812
7807
  async (body) => {
@@ -7821,11 +7816,11 @@ 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 persisted onto the agent immediately. 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.",
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."),
7828
- manualInstructions: import_zod18.z.string().optional().describe("Skip generation and set the agent's instructions to this verbatim.")
7823
+ manualInstructions: import_zod18.z.string().optional().describe("Requirements the generated instructions must include. Generation still runs; when this is sent, no follow-up question is returned even if the prompt is vague.")
7829
7824
  },
7830
7825
  { title: "Generate Voice Agent Config", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
7831
7826
  async ({ agentId, ...body }) => {
@@ -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 own instructions and knowledge base, via an LLM call. Requires the OWNER or ADMIN role. Overwrites the suite's existing scenarios.",
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 }) => {
@@ -8002,9 +7997,9 @@ function register18(server, client) {
8002
7997
  registerSpeakTool(
8003
7998
  server,
8004
7999
  "start_voice_test_run",
8005
- "Start a test run against a voice agent's suite. Requires the OWNER or ADMIN role. Rejects with 409 if the agent has no test suite." + NOT_WIRED_NOTE,
8000
+ "Queue a test run of a voice agent's scripted test suite. Creates a run record in queued status and returns it; it does not place phone calls, start a conversation, or use credits. Requires the OWNER or ADMIN role. Returns 404 if the agent or its test suite does not exist, and 409 if the suite has no enabled scenarios or the agent already has a queued, running, or paused run." + NOT_WIRED_NOTE,
8006
8001
  { agentId: import_zod19.z.string().min(1).describe("ID of the voice agent (from list_voice_agents)") },
8007
- { title: "Start Voice Test Run", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
8002
+ { title: "Queue Voice Agent Test Run", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
8008
8003
  async ({ agentId }) => {
8009
8004
  try {
8010
8005
  const result = await api.post(`/v1/voice/testing/${agentId}/run`);
@@ -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 fetches and embeds the content in the background (status moves from pending to completed).",
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. Each is fetched and embedded independently in the background. Use this instead of calling create_voice_agent_resource in a loop.",
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.1",
3
+ "version": "1.28.3",
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",
@@ -26,6 +26,7 @@
26
26
  "sync:check": "tsx scripts/sync-plugin.ts --check",
27
27
  "verify:plugin": "tsx scripts/verify-plugin.ts",
28
28
  "verify:plugin:live": "tsx scripts/verify-plugin.ts --live",
29
+ "build:openai-zip": "tsx scripts/build-openai-zip.ts",
29
30
  "test:watch": "vitest",
30
31
  "test:coverage": "vitest run --coverage"
31
32
  },