@snokam/mcp-api 2.38.0 → 2.42.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "2.38.0",
+  "version": "2.42.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": {
@@ -49838,6 +49854,7 @@
             }
           }
         },
+        "description": "Returns the published article list.\n\n`includeInactive=true` drops the `active == true` filter so\nadmins can see articles they've taken offline (\"Ikke live\").\nCallers decide whether to request it based on the viewer's\nsession — the public blog route leaves it false, admin routes\npass true.",
         "tags": [
           "Articles"
         ],
@@ -49866,6 +49883,15 @@
               "default": false,
               "type": "boolean"
             }
+          },
+          {
+            "in": "query",
+            "name": "includeInactive",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
           }
         ]
       }
@@ -49920,6 +49946,7 @@
             }
           }
         },
+        "description": "Single published article by slug or id.\n\n`includeInactive=true` removes the `active == true` requirement\nfrom the slug-match path so admins can open \"Ikke live\"\narticles by URL. Without it, slug lookups only return live\narticles (public behaviour). Id lookups are unaffected either\nway — if the caller already knows the sanity id, active is\nimmaterial.",
         "tags": [
           "Articles"
         ],
@@ -49956,6 +49983,15 @@
               "default": false,
               "type": "boolean"
             }
+          },
+          {
+            "in": "query",
+            "name": "includeInactive",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
           }
         ]
       },
@@ -50005,21 +50041,22 @@
         }
       }
     },
-    "/v1.0/articles/author/{employeeId}": {
+    "/v1.0/articles/all": {
       "get": {
-        "operationId": "GetArticlesByAuthor",
+        "operationId": "GetAllPublishedArticles",
         "responses": {
           "200": {
             "description": "Ok",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetArticlesByAuthorResult"
+                  "$ref": "#/components/schemas/GetArticlesResult"
                 }
               }
             }
           }
         },
+        "description": "Every published article regardless of the `active` flag. Used by\nthe admin list so editors can see articles they've taken offline\n(\"Ikke live\"). Public callers should stay on `GetArticles`,\nwhich filters to `active == true`.",
         "tags": [
           "Articles"
         ],
@@ -50031,20 +50068,12 @@
           }
         ],
         "parameters": [
-          {
-            "in": "path",
-            "name": "employeeId",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          },
           {
             "in": "query",
             "name": "useCache",
             "required": false,
             "schema": {
-              "default": true,
+              "default": false,
               "type": "boolean"
             }
           },
@@ -50060,22 +50089,22 @@
         ]
       }
     },
-    "/v1.0/articles/{slugOrId}/draft-status": {
+    "/v1.0/articles/drafts": {
       "get": {
-        "operationId": "GetArticleWithDraft",
+        "operationId": "GetDraftOnlyArticles",
         "responses": {
           "200": {
             "description": "Ok",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetArticleWithDraftResult"
+                  "$ref": "#/components/schemas/GetArticlesResult"
                 }
               }
             }
           }
         },
-        "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.",
+        "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"
         ],
@@ -50088,17 +50117,25 @@
         ],
         "parameters": [
           {
-            "in": "path",
-            "name": "slugOrId",
-            "required": true,
+            "in": "query",
+            "name": "useCache",
+            "required": false,
             "schema": {
-              "type": "string"
+              "default": false,
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "useCdn",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
             }
           }
         ]
-      }
-    },
-    "/v1.0/articles/drafts": {
+      },
       "post": {
         "operationId": "CreateDraft",
         "responses": {
@@ -50137,6 +50174,99 @@
         }
       }
     },
+    "/v1.0/articles/author/{employeeId}": {
+      "get": {
+        "operationId": "GetArticlesByAuthor",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesByAuthorResult"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "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/{slugOrId}/draft-status": {
+      "get": {
+        "operationId": "GetArticleWithDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticleWithDraftResult"
+                }
+              }
+            }
+          }
+        },
+        "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"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
+      }
+    },
     "/v1.0/articles/{slugOrId}/draft": {
       "patch": {
         "operationId": "PatchDraft",

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": {
@@ -49838,6 +49854,7 @@
             }
           }
         },
