@smartytalent/mcp-tools 0.9.36 → 0.9.38

package/dist/tools.json

@@ -187,7 +187,7 @@
                     },
                     "operation": {
                       "type": "object",
-                      "description": "Tenant-level outbound-sync defaults (ATS integrations): {syncStage, syncNotes, syncRatings, syncTags, syncReports, syncConversationReports, syncMessages} - overridden per job by job.settings.operation. NOTE: the generated model whitelists keys, so this property MUST be declared for the SDK to carry it."
+                      "description": "DEPRECATED (2026-09-24, PLAN_BOE_CONNECTIONS): ignored by the backend and stripped on write. The ATS sync defaults live on the virtual employee's connection (POST /v1/users/{boeUserId}/connections/{ats}) and a recruitment project overrides them in job.connections; no tenant row ever carried this block and nothing reads it. Removed in a later, breaking release; declared until then because the generated model whitelists keys."
                     },
                     "feedback": {
                       "title": "TenantAttributesSettingsFeedbackSchema",
@@ -763,7 +763,7 @@
                     },
                     "operation": {
                       "type": "object",
-                      "description": "Tenant-level outbound-sync defaults (ATS integrations): {syncStage, syncNotes, syncRatings, syncTags, syncReports, syncConversationReports, syncMessages} - overridden per job by job.settings.operation. NOTE: the generated model whitelists keys, so this property MUST be declared for the SDK to carry it."
+                      "description": "DEPRECATED (2026-09-24, PLAN_BOE_CONNECTIONS): ignored by the backend and stripped on write. The ATS sync defaults live on the virtual employee's connection (POST /v1/users/{boeUserId}/connections/{ats}) and a recruitment project overrides them in job.connections; no tenant row ever carried this block and nothing reads it. Removed in a later, breaking release; declared until then because the generated model whitelists keys."
                     },
                     "feedback": {
                       "title": "TenantAttributesSettingsFeedbackSchema",
@@ -1878,7 +1878,8 @@
                 },
                 "connections": {
                   "type": "object",
-                  "additionalProperties": true
+                  "additionalProperties": true,
+                  "description": "READ-ONLY since 2026-09-24 (PLAN_BOE_CONNECTIONS): the virtual employee's connections map as stored (secret references and the entries' defaults; `self` = the Boe's own API key reference). A non-empty `connections` on POST / PATCH /v1/users is a 400 with code SM_ERROR_CONNECTIONS_DOOR: connections are managed through GET/POST/PATCH/DELETE /v1/users/{userId}/connections/{integrationId}, which tests the credentials before storing them. The raw map leaves the wire in a later, breaking release; read the door's listing instead."
                 },
                 "identities": {
                   "type": "array",
@@ -2225,7 +2226,8 @@
                 },
                 "connections": {
                   "type": "object",
-                  "additionalProperties": true
+                  "additionalProperties": true,
+                  "description": "READ-ONLY since 2026-09-24 (PLAN_BOE_CONNECTIONS): the virtual employee's connections map as stored (secret references and the entries' defaults; `self` = the Boe's own API key reference). A non-empty `connections` on POST / PATCH /v1/users is a 400 with code SM_ERROR_CONNECTIONS_DOOR: connections are managed through GET/POST/PATCH/DELETE /v1/users/{userId}/connections/{integrationId}, which tests the credentials before storing them. The raw map leaves the wire in a later, breaking release; read the door's listing instead."
                 },
                 "identities": {
                   "type": "array",
@@ -2830,6 +2832,204 @@
       "operationId": "userIdentityOptions"
     }
   },
