@smartytalent/mcp-tools 0.9.56 → 0.9.57

package/dist/tools.json

@@ -5371,6 +5371,19 @@
                   "maximum": 1000,
                   "description": "Stage 3 (2026-10-06): how many people the job hires (brief.intakeContext.headcount). Written by the job build (copied); PATCH-able (an integer from 1 to 1000); null clears it."
                 },
+                "workingTime": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "1/4",
+                      "1/2",
+                      "3/4",
+                      "full-time"
+                    ]
+                  },
+                  "description": "The strict first gate (S.K. 2026-10-07): the working-time fractions the hiring manager's contract offers, read off brief.employmentType by the job build (code, never a model: '1/2, 3/4 or full-time' -> the three tokens; a text naming no fraction leaves the field absent). The application form asks 'which working time?' with the four fractions and rejects a choice the job does not offer - only when the job offers a part-time fraction or several fractions (a full-time-only job keeps the minimum of fields). Not PATCH-able: a rebuild of the job reads it again."
+                },
                 "languageCode": {
                   "type": "string",
                   "description": "Primary language code for the job posting (e.g. en-US, pl-PL)"
@@ -6351,6 +6364,19 @@
                   "maximum": 1000,
                   "description": "Stage 3 (2026-10-06): how many people the job hires (brief.intakeContext.headcount). Written by the job build (copied); PATCH-able (an integer from 1 to 1000); null clears it."
                 },
+                "workingTime": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "1/4",
+                      "1/2",
+                      "3/4",
+                      "full-time"
+                    ]
+                  },
+                  "description": "The strict first gate (S.K. 2026-10-07): the working-time fractions the hiring manager's contract offers, read off brief.employmentType by the job build (code, never a model: '1/2, 3/4 or full-time' -> the three tokens; a text naming no fraction leaves the field absent). The application form asks 'which working time?' with the four fractions and rejects a choice the job does not offer - only when the job offers a part-time fraction or several fractions (a full-time-only job keeps the minimum of fields). Not PATCH-able: a rebuild of the job reads it again."
+                },
                 "languageCode": {
                   "type": "string",
                   "description": "Primary language code for the job posting (e.g. en-US, pl-PL)"
@@ -7439,7 +7465,8 @@
                 },
                 "meta": {
                   "type": "object",
-                  "additionalProperties": true
+                  "additionalProperties": true,
+                  "description": "The analysis' record on the row. `verdict` (verdict-v1): band, code, the must outcomes (`must.met[]` with `reason: formDeclared | declaredOnly`, `must.failed[]`, `must.unverified[]`, `must.toClarify[]` = the salary without a figure), and - the screening package A, 2026-10-07 - the card's flags `verdict.declaredOnly[]` (musts met on the application form's word alone), `verdict.noReadableDocument` (the document gave the extraction nothing), `verdict.salaryToClarify` (no salary figure on the candidate's side, or the salary scale's 3: 5-20% above the ceiling or more than 5% below the floor), `verdict.formSetAside[]` (the criteria whose application-form answer RecOps set aside when it ordered the analysis past the knockout - the CV decided them; `must.unverified[]` entries with `reason: formSetAside` where the CV said nothing about the requirement; the answers and the reason are in `knockoutReleased`). `knockoutFailure.failures[]` (a row the form rejected: `fieldId`, `verifies`, `expected`, `actual`; package B adds `label`, `answerLabel`, `expectedLabel` in the job's language - the reason RecOps reads). `knockoutReleased` (package B: RecOps' candidates:analyze past the form's knockout - `by`, `at`, `taskId`, `reason`, `knockout {failures, band}`, `submissionId` = the application released; kept after the analysis, while `decision` reads `analyzeAnyway` only until the verdict's decision replaces it; a later re-application keeps the key, so the current application was analysed past the knockout only when `submissionId` equals `lastSubmissionId`). `decision`, `mandatoryCheck`, `provenance`, `lastSubmissionId` and the arc keys as before."
                 }
               }
             },
