@smartytalent/mcp-tools 0.9.24 → 0.9.26

package/dist/tools.json

@@ -3829,6 +3829,24 @@
                 "isTalentPool": {
                   "type": "boolean"
                 },
+                "lastActivityAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "The last time something happened with this person on our side - an application, an email sent to or received from them (stamped by the talent service from events, 2026-09-07). On the row and here only, not in the finder document."
+                },
+                "lastActivityType": {
+                  "type": "string",
+                  "enum": [
+                    "application",
+                    "email"
+                  ],
+                  "description": "What lastActivityAt refers to."
+                },
+                "availabilityDeclaredAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "When the person last stated their availability - the analysis that wrote the criterion (CV, application, an applied talents:update) or a PATCH carrying it (2026-09-07). Also on the finder tile as summary.availability.declaredAt."
+                },
                 "ttl": {
                   "type": "string"
                 },
@@ -4480,6 +4498,24 @@
                 "isTalentPool": {
                   "type": "boolean"
                 },
+                "lastActivityAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "The last time something happened with this person on our side - an application, an email sent to or received from them (stamped by the talent service from events, 2026-09-07). On the row and here only, not in the finder document."
+                },
+                "lastActivityType": {
+                  "type": "string",
+                  "enum": [
+                    "application",
+                    "email"
+                  ],
+                  "description": "What lastActivityAt refers to."
+                },
+                "availabilityDeclaredAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "When the person last stated their availability - the analysis that wrote the criterion (CV, application, an applied talents:update) or a PATCH carrying it (2026-09-07). Also on the finder tile as summary.availability.declaredAt."
+                },
                 "ttl": {
                   "type": "string"
                 },
@@ -4612,6 +4648,32 @@
       "operationId": "talentOptions"
     }
   },
+  {
+    "name": "show_talent_report",
+    "description": "Show Talent Report",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "GET",
+      "path": "/v1/talents/{talentId}/report",
+      "operationId": "showTalentReport"
+    }
+  },
+  {
+    "name": "talent_report_options",
+    "description": "CORS support",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "OPTIONS",
+      "path": "/v1/talents/{talentId}/report",
+      "operationId": "talentReportOptions"
+    }
+  },
   {
     "name": "list_talent_candidates",
     "description": "List Talent Candidates",
@@ -4726,6 +4788,16 @@
         "pageBefore": {
           "type": "string",
           "description": "Returns the data encoded in Base64 format, used for cursor-based pagination"
+        },
+        "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.",
+          "enum": [
+            "-created",
+            "created",
+            "-modified",
+            "modified"
+          ]
         }
       }
     },
@@ -19139,7 +19211,7 @@
         },
         "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\nTakes effect only when no equality filter (filterStatus,\nfilterCandidate, filterHost, filterJob, etc.) dictates a\ndifferent index; equality filters win. Compatible with\ndate-range filters (filterCreatedFrom/To, filterModifiedFrom/To)\nwhich already use the same indexes; sort just picks the\ndirection.",
+          "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.",
           "enum": [
             "-created",
             "created",
@@ -26302,6 +26374,415 @@
       "operationId": "findersOptions"
     }
   },
