@snokam/mcp-api 2.38.0 → 2.40.0

package/package.json

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

package/specs/production/sales.json

@@ -3829,7 +3829,7 @@
       "sendTenderSlackMessageRequest": {
         "type": "object",
         "properties": {
-          "channelId": {
+          "employeeName": {
             "type": "string",
             "nullable": true
           },

package/specs/production/sanity.json

@@ -30436,6 +30436,13 @@
           "telephone": {
             "type": "string"
           },
+          "track": {
+            "type": "string",
+            "enum": [
+              "developer",
+              "data_engineer"
+            ]
+          },
           "fromApplication": {
             "type": "boolean"
           },
@@ -30580,6 +30587,15 @@
             "type": "boolean",
             "nullable": true
           },
+          "track": {
+            "type": "string",
+            "enum": [
+              "developer",
+              "data_engineer",
+              null
+            ],
+            "nullable": true
+          },
           "applicationLetter": {
             "properties": {
               "sanityType": {
@@ -50005,21 +50021,22 @@
         }
       }
     },
-    "/v1.0/articles/author/{employeeId}": {
+    "/v1.0/articles/drafts": {
       "get": {
-        "operationId": "GetArticlesByAuthor",
+        "operationId": "GetDraftOnlyArticles",
         "responses": {
           "200": {
             "description": "Ok",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetArticlesByAuthorResult"
+                  "$ref": "#/components/schemas/GetArticlesResult"
                 }
               }
             }
           }
         },
+        "description": "Drafts with no published counterpart. Used by the admin list so\nauthors can resume unfinished articles. Same projection as\n`GetArticles`, so the list UI can render both uniformly and only\ntag the draft rows with an \"Utkast\" badge.\n\nDedup is done here (not in GROQ): strip the 7-char `drafts.`\nprefix from each draft's _id and filter out any that have a\nmatching document in the published set.",
         "tags": [
           "Articles"
         ],
@@ -50031,20 +50048,12 @@
           }
         ],
         "parameters": [
-          {
-            "in": "path",
-            "name": "employeeId",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          },
           {
             "in": "query",
             "name": "useCache",
             "required": false,
             "schema": {
-              "default": true,
+              "default": false,
               "type": "boolean"
             }
           },
@@ -50058,24 +50067,60 @@
             }
           }
         ]
+      },
+      "post": {
+        "operationId": "CreateDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Create a brand-new article as a draft. Returns the created\ndraft document (its `sanityId` carries the `drafts.` prefix).\nAuthors use this from the \"New article\" flow so nothing goes\nlive until they press publish.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityCreateArticle"
+              }
+            }
+          }
+        }
       }
     },
-    "/v1.0/articles/{slugOrId}/draft-status": {
+    "/v1.0/articles/author/{employeeId}": {
       "get": {
-        "operationId": "GetArticleWithDraft",
+        "operationId": "GetArticlesByAuthor",
         "responses": {
           "200": {
             "description": "Ok",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetArticleWithDraftResult"
+                  "$ref": "#/components/schemas/GetArticlesByAuthorResult"
                 }
               }
             }
           }
         },
-        "description": "Read both states at once. Returns all `null`s if neither exists.\nAccepts a published id or a slug; draft lookup is by id, so we\nresolve slug→id via the published GROQ query first. Brand-new\ndrafts (no published counterpart) can be fetched by passing the\nbare `drafts.<id>` form or the plain `<id>` half — the handler\ntries both.",
         "tags": [
           "Articles"
         ],
@@ -50089,31 +50134,49 @@
         "parameters": [
           {
             "in": "path",
-            "name": "slugOrId",
+            "name": "employeeId",
             "required": true,
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "in": "query",
+            "name": "useCache",
+            "required": false,
+            "schema": {
+              "default": true,
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "useCdn",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
           }
         ]
       }
     },
-    "/v1.0/articles/drafts": {
-      "post": {
-        "operationId": "CreateDraft",
+    "/v1.0/articles/{slugOrId}/draft-status": {
+      "get": {
+        "operationId": "GetArticleWithDraft",
         "responses": {
           "200": {
             "description": "Ok",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                  "$ref": "#/components/schemas/GetArticleWithDraftResult"
                 }
               }
             }
           }
         },
-        "description": "Create a brand-new article as a draft. Returns the created\ndraft document (its `sanityId` carries the `drafts.` prefix).\nAuthors use this from the \"New article\" flow so nothing goes\nlive until they press publish.",
+        "description": "Read both states at once. Returns all `null`s if neither exists.\nAccepts a published id or a slug; draft lookup is by id, so we\nresolve slug→id via the published GROQ query first. Brand-new\ndrafts (no published counterpart) can be fetched by passing the\nbare `drafts.<id>` form or the plain `<id>` half — the handler\ntries both.",
         "tags": [
           "Articles"
         ],
@@ -50124,17 +50187,16 @@
             ]
           }
         ],
-        "parameters": [],
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/SanityCreateArticle"
-              }
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
             }
           }
