@smartytalent/mcp-tools 0.9.9 → 0.9.10

package/dist/tools.json

@@ -8079,6 +8079,10 @@
           "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."
         },
+        "filterLabelId": {
+          "type": "string",
+          "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."
+        },
         "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.",
@@ -8247,7 +8251,7 @@
                       },
                       "type": {
                         "type": "string",
-                        "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`."
+                        "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."
                       },
                       "fileId": {
                         "type": "string",
@@ -8307,7 +8311,8 @@
                 },
                 "meta": {
                   "type": "object",
-                  "additionalProperties": true
+                  "additionalProperties": true,
+                  "description": "Not populated on the wire - the email meta rides at the resource level (data.meta, see EmailResourceSchema.meta). Kept for client compatibility only."
                 },
                 "timestamps": {
                   "title": "ResourceTimestampsSchema",
@@ -8752,7 +8757,7 @@
                       },
                       "type": {
                         "type": "string",
-                        "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`."
+                        "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."
                       },
                       "fileId": {
                         "type": "string",
@@ -8812,7 +8817,8 @@
                 },
                 "meta": {
                   "type": "object",
-                  "additionalProperties": true
+                  "additionalProperties": true,
+                  "description": "Not populated on the wire - the email meta rides at the resource level (data.meta, see EmailResourceSchema.meta). Kept for client compatibility only."
                 },
                 "timestamps": {
                   "title": "ResourceTimestampsSchema",
@@ -12540,7 +12546,7 @@
                 },
                 "meta": {
                   "type": "object",
-                  "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."
+                  "description": "Not populated on the wire - the submission meta rides at the resource level (data.meta, see SubmissionResourceSchema.meta). Kept for client compatibility only."
                 },
                 "timestamps": {
                   "title": "ResourceTimestampsSchema",
@@ -13048,7 +13054,7 @@
                     },
                     "meta": {
                       "type": "object",
-                      "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."
+                      "description": "Not populated on the wire - the submission meta rides at the resource level (data.meta, see SubmissionResourceSchema.meta). Kept for client compatibility only."
                     },
                     "timestamps": {
                       "title": "ResourceTimestampsSchema",
@@ -18080,13 +18086,18 @@
                   "type": "string",
                   "enum": [
                     "tenant",
-                    "user"
+                    "user",
+                    "system"
                   ],
-                  "description": "tenant = visible to every user in the tenant; user = visible only to the owner."
+                  "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)."
+                },
+                "systemKey": {
+                  "type": "string",
+                  "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."
                 },
                 "ownerId": {
                   "type": "string",
-                  "description": "Set server-side from the caller. Tenant-scope: tenantId. User-scope: the authenticated user's full userId."
+                  "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."
                 },
                 "resourceTypes": {
                   "type": "array",
@@ -18202,13 +18213,18 @@
                   "type": "string",
                   "enum": [
                     "tenant",
-                    "user"
+                    "user",
+                    "system"
                   ],
-                  "description": "tenant = visible to every user in the tenant; user = visible only to the owner."
+                  "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)."
+                },
+                "systemKey": {
+                  "type": "string",
+                  "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."
                 },
                 "ownerId": {
                   "type": "string",
-                  "description": "Set server-side from the caller. Tenant-scope: tenantId. User-scope: the authenticated user's full userId."
+                  "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."
                 },
                 "resourceTypes": {
                   "type": "array",
@@ -20610,7 +20626,7 @@
                 "meta": {
                   "type": "object",
                   "additionalProperties": true,
-                  "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."
+                  "description": "Not populated on the wire - the conversation meta rides at the resource level (data.meta, see ConversationResourceSchema.meta). Kept for client compatibility only."
                 },
                 "timestamps": {
                   "title": "ResourceTimestampsSchema",
@@ -20914,7 +20930,7 @@
                 "meta": {
                   "type": "object",
                   "additionalProperties": true,
-                  "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."
+                  "description": "Not populated on the wire - the conversation meta rides at the resource level (data.meta, see ConversationResourceSchema.meta). Kept for client compatibility only."
                 },
                 "timestamps": {
                   "title": "ResourceTimestampsSchema",

package/package.json

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