@@ -7498,6 +7525,26 @@
                           },
                           "id": {
                             "type": "string"
+                          },
+                          "meta": {
+                            "title": "CandidateFileLinkMetaSchema",
+                            "type": "object",
+                            "description": "Plan #2 (S.K. 2026-10-08): the state of this file OF THE APPLICATION - every file of it is linked, read or not; its type is the file's own `type`. Absent on links written before.",
+                            "properties": {
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "read",
+                                  "notRead",
+                                  "failed"
+                                ],
+                                "description": "read = the CV, or an evidence document the document reader read; notRead = typed, not read for facts; failed = the file failed or was refused."
+                              },
+                              "reason": {
+                                "type": "string",
+                                "description": "notRead: limit (an evidence document past the reader's 5) | secondCv | identityDocument | noFactSource (a cover letter, references, the rest); failed: the file's error code (DOCUMENT_TOO_LARGE, UNSUPPORTED_FORMAT, CONVERSION_FAILED, DOCUMENT_UNREADABLE, FILE_ANALYSIS_FAILED)."
+                              }
+                            }
                           }
                         }
                       }
@@ -8086,7 +8133,8 @@
                 },
                 "meta": {
                   "type": "object",
-                  "additionalProperties": true
+                  "additionalProperties": true,
+                  "description": "The analysis' record on the row. `verdict` (verdict-v1): band, code, the must outcomes (`must.met[]` with `reason: formDeclared | declaredOnly`, `must.failed[]`, `must.unverified[]`, `must.toClarify[]` = the salary without a figure), and - the screening package A, 2026-10-07 - the card's flags `verdict.declaredOnly[]` (musts met on the application form's word alone), `verdict.noReadableDocument` (the document gave the extraction nothing), `verdict.salaryToClarify` (no salary figure on the candidate's side, or the salary scale's 3: 5-20% above the ceiling or more than 5% below the floor), `verdict.formSetAside[]` (the criteria whose application-form answer RecOps set aside when it ordered the analysis past the knockout - the CV decided them; `must.unverified[]` entries with `reason: formSetAside` where the CV said nothing about the requirement; the answers and the reason are in `knockoutReleased`). `knockoutFailure.failures[]` (a row the form rejected: `fieldId`, `verifies`, `expected`, `actual`; package B adds `label`, `answerLabel`, `expectedLabel` in the job's language - the reason RecOps reads). `knockoutReleased` (package B: RecOps' candidates:analyze past the form's knockout - `by`, `at`, `taskId`, `reason`, `knockout {failures, band}`, `submissionId` = the application released; kept after the analysis, while `decision` reads `analyzeAnyway` only until the verdict's decision replaces it; a later re-application keeps the key, so the current application was analysed past the knockout only when `submissionId` equals `lastSubmissionId`). `decision`, `mandatoryCheck`, `provenance`, `lastSubmissionId` and the arc keys as before."
                 }
               }
             },
@@ -8145,6 +8193,26 @@
                           },
                           "id": {
                             "type": "string"
+                          },
+                          "meta": {
+                            "title": "CandidateFileLinkMetaSchema",
+                            "type": "object",
+                            "description": "Plan #2 (S.K. 2026-10-08): the state of this file OF THE APPLICATION - every file of it is linked, read or not; its type is the file's own `type`. Absent on links written before.",
+                            "properties": {
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "read",
+                                  "notRead",
+                                  "failed"
+                                ],
+                                "description": "read = the CV, or an evidence document the document reader read; notRead = typed, not read for facts; failed = the file failed or was refused."
+                              },
+                              "reason": {
+                                "type": "string",
+                                "description": "notRead: limit (an evidence document past the reader's 5) | secondCv | identityDocument | noFactSource (a cover letter, references, the rest); failed: the file's error code (DOCUMENT_TOO_LARGE, UNSUPPORTED_FORMAT, CONVERSION_FAILED, DOCUMENT_UNREADABLE, FILE_ANALYSIS_FAILED)."
+                              }
+                            }
                           }
                         }
                       }
