@smartytalent/mcp-tools 0.9.18 → 0.9.20

package/dist/tools.json

@@ -17379,6 +17379,32 @@
           "type": "string",
           "description": "Returns only the tasks linked to this conversation - the\noperator orders and the escalations filed on one thread. Same\nsemantics as `filterConversationId` on listEmails. Mutually\nexclusive with every other filter at the pagination layer."
         },
+        "filterFamily": {
+          "type": "string",
+          "description": "Recops board (2026-09-02): returns the tasks of one route family -\nthe part of `route` before the colon (`emails`, `jobs`, `talents`,\n`candidates`, `compliance` as families arrive), or the literal\n`escalation` for every task WITHOUT a route (an escalation the\nvirtual employee filed, a note). Any string is accepted; an\nunknown family answers an empty list, never 400. Served by\nFamilyIndex; combine with `sort=-created` for newest-first (the\npagination layer sorts the family's rows in memory). Mutually\nexclusive with the other equality filters."
+        },
+        "filterAuthorId": {
+          "type": "string",
+          "description": "Recops board: \"my orders\" - the tasks whose `relationships.author`\nis this user (the caller who filed them; the virtual employee's\nown escalations carry its user). Served by AuthorIdIndex, rows\nolder than the index were backfilled from the author link (a few\nlegacy rows have no author source and are absent). Combine with\n`sort=-created` for newest-first. Mutually exclusive with the\nother equality filters."
+        },
+        "filterJobId": {
+          "type": "string",
+          "description": "Recops board: \"this project's orders\" - the tasks whose\n`relationships.jobs` names this job (jobs:* orders and escalations\ncaptured on the project). Served by JobIdIndex, the link flattened\nat create and when it arrives on PATCH; older rows backfilled.\nCombine with `sort=-created`. Mutually exclusive with the other\nequality filters."
+        },
+        "filterClaimedBy": {
+          "type": "string",
+          "description": "Recops board: \"mine in progress\" - the tasks whose `meta.claimedBy`\nis this user. The claim is written by the client (`meta.claimedBy`\n+ `meta.claimedAt` merged per key; `null` releases) and mirrored\ninto the index key on every PATCH that names it. Served by\nClaimedByIndex. Combine with `sort=-created`. Mutually exclusive\nwith the other equality filters."
+        },
+        "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\nWithout any filter the list is served by the time index. With\n`filterFamily`, `filterAuthorId`, `filterClaimedBy` or\n`filterConversationId` the filter's own index is read and the\nrows are sorted in memory, so the order is honoured (cost bounded\nby the filter's scope). With `filterStatus` the sort is IGNORED\n(StatusIndex has no time key): read open statuses (small sets)\nand sort client-side, or use `sort=-created` without a filter for\nthe tenant's newest tasks. Compatible with the date-range filters.\nNote: without `sort` and without a filter the order is the base\ntable's key order, which is NOT chronological.",
+          "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."
@@ -17455,7 +17481,12 @@
                 "kind": {
                   "type": "string",
                   "maxLength": 64,
-                  "description": "Free-form task kind label (e.g. email_reply). Not a filter: the list door has no filterKind/filterRoute, only filterStatus."
+                  "description": "Free-form task kind label (e.g. email_reply). Not a filter: the list door filters by status, thread, route family (filterFamily), author and claim - never by kind."
+                },
+                "dueAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "Recops board (2026-09-02): the deadline for a HUMAN to act on this task (not the sending moment of a draft - that is meta.scheduledFor). Optional; written by the client (PATCH, `null` clears) and, later, by the flows that file decision tasks. Accepted as ISO 8601 with an offset or Z (a naive value is read as UTC), always returned as UTC with Z. A moment in the past is allowed - it means \"already overdue\". Not indexed: overdue is computed on the page."
                 },
                 "content": {
                   "type": "object",
@@ -17700,7 +17731,12 @@
                 "kind": {
                   "type": "string",
                   "maxLength": 64,
-                  "description": "Free-form task kind label (e.g. email_reply). Not a filter: the list door has no filterKind/filterRoute, only filterStatus."
+                  "description": "Free-form task kind label (e.g. email_reply). Not a filter: the list door filters by status, thread, route family (filterFamily), author and claim - never by kind."
+                },
+                "dueAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "Recops board (2026-09-02): the deadline for a HUMAN to act on this task (not the sending moment of a draft - that is meta.scheduledFor). Optional; written by the client (PATCH, `null` clears) and, later, by the flows that file decision tasks. Accepted as ISO 8601 with an offset or Z (a naive value is read as UTC), always returned as UTC with Z. A moment in the past is allowed - it means \"already overdue\". Not indexed: overdue is computed on the page."
                 },
                 "content": {
                   "type": "object",

package/package.json

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