@smartytalent/mcp-tools 0.9.23 → 0.9.25

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/tools.json +301 -1
  2. package/package.json +1 -1
package/dist/tools.json CHANGED
@@ -3829,6 +3829,24 @@
3829
3829
  "isTalentPool": {
3830
3830
  "type": "boolean"
3831
3831
  },
3832
+ "lastActivityAt": {
3833
+ "type": "string",
3834
+ "format": "date-time",
3835
+ "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."
3836
+ },
3837
+ "lastActivityType": {
3838
+ "type": "string",
3839
+ "enum": [
3840
+ "application",
3841
+ "email"
3842
+ ],
3843
+ "description": "What lastActivityAt refers to."
3844
+ },
3845
+ "availabilityDeclaredAt": {
3846
+ "type": "string",
3847
+ "format": "date-time",
3848
+ "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."
3849
+ },
3832
3850
  "ttl": {
3833
3851
  "type": "string"
3834
3852
  },
@@ -4480,6 +4498,24 @@
4480
4498
  "isTalentPool": {
4481
4499
  "type": "boolean"
4482
4500
  },
4501
+ "lastActivityAt": {
4502
+ "type": "string",
4503
+ "format": "date-time",
4504
+ "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."
4505
+ },
4506
+ "lastActivityType": {
4507
+ "type": "string",
4508
+ "enum": [
4509
+ "application",
4510
+ "email"
4511
+ ],
4512
+ "description": "What lastActivityAt refers to."
4513
+ },
4514
+ "availabilityDeclaredAt": {
4515
+ "type": "string",
4516
+ "format": "date-time",
4517
+ "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."
4518
+ },
4483
4519
  "ttl": {
4484
4520
  "type": "string"
4485
4521
  },
@@ -4612,6 +4648,32 @@
4612
4648
  "operationId": "talentOptions"
4613
4649
  }
4614
4650
  },
4651
+ {
4652
+ "name": "show_talent_report",
4653
+ "description": "Show Talent Report",
4654
+ "inputSchema": {
4655
+ "type": "object",
4656
+ "properties": {}
4657
+ },
4658
+ "_meta": {
4659
+ "method": "GET",
4660
+ "path": "/v1/talents/{talentId}/report",
4661
+ "operationId": "showTalentReport"
4662
+ }
4663
+ },
4664
+ {
4665
+ "name": "talent_report_options",
4666
+ "description": "CORS support",
4667
+ "inputSchema": {
4668
+ "type": "object",
4669
+ "properties": {}
4670
+ },
4671
+ "_meta": {
4672
+ "method": "OPTIONS",
4673
+ "path": "/v1/talents/{talentId}/report",
4674
+ "operationId": "talentReportOptions"
4675
+ }
4676
+ },
4615
4677
  {
4616
4678
  "name": "list_talent_candidates",
4617
4679
  "description": "List Talent Candidates",
@@ -4726,6 +4788,16 @@
4726
4788
  "pageBefore": {
4727
4789
  "type": "string",
4728
4790
  "description": "Returns the data encoded in Base64 format, used for cursor-based pagination"
4791
+ },
4792
+ "sort": {
4793
+ "type": "string",
4794
+ "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.",
4795
+ "enum": [
4796
+ "-created",
4797
+ "created",
4798
+ "-modified",
4799
+ "modified"
4800
+ ]
4729
4801
  }
4730
4802
  }
4731
4803
  },
@@ -17606,6 +17678,65 @@
17606
17678
  "additionalProperties": true,
17607
17679
  "description": "Multilingual task context keyed by language code"
17608
17680
  },
