@snokam/mcp-api 0.63.1 → 0.64.1

package/package.json

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

package/specs/production/sanity.json

@@ -46398,6 +46398,312 @@
         ],
         "type": "object",
         "nullable": true
+      },
+      "Annualevent": {
+        "properties": {
+          "link": {
+            "type": "string"
+          },
+          "time": {
+            "type": "string"
+          },
+          "daysBeforeEventForNotification": {
+            "type": "number",
+            "format": "double"
+          },
+          "SmsRecipients": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/EmployeeReference"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "title": {
+            "type": "string"
+          },
+          "sanityType": {
+            "type": "string",
+            "enum": [
+              "annualevent"
+            ],
+            "nullable": false
+          }
+        },
+        "required": [
+          "time",
+          "title",
+          "sanityType"
+        ],
+        "type": "object"
+      },
+      "SanityCreate_AnnualWheel_": {
+        "properties": {
+          "events": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/Annualevent"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "daysBeforeEventForNotification": {
+            "type": "number",
+            "format": "double"
+          },
+          "smsRecipients": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/EmployeeReference"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "slackChannelId": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "sanityType": {
+            "type": "string",
+            "enum": [
+              "annualWheel"
+            ],
+            "nullable": false
+          }
+        },
+        "required": [
+          "events",
+          "smsRecipients",
+          "title",
+          "sanityType"
+        ],
+        "type": "object"
+      },
+      "SanityCreateAnnualWheel": {
+        "$ref": "#/components/schemas/SanityCreate_AnnualWheel_"
+      },
+      "SanityPatch_AnnualWheel_": {
+        "properties": {
+          "sanityType": {
+            "type": "string",
+            "enum": [
+              "annualWheel",
+              null
+            ],
+            "nullable": true
+          },
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "slackChannelId": {
+            "type": "string",
+            "nullable": true
+          },
+          "smsRecipients": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/EmployeeReference"
+                }
+              ]
+            },
+            "type": "array",
+            "nullable": true
+          },
+          "daysBeforeEventForNotification": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "events": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/Annualevent"
+                }
+              ]
+            },
+            "type": "array",
+            "nullable": true
+          }
+        },
+        "type": "object"
+      },
+      "SanityPatchAnnualWheel": {
+        "$ref": "#/components/schemas/SanityPatch_AnnualWheel_"
+      },
+      "SanityCreate_Annualevent_": {
+        "properties": {
+          "SmsRecipients": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/EmployeeReference"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "daysBeforeEventForNotification": {
+            "type": "number",
+            "format": "double"
+          },
+          "time": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "link": {
+            "type": "string"
+          },
+          "sanityType": {
+            "type": "string",
+            "enum": [
+              "annualevent"
+            ],
+            "nullable": false
+          }
+        },
+        "required": [
+          "time",
+          "title",
+          "sanityType"
+        ],
+        "type": "object"
+      },
+      "SanityCreateAnnualWheelEvent": {
+        "$ref": "#/components/schemas/SanityCreate_Annualevent_"
+      },
+      "SanityPatch_Annualevent_": {
+        "properties": {
+          "sanityType": {
+            "type": "string",
+            "enum": [
+              "annualevent",
+              null
+            ],
+            "nullable": true
+          },
+          "link": {
+            "type": "string",
+            "nullable": true
+          },
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "time": {
+            "type": "string",
+            "nullable": true
+          },
+          "daysBeforeEventForNotification": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "SmsRecipients": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/EmployeeReference"
+                }
+              ]
+            },
+            "type": "array",
+            "nullable": true
+          }
+        },
+        "type": "object"
+      },
+      "SanityPatchAnnualWheelEvent": {
+        "$ref": "#/components/schemas/SanityPatch_Annualevent_"
       }
     },
     "securitySchemes": {
@@ -55605,6 +55911,43 @@
             }
           }
         ]
