@smartytalent/mcp-tools 0.9.10 → 0.9.11

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 +496 -0
  2. package/package.json +1 -1
package/dist/tools.json CHANGED
@@ -17355,6 +17355,502 @@
17355
17355
  "operationId": "noteOptions"
17356
17356
  }
17357
17357
  },
17358
+ {
17359
+ "name": "list_tasks",
17360
+ "description": "List Tasks",
17361
+ "inputSchema": {
17362
+ "type": "object",
17363
+ "properties": {
17364
+ "filterStatus": {
17365
+ "type": "string",
17366
+ "description": "Returns tasks with the given status.",
17367
+ "enum": [
17368
+ "active",
17369
+ "sent",
17370
+ "scheduled",
17371
+ "pending",
17372
+ "draft",
17373
+ "archived",
17374
+ "failed",
17375
+ "done"
17376
+ ]
17377
+ },
17378
+ "filterCreatedFrom": {
17379
+ "type": "string",
17380
+ "description": "Filters results to include only those created from the specified date and time. The value must be in ISO 8601 format."
17381
+ },
17382
+ "filterCreatedTo": {
17383
+ "type": "string",
17384
+ "description": "Filters results to include only those created up to the specified date and time. The value must be in ISO 8601 format."
17385
+ },
17386
+ "filterModifiedFrom": {
17387
+ "type": "string",
17388
+ "description": "Filters results to include only those modified from the specified date and time. The value must be in ISO 8601 format."
17389
+ },
17390
+ "filterModifiedTo": {
17391
+ "type": "string",
17392
+ "description": "Filters results to include only those modified up to the specified date and time. The value must be in ISO 8601 format."
17393
+ },
17394
+ "pageSize": {
17395
+ "type": "integer",
17396
+ "description": "Specifies the number of items to retrieve per page. The maximum value is 100."
17397
+ },
17398
+ "pageNumber": {
17399
+ "type": "integer",
17400
+ "description": "Specifies the page number to retrieve. Used for traditional pagination."
17401
+ },
17402
+ "pageAfter": {
17403
+ "type": "string",
17404
+ "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."
17405
+ },
17406
+ "pageBefore": {
17407
+ "type": "string",
17408
+ "description": "Returns the data encoded in Base64 format, used for cursor-based pagination"
17409
+ }
17410
+ }
17411
+ },
17412
+ "_meta": {
17413
+ "method": "GET",
17414
+ "path": "/v1/tasks",
17415
+ "operationId": "listTasks"
17416
+ }
17417
+ },
17418
+ {
17419
+ "name": "create_task",
17420
+ "description": "Create Task",
17421
+ "inputSchema": {
17422
+ "title": "CreateTaskRequestBody",
17423
+ "type": "object",
17424
+ "required": [
17425
+ "data"
17426
+ ],
17427
+ "properties": {
17428
+ "data": {
17429
+ "title": "CreateTaskRequestBodyData",
17430
+ "type": "object",
17431
+ "required": [
17432
+ "type",
17433
+ "attributes"
17434
+ ],
17435
+ "properties": {
17436
+ "type": {
17437
+ "type": "string",
17438
+ "enum": [
17439
+ "tasks"
17440
+ ]
17441
+ },
17442
+ "attributes": {
17443
+ "title": "TaskAttributesSchema",
17444
+ "type": "object",
17445
+ "properties": {
17446
+ "route": {
17447
+ "type": "string",
17448
+ "maxLength": 64,
17449
+ "description": "Workflow routing key (`namespace:verb`). The operator e-mail lane has exactly three: `emails:reply`, `emails:compose`, `emails:send` - nothing else. Optional, normalised to lowercase and shape-validated at create, stamped on the row and IMMUTABLE afterwards - a PATCH carrying route is rejected with 400. Creating a task whose route matches emails:* requires role recruiter/recops/admin/owner (hiringmanager and user are denied); the same gate guards a PATCH of an emails:* row."
17450
+ },
17451
+ "kind": {
17452
+ "type": "string",
17453
+ "maxLength": 64,
17454
+ "description": "Free-form task kind label (e.g. email_reply). Not a filter: the list door has no filterKind/filterRoute, only filterStatus."
17455
+ },
17456
+ "content": {
17457
+ "type": "object",
17458
+ "additionalProperties": true,
17459
+ "description": "Multilingual task content keyed by language code"
17460
+ },
17461
+ "context": {
17462
+ "type": "object",
17463
+ "additionalProperties": true,
17464
+ "description": "Multilingual task context keyed by language code"
17465
+ },
17466
+ "status": {
17467
+ "type": "string",
17468
+ "enum": [
17469
+ "active",
17470
+ "sent",
17471
+ "scheduled",
17472
+ "pending",
17473
+ "draft",
17474
+ "archived",
17475
+ "failed",
17476
+ "done"
17477
+ ],
17478
+ "description": "Row status, the same set as TaskStatus in the alpha layer. Defaults to active at create; on PATCH it is written only when provided (never forced). Operator-lane lifecycle: pending at create -> done (the workflow drafted the mail, the emails link carries it) or failed (compose produced nothing); done and failed are terminal and only task:complete writes them."
17479
+ },
17480
+ "languageCode": {
17481
+ "type": "string"
17482
+ },
17483
+ "ttl": {
17484
+ "type": "string",
17485
+ "description": "Time-to-live expiration timestamp. PATCH-writable, write-only: the row keeps it (DynamoDB TTL) but no response echoes it back."
17486
+ },
17487
+ "meta": {
17488
+ "type": "object",
17489
+ "additionalProperties": true,
17490
+ "description": "REQUEST side only: create merges these keys over the server-stamped `status`, PATCH writes them. Not populated on the wire - the task meta comes back at the resource level (data.meta, see TaskResourceSchema.meta), because Task.to_response emits it next to attributes/relationships. Kept here because this is where a request carries it."
17491
+ },
17492
+ "timestamps": {
17493
+ "title": "ResourceTimestampsSchema",
17494
+ "type": "object",
17495
+ "properties": {
17496
+ "created": {
17497
+ "type": "string",
17498
+ "format": "date-time"
17499
+ },
17500
+ "modified": {
17501
+ "type": "string",
17502
+ "format": "date-time"
17503
+ }
17504
+ }
17505
+ }
17506
+ }
17507
+ },
17508
+ "relationships": {
17509
+ "title": "TaskRelationshipsRequestSchema",
17510
+ "description": "Request shape: to-one links keyed plural (jobs/conversations/emails/talents/candidates). `author` is deliberately NOT here - it is stamped server-side from the authorizer and is immutable. On PATCH each key merges independently; a {data: null} link is a no-op (unlinking is not a PATCH door). Operator lane: an emails:reply task names the thread through `conversations` (and optionally the answered mail through `emails`); an emails:compose task names the addressee through `talents` or `candidates` (a candidate resolves to its talent's e-mail) or, failing both, through meta.recipientEmail; an emails:send task names the held draft through `emails`.",
17511
+ "type": "object",
17512
+ "properties": {
17513
+ "jobs": {
17514
+ "title": "TaskRelationshipsRequestJobsSchema",
17515
+ "type": "object",
17516
+ "properties": {
17517
+ "data": {
17518
+ "title": "TaskRelationshipsRequestJobsDataSchema",
17519
+ "type": "object",
17520
+ "properties": {
17521
+ "type": {
17522
+ "type": "string"
17523
+ },
17524
+ "id": {
17525
+ "type": "string"
17526
+ }
17527
+ }
17528
+ }
17529
+ }
17530
+ },
17531
+ "conversations": {
17532
+ "title": "TaskRelationshipsRequestConversationsSchema",
17533
+ "type": "object",
17534
+ "properties": {
17535
+ "data": {
17536
+ "title": "TaskRelationshipsRequestConversationsDataSchema",
17537
+ "type": "object",
17538
+ "properties": {
17539
+ "type": {
17540
+ "type": "string"
17541
+ },
17542
+ "id": {
17543
+ "type": "string"
17544
+ }
17545
+ }
17546
+ }
17547
+ }
17548
+ },
17549
+ "emails": {
17550
+ "title": "TaskRelationshipsRequestEmailsSchema",
17551
+ "type": "object",
17552
+ "properties": {
17553
+ "data": {
17554
+ "title": "TaskRelationshipsRequestEmailsDataSchema",
17555
+ "type": "object",
17556
+ "properties": {
17557
+ "type": {
17558
+ "type": "string"
17559
+ },
17560
+ "id": {
17561
+ "type": "string"
17562
+ }
17563
+ }
17564
+ }
17565
+ }
17566
+ },
17567
+ "talents": {
17568
+ "title": "TaskRelationshipsRequestTalentsSchema",
17569
+ "type": "object",
17570
+ "properties": {
17571
+ "data": {
17572
+ "title": "TaskRelationshipsRequestTalentsDataSchema",
17573
+ "type": "object",
17574
+ "properties": {
17575
+ "type": {
17576
+ "type": "string"
17577
+ },
17578
+ "id": {
17579
+ "type": "string"
17580
+ }
17581
+ }
17582
+ }
17583
+ }
17584
+ },
17585
+ "candidates": {
17586
+ "title": "TaskRelationshipsRequestCandidatesSchema",
17587
+ "type": "object",
17588
+ "properties": {
17589
+ "data": {
17590
+ "title": "TaskRelationshipsRequestCandidatesDataSchema",
17591
+ "type": "object",
17592
+ "properties": {
17593
+ "type": {
17594
+ "type": "string"
17595
+ },
17596
+ "id": {
17597
+ "type": "string"
17598
+ }
17599
+ }
17600
+ }
17601
+ }
17602
+ }
17603
+ }
17604
+ }
17605
+ }
17606
+ }
17607
+ }
17608
+ },
17609
+ "_meta": {
17610
+ "method": "POST",
17611
+ "path": "/v1/tasks",
17612
+ "operationId": "createTask"
17613
+ }
17614
+ },
17615
+ {
17616
+ "name": "tasks_options",
17617
+ "description": "Tasks Options",
17618
+ "inputSchema": {
17619
+ "type": "object",
17620
+ "properties": {}
17621
+ },
17622
+ "_meta": {
17623
+ "method": "OPTIONS",
17624
+ "path": "/v1/tasks",
17625
+ "operationId": "tasksOptions"
17626
+ }
17627
+ },
17628
+ {
17629
+ "name": "show_task",
17630
+ "description": "Show Task",
17631
+ "inputSchema": {
17632
+ "type": "object",
17633
+ "properties": {}
17634
+ },
17635
+ "_meta": {
17636
+ "method": "GET",
17637
+ "path": "/v1/tasks/{taskId}",
17638
+ "operationId": "showTask"
17639
+ }
17640
+ },
17641
+ {
17642
+ "name": "update_task",
17643
+ "description": "Update Task",
17644
+ "inputSchema": {
17645
+ "title": "UpdateTaskRequestBody",
17646
+ "type": "object",
17647
+ "required": [
17648
+ "data"
17649
+ ],
17650
+ "properties": {
17651
+ "data": {
17652
+ "title": "UpdateTaskRequestBodyData",
17653
+ "type": "object",
17654
+ "required": [
17655
+ "type",
17656
+ "id"
17657
+ ],
17658
+ "properties": {
17659
+ "type": {
17660
+ "type": "string",
17661
+ "enum": [
17662
+ "tasks"
17663
+ ]
17664
+ },
17665
+ "id": {
17666
+ "type": "string"
17667
+ },
17668
+ "attributes": {
17669
+ "title": "TaskAttributesSchema",
17670
+ "type": "object",
17671
+ "properties": {
17672
+ "route": {
17673
+ "type": "string",
17674
+ "maxLength": 64,
17675
+ "description": "Workflow routing key (`namespace:verb`). The operator e-mail lane has exactly three: `emails:reply`, `emails:compose`, `emails:send` - nothing else. Optional, normalised to lowercase and shape-validated at create, stamped on the row and IMMUTABLE afterwards - a PATCH carrying route is rejected with 400. Creating a task whose route matches emails:* requires role recruiter/recops/admin/owner (hiringmanager and user are denied); the same gate guards a PATCH of an emails:* row."
17676
+ },
17677
+ "kind": {
17678
+ "type": "string",
17679
+ "maxLength": 64,
17680
+ "description": "Free-form task kind label (e.g. email_reply). Not a filter: the list door has no filterKind/filterRoute, only filterStatus."
17681
+ },
17682
+ "content": {
17683
+ "type": "object",
17684
+ "additionalProperties": true,
17685
+ "description": "Multilingual task content keyed by language code"
17686
+ },
17687
+ "context": {
17688
+ "type": "object",
17689
+ "additionalProperties": true,
17690
+ "description": "Multilingual task context keyed by language code"
17691
+ },
17692
+ "status": {
17693
+ "type": "string",
17694
+ "enum": [
17695
+ "active",
17696
+ "sent",
17697
+ "scheduled",
17698
+ "pending",
17699
+ "draft",
17700
+ "archived",
17701
+ "failed",
17702
+ "done"
17703
+ ],
17704
+ "description": "Row status, the same set as TaskStatus in the alpha layer. Defaults to active at create; on PATCH it is written only when provided (never forced). Operator-lane lifecycle: pending at create -> done (the workflow drafted the mail, the emails link carries it) or failed (compose produced nothing); done and failed are terminal and only task:complete writes them."
17705
+ },
17706
+ "languageCode": {
17707
+ "type": "string"
17708
+ },
17709
+ "ttl": {
17710
+ "type": "string",
17711
+ "description": "Time-to-live expiration timestamp. PATCH-writable, write-only: the row keeps it (DynamoDB TTL) but no response echoes it back."
17712
+ },
17713
+ "meta": {
17714
+ "type": "object",
17715
+ "additionalProperties": true,
17716
+ "description": "REQUEST side only: create merges these keys over the server-stamped `status`, PATCH writes them. Not populated on the wire - the task meta comes back at the resource level (data.meta, see TaskResourceSchema.meta), because Task.to_response emits it next to attributes/relationships. Kept here because this is where a request carries it."
17717
+ },
17718
+ "timestamps": {
17719
+ "title": "ResourceTimestampsSchema",
17720
+ "type": "object",
17721
+ "properties": {
17722
+ "created": {
17723
+ "type": "string",
17724
+ "format": "date-time"
17725
+ },
17726
+ "modified": {
17727
+ "type": "string",
17728
+ "format": "date-time"
17729
+ }
17730
+ }
17731
+ }
17732
+ }
17733
+ },
17734
+ "relationships": {
17735
+ "title": "TaskRelationshipsRequestSchema",
17736
+ "description": "Request shape: to-one links keyed plural (jobs/conversations/emails/talents/candidates). `author` is deliberately NOT here - it is stamped server-side from the authorizer and is immutable. On PATCH each key merges independently; a {data: null} link is a no-op (unlinking is not a PATCH door). Operator lane: an emails:reply task names the thread through `conversations` (and optionally the answered mail through `emails`); an emails:compose task names the addressee through `talents` or `candidates` (a candidate resolves to its talent's e-mail) or, failing both, through meta.recipientEmail; an emails:send task names the held draft through `emails`.",
17737
+ "type": "object",
17738
+ "properties": {
17739
+ "jobs": {
17740
+ "title": "TaskRelationshipsRequestJobsSchema",
17741
+ "type": "object",
17742
+ "properties": {
17743
+ "data": {
17744
+ "title": "TaskRelationshipsRequestJobsDataSchema",
17745
+ "type": "object",
17746
+ "properties": {
17747
+ "type": {
17748
+ "type": "string"
17749
+ },
17750
+ "id": {
17751
+ "type": "string"
17752
+ }
17753
+ }
17754
+ }
17755
+ }
17756
+ },
17757
+ "conversations": {
17758
+ "title": "TaskRelationshipsRequestConversationsSchema",
17759
+ "type": "object",
17760
+ "properties": {
17761
+ "data": {
17762
+ "title": "TaskRelationshipsRequestConversationsDataSchema",
17763
+ "type": "object",
17764
+ "properties": {
17765
+ "type": {
17766
+ "type": "string"
17767
+ },
17768
+ "id": {
17769
+ "type": "string"
17770
+ }
17771
+ }
17772
+ }
17773
+ }
17774
+ },
17775
+ "emails": {
17776
+ "title": "TaskRelationshipsRequestEmailsSchema",
17777
+ "type": "object",
17778
+ "properties": {
17779
+ "data": {
17780
+ "title": "TaskRelationshipsRequestEmailsDataSchema",
17781
+ "type": "object",
17782
+ "properties": {
17783
+ "type": {
17784
+ "type": "string"
17785
+ },
17786
+ "id": {
17787
+ "type": "string"
17788
+ }
17789
+ }
17790
+ }
17791
+ }
17792
+ },
17793
+ "talents": {
17794
+ "title": "TaskRelationshipsRequestTalentsSchema",
17795
+ "type": "object",
17796
+ "properties": {
17797
+ "data": {
17798
+ "title": "TaskRelationshipsRequestTalentsDataSchema",
17799
+ "type": "object",
17800
+ "properties": {
17801
+ "type": {
17802
+ "type": "string"
17803
+ },
17804
+ "id": {
17805
+ "type": "string"
17806
+ }
17807
+ }
17808
+ }
17809
+ }
17810
+ },
17811
+ "candidates": {
17812
+ "title": "TaskRelationshipsRequestCandidatesSchema",
17813
+ "type": "object",
17814
+ "properties": {
17815
+ "data": {
17816
+ "title": "TaskRelationshipsRequestCandidatesDataSchema",
17817
+ "type": "object",
17818
+ "properties": {
17819
+ "type": {
17820
+ "type": "string"
17821
+ },
17822
+ "id": {
17823
+ "type": "string"
17824
+ }
17825
+ }
17826
+ }
17827
+ }
17828
+ }
17829
+ }
17830
+ }
17831
+ }
17832
+ }
17833
+ }
17834
+ },
17835
+ "_meta": {
17836
+ "method": "PATCH",
17837
+ "path": "/v1/tasks/{taskId}",
17838
+ "operationId": "updateTask"
17839
+ }
17840
+ },
17841
+ {
17842
+ "name": "task_options",
17843
+ "description": "Task Options",
17844
+ "inputSchema": {
17845
+ "type": "object",
17846
+ "properties": {}
17847
+ },
17848
+ "_meta": {
17849
+ "method": "OPTIONS",
17850
+ "path": "/v1/tasks/{taskId}",
17851
+ "operationId": "taskOptions"
17852
+ }
17853
+ },
17358
17854
  {
17359
17855
  "name": "list_states",
17360
17856
  "description": "List States",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@smartytalent/mcp-tools",
3
- "version": "0.9.10",
3
+ "version": "0.9.11",
4
4
  "description": "MCP tool definitions for SmartyTalent API",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",