+        "description": "Returns the published article list.\n\n`includeInactive=true` drops the `active == true` filter so\nadmins can see articles they've taken offline (\"Ikke live\").\nCallers decide whether to request it based on the viewer's\nsession — the public blog route leaves it false, admin routes\npass true.",
         "tags": [
           "Articles"
         ],
@@ -49866,6 +49883,15 @@
               "default": false,
               "type": "boolean"
             }
+          },
+          {
+            "in": "query",
+            "name": "includeInactive",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
           }
         ]
       }
@@ -49920,6 +49946,7 @@
             }
           }
         },
+        "description": "Single published article by slug or id.\n\n`includeInactive=true` removes the `active == true` requirement\nfrom the slug-match path so admins can open \"Ikke live\"\narticles by URL. Without it, slug lookups only return live\narticles (public behaviour). Id lookups are unaffected either\nway — if the caller already knows the sanity id, active is\nimmaterial.",
         "tags": [
           "Articles"
         ],
@@ -49956,6 +49983,15 @@
               "default": false,
               "type": "boolean"
             }
+          },
+          {
+            "in": "query",
+            "name": "includeInactive",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
           }
         ]
       },
@@ -50005,21 +50041,22 @@
         }
       }
     },
-    "/v1.0/articles/author/{employeeId}": {
+    "/v1.0/articles/all": {
       "get": {
-        "operationId": "GetArticlesByAuthor",
+        "operationId": "GetAllPublishedArticles",
         "responses": {
           "200": {
             "description": "Ok",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetArticlesByAuthorResult"
+                  "$ref": "#/components/schemas/GetArticlesResult"
                 }
               }
             }
           }
         },
+        "description": "Every published article regardless of the `active` flag. Used by\nthe admin list so editors can see articles they've taken offline\n(\"Ikke live\"). Public callers should stay on `GetArticles`,\nwhich filters to `active == true`.",
         "tags": [
           "Articles"
         ],
@@ -50031,20 +50068,12 @@
           }
         ],
         "parameters": [
-          {
-            "in": "path",
-            "name": "employeeId",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          },
           {
             "in": "query",
             "name": "useCache",
             "required": false,
             "schema": {
-              "default": true,
+              "default": false,
               "type": "boolean"
             }
           },
@@ -50060,22 +50089,22 @@
         ]
       }
     },
-    "/v1.0/articles/{slugOrId}/draft-status": {
+    "/v1.0/articles/drafts": {
       "get": {
-        "operationId": "GetArticleWithDraft",
+        "operationId": "GetDraftOnlyArticles",
         "responses": {
           "200": {
             "description": "Ok",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetArticleWithDraftResult"
+                  "$ref": "#/components/schemas/GetArticlesResult"
                 }
               }
             }
           }
         },
-        "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.",
+        "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"
         ],
@@ -50088,17 +50117,25 @@
         ],
         "parameters": [
           {
-            "in": "path",
-            "name": "slugOrId",
-            "required": true,
+            "in": "query",
+            "name": "useCache",
+            "required": false,
             "schema": {
-              "type": "string"
+              "default": false,
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "useCdn",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
             }
           }
         ]
-      }
-    },
-    "/v1.0/articles/drafts": {
+      },
       "post": {
         "operationId": "CreateDraft",
         "responses": {
@@ -50137,6 +50174,99 @@
         }
       }
     },
+    "/v1.0/articles/author/{employeeId}": {
+      "get": {
+        "operationId": "GetArticlesByAuthor",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesByAuthorResult"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "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/{slugOrId}/draft-status": {
+      "get": {
+        "operationId": "GetArticleWithDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticleWithDraftResult"
+                }
+              }
+            }
+          }
+        },
+        "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"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
+      }
+    },
     "/v1.0/articles/{slugOrId}/draft": {
       "patch": {
         "operationId": "PatchDraft",