@smartytalent/mcp-tools 0.9.9 → 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 +526 -14
  2. package/package.json +1 -1
package/dist/tools.json CHANGED
@@ -8079,6 +8079,10 @@
8079
8079
  "type": "boolean",
8080
8080
  "description": "Return only emails the system (broker / classifier) flagged as spam. Used by the Spam folder's `isSystemSpam=true` leg - the other leg comes from `/v1/states?folder=spam`. Backed by a filter-expression scan across shards for v1; promote to a sparse `SystemSpamIndex` if load warrants. Mutually exclusive with the other index-backed filters at the pagination layer."
8081
8081
  },
8082
+ "filterLabelId": {
8083
+ "type": "string",
8084
+ "description": "Return only emails carrying this label. Server-side filter on the denormalised `labelIds` of relationships.labels. Mutually exclusive with the other filters - one filter at a time. Results are sorted by created desc."
8085
+ },
8082
8086
  "sort": {
8083
8087
  "type": "string",
8084
8088
  "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,\nfilterConversationId, filterDirection) dictates a different\nindex; equality filters win. Compatible with date-range filters\n(filterCreatedFrom/To, filterModifiedFrom/To) which already use\nthe same indexes; sort just picks the direction.",
@@ -8247,7 +8251,7 @@
8247
8251
  },
8248
8252
  "type": {
8249
8253
  "type": "string",
8250
- "description": "Resource type this attachment belongs to. User-uploaded attachments use `files`; system-generated attachments use the owning resource type: `jobs`, `personas`, `talents`, `candidates`, `reports`, `ads`."
8254
+ "description": "Resource type this attachment belongs to. User-uploaded attachments use `files`; system-generated attachments use the owning resource type: `jobs`, `personas`, `talents`, `candidates`, `reports`, `ads`, `briefs`. Calendar invites use `emails` - the mail itself owns the .ics."
8251
8255
  },
8252
8256
  "fileId": {
8253
8257
  "type": "string",
@@ -8307,7 +8311,8 @@
8307
8311
  },
8308
8312
  "meta": {
8309
8313
  "type": "object",
8310
- "additionalProperties": true
8314
+ "additionalProperties": true,
8315
+ "description": "Not populated on the wire - the email meta rides at the resource level (data.meta, see EmailResourceSchema.meta). Kept for client compatibility only."
8311
8316
  },
8312
8317
  "timestamps": {
8313
8318
  "title": "ResourceTimestampsSchema",
@@ -8752,7 +8757,7 @@
8752
8757
  },
8753
8758
  "type": {
8754
8759
  "type": "string",
8755
- "description": "Resource type this attachment belongs to. User-uploaded attachments use `files`; system-generated attachments use the owning resource type: `jobs`, `personas`, `talents`, `candidates`, `reports`, `ads`."
8760
+ "description": "Resource type this attachment belongs to. User-uploaded attachments use `files`; system-generated attachments use the owning resource type: `jobs`, `personas`, `talents`, `candidates`, `reports`, `ads`, `briefs`. Calendar invites use `emails` - the mail itself owns the .ics."
8756
8761
  },
8757
8762
  "fileId": {
8758
8763
  "type": "string",
@@ -8812,7 +8817,8 @@
8812
8817
  },
8813
8818
  "meta": {
8814
8819
  "type": "object",
8815
- "additionalProperties": true
8820
+ "additionalProperties": true,
8821
+ "description": "Not populated on the wire - the email meta rides at the resource level (data.meta, see EmailResourceSchema.meta). Kept for client compatibility only."
8816
8822
  },
8817
8823
  "timestamps": {
8818
8824
  "title": "ResourceTimestampsSchema",
@@ -12540,7 +12546,7 @@
12540
12546
  },
12541
12547
  "meta": {
12542
12548
  "type": "object",
12543
- "description": "Free-form metadata. meta.external carries ATS import correlation ({source, jobShortCode, talentShortCode, applicationShortCode, ttl}); meta.email carries email-intake correlation on channel='email' submissions ({conversationId, emailId (the application mail), consentEmailId (the YES), messageId, threadRef 'SMT-<consentAskedEmailId>', consentVerbatim (capped), consentAt, askEmailId, askTextVersion, yesS3Key, senderAuth}) - the consent proof, kept for the life of the row (no TTL); meta.userId is stamped server-side on create. CREATE-ONLY today: the update path ignores meta."
12549
+ "description": "Not populated on the wire - the submission meta rides at the resource level (data.meta, see SubmissionResourceSchema.meta). Kept for client compatibility only."
12544
12550
  },
12545
12551
  "timestamps": {
12546
12552
  "title": "ResourceTimestampsSchema",
@@ -13048,7 +13054,7 @@
13048
13054
  },
13049
13055
  "meta": {
13050
13056
  "type": "object",
13051
- "description": "Free-form metadata. meta.external carries ATS import correlation ({source, jobShortCode, talentShortCode, applicationShortCode, ttl}); meta.email carries email-intake correlation on channel='email' submissions ({conversationId, emailId (the application mail), consentEmailId (the YES), messageId, threadRef 'SMT-<consentAskedEmailId>', consentVerbatim (capped), consentAt, askEmailId, askTextVersion, yesS3Key, senderAuth}) - the consent proof, kept for the life of the row (no TTL); meta.userId is stamped server-side on create. CREATE-ONLY today: the update path ignores meta."
13057
+ "description": "Not populated on the wire - the submission meta rides at the resource level (data.meta, see SubmissionResourceSchema.meta). Kept for client compatibility only."
13052
13058
  },
13053
13059
  "timestamps": {
13054
13060
  "title": "ResourceTimestampsSchema",
@@ -17349,6 +17355,502 @@
17349
17355
  "operationId": "noteOptions"
17350
17356
  }
