@smartytalent/mcp-tools 0.9.49 → 0.9.51

package/dist/tools.json

@@ -19335,7 +19335,7 @@
       "properties": {
         "filterResourceType": {
           "type": "string",
-          "description": "Only return aggregates for this resource type (e.g. emails, chats, calls, comments).",
+          "description": "Only return aggregates for this resource type (e.g. emails, chats, calls, comments, meetings).",
           "enum": [
             "emails",
             "chats",
@@ -19347,9 +19347,18 @@
             "talents",
             "personas",
             "reports",
-            "tasks"
+            "tasks",
+            "meetings"
           ]
         },
+        "filterDayFrom": {
+          "type": "string",
+          "description": "Day buckets from this UTC day on (YYYY-MM-DD, inclusive). Needs filterResourceType and filterDimension."
+        },
+        "filterDayTo": {
+          "type": "string",
+          "description": "Day buckets up to this UTC day (YYYY-MM-DD, inclusive). Needs filterResourceType and filterDimension."
+        },
         "filterDimension": {
           "type": "string",
           "description": "Only return aggregates for this dimension (e.g. byFolder, byStatus). Triggers the `meta.by{Dimension}` overlay in the response."
@@ -19470,6 +19479,11 @@
                   "type": "integer",
                   "description": "Current counter value. Updated via atomic ADD on event consumption; admin PATCH allows manual correction for drift recovery."
                 },
+                "day": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "The UTC day of a day bucket (event counts read with filterDayFrom / filterDayTo, e.g. the meet home's `meetings` counters, 2026-10-06). Absent on every other row."
+                },
                 "timestamps": {
                   "title": "ResourceTimestampsSchema",
                   "type": "object",
@@ -19946,7 +19960,7 @@
       "properties": {
         "filterStatus": {
           "type": "string",
-          "description": "Returns meetings with the current status (active, scheduled, ended, archived). If not provided, the default value will be set to 'active'.",
+          "description": "Returns meetings with the current status (active, scheduled, ended, archived), ordered by `sort`. Without it every status is listed.",
           "enum": [
             "active",
             "scheduled",
@@ -19982,14 +19996,24 @@
           "type": "string",
           "description": "Filters results to include only those modified up to the specified date and time. The value must be in ISO 8601 format."
         },
+        "filterScheduledFrom": {
+          "type": "string",
+          "description": "Meetings whose `scheduledAt` is at or after this time (ISO 8601; no zone = UTC), of `filterStatus` or `scheduled`."
+        },
+        "filterScheduledTo": {
+          "type": "string",
+          "description": "Meetings whose `scheduledAt` is before this time (ISO 8601; no zone = UTC), of `filterStatus` or `scheduled`."
+        },
         "sort": {
           "type": "string",
-          "description": "Order results by a time field. Leading `-` means descending\n(newest-first). Accepted values:\n  `-created`  newest-first by creation time (CreatedIndex)\n  `created`   oldest-first by creation time\n  `-modified` most-recently-modified first (ModifiedIndex)\n  `modified`  least-recently-modified first\nWith `filterStatus` the order is honoured on page-number\npagination (pageNumber): the matching ids are read from the\nstatus index with the sort field and ordered globally before the\npage is cut (since 2026-09-06). Cursor pagination (pageAfter /\npageBefore) and the other equality filters (filterCandidate,\nfilterHost, filterJob, filterShortCode, etc.) keep their own\nindex order; there sort has no effect. Compatible with\ndate-range filters (filterCreatedFrom/To, filterModifiedFrom/To)\nwhich already use the same indexes; sort just picks the\ndirection. On a capped list (meta.page.totalItemsCapped) the\norder applies within the capped window.",
+          "description": "`-created` (the default) / `created`, `-modified` / `modified`, or\n`scheduledAt` / `-scheduledAt` (the meeting's time, of\n`filterStatus` or `scheduled`; a meeting without one sorts first\nascending, last descending). A leading `-` is descending.",
           "enum": [
             "-created",
             "created",
             "-modified",
-            "modified"
+            "modified",
+            "scheduledAt",
+            "-scheduledAt"
           ]
         },
         "pageSize": {
@@ -20156,11 +20180,11 @@
                 },
                 "recordingUrl": {
                   "type": "string",
-                  "description": "Post-meeting recording URL. Populated by different paths\ndepending on meetingType:\n  - `chime`: presigned S3 URL minted on read (in showMeeting)\n    once `concatenationStatus=success`. Null until then.\n  - `recall`: written by the recall.ai webhook handler with\n    the recall.ai-hosted recording URL.\n  - `external`: null - no recording captured.\nFE should treat presence-not-null as \"playable\" regardless\nof meetingType."
+                  "description": "Post-meeting recording URL. Populated by different paths\ndepending on meetingType:\n  - `chime`: presigned S3 URL minted on read (in showMeeting) - of the copy cut where the room emptied (2026-10-06) when the post-meeting pipeline made one, of the merged recording otherwise -\n    once `concatenationStatus=success`. Null until then.\n  - `recall`: written by the recall.ai webhook handler with\n    the recall.ai-hosted recording URL.\n  - `external`: null - no recording captured.\nFE should treat presence-not-null as \"playable\" regardless\nof meetingType."
                 },
                 "transcript": {
                   "type": "object",
-                  "description": "Post-meeting transcript. Multilingual dict like calls: { langCode: text }.",
+                  "description": "Post-meeting transcript. Multilingual dict like calls: { langCode: text }. showMeeting only: listMeetings rows leave it out (2026-10-06, the meet home).",
                   "additionalProperties": {
                     "type": "string"
                   }
@@ -20280,7 +20304,7 @@
                 },
                 "transcriptSegments": {
                   "type": "array",
-                  "description": "Time-coded transcript turns. Same shape as call transcriptSegments + adds attendeeId so FE can colour-code participants.",
+                  "description": "Time-coded transcript turns. Same shape as call transcriptSegments + adds attendeeId so FE can colour-code participants. showMeeting only: listMeetings rows leave it out (2026-10-06, the meet home).",
                   "items": {
                     "title": "MeetingTranscriptSegmentSchema",
                     "type": "object",
@@ -20425,6 +20449,80 @@
                     }
                   }
                 },
+                "candidateName": {
+                  "type": "string",
+                  "description": "The name of the candidate the meeting is with (`candidateId`), read with the meeting on every read (2026-10-06, the meet home), so never stale. Absent without a candidate, when the candidate is gone, and for a hiring manager (his meeting list is not scoped to his team yet)."
+                },
+                "conversationSeconds": {
+                  "type": "integer",
+                  "description": "The conversation's length in seconds, from the first word to the last on the recording's clock (written by the post-meeting pipeline, 2026-10-06). Not the recording's length, which also holds the virtual employee waiting for the manager. Absent until the transcript is made."
+                },
+                "intakeConsent": {
+                  "type": "object",
+                  "description": "A brief's conversation: the manager's consent to the recording, stored once when he entered (the first stamp stays). Absent when none was given (meetings before the consent door, or he never entered).",
+                  "properties": {
+                    "recording": {
+                      "type": "boolean"
+                    },
+                    "text": {
+                      "type": "string",
+                      "description": "The words of the button he pressed, as the page showed them."
+                    },
+                    "locale": {
+                      "type": "string",
+                      "description": "The page's language."
+                    },
+                    "at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "description": "The server's time of the consent."
+                    },
+                    "userId": {
+                      "type": "string",
+                      "description": "Who gave it."
+                    }
+                  }
+                },
+                "issues": {
+                  "type": "array",
+                  "description": "What went wrong with the meeting, computed from the row on every read (never stored); empty when nothing did. See MeetingIssueSchema for the codes.",
+                  "items": {
+                    "title": "MeetingIssueSchema",
+                    "type": "object",
+                    "description": "One thing that went wrong with a meeting (2026-10-06, the meet home):\n  - `recordingFailed`: the capture of the recording failed (`detail` = the error).\n  - `concatenationFailed`: merging the recording's chunks failed (`detail` = the error).\n  - `transcriptMissing`: the recording was merged and no transcript came within an hour of it (the analysis failed or never ran); `at` = an hour after the merge.\n  - `botFailed`: the virtual employee ended in an error (`attendeeId`, `detail`).\n  - `botNeverJoined`: the meeting ended and the virtual employee never came into the room (`attendeeId`).\n  - `avatarGivenUp`: the virtual employee's face was given up for good and the camera stayed off (`attendeeId`, `recoveries`).\n  - `managerNeverEntered`: a brief's conversation ended and no signed-in person ever came in (a guest may have).\n  - `nobodyEntered`: any other meeting with the virtual employee ended and no person ever came in.",
+                    "properties": {
+                      "code": {
+                        "type": "string",
+                        "enum": [
+                          "recordingFailed",
+                          "concatenationFailed",
+                          "transcriptMissing",
+                          "botFailed",
+                          "botNeverJoined",
+                          "avatarGivenUp",
+                          "managerNeverEntered",
+                          "nobodyEntered"
+                        ]
+                      },
+                      "at": {
+                        "type": "string",
+                        "description": "When it was known (ISO 8601, as stored)."
+                      },
+                      "detail": {
+                        "type": "string",
+                        "description": "The error, cut to 300 characters, where there is one."
+                      },
+                      "attendeeId": {
+                        "type": "string",
+                        "description": "The Chime attendee it concerns (the virtual employee)."
+                      },
+                      "recoveries": {
+                        "type": "integer",
+                        "description": "avatarGivenUp: how many times the face was raised again before it was given up."
+                      }
+                    }
+                  }
+                },
                 "status": {
                   "type": "string",
                   "enum": [
@@ -20610,6 +20708,24 @@
                     }
                   }
                 },