+      },
+      "post": {
+        "operationId": "CreateAnnualWheel",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanityAnnualWheel"
+                }
+              }
+            }
+          }
+        },
+        "description": "Create a new Annual Wheel document.",
+        "tags": [
+          "Annual wheels"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityCreateAnnualWheel"
+              }
+            }
+          }
+        }
       }
     },
     "/v1.0/annual-wheels/{id}": {
@@ -55660,6 +56003,208 @@
             }
           }
         ]
+      },
+      "patch": {
+        "operationId": "PatchAnnualWheel",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanityAnnualWheel"
+                }
+              }
+            }
+          }
+        },
+        "description": "Update top-level fields on an Annual Wheel. Any omitted field is left unchanged.",
+        "tags": [
+          "Annual wheels"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityPatchAnnualWheel"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1.0/annual-wheels/{id}/events": {
+      "post": {
+        "operationId": "CreateAnnualWheelEvent",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                }
+              }
+            }
+          }
+        },
+        "description": "Add a new event to an Annual Wheel's `events` array.\nReturns the `_key` of the newly created event.\nEvent `time` format: `<day>.<month>`, e.g. `\"1.8\"` for August 1.",
+        "tags": [
+          "Annual wheels"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityCreateAnnualWheelEvent"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1.0/annual-wheels/{id}/events/{eventKey}": {
+      "patch": {
+        "operationId": "PatchAnnualWheelEvent",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanityAnnualWheel"
+                }
+              }
+            }
+          }
+        },
+        "description": "Update an existing event inside an Annual Wheel.\n`eventKey` is the `_key` of the event (returned when it was created).\nAny omitted field is left unchanged.",
+        "tags": [
+          "Annual wheels"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "path",
+            "name": "eventKey",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityPatchAnnualWheelEvent"
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "DeleteAnnualWheelEvent",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanityAnnualWheel"
+                }
+              }
+            }
+          }
+        },
+        "description": "Remove an event from an Annual Wheel.\n`eventKey` is the `_key` of the event to remove.",
+        "tags": [
+          "Annual wheels"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "path",
+            "name": "eventKey",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
       }
     }
   },

package/specs/test/sanity.json

@@ -46398,6 +46398,312 @@
         ],
         "type": "object",
         "nullable": true
+      },
+      "Annualevent": {
+        "properties": {
+          "link": {
+            "type": "string"
+          },
+          "time": {
+            "type": "string"
+          },
+          "daysBeforeEventForNotification": {
+            "type": "number",
+            "format": "double"
+          },
+          "SmsRecipients": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/EmployeeReference"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "title": {
+            "type": "string"
+          },
+          "sanityType": {
+            "type": "string",
+            "enum": [
+              "annualevent"
+            ],
+            "nullable": false
+          }
+        },
+        "required": [
+          "time",
+          "title",
+          "sanityType"
+        ],
+        "type": "object"
+      },
+      "SanityCreate_AnnualWheel_": {
+        "properties": {
+          "events": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/Annualevent"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "daysBeforeEventForNotification": {
+            "type": "number",
+            "format": "double"
+          },
+          "smsRecipients": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/EmployeeReference"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "slackChannelId": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "sanityType": {
+            "type": "string",
+            "enum": [
+              "annualWheel"
+            ],
+            "nullable": false
+          }
+        },
+        "required": [
+          "events",
+          "smsRecipients",
+          "title",
+          "sanityType"
+        ],
+        "type": "object"
+      },
+      "SanityCreateAnnualWheel": {
+        "$ref": "#/components/schemas/SanityCreate_AnnualWheel_"
+      },
+      "SanityPatch_AnnualWheel_": {
+        "properties": {
+          "sanityType": {
+            "type": "string",
+            "enum": [
+              "annualWheel",
+              null
+            ],
+            "nullable": true
+          },
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "slackChannelId": {
+            "type": "string",
+            "nullable": true
+          },
+          "smsRecipients": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/EmployeeReference"
+                }
+              ]
+            },
+            "type": "array",
+            "nullable": true
+          },
+          "daysBeforeEventForNotification": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "events": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/Annualevent"
+                }
+              ]
+            },
+            "type": "array",
+            "nullable": true
+          }
+        },
+        "type": "object"
+      },
+      "SanityPatchAnnualWheel": {
+        "$ref": "#/components/schemas/SanityPatch_AnnualWheel_"
+      },
+      "SanityCreate_Annualevent_": {
+        "properties": {
+          "SmsRecipients": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/EmployeeReference"
+                }
+              ]
+            },
+            "type": "array"
+          },
+          "daysBeforeEventForNotification": {
+            "type": "number",
+            "format": "double"
+          },
+          "time": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "link": {
+            "type": "string"
+          },
+          "sanityType": {
+            "type": "string",
+            "enum": [
+              "annualevent"
+            ],
+            "nullable": false
+          }
+        },
+        "required": [
+          "time",
+          "title",
+          "sanityType"
+        ],
+        "type": "object"
+      },
+      "SanityCreateAnnualWheelEvent": {
+        "$ref": "#/components/schemas/SanityCreate_Annualevent_"
+      },
+      "SanityPatch_Annualevent_": {
+        "properties": {
+          "sanityType": {
+            "type": "string",
+            "enum": [
+              "annualevent",
+              null
+            ],
+            "nullable": true
+          },
+          "link": {
+            "type": "string",
+            "nullable": true
+          },
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "time": {
+            "type": "string",
+            "nullable": true
+          },
+          "daysBeforeEventForNotification": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "SmsRecipients": {
+            "items": {
+              "allOf": [
+                {
+                  "properties": {
+                    "sanityKey": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "sanityKey"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "$ref": "#/components/schemas/EmployeeReference"
+                }
+              ]
+            },
+            "type": "array",
+            "nullable": true
+          }
+        },
+        "type": "object"
+      },
+      "SanityPatchAnnualWheelEvent": {
+        "$ref": "#/components/schemas/SanityPatch_Annualevent_"
       }
     },
     "securitySchemes": {
@@ -55605,6 +55911,43 @@
             }
           }
         ]
