@snokam/mcp-api 2.50.0 → 2.53.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "2.50.0",
+  "version": "2.53.0",
   "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
   "type": "module",
   "bin": {

package/specs/production/events.json

@@ -1446,6 +1446,9 @@
             "type": "string",
             "default": "event"
           },
+          "allowDigitalParticipation": {
+            "type": "boolean"
+          },
           "askForFeedback": {
             "type": "boolean"
           },
@@ -1522,6 +1525,9 @@
           "slug": {
             "$ref": "#/components/schemas/slug"
           },
+          "teamsLink": {
+            "type": "string"
+          },
           "time": {
             "type": "string"
           },
@@ -1695,6 +1701,13 @@
           "invitationSent": {
             "type": "boolean",
             "nullable": true
+          },
+          "allowDigitalParticipation": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "teamsLink": {
+            "type": "string"
           }
         }
       },
@@ -1944,6 +1957,10 @@
             "default": "active",
             "nullable": true
           },
+          "allowDigitalParticipation": {
+            "type": "boolean",
+            "nullable": true
+          },
           "askForFeedback": {
             "type": "boolean",
             "nullable": true
@@ -2023,6 +2040,9 @@
           "slug": {
             "$ref": "#/components/schemas/slug"
           },
+          "teamsLink": {
+            "type": "string"
+          },
           "time": {
             "type": "string"
           },

package/specs/production/recruitment.json

@@ -318,6 +318,91 @@
         ]
       }
     },