-        }
+        ]
       }
     },
     "/v1.0/articles/{slugOrId}/draft": {

package/specs/test/sales.json

@@ -3829,7 +3829,7 @@
       "sendTenderSlackMessageRequest": {
         "type": "object",
         "properties": {
-          "channelId": {
+          "employeeName": {
             "type": "string",
             "nullable": true
           },

package/specs/test/sanity.json

@@ -30436,6 +30436,13 @@
           "telephone": {
             "type": "string"
           },
+          "track": {
+            "type": "string",
+            "enum": [
+              "developer",
+              "data_engineer"
+            ]
+          },
           "fromApplication": {
             "type": "boolean"
           },
@@ -30580,6 +30587,15 @@
             "type": "boolean",
             "nullable": true
           },
+          "track": {
+            "type": "string",
+            "enum": [
+              "developer",
+              "data_engineer",
+              null
+            ],
+            "nullable": true
+          },
           "applicationLetter": {
             "properties": {
               "sanityType": {
@@ -50005,21 +50021,22 @@
         }
       }
     },
-    "/v1.0/articles/author/{employeeId}": {
+    "/v1.0/articles/drafts": {
       "get": {
-        "operationId": "GetArticlesByAuthor",
+        "operationId": "GetDraftOnlyArticles",
         "responses": {
           "200": {
             "description": "Ok",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetArticlesByAuthorResult"
+                  "$ref": "#/components/schemas/GetArticlesResult"
                 }
               }
             }
           }
         },
+        "description": "Drafts with no published counterpart. Used by the admin list so\nauthors can resume unfinished articles. Same projection as\n`GetArticles`, so the list UI can render both uniformly and only\ntag the draft rows with an \"Utkast\" badge.\n\nDedup is done here (not in GROQ): strip the 7-char `drafts.`\nprefix from each draft's _id and filter out any that have a\nmatching document in the published set.",
         "tags": [
           "Articles"
         ],
@@ -50031,20 +50048,12 @@
           }
         ],
         "parameters": [
-          {
-            "in": "path",
-            "name": "employeeId",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          },
           {
             "in": "query",
             "name": "useCache",
             "required": false,
             "schema": {
-              "default": true,
+              "default": false,
               "type": "boolean"
             }
           },
@@ -50058,24 +50067,60 @@
             }
           }
         ]
+      },
+      "post": {
+        "operationId": "CreateDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Create a brand-new article as a draft. Returns the created\ndraft document (its `sanityId` carries the `drafts.` prefix).\nAuthors use this from the \"New article\" flow so nothing goes\nlive until they press publish.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityCreateArticle"
+              }
+            }
+          }
+        }
       }
     },
-    "/v1.0/articles/{slugOrId}/draft-status": {
+    "/v1.0/articles/author/{employeeId}": {
       "get": {
-        "operationId": "GetArticleWithDraft",
+        "operationId": "GetArticlesByAuthor",
         "responses": {
           "200": {
             "description": "Ok",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetArticleWithDraftResult"
+                  "$ref": "#/components/schemas/GetArticlesByAuthorResult"
                 }
               }
             }
           }
         },
-        "description": "Read both states at once. Returns all `null`s if neither exists.\nAccepts a published id or a slug; draft lookup is by id, so we\nresolve slug→id via the published GROQ query first. Brand-new\ndrafts (no published counterpart) can be fetched by passing the\nbare `drafts.<id>` form or the plain `<id>` half — the handler\ntries both.",
         "tags": [
           "Articles"
         ],
@@ -50089,31 +50134,49 @@
         "parameters": [
           {
             "in": "path",
-            "name": "slugOrId",
+            "name": "employeeId",
             "required": true,
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "in": "query",
+            "name": "useCache",
+            "required": false,
+            "schema": {
+              "default": true,
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "useCdn",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
           }
         ]
       }
     },
-    "/v1.0/articles/drafts": {
-      "post": {
-        "operationId": "CreateDraft",
+    "/v1.0/articles/{slugOrId}/draft-status": {
+      "get": {
+        "operationId": "GetArticleWithDraft",
         "responses": {
           "200": {
             "description": "Ok",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                  "$ref": "#/components/schemas/GetArticleWithDraftResult"
                 }
               }
             }
           }
         },
-        "description": "Create a brand-new article as a draft. Returns the created\ndraft document (its `sanityId` carries the `drafts.` prefix).\nAuthors use this from the \"New article\" flow so nothing goes\nlive until they press publish.",
+        "description": "Read both states at once. Returns all `null`s if neither exists.\nAccepts a published id or a slug; draft lookup is by id, so we\nresolve slug→id via the published GROQ query first. Brand-new\ndrafts (no published counterpart) can be fetched by passing the\nbare `drafts.<id>` form or the plain `<id>` half — the handler\ntries both.",
         "tags": [
           "Articles"
         ],
@@ -50124,17 +50187,16 @@
             ]
           }
         ],
-        "parameters": [],
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/SanityCreateArticle"
-              }
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
             }
           }
-        }
+        ]
       }
     },
     "/v1.0/articles/{slugOrId}/draft": {