@@ -8504,7 +8572,8 @@
                   "type": "string"
                 },
                 "status": {
-                  "type": "string"
+                  "type": "string",
+                  "description": "pending | uploaded | success | failed | archived. `failed` = the conversion or the analysis failed, or the file was REFUSED at intake (plan #2 P2: too large / an unsupported format) - meta.failure says which."
                 },
                 "extension": {
                   "type": "string"
@@ -8519,7 +8588,8 @@
                   "type": "string"
                 },
                 "type": {
-                  "type": "string"
+                  "type": "string",
+                  "description": "The document's type as the file reader classified it (plan #2): resume, coverLetter, certificate (diplomas included), licence (a driving licence, a driver card), identityDocument (an ID card, a passport, a residence card), referenceLetter, portfolio, assessmentResult, jobBrief, jobDescription, document (anything else); videoRecording / audioRecording for media; undefined before the reader ran. Not an enum: rows written earlier may carry other values."
                 },
                 "kind": {
                   "type": "string",
@@ -8739,7 +8809,8 @@
                   "type": "string"
                 },
                 "status": {
-                  "type": "string"
+                  "type": "string",
+                  "description": "pending | uploaded | success | failed | archived. `failed` = the conversion or the analysis failed, or the file was REFUSED at intake (plan #2 P2: too large / an unsupported format) - meta.failure says which."
                 },
                 "extension": {
                   "type": "string"
@@ -8754,7 +8825,8 @@
                   "type": "string"
                 },
                 "type": {
-                  "type": "string"
+                  "type": "string",
+                  "description": "The document's type as the file reader classified it (plan #2): resume, coverLetter, certificate (diplomas included), licence (a driving licence, a driver card), identityDocument (an ID card, a passport, a residence card), referenceLetter, portfolio, assessmentResult, jobBrief, jobDescription, document (anything else); videoRecording / audioRecording for media; undefined before the reader ran. Not an enum: rows written earlier may carry other values."
                 },
                 "kind": {
                   "type": "string",
@@ -9991,7 +10063,7 @@
                 },
                 "content": {
                   "type": "string",
-                  "description": "The field schema, JSON-encoded: a flat map of `fieldId -> field`.\nA field carries `label` and `description` as locale maps, a\n`type` (text, textarea, select, checkbox, file, email, phone,\ndate, number), `required`, and for a select an `options` list of\n`{value, label}` - the candidate submits `value`, never the\nlocalized label.\n\nA knockout field adds `knockout: true`, `verifies` (the criterion\nit gates on) and `expectedAnswer` (the PASSING answer, matching\none of the option values for a select). The submission gate\nrejects a candidate on a failed knockout without any AI spend, so\na knockout missing `expectedAnswer` is refused: the gate would\nskip it and admit everyone. A knockout on a checkbox is refused\ntoo - a required checkbox renders as must-tick, so \"No\" cannot be\nexpressed and the gate could never fire.\n\nEvery label and option label must carry text in the form's\n`languageCode` or in `en-US` - the locales the apply page falls\nback to. A label that resolves in neither renders blank for the\ncandidate and is refused.\n\nAn apply form (`kind: candidateSubmission`) must keep the\n`fullName`, `email`, `phone` and `cv` fields: the apply page maps\nthem onto first-class submission slots.\n\nRejections come back as one error object per violation, each with\na `source.pointer` at the offending field. Limit: 131072 bytes."
+                  "description": "The field schema, JSON-encoded: a flat map of `fieldId -> field`.\nA field carries `label` and `description` as locale maps, a\n`type` (text, textarea, select, checkbox, file, email, phone,\ndate, number), `required`, and for a select an `options` list of\n`{value, label}` - the candidate submits `value`, never the\nlocalized label. A `file` field may take several files: `multiple:\ntrue` and `maxFiles` (the apply form's CV field: 6 - the CV + 5\ndocuments; plan #2, S.K. 2026-10-08: no separate field, the CV is\nfound by its type).\n\nA knockout field adds `knockout: true`, `verifies` (the criterion\nit gates on) and `expectedAnswer` (the PASSING answer, matching\none of the option values for a select; since the strict first gate\nof 2026-10-07 it may be an ARRAY of option values - any of them\npasses: the weekends select 0-4 gating at the job's minimum, the\nworking-time select 1/4 / 1/2 / 3/4 / full-time gating on the\nfractions the job offers; the experience select gates on\n`{N}-years-or-more` aligned to the job's minimum). The submission gate\nrejects a candidate on a failed knockout without any AI spend, so\na knockout missing `expectedAnswer` is refused: the gate would\nskip it and admit everyone. A knockout on a checkbox is refused\ntoo - a required checkbox renders as must-tick, so \"No\" cannot be\nexpressed and the gate could never fire.\n\nEvery label and option label must carry text in the form's\n`languageCode` or in `en-US` - the locales the apply page falls\nback to. A label that resolves in neither renders blank for the\ncandidate and is refused.\n\nAn apply form (`kind: candidateSubmission`) must keep the\n`fullName`, `email`, `phone` and `cv` fields: the apply page maps\nthem onto first-class submission slots.\n\nRejections come back as one error object per violation, each with\na `source.pointer` at the offending field. Limit: 131072 bytes."
                 },
                 "publish": {
                   "type": "boolean",
@@ -10134,7 +10206,7 @@
                 },
                 "content": {
                   "type": "string",
-                  "description": "The field schema, JSON-encoded: a flat map of `fieldId -> field`.\nA field carries `label` and `description` as locale maps, a\n`type` (text, textarea, select, checkbox, file, email, phone,\ndate, number), `required`, and for a select an `options` list of\n`{value, label}` - the candidate submits `value`, never the\nlocalized label.\n\nA knockout field adds `knockout: true`, `verifies` (the criterion\nit gates on) and `expectedAnswer` (the PASSING answer, matching\none of the option values for a select). The submission gate\nrejects a candidate on a failed knockout without any AI spend, so\na knockout missing `expectedAnswer` is refused: the gate would\nskip it and admit everyone. A knockout on a checkbox is refused\ntoo - a required checkbox renders as must-tick, so \"No\" cannot be\nexpressed and the gate could never fire.\n\nEvery label and option label must carry text in the form's\n`languageCode` or in `en-US` - the locales the apply page falls\nback to. A label that resolves in neither renders blank for the\ncandidate and is refused.\n\nAn apply form (`kind: candidateSubmission`) must keep the\n`fullName`, `email`, `phone` and `cv` fields: the apply page maps\nthem onto first-class submission slots.\n\nRejections come back as one error object per violation, each with\na `source.pointer` at the offending field. Limit: 131072 bytes."
+                  "description": "The field schema, JSON-encoded: a flat map of `fieldId -> field`.\nA field carries `label` and `description` as locale maps, a\n`type` (text, textarea, select, checkbox, file, email, phone,\ndate, number), `required`, and for a select an `options` list of\n`{value, label}` - the candidate submits `value`, never the\nlocalized label. A `file` field may take several files: `multiple:\ntrue` and `maxFiles` (the apply form's CV field: 6 - the CV + 5\ndocuments; plan #2, S.K. 2026-10-08: no separate field, the CV is\nfound by its type).\n\nA knockout field adds `knockout: true`, `verifies` (the criterion\nit gates on) and `expectedAnswer` (the PASSING answer, matching\none of the option values for a select; since the strict first gate\nof 2026-10-07 it may be an ARRAY of option values - any of them\npasses: the weekends select 0-4 gating at the job's minimum, the\nworking-time select 1/4 / 1/2 / 3/4 / full-time gating on the\nfractions the job offers; the experience select gates on\n`{N}-years-or-more` aligned to the job's minimum). The submission gate\nrejects a candidate on a failed knockout without any AI spend, so\na knockout missing `expectedAnswer` is refused: the gate would\nskip it and admit everyone. A knockout on a checkbox is refused\ntoo - a required checkbox renders as must-tick, so \"No\" cannot be\nexpressed and the gate could never fire.\n\nEvery label and option label must carry text in the form's\n`languageCode` or in `en-US` - the locales the apply page falls\nback to. A label that resolves in neither renders blank for the\ncandidate and is refused.\n\nAn apply form (`kind: candidateSubmission`) must keep the\n`fullName`, `email`, `phone` and `cv` fields: the apply page maps\nthem onto first-class submission slots.\n\nRejections come back as one error object per violation, each with\na `source.pointer` at the offending field. Limit: 131072 bytes."
                 },
                 "publish": {
                   "type": "boolean",
@@ -13880,6 +13952,8 @@
         },
         "files": {
           "type": "array",
+          "maxItems": 10,
+          "description": "The application's files (at most 10; each fileKey one the form's upload door issued - #66). The CV is found by its type (plan #2), not by its position.",
           "items": {
             "type": "object",
             "properties": {
@@ -18804,7 +18878,7 @@
                 "route": {
                   "type": "string",
                   "maxLength": 64,
-                  "description": "Workflow routing key (`namespace:verb`). The operator e-mail lane has exactly three: `emails:reply`, `emails:compose`, `emails:send` - nothing else. Optional, normalised to lowercase and shape-validated at create, stamped on the row and IMMUTABLE afterwards - a PATCH carrying route is rejected with 400. Creating a task whose route matches emails:* requires role recruiter/recops/admin/owner (hiringmanager and auditor are denied); the same gate guards a PATCH of an emails:* row."
+                  "description": "Workflow routing key (`namespace:verb`). The operator e-mail lane has exactly three: `emails:reply`, `emails:compose`, `emails:send` - nothing else. Optional, normalised to lowercase and shape-validated at create, stamped on the row and IMMUTABLE afterwards - a PATCH carrying route is rejected with 400. Creating a task whose route matches emails:* requires role recruiter/recops/admin/owner (hiringmanager and auditor are denied); the same gate guards a PATCH of an emails:* row. The RecOps doors on a candidate ride the same key with the candidate in `relationships.candidates` and their order in `meta`: `candidates:opinion` (`meta.override`, see the criterion's `override`), `candidates:stage` (`meta.stage`), and - the screening package B, 2026-10-07 - `candidates:analyze` (`meta.analyze {reason}`: analyse a candidate the application form knocked out; the action clears the knockout, keeps it in `meta.decision` history and runs the analysis on the pointed submission; the task closes `done`, or `failed` with the reason when the row is not a knockout)."
                 },
                 "kind": {
                   "type": "string",
@@ -19113,7 +19187,7 @@
                 "route": {
                   "type": "string",
                   "maxLength": 64,
-                  "description": "Workflow routing key (`namespace:verb`). The operator e-mail lane has exactly three: `emails:reply`, `emails:compose`, `emails:send` - nothing else. Optional, normalised to lowercase and shape-validated at create, stamped on the row and IMMUTABLE afterwards - a PATCH carrying route is rejected with 400. Creating a task whose route matches emails:* requires role recruiter/recops/admin/owner (hiringmanager and auditor are denied); the same gate guards a PATCH of an emails:* row."
+                  "description": "Workflow routing key (`namespace:verb`). The operator e-mail lane has exactly three: `emails:reply`, `emails:compose`, `emails:send` - nothing else. Optional, normalised to lowercase and shape-validated at create, stamped on the row and IMMUTABLE afterwards - a PATCH carrying route is rejected with 400. Creating a task whose route matches emails:* requires role recruiter/recops/admin/owner (hiringmanager and auditor are denied); the same gate guards a PATCH of an emails:* row. The RecOps doors on a candidate ride the same key with the candidate in `relationships.candidates` and their order in `meta`: `candidates:opinion` (`meta.override`, see the criterion's `override`), `candidates:stage` (`meta.stage`), and - the screening package B, 2026-10-07 - `candidates:analyze` (`meta.analyze {reason}`: analyse a candidate the application form knocked out; the action clears the knockout, keeps it in `meta.decision` history and runs the analysis on the pointed submission; the task closes `done`, or `failed` with the reason when the row is not a knockout)."
                 },
                 "kind": {
                   "type": "string",

package/package.json

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