+    "/v1.0/protected/candidates/{id}/onboard-full/stream": {
+      "post": {
+        "tags": [
+          "Candidates"
+        ],
+        "summary": "Run the onboarding chain with a live SSE event feed",
+        "description": "Same chain as /onboard-full but streams Server-Sent Events (`event: step`) as each step starts (`status:running`) and finishes (`succeeded`/`failed`). Closes with `event: done`. Frontend uses fetch streaming so we can pass a Bearer token; EventSource doesn't support custom headers.",
+        "operationId": "OnboardCandidateFullStream",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "No description",
+            "x-ms-summary": "SSE stream of OnboardingResult frames"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b9f9de6f-132f-4a9a-a583-e9054a46f2fa/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/candidates/{id}/onboard-full": {
+      "post": {
+        "tags": [
+          "Candidates"
+        ],
+        "summary": "Run the full automated onboarding chain",
+        "description": "Provisions the candidate's Microsoft 365 user, then triggers an Azure AD → Sanity sync to create the matching employee doc. Returns one OnboardingResult row per step so the admin UI can render a live timeline.",
+        "operationId": "OnboardCandidateFull",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Candidate Sanity id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Per-step results",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/onboardingResult"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b9f9de6f-132f-4a9a-a583-e9054a46f2fa/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/protected/candidates/{id}/reject": {
       "post": {
         "tags": [
@@ -991,6 +1076,9 @@
       "onboardingResult": {
         "type": "object",
         "properties": {
+          "step": {
+            "type": "string"
+          },
           "status": {
             "type": "string"
           },
@@ -1089,27 +1177,13 @@
             "type": "string",
             "default": "CREATED"
           },
-          "tShirtSize": {
-            "enum": [
-              "L",
-              "M",
-              "S",
-              "XL",
-              "XS",
-              "XXL"
-            ],
-            "type": "string",
-            "default": "L",
-            "nullable": true
-          },
           "track": {
             "enum": [
               "data_engineer",
               "developer"
             ],
             "type": "string",
-            "default": "data_engineer",
-            "nullable": true
+            "default": "data_engineer"
           },
           "address": {
             "$ref": "#/components/schemas/sanityCandidateAddress"
@@ -1138,6 +1212,9 @@
           "fromApplication": {
             "type": "boolean"
           },
+          "githubUsername": {
+            "type": "string"
+          },
           "grades": {
             "$ref": "#/components/schemas/sanityCandidateGrades"
           },
@@ -1658,19 +1735,6 @@
             "default": "CREATED",
             "nullable": true
           },
-          "tShirtSize": {
-            "enum": [
-              "XS",
-              "S",
-              "M",
-              "L",
-              "XL",
-              "XXL"
-            ],
-            "type": "string",
-            "default": "XS",
-            "nullable": true
-          },
           "track": {
             "enum": [
               "developer",
@@ -1708,6 +1772,9 @@
             "type": "boolean",
             "nullable": true
           },
+          "githubUsername": {
+            "type": "string"
+          },
           "grades": {
             "$ref": "#/components/schemas/sanityPatchCandidateApplicationLetter"
           },

package/specs/production/sanity.json

@@ -29794,6 +29794,9 @@
       },
       "SanityCandidate": {
         "properties": {
+          "githubUsername": {
+            "type": "string"
+          },
           "bankAccount": {
             "type": "string"
           },
@@ -30750,6 +30753,7 @@
           "grades",
           "cv",
           "applicationLetter",
+          "track",
           "status",
           "candidate",
           "sanityRev",
@@ -31101,6 +31105,10 @@
           "bankAccount": {
             "type": "string",
             "nullable": true
+          },
+          "githubUsername": {
+            "type": "string",
+            "nullable": true
           }
         },
         "type": "object",

package/specs/test/events.json

@@ -1446,6 +1446,9 @@
             "type": "string",
             "default": "event"
           },
+          "allowDigitalParticipation": {
+            "type": "boolean"
+          },
           "askForFeedback": {
             "type": "boolean"
           },
@@ -1522,6 +1525,9 @@
           "slug": {
             "$ref": "#/components/schemas/slug"
           },
+          "teamsLink": {
+            "type": "string"
+          },
           "time": {
             "type": "string"
           },
@@ -1695,6 +1701,13 @@
           "invitationSent": {
             "type": "boolean",
             "nullable": true
+          },
+          "allowDigitalParticipation": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "teamsLink": {
+            "type": "string"
           }
         }
       },
@@ -1944,6 +1957,10 @@
             "default": "active",
             "nullable": true
           },
+          "allowDigitalParticipation": {
+            "type": "boolean",
+            "nullable": true
+          },
           "askForFeedback": {
             "type": "boolean",
             "nullable": true
@@ -2023,6 +2040,9 @@
           "slug": {
             "$ref": "#/components/schemas/slug"
           },
+          "teamsLink": {
+            "type": "string"
+          },
           "time": {
             "type": "string"
           },

package/specs/test/recruitment.json

@@ -318,6 +318,91 @@
         ]
       }
     },
+    "/v1.0/protected/candidates/{id}/onboard-full/stream": {
+      "post": {
+        "tags": [
+          "Candidates"
+        ],
+        "summary": "Run the onboarding chain with a live SSE event feed",
+        "description": "Same chain as /onboard-full but streams Server-Sent Events (`event: step`) as each step starts (`status:running`) and finishes (`succeeded`/`failed`). Closes with `event: done`. Frontend uses fetch streaming so we can pass a Bearer token; EventSource doesn't support custom headers.",
+        "operationId": "OnboardCandidateFullStream",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "No description",
+            "x-ms-summary": "SSE stream of OnboardingResult frames"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/candidates/{id}/onboard-full": {
+      "post": {
+        "tags": [
+          "Candidates"
+        ],
+        "summary": "Run the full automated onboarding chain",
+        "description": "Provisions the candidate's Microsoft 365 user, then triggers an Azure AD → Sanity sync to create the matching employee doc. Returns one OnboardingResult row per step so the admin UI can render a live timeline.",
+        "operationId": "OnboardCandidateFull",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Candidate Sanity id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Per-step results",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/onboardingResult"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/protected/candidates/{id}/reject": {
       "post": {
         "tags": [
@@ -991,6 +1076,9 @@
       "onboardingResult": {
         "type": "object",
         "properties": {
+          "step": {
+            "type": "string"
+          },
           "status": {
             "type": "string"
           },
@@ -1089,27 +1177,13 @@
             "type": "string",
             "default": "CREATED"
           },
-          "tShirtSize": {
-            "enum": [
-              "L",
-              "M",
-              "S",
-              "XL",
-              "XS",
-              "XXL"
-            ],
-            "type": "string",
-            "default": "L",
-            "nullable": true
-          },
           "track": {
             "enum": [
               "data_engineer",
               "developer"
             ],
             "type": "string",
-            "default": "data_engineer",
-            "nullable": true
+            "default": "data_engineer"
           },
           "address": {
             "$ref": "#/components/schemas/sanityCandidateAddress"
@@ -1138,6 +1212,9 @@
           "fromApplication": {
             "type": "boolean"
           },
+          "githubUsername": {
+            "type": "string"
+          },
           "grades": {
             "$ref": "#/components/schemas/sanityCandidateGrades"
           },
@@ -1658,19 +1735,6 @@
             "default": "CREATED",
             "nullable": true
           },
-          "tShirtSize": {
-            "enum": [
-              "XS",
-              "S",
-              "M",
-              "L",
-              "XL",
-              "XXL"
-            ],
-            "type": "string",
-            "default": "XS",
-            "nullable": true
-          },
           "track": {
             "enum": [
               "developer",
@@ -1708,6 +1772,9 @@
             "type": "boolean",
             "nullable": true
           },
+          "githubUsername": {
+            "type": "string"
+          },
           "grades": {
             "$ref": "#/components/schemas/sanityPatchCandidateApplicationLetter"
           },

package/specs/test/sanity.json

@@ -24288,6 +24288,12 @@
             "type": "number",
             "format": "double"
           },
+          "teamsLink": {
+            "type": "string"
+          },
+          "allowDigitalParticipation": {
+            "type": "boolean"
+          },
           "place": {
             "type": "string"
           },
@@ -25922,6 +25928,12 @@
             "type": "number",
             "format": "double"
           },
+          "teamsLink": {
+            "type": "string"
+          },
+          "allowDigitalParticipation": {
+            "type": "boolean"
+          },
           "place": {
             "type": "string"
           },
@@ -26175,6 +26187,14 @@
             "type": "string",
             "nullable": true
           },
+          "allowDigitalParticipation": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "teamsLink": {
+            "type": "string",
+            "nullable": true
+          },
           "maxParticipants": {
             "type": "number",
             "format": "double",
@@ -29794,6 +29814,9 @@
       },
       "SanityCandidate": {
         "properties": {
+          "githubUsername": {
+            "type": "string"
+          },
           "bankAccount": {
             "type": "string"
           },
@@ -30750,6 +30773,7 @@
           "grades",
           "cv",
           "applicationLetter",
+          "track",
           "status",
           "candidate",
           "sanityRev",
@@ -31101,6 +31125,10 @@
           "bankAccount": {
             "type": "string",
             "nullable": true
+          },
+          "githubUsername": {
+            "type": "string",
+            "nullable": true
           }
         },
         "type": "object",