@smartytalent/mcp-tools 0.8.12 → 0.8.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/tools.json +36 -2
  2. package/package.json +1 -1
package/dist/tools.json CHANGED
@@ -8517,7 +8517,24 @@
8517
8517
  "type": "string"
8518
8518
  },
8519
8519
  "content": {
8520
- "type": "string"
8520
+ "type": "string",
8521
+ "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."
8522
+ },
8523
+ "publish": {
8524
+ "type": "boolean",
8525
+ "description": "Publish transition. `true` mirrors `content` to the CDN and flips\nthe form to `active`, the state guest submission intake requires.\nSend it on the same PATCH that carries the edit, or on its own to\nrepublish what is already stored. Needs the recruiting tier or\nabove; publishing a form with no content is a 400."
8526
+ },
8527
+ "languageCode": {
8528
+ "type": "string",
8529
+ "description": "The form's own language as a BCP-47 tag (e.g. `pl-PL`). Stamped by\nthe build pipeline; settable at create and changeable by PATCH.\n\nIt is part of the RENDER FALLBACK CHAIN: the apply page tries the\ncandidate's locale, then this one, then `en-US`. Every label and\noption label must resolve somewhere in that chain - in this locale\nOR in `en-US`, not necessarily both. A form with no `languageCode`\nis held to `en-US` alone. Change it and the labels in the same\nPATCH; the new text is validated against the new chain."
8530
+ },
8531
+ "revision": {
8532
+ "type": "integer",
8533
+ "description": "Optimistic-concurrency token, bumped atomically on every write.\nSend it back as `If-Match: \"<revision>\"` on PATCH to make the\nwrite conditional; a mismatch is a 409 `SM_FORM_STALE`, meaning\nsomeone else saved since your read. Without the header the write\nis unconditional and the last writer wins - which for a form\nmeans silently replacing the whole field schema."
8534
+ },
8535
+ "publishedUrl": {
8536
+ "type": "string",
8537
+ "description": "Where the published document lives. Server-managed: the server\nowns the key it wrote, so never compose this URL client-side - a\nURL built from the wrong tenant shortCode is indistinguishable\nfrom a correct one."
8521
8538
  },
8522
8539
  "ttl": {
8523
8540
  "type": "string"
@@ -8638,7 +8655,24 @@
8638
8655
  "type": "string"
8639
8656
  },
8640
8657
  "content": {
8641
- "type": "string"
8658
+ "type": "string",
8659
+ "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."
8660
+ },
8661
+ "publish": {
8662
+ "type": "boolean",
8663
+ "description": "Publish transition. `true` mirrors `content` to the CDN and flips\nthe form to `active`, the state guest submission intake requires.\nSend it on the same PATCH that carries the edit, or on its own to\nrepublish what is already stored. Needs the recruiting tier or\nabove; publishing a form with no content is a 400."
8664
+ },
8665
+ "languageCode": {
8666
+ "type": "string",
8667
+ "description": "The form's own language as a BCP-47 tag (e.g. `pl-PL`). Stamped by\nthe build pipeline; settable at create and changeable by PATCH.\n\nIt is part of the RENDER FALLBACK CHAIN: the apply page tries the\ncandidate's locale, then this one, then `en-US`. Every label and\noption label must resolve somewhere in that chain - in this locale\nOR in `en-US`, not necessarily both. A form with no `languageCode`\nis held to `en-US` alone. Change it and the labels in the same\nPATCH; the new text is validated against the new chain."
8668
+ },
8669
+ "revision": {
8670
+ "type": "integer",
8671
+ "description": "Optimistic-concurrency token, bumped atomically on every write.\nSend it back as `If-Match: \"<revision>\"` on PATCH to make the\nwrite conditional; a mismatch is a 409 `SM_FORM_STALE`, meaning\nsomeone else saved since your read. Without the header the write\nis unconditional and the last writer wins - which for a form\nmeans silently replacing the whole field schema."
8672
+ },
8673
+ "publishedUrl": {
8674
+ "type": "string",
8675
+ "description": "Where the published document lives. Server-managed: the server\nowns the key it wrote, so never compose this URL client-side - a\nURL built from the wrong tenant shortCode is indistinguishable\nfrom a correct one."
8642
8676
  },
8643
8677
  "ttl": {
8644
8678
  "type": "string"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@smartytalent/mcp-tools",
3
- "version": "0.8.12",
3
+ "version": "0.8.14",
4
4
  "description": "MCP tool definitions for SmartyTalent API",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",