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

package/dist/tools.json

@@ -12118,17 +12118,9 @@
           "type": "string",
           "description": "Comma-separated list of resource ids to batch-fetch. Requires `filterResourceType`."
         },
-        "filterIsStarred": {
-          "type": "boolean",
-          "description": "Only return starred states."
-        },
-        "filterIsSeen": {
-          "type": "boolean",
-          "description": "Only return seen (true) or unseen (false) states."
-        },
-        "filterIsSpam": {
-          "type": "boolean",
-          "description": "Only return spam-marked states. Reads from the SpamIndex."
+        "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"
         },
         "pageSize": {
           "type": "integer",
@@ -15732,12 +15724,62 @@
                   "description": "The type of search to perform"
                 },
                 "query": {
-                  "type": "object",
-                  "description": "Search query parameters sent to OpenSearch. Supported keys for talent search: Semantic (full-text match) - \"search\" (multi-match across all text fields), \"name\", \"quickInsights\", \"skillsAndExpertise\", \"professionalExperience\", \"education\", \"experienceAndSeniority\", \"jobPositions\", \"keywords\", \"certifications\", \"industryExperience\", \"languagesSpoken\", \"locationPreferences\", \"personalityAndSoftSkills\", \"availability\", \"workPreferences\", \"workAuthorization\". Filters (exact match) - \"status\", \"source\", \"email\", \"gender\", \"shortCode\", \"isTalentPool\", \"relocationWillingness\", \"requiresSponsorship\", \"careerBreak\". IDs - \"jobId\", \"talentId\"."
+                  "description": "Search query parameters sent to OpenSearch. Shape varies by finder `type`. OpenAPI can't express the full type/query correlation as a strict discriminated union (the discriminator lives on the sibling `type` field, not on `query` itself), so this is encoded as `oneOf` over per-type query schemas. Clients should pick the shape matching the `type` they are posting.",
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/FinderQueryTalentsSchema"
+                    },
+                    {
+                      "$ref": "#/components/schemas/FinderQueryCandidatesSchema"
+                    },
+                    {
+                      "$ref": "#/components/schemas/FinderQueryJobsSchema"
+                    },
+                    {
+                      "$ref": "#/components/schemas/FinderQueryEmailsSchema"
+                    }
+                  ]
                 },
                 "results": {
+                  "title": "FinderResultsSchema",
                   "type": "object",
-                  "description": "The search results returned from OpenSearch (auto-populated)"
+                  "description": "OpenSearch-shaped results attached to the finder record after the search runs. Hits array items carry whatever subset of the index schema was projected.",
+                  "properties": {
+                    "total": {
+                      "type": "integer",
+                      "description": "Count of matching documents before pagination."
+                    },
+                    "hits": {
+                      "type": "array",
+                      "items": {
+                        "title": "FinderResultHitSchema",
+                        "type": "object",
+                        "description": "Single hit from the OpenSearch query. The `id` equals the underlying resource id (emailId, talentId, candidateId, jobId, ...) so the frontend can navigate directly to that resource. Additional fields vary by finder `type`.",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "description": "The underlying resource id (emailId / talentId / candidateId / jobId)."
+                          },
+                          "tenantId": {
+                            "type": "string"
+                          },
+                          "status": {
+                            "type": "string"
+                          },
+                          "source": {
+                            "type": "string"
+                          },
+                          "created": {
+                            "type": "string"
+                          },
+                          "shortCode": {
+                            "type": "string"
+                          }
+                        },
+                        "additionalProperties": true
+                      }
+                    }
+                  }
                 },
                 "status": {
                   "type": "string",
@@ -15965,12 +16007,62 @@
                   "description": "The type of search to perform"
                 },
                 "query": {
-                  "type": "object",
-                  "description": "Search query parameters sent to OpenSearch. Supported keys for talent search: Semantic (full-text match) - \"search\" (multi-match across all text fields), \"name\", \"quickInsights\", \"skillsAndExpertise\", \"professionalExperience\", \"education\", \"experienceAndSeniority\", \"jobPositions\", \"keywords\", \"certifications\", \"industryExperience\", \"languagesSpoken\", \"locationPreferences\", \"personalityAndSoftSkills\", \"availability\", \"workPreferences\", \"workAuthorization\". Filters (exact match) - \"status\", \"source\", \"email\", \"gender\", \"shortCode\", \"isTalentPool\", \"relocationWillingness\", \"requiresSponsorship\", \"careerBreak\". IDs - \"jobId\", \"talentId\"."
+                  "description": "Search query parameters sent to OpenSearch. Shape varies by finder `type`. OpenAPI can't express the full type/query correlation as a strict discriminated union (the discriminator lives on the sibling `type` field, not on `query` itself), so this is encoded as `oneOf` over per-type query schemas. Clients should pick the shape matching the `type` they are posting.",
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/FinderQueryTalentsSchema"
+                    },
+                    {
+                      "$ref": "#/components/schemas/FinderQueryCandidatesSchema"
+                    },
+                    {
+                      "$ref": "#/components/schemas/FinderQueryJobsSchema"
+                    },
+                    {
+                      "$ref": "#/components/schemas/FinderQueryEmailsSchema"
+                    }
+                  ]
                 },
                 "results": {
+                  "title": "FinderResultsSchema",
                   "type": "object",
-                  "description": "The search results returned from OpenSearch (auto-populated)"
+                  "description": "OpenSearch-shaped results attached to the finder record after the search runs. Hits array items carry whatever subset of the index schema was projected.",
+                  "properties": {
+                    "total": {
+                      "type": "integer",
+                      "description": "Count of matching documents before pagination."
+                    },
+                    "hits": {
+                      "type": "array",
+                      "items": {
+                        "title": "FinderResultHitSchema",
+                        "type": "object",
+                        "description": "Single hit from the OpenSearch query. The `id` equals the underlying resource id (emailId, talentId, candidateId, jobId, ...) so the frontend can navigate directly to that resource. Additional fields vary by finder `type`.",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "description": "The underlying resource id (emailId / talentId / candidateId / jobId)."
+                          },
+                          "tenantId": {
+                            "type": "string"
+                          },
+                          "status": {
+                            "type": "string"
+                          },
+                          "source": {
+                            "type": "string"
+                          },
+                          "created": {
+                            "type": "string"
+                          },
+                          "shortCode": {
+                            "type": "string"
+                          }
+                        },
+                        "additionalProperties": true
+                      }
+                    }
+                  }
                 },
                 "status": {
                   "type": "string",

package/package.json

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