+                "brief": {
+                  "title": "MeetingRelationshipsBriefSchema",
+                  "type": "object",
+                  "description": "The brief this meeting is the intake conversation of (2026-10-06, the meet home), derived on read from `sourceType: briefs` + `sourceId`; `data: null` for any other meeting.",
+                  "properties": {
+                    "data": {
+                      "type": "object",
+                      "properties": {
+                        "type": {
+                          "type": "string"
+                        },
+                        "id": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  }
+                },
                 "job": {
                   "title": "MeetingRelationshipsJobSchema",
                   "type": "object",
@@ -20833,11 +20949,11 @@
                 },
                 "recordingUrl": {
                   "type": "string",
-                  "description": "Post-meeting recording URL. Populated by different paths\ndepending on meetingType:\n  - `chime`: presigned S3 URL minted on read (in showMeeting)\n    once `concatenationStatus=success`. Null until then.\n  - `recall`: written by the recall.ai webhook handler with\n    the recall.ai-hosted recording URL.\n  - `external`: null - no recording captured.\nFE should treat presence-not-null as \"playable\" regardless\nof meetingType."
+                  "description": "Post-meeting recording URL. Populated by different paths\ndepending on meetingType:\n  - `chime`: presigned S3 URL minted on read (in showMeeting) - of the copy cut where the room emptied (2026-10-06) when the post-meeting pipeline made one, of the merged recording otherwise -\n    once `concatenationStatus=success`. Null until then.\n  - `recall`: written by the recall.ai webhook handler with\n    the recall.ai-hosted recording URL.\n  - `external`: null - no recording captured.\nFE should treat presence-not-null as \"playable\" regardless\nof meetingType."
                 },
                 "transcript": {
                   "type": "object",
-                  "description": "Post-meeting transcript. Multilingual dict like calls: { langCode: text }.",
+                  "description": "Post-meeting transcript. Multilingual dict like calls: { langCode: text }. showMeeting only: listMeetings rows leave it out (2026-10-06, the meet home).",
                   "additionalProperties": {
                     "type": "string"
                   }
@@ -20957,7 +21073,7 @@
                 },
                 "transcriptSegments": {
                   "type": "array",
-                  "description": "Time-coded transcript turns. Same shape as call transcriptSegments + adds attendeeId so FE can colour-code participants.",
+                  "description": "Time-coded transcript turns. Same shape as call transcriptSegments + adds attendeeId so FE can colour-code participants. showMeeting only: listMeetings rows leave it out (2026-10-06, the meet home).",
                   "items": {
                     "title": "MeetingTranscriptSegmentSchema",
                     "type": "object",
@@ -21102,6 +21218,80 @@
                     }
                   }
                 },
+                "candidateName": {
+                  "type": "string",
+                  "description": "The name of the candidate the meeting is with (`candidateId`), read with the meeting on every read (2026-10-06, the meet home), so never stale. Absent without a candidate, when the candidate is gone, and for a hiring manager (his meeting list is not scoped to his team yet)."
+                },
+                "conversationSeconds": {
+                  "type": "integer",
+                  "description": "The conversation's length in seconds, from the first word to the last on the recording's clock (written by the post-meeting pipeline, 2026-10-06). Not the recording's length, which also holds the virtual employee waiting for the manager. Absent until the transcript is made."
+                },
+                "intakeConsent": {
+                  "type": "object",
+                  "description": "A brief's conversation: the manager's consent to the recording, stored once when he entered (the first stamp stays). Absent when none was given (meetings before the consent door, or he never entered).",
+                  "properties": {
+                    "recording": {
+                      "type": "boolean"
+                    },
+                    "text": {
+                      "type": "string",
+                      "description": "The words of the button he pressed, as the page showed them."
+                    },
+                    "locale": {
+                      "type": "string",
+                      "description": "The page's language."
+                    },
+                    "at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "description": "The server's time of the consent."
+                    },
+                    "userId": {
+                      "type": "string",
+                      "description": "Who gave it."
+                    }
+                  }
+                },
+                "issues": {
+                  "type": "array",
+                  "description": "What went wrong with the meeting, computed from the row on every read (never stored); empty when nothing did. See MeetingIssueSchema for the codes.",
+                  "items": {
+                    "title": "MeetingIssueSchema",
+                    "type": "object",
+                    "description": "One thing that went wrong with a meeting (2026-10-06, the meet home):\n  - `recordingFailed`: the capture of the recording failed (`detail` = the error).\n  - `concatenationFailed`: merging the recording's chunks failed (`detail` = the error).\n  - `transcriptMissing`: the recording was merged and no transcript came within an hour of it (the analysis failed or never ran); `at` = an hour after the merge.\n  - `botFailed`: the virtual employee ended in an error (`attendeeId`, `detail`).\n  - `botNeverJoined`: the meeting ended and the virtual employee never came into the room (`attendeeId`).\n  - `avatarGivenUp`: the virtual employee's face was given up for good and the camera stayed off (`attendeeId`, `recoveries`).\n  - `managerNeverEntered`: a brief's conversation ended and no signed-in person ever came in (a guest may have).\n  - `nobodyEntered`: any other meeting with the virtual employee ended and no person ever came in.",
+                    "properties": {
+                      "code": {
+                        "type": "string",
+                        "enum": [
+                          "recordingFailed",
+                          "concatenationFailed",
+                          "transcriptMissing",
+                          "botFailed",
+                          "botNeverJoined",
+                          "avatarGivenUp",
+                          "managerNeverEntered",
+                          "nobodyEntered"
+                        ]
+                      },
+                      "at": {
+                        "type": "string",
+                        "description": "When it was known (ISO 8601, as stored)."
+                      },
+                      "detail": {
+                        "type": "string",
+                        "description": "The error, cut to 300 characters, where there is one."
+                      },
+                      "attendeeId": {
+                        "type": "string",
+                        "description": "The Chime attendee it concerns (the virtual employee)."
+                      },
+                      "recoveries": {
+                        "type": "integer",
+                        "description": "avatarGivenUp: how many times the face was raised again before it was given up."
+                      }
+                    }
+                  }
+                },
                 "status": {
                   "type": "string",
                   "enum": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartytalent/mcp-tools",
-  "version": "0.9.49",
+  "version": "0.9.51",
   "description": "MCP tool definitions for SmartyTalent API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",