+      },
+      "post": {
+        "operationId": "CreateAnnualWheel",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanityAnnualWheel"
+                }
+              }
+            }
+          }
+        },
+        "description": "Create a new Annual Wheel document.",
+        "tags": [
+          "Annual wheels"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityCreateAnnualWheel"
+              }
+            }
+          }
+        }
       }
     },
     "/v1.0/annual-wheels/{id}": {
@@ -55660,6 +56003,208 @@
             }
           }
         ]
+      },
+      "patch": {
+        "operationId": "PatchAnnualWheel",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanityAnnualWheel"
+                }
+              }
+            }
+          }
+        },
+        "description": "Update top-level fields on an Annual Wheel. Any omitted field is left unchanged.",
+        "tags": [
+          "Annual wheels"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityPatchAnnualWheel"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1.0/annual-wheels/{id}/events": {
+      "post": {
+        "operationId": "CreateAnnualWheelEvent",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "type": "object"
+                }
+              }
+            }
+          }
+        },
+        "description": "Add a new event to an Annual Wheel's `events` array.\nReturns the `_key` of the newly created event.\nEvent `time` format: `<day>.<month>`, e.g. `\"1.8\"` for August 1.",
+        "tags": [
+          "Annual wheels"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityCreateAnnualWheelEvent"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1.0/annual-wheels/{id}/events/{eventKey}": {
+      "patch": {
+        "operationId": "PatchAnnualWheelEvent",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanityAnnualWheel"
+                }
+              }
+            }
+          }
+        },
+        "description": "Update an existing event inside an Annual Wheel.\n`eventKey` is the `_key` of the event (returned when it was created).\nAny omitted field is left unchanged.",
+        "tags": [
+          "Annual wheels"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "path",
+            "name": "eventKey",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityPatchAnnualWheelEvent"
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "DeleteAnnualWheelEvent",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SanityAnnualWheel"
+                }
+              }
+            }
+          }
+        },
+        "description": "Remove an event from an Annual Wheel.\n`eventKey` is the `_key` of the event to remove.",
+        "tags": [
+          "Annual wheels"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "path",
+            "name": "eventKey",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
       }
     }
   },