@smartytalent/mcp-tools 0.1.33-dev.5 → 0.1.33-dev.7

package/dist/tools.json

@@ -6729,6 +6729,32 @@
           "type": "string",
           "description": "Return only emails belonging to this conversation. Resolved via the ConversationIdIndex GSI (top-level denormalisation of relationships.conversations[0].data.id). Pass the full conversation id (e.g. `980434e7...-2`)."
         },
+        "filterDirection": {
+          "type": "string",
+          "description": "Return only emails with this direction. `inbound` = received from an external sender (Inbox), `outbound` = composed by the tenant (Sent). Resolved via the DirectionIndex GSI. Mutually exclusive with `filterStatus` and `filterConversationId` at the pagination layer.",
+          "enum": [
+            "inbound",
+            "outbound"
+          ]
+        },
+        "filterIds": {
+          "type": "string",
+          "description": "Batch-fetch emails by id. Pass a comma-separated list (e.g. `abc-1,def-2,ghi-3`). Resolves each id's shard from its suffix and issues a BatchGetItem. Used by the inbox UI to hydrate emails referenced by state rows (folder=unseen / starred / spam) without N showEmail calls. Cap: 500 ids per request; beyond that, page the state list and batch again. Bypasses pagination - the returned `data` is the full batch result with no `nextPage` cursor."
+        },
+        "filterIsSystemSpam": {
+          "type": "boolean",
+          "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."
+        },
+        "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,\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.",
+          "enum": [
+            "-created",
+            "created",
+            "-modified",
+            "modified"
+          ]
+        },
         "filterCreatedFrom": {
           "type": "string",
           "description": "Filters results to include only those created from the specified date and time. The value must be in ISO 8601 format."
@@ -12120,7 +12146,7 @@
         },
         "folder": {
           "type": "string",
-          "description": "Folder-style filter. Exactly one value at a time (tagged-union\nsemantics - the SDK enforces this at compile time via string\nliteral union). Orthogonal to filterResourceType and\nfilterResourceIds, which scope the query but don't pick a folder.\n  `all`             - default, no folder filter\n  `unseen`          - only unread rows (sparse UnseenIndex)\n  `starred`         - only starred rows (sparse StarredIndex)\n  `spam`            - only user-spam-marked rows (sparse SpamIndex)\n  `label:<labelId>` - rows whose flags.labels contains the labelId"
+          "description": "Folder-style filter. Tagged-union: the fixed folders are an enum,\nand the label folder is a `label:<labelId>` template. Orthogonal\nto filterResourceType and filterResourceIds which scope within\nthe folder.\n\nFixed folders:\n  `all`     - default, no folder filter\n  `unseen`  - only unread rows (sparse UnseenIndex)\n  `starred` - only starred rows (sparse StarredIndex)\n  `spam`    - only user-spam-marked rows (sparse SpamIndex)\n\nLabel folder:\n  `label:<labelId>` - rows whose `flags.labels` contains labelId\n\nTypeScript callers should narrow this to\n`'all' | 'unseen' | 'starred' | 'spam' | \\`label:${string}\\``\nin their client wrapper; OpenAPI cannot express template-literal\nunions natively."
         },
         "pageSize": {
           "type": "integer",

package/package.json

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