17681
+ "changes": {
17682
+ "type": "array",
17683
+ "description": "jobs:update orders only (2026-09-03): the requested changes as\nSTRUCTURE instead of (or next to) the free text in `content`. When\npresent the proposal is built from it deterministically - no model\ncall, exact items - and `meta.proposal.source = structured`.\nCreate-only (a PATCH carrying it is a 400). Validated at create:\n1-50 entries, criteriaKey one of the 16 criteria or `basic` /\n`title`, action add|remove|update, `name` required, `field` required\nfor basic (one of department, description, seniority,\nspecialization, benefits, responsibilities, keywords, companyCulture,\nlocations, sites), importance required|preferred|optional when\ngiven. `target` names the EXISTING item an update/remove refers to\n(defaults to name). Not accepted on any other route.",
17684
+ "items": {
17685
+ "title": "TaskChangeSchema",
17686
+ "type": "object",
17687
+ "required": [
17688
+ "criteriaKey",
17689
+ "action",
17690
+ "name"
17691
+ ],
17692
+ "properties": {
17693
+ "criteriaKey": {
17694
+ "type": "string",
17695
+ "description": "One of the 16 criteria (availability, certifications, companyTypeExperience, education, experienceAndSeniority, industryExperience, jobPositions, jobTendencies, languagesSpoken, licenses, locationPreferences, personalityAndSoftSkills, salaryExpectation, skillsAndExpertise, workAuthorization, workPreferences), `basic` (the job's own fields, with `field`) or `title`."
17696
+ },
17697
+ "action": {
17698
+ "type": "string",
17699
+ "enum": [
17700
+ "add",
17701
+ "remove",
17702
+ "update"
17703
+ ]
17704
+ },
17705
+ "name": {
17706
+ "type": "string",
17707
+ "maxLength": 200,
17708
+ "description": "The item (skill, language, certification, value...) as the operator names it; for basic/title the new value."
17709
+ },
17710
+ "target": {
17711
+ "type": "string",
17712
+ "maxLength": 200,
17713
+ "description": "For update/remove: the existing item's name when it differs from `name` (e.g. rename)."
17714
+ },
17715
+ "field": {
17716
+ "type": "string",
17717
+ "description": "basic only: department|description|seniority|specialization|benefits|responsibilities|keywords|companyCulture|locations|sites"
17718
+ },
17719
+ "importance": {
17720
+ "type": "string",
17721
+ "enum": [
17722
+ "required",
17723
+ "preferred",
17724
+ "optional"
17725
+ ]
17726
+ },
17727
+ "proficiencyLevel": {
17728
+ "type": "string",
17729
+ "maxLength": 60,
17730
+ "description": "A level when the item has one (B2, senior, 3 years)."
17731
+ },
17732
+ "reason": {
17733
+ "type": "string",
17734
+ "maxLength": 500,
17735
+ "description": "The operator's why - shown to the reviewer, never applied as content."
17736
+ }
17737
+ }
17738
+ }
17739
+ },
17609
17740
  "status": {
17610
17741
  "type": "string",
17611
17742
  "enum": [
@@ -17856,6 +17987,65 @@
17856
17987
  "additionalProperties": true,
17857
17988
  "description": "Multilingual task context keyed by language code"
17858
17989
  },
17990
+ "changes": {
17991
+ "type": "array",
17992
+ "description": "jobs:update orders only (2026-09-03): the requested changes as\nSTRUCTURE instead of (or next to) the free text in `content`. When\npresent the proposal is built from it deterministically - no model\ncall, exact items - and `meta.proposal.source = structured`.\nCreate-only (a PATCH carrying it is a 400). Validated at create:\n1-50 entries, criteriaKey one of the 16 criteria or `basic` /\n`title`, action add|remove|update, `name` required, `field` required\nfor basic (one of department, description, seniority,\nspecialization, benefits, responsibilities, keywords, companyCulture,\nlocations, sites), importance required|preferred|optional when\ngiven. `target` names the EXISTING item an update/remove refers to\n(defaults to name). Not accepted on any other route.",
17993
+ "items": {
17994
+ "title": "TaskChangeSchema",
17995
+ "type": "object",
17996
+ "required": [
17997
+ "criteriaKey",
17998
+ "action",
17999
+ "name"
18000
+ ],
18001
+ "properties": {
18002
+ "criteriaKey": {
18003
+ "type": "string",
18004
+ "description": "One of the 16 criteria (availability, certifications, companyTypeExperience, education, experienceAndSeniority, industryExperience, jobPositions, jobTendencies, languagesSpoken, licenses, locationPreferences, personalityAndSoftSkills, salaryExpectation, skillsAndExpertise, workAuthorization, workPreferences), `basic` (the job's own fields, with `field`) or `title`."
18005
+ },
18006
+ "action": {
18007
+ "type": "string",
18008
+ "enum": [
18009
+ "add",
18010
+ "remove",
18011
+ "update"
18012
+ ]
18013
+ },
18014
+ "name": {
18015
+ "type": "string",
18016
+ "maxLength": 200,
18017
+ "description": "The item (skill, language, certification, value...) as the operator names it; for basic/title the new value."
18018
+ },
18019
+ "target": {
18020
+ "type": "string",
18021
+ "maxLength": 200,
18022
+ "description": "For update/remove: the existing item's name when it differs from `name` (e.g. rename)."
18023
+ },
18024
+ "field": {
18025
+ "type": "string",
18026
+ "description": "basic only: department|description|seniority|specialization|benefits|responsibilities|keywords|companyCulture|locations|sites"
18027
+ },
18028
+ "importance": {
18029
+ "type": "string",
18030
+ "enum": [
18031
+ "required",
18032
+ "preferred",
18033
+ "optional"
18034
+ ]
18035
+ },
18036
+ "proficiencyLevel": {
18037
+ "type": "string",
18038
+ "maxLength": 60,
18039
+ "description": "A level when the item has one (B2, senior, 3 years)."
18040
+ },
18041
+ "reason": {
18042
+ "type": "string",
18043
+ "maxLength": 500,
18044
+ "description": "The operator's why - shown to the reviewer, never applied as content."
18045
+ }
18046
+ }
18047
+ }
18048
+ },
17859
18049
  "status": {
17860
18050
  "type": "string",
17861
18051
  "enum": [
@@ -19021,7 +19211,7 @@
19021
19211
  },
19022
19212
  "sort": {
19023
19213
  "type": "string",
19024
- "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.",
19214
+ "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.",
19025
19215
  "enum": [
19026
19216
  "-created",
19027
19217
  "created",
@@ -26184,6 +26374,116 @@
26184
26374
  "operationId": "findersOptions"
26185
26375
  }
26186
26376
  },
26377
+ {
26378
+ "name": "list_invitations",
26379
+ "description": "List Invitations",
26380
+ "inputSchema": {
26381
+ "type": "object",
26382
+ "properties": {
26383
+ "filterJobId": {
26384
+ "type": "string",
26385
+ "description": "filterJobId parameter"
26386
+ },
26387
+ "filterTalentId": {
26388
+ "type": "string",
26389
+ "description": "filterTalentId parameter"
26390
+ }
26391
+ }
26392
+ },
26393
+ "_meta": {
26394
+ "method": "GET",
26395
+ "path": "/v1/invitations",
26396
+ "operationId": "listInvitations"
26397
+ }
26398
+ },
26399
+ {
26400
+ "name": "invitations_options",
26401
+ "description": "CORS support",
26402
+ "inputSchema": {
26403
+ "type": "object",
26404
+ "properties": {}
26405
+ },
26406
+ "_meta": {
26407
+ "method": "OPTIONS",
26408
+ "path": "/v1/invitations",
26409
+ "operationId": "invitationsOptions"
26410
+ }
26411
+ },
26412
+ {
26413
+ "name": "show_invitation",
26414
+ "description": "Show Invitation",
26415
+ "inputSchema": {
26416
+ "type": "object",
26417
+ "properties": {}
26418
+ },
26419
+ "_meta": {
26420
+ "method": "GET",
26421
+ "path": "/v1/invitations/{invitationId}",
26422
+ "operationId": "showInvitation"
26423
+ }
26424
+ },
26425
+ {
26426
+ "name": "update_invitation",
26427
+ "description": "Update Invitation",
26428
+ "inputSchema": {
26429
+ "title": "UpdateInvitationRequestBody",
26430
+ "type": "object",
26431
+ "required": [
26432
+ "data"
26433
+ ],
26434
+ "properties": {
26435
+ "data": {
26436
+ "title": "UpdateInvitationRequestBodyData",
26437
+ "type": "object",
26438
+ "required": [
26439
+ "type",
26440
+ "attributes"
26441
+ ],
26442
+ "properties": {
26443
+ "type": {
26444
+ "type": "string",
26445
+ "enum": [
26446
+ "invitations"
26447
+ ]
26448
+ },
26449
+ "attributes": {
26450
+ "title": "UpdateInvitationRequestBodyAttributes",
26451
+ "type": "object",
26452
+ "required": [
26453
+ "status"
26454
+ ],
26455
+ "properties": {
26456
+ "status": {
26457
+ "type": "string",
26458
+ "enum": [
26459
+ "declined"
26460
+ ]
26461
+ }
26462
+ }
26463
+ }
26464
+ }
26465
+ }
26466
+ }
26467
+ },
26468
+ "_meta": {
26469
+ "method": "PATCH",
26470
+ "path": "/v1/invitations/{invitationId}",
26471
+ "operationId": "updateInvitation"
26472
+ }
26473
+ },
26474
+ {
26475
+ "name": "invitation_options",
26476
+ "description": "CORS support",
26477
+ "inputSchema": {
26478
+ "type": "object",
26479
+ "properties": {}
26480
+ },
26481
+ "_meta": {
26482
+ "method": "OPTIONS",
26483
+ "path": "/v1/invitations/{invitationId}",
26484
+ "operationId": "invitationOptions"
26485
+ }
26486
+ },
26187
26487
  {
26188
26488
  "name": "show_finder",
26189
26489
  "description": "Show Finder",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@smartytalent/mcp-tools",
3
- "version": "0.9.23",
3
+ "version": "0.9.25",
4
4
  "description": "MCP tool definitions for SmartyTalent API",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",