+  {
+    "name": "list_invitations",
+    "description": "List Invitations",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "filterJobId": {
+          "type": "string",
+          "description": "filterJobId parameter"
+        },
+        "filterTalentId": {
+          "type": "string",
+          "description": "filterTalentId parameter"
+        },
+        "filterStatus": {
+          "type": "string",
+          "description": "filterStatus parameter",
+          "enum": [
+            "draft",
+            "active",
+            "closed"
+          ]
+        },
+        "pageSize": {
+          "type": "integer",
+          "description": "Specifies the number of items to retrieve per page. The maximum value is 100."
+        },
+        "pageNumber": {
+          "type": "integer",
+          "description": "Specifies the page number to retrieve. Used for traditional pagination."
+        },
+        "pageAfter": {
+          "type": "string",
+          "description": "Opaque base64-encoded cursor returned by a previous list response, used for forward cursor-based pagination. Pass the value verbatim; do not decode or mutate it."
+        },
+        "pageBefore": {
+          "type": "string",
+          "description": "Returns the data encoded in Base64 format, used for cursor-based pagination"
+        },
+        "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.",
+          "enum": [
+            "-created",
+            "created",
+            "-modified",
+            "modified"
+          ]
+        }
+      }
+    },
+    "_meta": {
+      "method": "GET",
+      "path": "/v1/invitations",
+      "operationId": "listInvitations"
+    }
+  },
+  {
+    "name": "create_invitation",
+    "description": "Create Invitation",
+    "inputSchema": {
+      "title": "CreateInvitationRequestBody",
+      "type": "object",
+      "required": [
+        "data"
+      ],
+      "properties": {
+        "data": {
+          "title": "CreateInvitationRequestBodyData",
+          "type": "object",
+          "required": [
+            "type",
+            "relationships"
+          ],
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "invitations"
+              ]
+            },
+            "attributes": {
+              "title": "CreateInvitationRequestBodyAttributes",
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "maxLength": 160
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "draft",
+                    "active"
+                  ],
+                  "description": "draft (default) to compose first, active to send right away."
+                },
+                "channels": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "email",
+                      "sms",
+                      "call"
+                    ]
+                  }
+                },
+                "languageCode": {
+                  "type": "string"
+                },
+                "source": {
+                  "type": "string",
+                  "enum": [
+                    "sourcing",
+                    "manual"
+                  ]
+                }
+              }
+            },
+            "relationships": {
+              "title": "CreateInvitationRequestBodyRelationships",
+              "type": "object",
+              "required": [
+                "job"
+              ],
+              "properties": {
+                "job": {
+                  "title": "InvitationRelationshipsJobSchema",
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "title": "InvitationRelationshipsJobDataSchema",
+                      "type": "object",
+                      "properties": {
+                        "type": {
+                          "type": "string",
+                          "enum": [
+                            "jobs"
+                          ]
+                        },
+                        "id": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  }
+                },
+                "task": {
+                  "title": "InvitationRelationshipsTaskSchema",
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "title": "InvitationRelationshipsTaskDataSchema",
+                      "type": "object",
+                      "properties": {
+                        "type": {
+                          "type": "string",
+                          "enum": [
+                            "tasks"
+                          ]
+                        },
+                        "id": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  }
+                },
+                "talents": {
+                  "title": "CreateInvitationRequestBodyTalents",
+                  "type": "object",
+                  "description": "The people to put on the list (identifiers, no meta).",
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "title": "ResourceIdentifierSchema",
+                        "type": "object",
+                        "required": [
+                          "type",
+                          "id"
+                        ],
+                        "properties": {
+                          "type": {
+                            "type": "string"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[a-f0-9]{32}-[1-9]$"
+                          },
+                          "meta": {
+                            "title": "ResourceMetaSchema",
+                            "type": "object",
+                            "additionalProperties": true
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "_meta": {
+      "method": "POST",
+      "path": "/v1/invitations",
+      "operationId": "createInvitation"
+    }
+  },
+  {
+    "name": "invitations_options",
+    "description": "CORS support",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "OPTIONS",
+      "path": "/v1/invitations",
+      "operationId": "invitationsOptions"
+    }
+  },
+  {
+    "name": "show_invitation",
+    "description": "Show Invitation",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "GET",
+      "path": "/v1/invitations/{invitationId}",
+      "operationId": "showInvitation"
+    }
+  },
+  {
+    "name": "update_invitation",
+    "description": "Update Invitation",
+    "inputSchema": {
+      "title": "UpdateInvitationRequestBody",
+      "type": "object",
+      "required": [
+        "data"
+      ],
+      "properties": {
+        "data": {
+          "title": "UpdateInvitationRequestBodyData",
+          "type": "object",
+          "required": [
+            "type",
+            "id"
+          ],
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "invitations"
+              ]
+            },
+            "id": {
+              "type": "string"
+            },
+            "attributes": {
+              "title": "UpdateInvitationRequestBodyAttributes",
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "maxLength": 160
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "active",
+                    "closed"
+                  ],
+                  "description": "active starts the sending (draft -> active), closed ends it."
+                },
+                "channels": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "email",
+                      "sms",
+                      "call"
+                    ]
+                  }
+                },
+                "languageCode": {
+                  "type": "string"
+                },
+                "claimTalentIds": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "The send action's claim - each named person flips queued -> sending in its own conditional write (the invitation must be active in that same write); the response's `meta.claimed` lists the ids THIS call claimed (a second run of the same activation claims none). Not for the FE."
+                },
+                "claimOwner": {
+                  "type": "string",
+                  "description": "Who claims (the send action's run and step). A retry of the same run takes its own `sending` people back at once; anyone may take a `sending` person whose claim is older than the 5-minute lease (a run that never finished). Not for the FE."
+                }
+              }
+            },
+            "relationships": {
+              "title": "UpdateInvitationRequestBodyRelationships",
+              "type": "object",
+              "properties": {
+                "talents": {
+                  "title": "UpdateInvitationRequestBodyTalents",
+                  "type": "object",
+                  "description": "The FULL list of people wanted on the list; a contacted person cannot be left out (409).",
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "title": "ResourceIdentifierSchema",
+                        "type": "object",
+                        "required": [
+                          "type",
+                          "id"
+                        ],
+                        "properties": {
+                          "type": {
+                            "type": "string"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[a-f0-9]{32}-[1-9]$"
+                          },
+                          "meta": {
+                            "title": "ResourceMetaSchema",
+                            "type": "object",
+                            "additionalProperties": true
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "_meta": {
+      "method": "PATCH",
+      "path": "/v1/invitations/{invitationId}",
+      "operationId": "updateInvitation"
+    }
+  },
+  {
+    "name": "delete_invitation",
+    "description": "Delete Invitation",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "DELETE",
+      "path": "/v1/invitations/{invitationId}",
+      "operationId": "deleteInvitation"
+    }
+  },
+  {
+    "name": "invitation_options",
+    "description": "CORS support",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "OPTIONS",
+      "path": "/v1/invitations/{invitationId}",
+      "operationId": "invitationOptions"
+    }
+  },
+  {
+    "name": "list_invitation_talents_relationship",
+    "description": "List Invitation Talents Relationship",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "GET",
+      "path": "/v1/invitations/{invitationId}/relationships/talents",
+      "operationId": "listInvitationTalentsRelationship"
+    }
+  },
+  {
+    "name": "invitation_talents_relationship_options",
+    "description": "CORS support",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "OPTIONS",
+      "path": "/v1/invitations/{invitationId}/relationships/talents",
+      "operationId": "invitationTalentsRelationshipOptions"
+    }
+  },
   {
     "name": "show_finder",
     "description": "Show Finder",

package/package.json

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