17351
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
+ },
17352
17854
  {
17353
17855
  "name": "list_states",
17354
17856
  "description": "List States",
@@ -18080,13 +18582,18 @@
18080
18582
  "type": "string",
18081
18583
  "enum": [
18082
18584
  "tenant",
18083
- "user"
18585
+ "user",
18586
+ "system"
18084
18587
  ],
18085
- "description": "tenant = visible to every user in the tenant; user = visible only to the owner."
18588
+ "description": "tenant = visible to every user in the tenant; user = visible only to the owner; system = seeded and stamped by the platform; read-only (create/update/delete via the API are rejected)."
18589
+ },
18590
+ "systemKey": {
18591
+ "type": "string",
18592
+ "description": "Present only on scope=system rows: stable machine key naming the platform intent. `application` = inbound e-mail application, `talent_pool` = talent-pool opt-in (application without a job), `status` = status inquiry about an existing application, `withdrawal` = withdrawal / opt-out acknowledgement. Null on tenant/user labels. Filter or branch on this key, never on the localised name."
18086
18593
  },
18087
18594
  "ownerId": {
18088
18595
  "type": "string",
18089
- "description": "Set server-side from the caller. Tenant-scope: tenantId. User-scope: the authenticated user's full userId."
18596
+ "description": "Set server-side from the caller. Tenant-scope: tenantId. User-scope: the authenticated user's full userId. System-scope: the tenant base id, stamped by the seeder."
18090
18597
  },
18091
18598
  "resourceTypes": {
18092
18599
  "type": "array",
@@ -18202,13 +18709,18 @@
18202
18709
  "type": "string",
18203
18710
  "enum": [
18204
18711
  "tenant",
18205
- "user"
18712
+ "user",
18713
+ "system"
18206
18714
  ],
18207
- "description": "tenant = visible to every user in the tenant; user = visible only to the owner."
18715
+ "description": "tenant = visible to every user in the tenant; user = visible only to the owner; system = seeded and stamped by the platform; read-only (create/update/delete via the API are rejected)."
18716
+ },
18717
+ "systemKey": {
18718
+ "type": "string",
18719
+ "description": "Present only on scope=system rows: stable machine key naming the platform intent. `application` = inbound e-mail application, `talent_pool` = talent-pool opt-in (application without a job), `status` = status inquiry about an existing application, `withdrawal` = withdrawal / opt-out acknowledgement. Null on tenant/user labels. Filter or branch on this key, never on the localised name."
18208
18720
  },
18209
18721
  "ownerId": {
18210
18722
  "type": "string",
18211
- "description": "Set server-side from the caller. Tenant-scope: tenantId. User-scope: the authenticated user's full userId."
18723
+ "description": "Set server-side from the caller. Tenant-scope: tenantId. User-scope: the authenticated user's full userId. System-scope: the tenant base id, stamped by the seeder."
18212
18724
  },
18213
18725
  "resourceTypes": {
18214
18726
  "type": "array",
@@ -20610,7 +21122,7 @@
20610
21122
  "meta": {
20611
21123
  "type": "object",
20612
21124
  "additionalProperties": true,
20613
- "description": "Free-form metadata. meta.reference is the RFC 5322 Message-ID chain of the thread (appended by the conversation eventbus on email events; the outbound sender reads it for In-Reply-To/References). meta.intake marks an email-intake thread and is absent on every other conversation: {version, kind: job_application|talent_pool, status: awaiting_consent|submitted|incomplete|declined|expired, jobId|null, jobShort, jobTitle, formId, language, senderEmail, applicationEmailId, consentAskedEmailId|null, consentEmailId|null, submissionId|null, submittedAt|null, expiresAt, missingFields[] (incomplete), askTextVersion, consentQuestion, draft {answers, wire, cv {s3Key, filename, contentType, size}} (awaiting_consent only)} - written only by the inbound email Lambda; workflows never touch it. talentId/candidateId/jobId are NOT meta or attributes on the wire - read relationships.talent/candidate/job."
21125
+ "description": "Not populated on the wire - the conversation meta rides at the resource level (data.meta, see ConversationResourceSchema.meta). Kept for client compatibility only."
20614
21126
  },
20615
21127
  "timestamps": {
20616
21128
  "title": "ResourceTimestampsSchema",
@@ -20914,7 +21426,7 @@
20914
21426
  "meta": {
20915
21427
  "type": "object",
20916
21428
  "additionalProperties": true,
20917
- "description": "Free-form metadata. meta.reference is the RFC 5322 Message-ID chain of the thread (appended by the conversation eventbus on email events; the outbound sender reads it for In-Reply-To/References). meta.intake marks an email-intake thread and is absent on every other conversation: {version, kind: job_application|talent_pool, status: awaiting_consent|submitted|incomplete|declined|expired, jobId|null, jobShort, jobTitle, formId, language, senderEmail, applicationEmailId, consentAskedEmailId|null, consentEmailId|null, submissionId|null, submittedAt|null, expiresAt, missingFields[] (incomplete), askTextVersion, consentQuestion, draft {answers, wire, cv {s3Key, filename, contentType, size}} (awaiting_consent only)} - written only by the inbound email Lambda; workflows never touch it. talentId/candidateId/jobId are NOT meta or attributes on the wire - read relationships.talent/candidate/job."
21429
+ "description": "Not populated on the wire - the conversation meta rides at the resource level (data.meta, see ConversationResourceSchema.meta). Kept for client compatibility only."
20918
21430
  },
20919
21431
  "timestamps": {
20920
21432
  "title": "ResourceTimestampsSchema",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@smartytalent/mcp-tools",
3
- "version": "0.9.9",
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",