+  {
+    "name": "list_integrations",
+    "description": "List Integrations",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "GET",
+      "path": "/v1/integrations",
+      "operationId": "listIntegrations"
+    }
+  },
+  {
+    "name": "integrations_options",
+    "description": "Integrations Options",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "OPTIONS",
+      "path": "/v1/integrations",
+      "operationId": "integrationsOptions"
+    }
+  },
+  {
+    "name": "list_user_connections",
+    "description": "List The Virtual Employee's Connections",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "GET",
+      "path": "/v1/users/{userId}/connections",
+      "operationId": "listUserConnections"
+    }
+  },
+  {
+    "name": "user_connections_options",
+    "description": "User Connections Options",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "OPTIONS",
+      "path": "/v1/users/{userId}/connections",
+      "operationId": "userConnectionsOptions"
+    }
+  },
+  {
+    "name": "create_user_connection",
+    "description": "Connect An Integration",
+    "inputSchema": {
+      "title": "UserConnectionRequestSchema",
+      "type": "object",
+      "description": "POST: `values` (the credential fields of the catalogue's connection schema) plus the default flags of an ATS or `default` of a job board. PATCH: the flags / `default` only (a flag sent as null clears it). Unknown keys are a 400.",
+      "properties": {
+        "data": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string"
+            },
+            "attributes": {
+              "title": "UserConnectionRequestAttributesSchema",
+              "type": "object",
+              "properties": {
+                "values": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "description": "The credential fields named by the catalogue (eRecruiter: accessKey; Teamtailor: apiKey, signatureKey, stackHost, companyUuid, reviewUserId). POST only; write-only, never echoed."
+                },
+                "default": {
+                  "type": "boolean",
+                  "description": "Job boards only."
+                },
+                "syncStage": {
+                  "type": "boolean"
+                },
+                "syncNotes": {
+                  "type": "boolean"
+                },
+                "syncRatings": {
+                  "type": "boolean"
+                },
+                "syncTags": {
+                  "type": "boolean"
+                },
+                "syncReports": {
+                  "type": "boolean"
+                },
+                "syncConversationReports": {
+                  "type": "boolean"
+                },
+                "syncMessages": {
+                  "type": "boolean"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "_meta": {
+      "method": "POST",
+      "path": "/v1/users/{userId}/connections/{integrationId}",
+      "operationId": "createUserConnection"
+    }
+  },
+  {
+    "name": "update_user_connection",
+    "description": "Update A Connection's Defaults",
+    "inputSchema": {
+      "title": "UserConnectionRequestSchema",
+      "type": "object",
+      "description": "POST: `values` (the credential fields of the catalogue's connection schema) plus the default flags of an ATS or `default` of a job board. PATCH: the flags / `default` only (a flag sent as null clears it). Unknown keys are a 400.",
+      "properties": {
+        "data": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string"
+            },
+            "attributes": {
+              "title": "UserConnectionRequestAttributesSchema",
+              "type": "object",
+              "properties": {
+                "values": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "description": "The credential fields named by the catalogue (eRecruiter: accessKey; Teamtailor: apiKey, signatureKey, stackHost, companyUuid, reviewUserId). POST only; write-only, never echoed."
+                },
+                "default": {
+                  "type": "boolean",
+                  "description": "Job boards only."
+                },
+                "syncStage": {
+                  "type": "boolean"
+                },
+                "syncNotes": {
+                  "type": "boolean"
+                },
+                "syncRatings": {
+                  "type": "boolean"
+                },
+                "syncTags": {
+                  "type": "boolean"
+                },
+                "syncReports": {
+                  "type": "boolean"
+                },
+                "syncConversationReports": {
+                  "type": "boolean"
+                },
+                "syncMessages": {
+                  "type": "boolean"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "_meta": {
+      "method": "PATCH",
+      "path": "/v1/users/{userId}/connections/{integrationId}",
+      "operationId": "updateUserConnection"
+    }
+  },
+  {
+    "name": "delete_user_connection",
+    "description": "Disconnect An Integration",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "DELETE",
+      "path": "/v1/users/{userId}/connections/{integrationId}",
+      "operationId": "deleteUserConnection"
+    }
+  },
+  {
+    "name": "user_connection_options",
+    "description": "User Connection Options",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "_meta": {
+      "method": "OPTIONS",
+      "path": "/v1/users/{userId}/connections/{integrationId}",
+      "operationId": "userConnectionOptions"
+    }
+  },
   {
     "name": "create_user_invitation",
     "description": "Resend User Invitation",
@@ -5275,6 +5475,14 @@
                     }
                   }
                 },
+                "connections": {
+                  "title": "JobAttributesConnectionsSchema",
+                  "type": "object",
+                  "description": "The recruitment project's LINKS to the external systems its virtual employee is connected to (PLAN_BOE_CONNECTIONS, 2026-09-24), a flat map keyed by the integration id of GET /v1/integrations. An ATS entry carries ONLY overrides of the sync-flag defaults stored on the Boe's connection (WHETHER a candidate syncs is decided by the candidate's source and the Boe's connection, never here; a project that wants nothing synced sets every flag to false). A job-board entry carries `enabled`, the override of the Boe entry's `default`, read once when the ad is built (no rebuild). A top-level attribute on purpose, not part of settings: its own validation (400 naming the key; an ATS entry with `enabled`, a job-board entry with a flag, an ATS the Boe has not connected, `apply`), its own PER-KEY merge on PATCH (a key sent as null clears the override, an entry sent as null clears the entry) and its own writer gate (sysowner / owner / admin / recops, 403 below); the AI build never touches it.",
+                  "additionalProperties": {
+                    "$ref": "#/components/schemas/JobConnectionSchema"
+                  }
+                },
                 "settings": {
                   "title": "JobAttributesSettingsSchema",
                   "type": "object",
@@ -5370,6 +5578,7 @@
                     "operation": {
                       "title": "JobAttributesSettingsOperationSchema",
                       "type": "object",
+                      "description": "DEPRECATED (2026-09-24, PLAN_BOE_CONNECTIONS): the ATS sync flags moved to the top-level `connections.<ats>` of the job (overrides per ATS) with their defaults on the virtual employee's connection. Still writable per key and read through ONLY for a flag the job's ATS entry does not carry (changeStage -> syncStage, createNote -> syncNotes, createRate -> syncRatings, createTag -> syncTags, createConversationReport -> syncConversationReports); the AI build no longer generates it. Removed in a later, breaking release.",
                       "properties": {
                         "changeStage": {
                           "type": "boolean"
@@ -6175,6 +6384,14 @@
                     }
                   }
                 },
+                "connections": {
+                  "title": "JobAttributesConnectionsSchema",
+                  "type": "object",
+                  "description": "The recruitment project's LINKS to the external systems its virtual employee is connected to (PLAN_BOE_CONNECTIONS, 2026-09-24), a flat map keyed by the integration id of GET /v1/integrations. An ATS entry carries ONLY overrides of the sync-flag defaults stored on the Boe's connection (WHETHER a candidate syncs is decided by the candidate's source and the Boe's connection, never here; a project that wants nothing synced sets every flag to false). A job-board entry carries `enabled`, the override of the Boe entry's `default`, read once when the ad is built (no rebuild). A top-level attribute on purpose, not part of settings: its own validation (400 naming the key; an ATS entry with `enabled`, a job-board entry with a flag, an ATS the Boe has not connected, `apply`), its own PER-KEY merge on PATCH (a key sent as null clears the override, an entry sent as null clears the entry) and its own writer gate (sysowner / owner / admin / recops, 403 below); the AI build never touches it.",
+                  "additionalProperties": {
+                    "$ref": "#/components/schemas/JobConnectionSchema"
+                  }
+                },
                 "settings": {
                   "title": "JobAttributesSettingsSchema",
                   "type": "object",
@@ -6270,6 +6487,7 @@
                     "operation": {
                       "title": "JobAttributesSettingsOperationSchema",
                       "type": "object",
+                      "description": "DEPRECATED (2026-09-24, PLAN_BOE_CONNECTIONS): the ATS sync flags moved to the top-level `connections.<ats>` of the job (overrides per ATS) with their defaults on the virtual employee's connection. Still writable per key and read through ONLY for a flag the job's ATS entry does not carry (changeStage -> syncStage, createNote -> syncNotes, createRate -> syncRatings, createTag -> syncTags, createConversationReport -> syncConversationReports); the AI build no longer generates it. Removed in a later, breaking release.",
                       "properties": {
                         "changeStage": {
                           "type": "boolean"
@@ -22474,7 +22692,7 @@
       "properties": {
         "filterStatus": {
           "type": "string",
-          "description": "Returns reports with the given status. Pass it explicitly - the backend applies NO default, so without it pending and failed rows come back too. The report app's history query is `filterStatus=active&sort=-created` (newest first; the status index carries the sort). One filter at a time: the backend serves a single index per request.",
+          "description": "Returns reports with the given status. Pass it explicitly - the backend applies NO default, so without it pending and failed rows come back too. The report app's history query is `filterStatus=active&sort=-created&pageNumber=1` (newest first): the sort is honoured next to filterStatus ONLY with page-number pagination (`pageNumber`); the cursor pagination (`pageAfter` / `pageBefore`, the default without pageNumber) keeps the index order and ignores `sort` (measured on dev03 2026-09-24). One filter at a time: the backend serves a single index per request.",
           "enum": [
             "active",
             "inactive",
@@ -22489,7 +22707,7 @@
         },
         "sort": {
           "type": "string",
-          "description": "`created` / `-created` / `modified` / `-modified`. Honoured alone and next to filterStatus; ignored next to filterResourceId (index order) and the date windows keep their own index order."
+          "description": "`created` / `-created` / `modified` / `-modified`. Honoured alone (any pagination) and next to filterStatus with page-number pagination only (`pageNumber`; the cursor pagination ignores it there); ignored next to filterResourceId (index order); the date windows keep their own index order."
         },
         "filterCreatedFrom": {
           "type": "string",
@@ -22587,12 +22805,14 @@
                   ]
                 },
                 "reportContent": {
-                  "type": "string",
-                  "description": "Merged analytics and AI analysis content"
+                  "type": "object",
+                  "additionalProperties": true,
+                  "description": "Merged analytics and AI analysis content, an OBJECT (declared as a string until 2026-09-24): keyed by locale for a non-English tenant (`en-US` + the tenant language, each holding the sections kpis / alerts / notes / insights / dailyData / topJobs / ...), the sections directly at the top level for an en-US tenant; `{}` while the row is pending."
                 },
                 "settings": {
-                  "type": "string",
-                  "description": "The analysis window the broker stamps at creation (startDate, endDate, reportPeriod, displayName and the period's own fields such as isoWeek or monthName). Since 2026-09-24 (PLAN_TENANT_SETTINGS_CLEANUP) no `emails`: reports are downloaded in the report app, not mailed."
+                  "type": "object",
+                  "additionalProperties": true,
+                  "description": "The analysis window the broker stamps at creation, an OBJECT (declared as a string until 2026-09-24): startDate, endDate (naive calendar stamps `YYYY-MM-DD HH:MM:SS`), reportPeriod, displayName and the period's own fields (day / month / year, isoWeek / isoYear / dateRange, monthName / daysCount). Since 2026-09-24 (PLAN_TENANT_SETTINGS_CLEANUP) no `emails`: reports are downloaded in the report app, not mailed."
                 },
                 "shortCode": {
                   "type": "string",
@@ -22614,8 +22834,9 @@
                   ]
                 },
                 "ttl": {
-                  "type": "string",
-                  "description": "Time-to-live value for automatic report expiration"
+                  "type": "integer",
+                  "format": "int64",
+                  "description": "Epoch seconds at which DynamoDB expires the row (an INTEGER, declared as a string until 2026-09-24): created + 400 days on every scheduled report since 2026-09-24; null on rows born before that."
                 },
                 "timestamps": {
                   "title": "ResourceTimestampsSchema",
@@ -22754,12 +22975,14 @@
                   ]
                 },
                 "reportContent": {
-                  "type": "string",
-                  "description": "Merged analytics and AI analysis content"
+                  "type": "object",
+                  "additionalProperties": true,
+                  "description": "Merged analytics and AI analysis content, an OBJECT (declared as a string until 2026-09-24): keyed by locale for a non-English tenant (`en-US` + the tenant language, each holding the sections kpis / alerts / notes / insights / dailyData / topJobs / ...), the sections directly at the top level for an en-US tenant; `{}` while the row is pending."
                 },
                 "settings": {
-                  "type": "string",
-                  "description": "The analysis window the broker stamps at creation (startDate, endDate, reportPeriod, displayName and the period's own fields such as isoWeek or monthName). Since 2026-09-24 (PLAN_TENANT_SETTINGS_CLEANUP) no `emails`: reports are downloaded in the report app, not mailed."
+                  "type": "object",
+                  "additionalProperties": true,
+                  "description": "The analysis window the broker stamps at creation, an OBJECT (declared as a string until 2026-09-24): startDate, endDate (naive calendar stamps `YYYY-MM-DD HH:MM:SS`), reportPeriod, displayName and the period's own fields (day / month / year, isoWeek / isoYear / dateRange, monthName / daysCount). Since 2026-09-24 (PLAN_TENANT_SETTINGS_CLEANUP) no `emails`: reports are downloaded in the report app, not mailed."
                 },
                 "shortCode": {
                   "type": "string",
@@ -22781,8 +23004,9 @@
                   ]
                 },
                 "ttl": {
-                  "type": "string",
-                  "description": "Time-to-live value for automatic report expiration"
+                  "type": "integer",
+                  "format": "int64",
+                  "description": "Epoch seconds at which DynamoDB expires the row (an INTEGER, declared as a string until 2026-09-24): created + 400 days on every scheduled report since 2026-09-24; null on rows born before that."
                 },
                 "timestamps": {
                   "title": "ResourceTimestampsSchema",
@@ -23000,7 +23224,36 @@
                   }
                 },
                 "settings": {
-                  "type": "object"
+                  "title": "AdAttributesSettingsSchema",
+                  "type": "object",
+                  "description": "The build snapshot (PLAN_BOE_CONNECTIONS, 2026-09-24): which job boards this ad was built for and why. Written by the pipeline's finalize, never by a client; a platform switched on or off AFTER the build changes nothing here (no rebuild in this version).",
+                  "properties": {
+                    "platforms": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "The job-board ids the ad targets (catalogue order); the apply page is always built and not listed."
+                    },
+                    "sources": {
+                      "type": "object",
+                      "description": "Per job board of the catalogue: job (the job's connections entry decided) | boe (the Boe entry's default decided) | default (the Boe carries no job-board entry, every platform is built)."
+                    },
+                    "imageVariants": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "The master images rendered: landscape always, square only when a chosen platform crops from it (linkedin, olx)."
+                    },
+                    "exports": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "The crop exports produced: the apply trio (apply, apply_card, apply_share) plus the chosen platforms' exports."
+                    }
+                  }
                 },
                 "timestamps": {
                   "title": "ResourceTimestampsSchema",
@@ -23188,7 +23441,36 @@
                   }
                 },
                 "settings": {
-                  "type": "object"
+                  "title": "AdAttributesSettingsSchema",
+                  "type": "object",
+                  "description": "The build snapshot (PLAN_BOE_CONNECTIONS, 2026-09-24): which job boards this ad was built for and why. Written by the pipeline's finalize, never by a client; a platform switched on or off AFTER the build changes nothing here (no rebuild in this version).",
+                  "properties": {
+                    "platforms": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "The job-board ids the ad targets (catalogue order); the apply page is always built and not listed."
+                    },
+                    "sources": {
+                      "type": "object",
+                      "description": "Per job board of the catalogue: job (the job's connections entry decided) | boe (the Boe entry's default decided) | default (the Boe carries no job-board entry, every platform is built)."
+                    },
+                    "imageVariants": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "The master images rendered: landscape always, square only when a chosen platform crops from it (linkedin, olx)."
+                    },
+                    "exports": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "The crop exports produced: the apply trio (apply, apply_card, apply_share) plus the chosen platforms' exports."
+                    }
+                  }
                 },
                 "timestamps": {
                   "title": "ResourceTimestampsSchema",

package/package.json

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