@smartytalent/openai-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",
@@ -757,7 +757,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",
@@ -1832,7 +1832,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",
@@ -2173,7 +2174,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",
@@ -2730,6 +2732,188 @@
       }
     }
   },
+  {
+    "type": "function",
+    "function": {
+      "name": "list_integrations",
+      "description": "List Integrations",
+      "parameters": {
+        "type": "object",
+        "properties": {}
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "integrations_options",
+      "description": "Integrations Options",
+      "parameters": {
+        "type": "object",
+        "properties": {}
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "list_user_connections",
+      "description": "List The Virtual Employee's Connections",
+      "parameters": {
+        "type": "object",
+        "properties": {}
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "user_connections_options",
+      "description": "User Connections Options",
+      "parameters": {
+        "type": "object",
+        "properties": {}
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "create_user_connection",
+      "description": "Connect An Integration",
+      "parameters": {
+        "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"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "update_user_connection",
+      "description": "Update A Connection's Defaults",
+      "parameters": {
+        "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"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "delete_user_connection",
+      "description": "Disconnect An Integration",
+      "parameters": {
+        "type": "object",
+        "properties": {}
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "user_connection_options",
+      "description": "User Connection Options",
+      "parameters": {
+        "type": "object",
+        "properties": {}
+      }
+    }
+  },
   {
     "type": "function",
     "function": {
@@ -5109,6 +5293,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",
@@ -5204,6 +5396,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"
@@ -6003,6 +6196,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",
@@ -6098,6 +6299,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"
@@ -21864,7 +22066,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",
@@ -21879,7 +22081,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",
@@ -21975,12 +22177,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",
@@ -22002,8 +22206,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",
@@ -22136,12 +22341,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",
@@ -22163,8 +22370,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",
@@ -22374,7 +22582,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",
@@ -22556,7 +22793,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/openai-tools",
-  "version": "0.9.36",
+  "version": "0.9.38",
   "description": "OpenAI function/tool definitions for SmartyTalent API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",