@smartytalent/openai-tools 0.9.9 → 0.9.10

package/dist/tools.json

@@ -7839,6 +7839,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.",
@@ -8005,7 +8009,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",
@@ -8065,7 +8069,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",
@@ -8504,7 +8509,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",
@@ -8564,7 +8569,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",
@@ -12182,7 +12188,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",
@@ -12674,7 +12680,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",
@@ -17566,13 +17572,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",
@@ -17682,13 +17693,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",
@@ -20032,7 +20048,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",
@@ -20330,7 +20346,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/openai-tools",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "description": "OpenAI function/tool definitions for SmartyTalent API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",