@speakai/mcp-server 1.33.1 → 1.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/index.js +17 -14
  2. package/package.json +2 -2
package/dist/index.js CHANGED
@@ -4152,7 +4152,7 @@ var init_label3 = __esm({
4152
4152
  [UserRole.OWNER]: ALL_LABEL_PERMISSIONS,
4153
4153
  [UserRole.ADMIN]: ALL_LABEL_PERMISSIONS,
4154
4154
  [UserRole.MEMBER]: {
4155
- labels: { create: false, update: false, delete: false, assign: true },
4155
+ labels: { create: true, update: true, delete: false, assign: true },
4156
4156
  comments: { create: true, update: true, delete: false }
4157
4157
  }
4158
4158
  };
@@ -5916,7 +5916,7 @@ function register6(server, client) {
5916
5916
  ),
5917
5917
  password: import_zod7.z.string().optional().describe("Password to protect the embed with when privacyMode is private. Only applied when privacyMode is also sent."),
5918
5918
  meta: import_zod7.z.record(import_zod7.z.unknown()).optional().describe(
5919
- "Embed appearance & feature toggles: { backgroundImg, logo, primaryColor, titleColor, chatWelcomeMessage, assistantTemplateId, isTitle, isDescription, isRemarks, isDataVizDownloadable, isSEOIndexing, isPromptAsk, isPromptHistory, isMediaExport, isLabels, isComments, callToActionButtons:[{ url, label }], features:[{ name, isActive, isCustom? }] }. isLabels and isComments show the media's labels and comments read-only on media and folder embeds; both are off by default and embed viewers can never write them."
5919
+ `Embed appearance & feature toggles: { backgroundImg, logo, primaryColor, titleColor, chatWelcomeMessage, assistantTemplateId, isTitle, isDescription, isRemarks, isDataVizDownloadable, isSEOIndexing, isPromptAsk, isPromptHistory, isMediaExport, isLabels, isComments, callToActionButtons:[{ url, label }], features:[{ name, isActive, isCustom? }] }. features entry { name: "fieldsFocus", isActive: false } turns off the fields-first media page: by default, when a media page is opened from a shared dashboard and the media has custom fields, the page shrinks the player to about 22% and leads with the fields. isPromptAsk must be on for the chat button of a shared dashboard (and a notes widget openChat action) to work. isLabels and isComments show the media's labels and comments read-only on media and folder embeds; both are off by default and embed viewers can never write them.`
5920
5920
  )
5921
5921
  },
