@smartytalent/openai-tools 0.9.49 → 0.9.50

package/dist/tools.json

@@ -19384,7 +19384,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",
@@ -19420,14 +19420,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": {
@@ -19592,11 +19602,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"
                     }
@@ -19716,7 +19726,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",
@@ -19861,6 +19871,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": [
@@ -20046,6 +20130,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",
@@ -20263,11 +20365,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"
                     }
@@ -20387,7 +20489,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",
@@ -20532,6 +20634,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/openai-tools",
-  "version": "0.9.49",
+  "version": "0.9.50",
   "description": "OpenAI function/tool definitions for SmartyTalent API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",