5922
5922
  {
@@ -7058,7 +7058,7 @@ function register10(server, client) {
7058
7058
  registerSpeakTool(
7059
7059
  server,
7060
7060
  "create_label",
7061
- "Create a label, or a label group with isGroup true. Labels are shared by the whole workspace and are applied to transcript words with apply_label. A label can sit in one group (parentId); groups cannot be nested, and a group has no color. Names are unique among active labels under the same parent, ignoring case and extra spaces: 409 means the name is taken. Requires the labels create permission (owners and admins by default). " + LABEL_ACTIVITY_NOTE,
7061
+ "Create a label, or a label group with isGroup true. Labels are shared by the whole workspace and are applied to transcript words with apply_label. A label can sit in one group (parentId); groups cannot be nested, and a group has no color. Names are unique among active labels under the same parent, ignoring case and extra spaces: 409 means the name is taken. Requires the labels create permission (every member by default). " + LABEL_ACTIVITY_NOTE,
7062
7062
  {
7063
7063
  name: labelName.describe(`Label or group name (1 to ${LABEL_NAME_MAX} characters)`),
7064
7064
  isGroup: import_zod12.z.boolean().optional().describe("true to create a group that holds labels"),
@@ -7083,7 +7083,7 @@ function register10(server, client) {
7083
7083
  registerSpeakTool(
7084
7084
  server,
7085
7085
  "update_label",
7086
- "Rename, recolor, describe, move or reorder a label or group. Send only the fields to change. parentId null moves a label to the top level. An archived label cannot be edited (restore_label first), and a group cannot take a color or a parent. 409 means another active label under the same parent already has the name. Requires the labels update permission (owners and admins by default). " + LABEL_ACTIVITY_NOTE,
7086
+ "Rename, recolor, describe, move or reorder a label or group. Send only the fields to change. parentId null moves a label to the top level. An archived label cannot be edited (restore_label first), and a group cannot take a color or a parent. 409 means another active label under the same parent already has the name. Requires the labels update permission (every member by default). " + LABEL_ACTIVITY_NOTE,
7087
7087
  {
7088
7088
  labelId: publicId("labelId").describe("labelId from list_labels"),
7089
7089
  name: labelName.optional().describe(`New name (1 to ${LABEL_NAME_MAX} characters)`),
@@ -7138,7 +7138,7 @@ function register10(server, client) {
7138
7138
  registerSpeakTool(
7139
7139
  server,
7140
7140
  "merge_labels",
7141
- "Merge one label into another: every place the source label is applied moves onto the target (a span that had both keeps one), then the source is archived with mergedInto set. This cannot be undone by restore_label. Both must be active, non-group labels and different. Returns movedCount. Requires both the labels update and labels delete permissions (owners and admins by default). " + LABEL_ACTIVITY_NOTE,
7141
+ "Merge one label into another: every place the source label is applied moves onto the target (a span that had both keeps one), then the source is archived with mergedInto set. This cannot be undone by restore_label. Both must be active, non-group labels and different. Returns movedCount. Requires both the labels update and labels delete permissions; only owners and admins have labels delete by default. " + LABEL_ACTIVITY_NOTE,
7142
7142
  {
7143
7143
  labelId: publicId("labelId").describe("The label to merge away (it is archived)"),
7144
7144
  targetLabelId: publicId("targetLabelId").describe("The label that receives every use of labelId")
@@ -7159,7 +7159,7 @@ function register10(server, client) {
7159
7159
  registerSpeakTool(
7160
7160
  server,
7161
7161
  "add_speak_label_sets",
7162
- "Add ready-made label groups from Speak: sales_qa (Unprofessional, Slang, Objection, Great moment, Compliance risk), research (Pain point, Motivation, Quote for report, Surprise, Follow-up), meetings (Decision, Action item, Risk, Open question) and transcript_feedback (Wrong split, Misheard word, Wrong speaker, Bad translation). Safe to repeat: a group or label that already exists with the same name is reused, and a set whose group name is taken by a plain label is skipped (listed in skippedSets). Requires the labels create permission (owners and admins by default). " + LABEL_ACTIVITY_NOTE,
7162
+ "Add ready-made label groups from Speak: sales_qa (Unprofessional, Slang, Objection, Great moment, Compliance risk), research (Pain point, Motivation, Quote for report, Surprise, Follow-up), meetings (Decision, Action item, Risk, Open question) and transcript_feedback (Wrong split, Misheard word, Wrong speaker, Bad translation). Safe to repeat: a group or label that already exists with the same name is reused, and a set whose group name is taken by a plain label is skipped (listed in skippedSets). Requires the labels create permission (every member by default). " + LABEL_ACTIVITY_NOTE,
7163
7163
  {
7164
7164
  sets: import_zod12.z.array(import_zod12.z.nativeEnum(SpeakLabelSet)).min(1).refine((sets) => new Set(sets).size === sets.length, "sets must not repeat").describe("Which sets to add")
7165
7165
  },
@@ -10253,7 +10253,7 @@ var init_dashboard_widgets = __esm({
10253
10253
  {
10254
10254
  type: "table",
10255
10255
  purpose: "Tabular records or grouped aggregates (full width).",
10256
- config: 'rowsAre: "records" | "groups"; groupBy?: GroupBy (required when rowsAre="groups", forbidden when "records"); columns: Array<{ header: string (<=40, unique), field: string } | { header: string, metric: Metric }> (1-12; a column is EITHER a raw field OR a metric, never both; thresholds? allowed on both forms); sort?: { column: <one of the headers>, dir: "asc" | "desc" }; limit?: number (1-500); searchable?: boolean; rowClick?: "openMedia" | "none"'
10256
+ config: 'rowsAre: "records" | "groups"; groupBy?: GroupBy (required when rowsAre="groups", forbidden when "records"); columns: Array<{ header: string (<=40, unique), field: string } | { header: string, metric: Metric }> (1-12; a column is EITHER a raw field OR a metric, never both; thresholds? allowed on both forms); sort?: { column: <one of the headers>, dir: "asc" | "desc" }; limit?: number (1-500); searchable?: boolean; rowClick?: "openMedia" | "none"; display?: "table" | "cards"; card?: { titleColumn?: string, subtitleColumns?: string[] (<=2), detailColumns?: string[] (<=2), showDuration?: boolean }. SESSION CARDS: display "cards" renders each record as a card (poster frame from the video, loaded lazily, plus title, subtitle lines, up to 2 detail lines and duration). Only valid with rowsAre "records"; `card` is only valid with display "cards"; every card value must be an existing column header; set rowClick "openMedia" so a click opens the media page. Example: { rowsAre: "records", rowClick: "openMedia", display: "cards", columns: [{ header: "Session", field: "Title" }, { header: "Speaker", field: "Speaker" }], card: { titleColumn: "Session", subtitleColumns: ["Speaker"], showDuration: true } }'
10257
10257
  },
10258
10258
  {
10259
10259
  type: "comparison",
@@ -10288,7 +10288,7 @@ var init_dashboard_widgets = __esm({
10288
10288
  {
10289
10289
  type: "notes",
10290
10290
  purpose: "Free-text note/context block (full width).",
10291
- config: "content: string (1-4000 chars, required)"
10291
+ config: `content: string (1-4000 chars, required); actions?: Array<{ label: string (1-40), action: "openChat" | "goToSection", sectionId?: string }> (max 3 buttons; first renders primary, the rest outline). goToSection needs a sectionId that is a section id of this dashboard (or "overview"); openChat takes no sectionId and needs the shared embed's isPromptAsk on (update_embed meta.isPromptAsk) or the chat panel will not work. Example: { content: "Pick a session below.", actions: [{ label: "Ask the data", action: "openChat" }, { label: "See sessions", action: "goToSection", sectionId: "sessions" }] }`
10292
10292
  },
10293
10293
  {
10294
10294
  type: "chat-history",
@@ -10306,7 +10306,7 @@ var init_dashboard_widgets = __esm({
10306
10306
  binding: "Per-widget scope override, set as `binding` on any widget (omit a key to inherit the dashboard's value): { source?: Source, dateRange?: { preset }, filter?: Filter }",
10307
10307
  filter: 'Predicate tree: { field, op: "eq" | "neq" | "in" | "gt" | "gte" | "lt" | "lte" | "exists" | "notExists", value? } (op "in" takes an array value; "exists"/"notExists" take none) \u2014 or { and: Filter[] } / { or: Filter[] } (1-10 branches, max depth 5)',
10308
10308
  thresholds: 'Color bands for stat tiles, chart marks, and table columns (max 8): { when: { op: "gte" | "gt" | "lt" | "lte", value: number } | { op: "between", value: [low, high] }, status: "good" | "warn" | "critical" | "neutral", label?: string (<=40) }',
10309
- source: 'Dashboard data source: { type: "folders", folderIds: string[] (1-50) } | { type: "team" } | { type: "workspace" }',
10309
+ source: 'Dashboard data source: { type: "folders", folderIds: string[] (1-250) } | { type: "team" } | { type: "workspace" }',
10310
10310
  dateRangePresets: DATE_RANGE_PRESETS,
10311
10311
  sections: "Optional named groups of widgets rendered as tabs/sections (max 12): { id: kebab-case string, title: string (<=24), icon: kebab-case lucide icon name, widgetIds: string[] (<=24) }. Widget ids in sections must match explicit `id`s you set on the widgets; a widget may appear in at most one section; widgets in no section form the implicit Overview group."
10312
10312
  };
@@ -10416,12 +10416,14 @@ var init_dashboard_widgets = __esm({
10416
10416
  // src/tools/dashboards.ts
10417
10417
  var dashboards_exports = {};
10418
10418
  __export(dashboards_exports, {
10419
- register: () => register18
10419
+ MAX_DASHBOARD_SOURCE_FOLDERS: () => MAX_DASHBOARD_SOURCE_FOLDERS,
10420
+ register: () => register18,
10421
+ sourceInputSchema: () => sourceInputSchema
10420
10422
  });
10421
10423
  function buildSource(source) {
10422
10424
  if (source.type === "folders") {
10423
10425
  if (!source.folderIds?.length) {
10424
- throw new Error('source.type "folders" requires source.folderIds (1-50 folder ids)');
10426
+ throw new Error(`source.type "folders" requires source.folderIds (1-${MAX_DASHBOARD_SOURCE_FOLDERS} folder ids)`);
10425
10427
  }
10426
10428
  return { type: "folders", folderIds: source.folderIds };
10427
10429
  }
@@ -10747,7 +10749,7 @@ function register18(server, client) {
10747
10749
  }
10748
10750
  );
10749
10751
  }
10750
- var import_zod20, FILTER_LIST_DESCRIPTION, widgetInputSchema, sectionInputSchema, sourceInputSchema, dateRangeInputSchema, settingsFieldIds, SETTINGS_RULES, dashboardSettingsSchema, metadataFields, specFields, SPEAKERS_FILTER_SCHEMA;
10752
+ var import_zod20, MAX_DASHBOARD_SOURCE_FOLDERS, FILTER_LIST_DESCRIPTION, widgetInputSchema, sectionInputSchema, sourceInputSchema, dateRangeInputSchema, settingsFieldIds, SETTINGS_RULES, dashboardSettingsSchema, metadataFields, specFields, SPEAKERS_FILTER_SCHEMA;
10751
10753
  var init_dashboards = __esm({
10752
10754
  "src/tools/dashboards.ts"() {
10753
10755
  "use strict";
@@ -10756,6 +10758,7 @@ var init_dashboards = __esm({
10756
10758
  init_helpers();
10757
10759
  init_client();
10758
10760
  init_dashboard_widgets();
10761
+ MAX_DASHBOARD_SOURCE_FOLDERS = 250;
10759
10762
  FILTER_LIST_DESCRIPTION = "Field filters. filters.filterList is an array of { fieldName, fieldOperator?, fieldValue?: string[], fieldCondition? }. Other keys pass through but only filterList is enforced.";
10760
10763
  widgetInputSchema = import_zod20.z.object({
10761
10764
  type: import_zod20.z.enum(WIDGET_TYPES).describe(
@@ -10766,7 +10769,7 @@ var init_dashboards = __esm({
10766
10769
  ),
10767
10770
  title: import_zod20.z.string().min(1).max(40).optional().describe("Widget title, max 40 chars (defaults to a per-type label)"),
10768
10771
  config: import_zod20.z.record(import_zod20.z.unknown()).optional().describe(
10769
- "Per-type config (STRICT \u2014 unknown keys are rejected). metric-chart: mark (line|bar|area|donut|stacked-bar) + metric + groupBy/series + thresholds; table: rowsAre + columns [{header, field|metric}]; stat-cards: tiles; field-distribution: fieldName+measure+chartType (required); narrative: focus; notes: content; chat-history: limit (optional, past conversations to list, 1-100, default 25). Call list_dashboard_widgets for the full per-type vocabulary + metric/filter grammar. Omit for a sensible valid default (except field-distribution, which needs fieldName)."
10772
+ "Per-type config (STRICT \u2014 unknown keys are rejected). metric-chart: mark (line|bar|area|donut|stacked-bar) + metric + groupBy/series + thresholds; table: rowsAre + columns [{header, field|metric}] (+ display: cards and card for session cards); stat-cards: tiles; field-distribution: fieldName+measure+chartType (required); narrative: focus; notes: content (+ actions for buttons); chat-history: limit (optional, past conversations to list, 1-100, default 25). Call list_dashboard_widgets for the full per-type vocabulary + metric/filter grammar. Omit for a sensible valid default (except field-distribution, which needs fieldName)."
10770
10773
  ),
10771
10774
  binding: import_zod20.z.record(import_zod20.z.unknown()).optional().describe(
10772
10775
  "Per-widget scope override: { source?, dateRange?: {preset}, filter? }. Omit any key to inherit the dashboard's value."
@@ -10790,7 +10793,7 @@ var init_dashboards = __esm({
10790
10793
  type: import_zod20.z.enum(["folders", "team", "workspace"]).describe(
10791
10794
  "folders = specific folder ids; team = the caller's team scope; workspace = everything accessible"
10792
10795
  ),
10793
- folderIds: import_zod20.z.array(import_zod20.z.string().min(1).max(64)).min(1).max(50).optional().describe('Folder ids \u2014 required when type is "folders", forbidden otherwise')
10796
+ folderIds: import_zod20.z.array(import_zod20.z.string().min(1).max(64)).min(1).max(MAX_DASHBOARD_SOURCE_FOLDERS).optional().describe(`Folder ids (1-${MAX_DASHBOARD_SOURCE_FOLDERS}) \u2014 required when type is "folders", forbidden otherwise`)
10794
10797
  }).describe(
10795
10798
  'Data source: {type:"folders", folderIds:[...]} | {type:"team"} | {type:"workspace"}'
10796
10799
  );
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@speakai/mcp-server",
3
- "version": "1.33.1",
3
+ "version": "1.34.0",
4
4
  "mcpName": "io.github.speakai/mcp-server",
5
5
  "description": "Official Speak AI MCP Server — capture meetings, search thousands of recordings, run async voice and video surveys, create clips, and automate workflows from your AI assistant.",
6
6
  "homepage": "https://docs.speakai.co/mcp",
@@ -54,7 +54,7 @@
54
54
  "zod": "^3.22.0"
55
55
  },
56
56
  "devDependencies": {
57
- "@speakai/shared": "^2.1.46",
57
+ "@speakai/shared": "^2.1.49",
58
58
  "@types/node": "^20.0.0",
59
59
  "@vitest/coverage-v8": "^4.1.6",
60
60
  "tsup": "^8.5.1",