@snokam/mcp-api 2.57.0 → 2.58.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/package.json +1 -1
  2. package/specs/production/recruitment.json +90 -0
  3. package/specs/production/sanity.json +203 -0
  4. package/specs/test/recruitment.json +90 -0
  5. package/specs/test/sanity.json +203 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@snokam/mcp-api",
3
- "version": "2.57.0",
3
+ "version": "2.58.0",
4
4
  "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
5
5
  "type": "module",
6
6
  "bin": {
package/specs/production/recruitment.json CHANGED
@@ -69,6 +69,60 @@
69
69
  ]
70
70
  }
71
71
  ]
72
+ },
73
+ "post": {
74
+ "tags": [
75
+ "Candidates"
76
+ ],
77
+ "summary": "Create a fresh admin-initiated candidate",
78
+ "description": "Creates a candidate document directly (not via the public application flow). Caller supplies name + status + track.",
79
+ "operationId": "CreateCandidate",
80
+ "requestBody": {
81
+ "description": "Initial candidate fields",
82
+ "content": {
83
+ "application/json": {
84
+ "schema": {
85
+ "$ref": "#/components/schemas/createCandidateInput"
86
+ }
87
+ }
88
+ },
89
+ "required": true
90
+ },
91
+ "responses": {
92
+ "201": {
93
+ "description": "The created candidate",
94
+ "content": {
95
+ "application/json": {
96
+ "schema": {
97
+ "$ref": "#/components/schemas/sanityCandidate"
98
+ }
99
+ }
100
+ },
101
+ "x-ms-summary": "Created"
102
+ },
103
+ "400": {
104
+ "description": "Payload of Object",
105
+ "content": {
106
+ "application/json": {
107
+ "schema": {
108
+ "type": "object"
109
+ }
110
+ }
111
+ },
112
+ "x-ms-summary": "Bad Request"
113
+ },
114
+ "401": {
115
+ "description": "No description",
116
+ "x-ms-summary": "Unauthorized"
117
+ }
118
+ },
119
+ "security": [
120
+ {
121
+ "Implicit": [
122
+ "api://b9f9de6f-132f-4a9a-a583-e9054a46f2fa/.default"
123
+ ]
124
+ }
125
+ ]
72
126
  }
73
127
  },
74
128
  "/v1.0/protected/candidates/{id}": {
@@ -1139,6 +1193,42 @@
1139
1193
  }
1140
1194
  }
1141
1195
  },
1196
+ "createCandidateInput": {
1197
+ "type": "object",
1198
+ "properties": {
1199
+ "status": {
1200
+ "enum": [
1201
+ "CREATED",
1202
+ "INTRODUCTION",
1203
+ "OFFER",
1204
+ "SIGNED",
1205
+ "ONBOARDING",
1206
+ "USER_CREATION_REVIEW",
1207
+ "OFFBOARDING",
1208
+ "REJECTED"
1209
+ ],
1210
+ "type": "string",
1211
+ "default": "CREATED"
1212
+ },
1213
+ "track": {
1214
+ "enum": [
1215
+ "developer",
1216
+ "data_engineer"
1217
+ ],
1218
+ "type": "string",
1219
+ "default": "developer"
1220
+ },
1221
+ "candidate": {
1222
+ "type": "string"
1223
+ },
1224
+ "additionalProperties": {
1225
+ "type": "object",
1226
+ "additionalProperties": {
1227
+ "type": "object"
1228
+ }
1229
+ }
1230
+ }
1231
+ },
1142
1232
  "employeeReference": {
1143
1233
  "type": "object",
1144
1234
  "properties": {
package/specs/production/sanity.json CHANGED
@@ -29814,6 +29814,124 @@
29814
29814
  },
29815
29815
  "SanityCandidate": {
29816
29816
  "properties": {
29817
+ "employee": {
29818
+ "properties": {
29819
+ "tags": {
29820
+ "items": {
29821
+ "properties": {
29822
+ "slug": {
29823
+ "$ref": "#/components/schemas/Slug"
29824
+ },
29825
+ "name": {
29826
+ "type": "string"
29827
+ },
29828
+ "sanityType": {
29829
+ "type": "string",
29830
+ "enum": [
29831
+ "tag"
29832
+ ],
29833
+ "nullable": false
29834
+ },
29835
+ "sanityId": {
29836
+ "type": "string"
29837
+ }
29838
+ },
29839
+ "required": [
29840
+ "slug",
29841
+ "name",
29842
+ "sanityType",
29843
+ "sanityId"
29844
+ ],
29845
+ "type": "object"
29846
+ },
29847
+ "type": "array",
29848
+ "nullable": true
29849
+ },
29850
+ "image": {
29851
+ "properties": {
29852
+ "asset": {
29853
+ "properties": {
29854
+ "mimeType": {
29855
+ "type": "string"
29856
+ },
29857
+ "originalFilename": {
29858
+ "type": "string",
29859
+ "nullable": true
29860
+ },
29861
+ "url": {
29862
+ "type": "string"
29863
+ },
29864
+ "sanityType": {
29865
+ "type": "string",
29866
+ "enum": [
29867
+ "sanity.imageAsset"
29868
+ ],
29869
+ "nullable": false
29870
+ },
29871
+ "sanityId": {
29872
+ "type": "string"
29873
+ }
29874
+ },
29875
+ "required": [
29876
+ "mimeType",
29877
+ "originalFilename",
29878
+ "url",
29879
+ "sanityType",
29880
+ "sanityId"
29881
+ ],
29882
+ "type": "object",
29883
+ "nullable": true
29884
+ },
29885
+ "sanityType": {
29886
+ "type": "string",
29887
+ "enum": [
29888
+ "image"
29889
+ ],
29890
+ "nullable": false
29891
+ }
29892
+ },
29893
+ "required": [
29894
+ "asset",
29895
+ "sanityType"
29896
+ ],
29897
+ "type": "object"
29898
+ },
29899
+ "slug": {
29900
+ "$ref": "#/components/schemas/Slug"
29901
+ },
29902
+ "email": {
29903
+ "type": "string"
29904
+ },
29905
+ "telephone": {
29906
+ "type": "string"
29907
+ },
29908
+ "name": {
29909
+ "type": "string"
29910
+ },
29911
+ "sanityType": {
29912
+ "type": "string",
29913
+ "enum": [
29914
+ "employee"
29915
+ ],
29916
+ "nullable": false
29917
+ },
29918
+ "sanityId": {
29919
+ "type": "string"
29920
+ }
29921
+ },
29922
+ "required": [
29923
+ "tags",
29924
+ "image",
29925
+ "slug",
29926
+ "email",
29927
+ "telephone",
29928
+ "name",
29929
+ "sanityType",
29930
+ "sanityId"
29931
+ ],
29932
+ "type": "object",
29933
+ "nullable": true
29934
+ },
29817
29935
  "githubUsername": {
29818
29936
  "type": "string"
29819
29937
  },
@@ -30766,6 +30884,7 @@
30766
30884
  }
30767
30885
  },
30768
30886
  "required": [
30887
+ "employee",
30769
30888
  "profileImage",
30770
30889
  "systemsActive",
30771
30890
  "buddy",
@@ -30847,6 +30966,14 @@
30847
30966
  "type": "string",
30848
30967
  "nullable": true
30849
30968
  },
30969
+ "employee": {
30970
+ "allOf": [
30971
+ {
30972
+ "$ref": "#/components/schemas/EmployeeReference"
30973
+ }
30974
+ ],
30975
+ "nullable": true
30976
+ },
30850
30977
  "status": {
30851
30978
  "type": "string",
30852
30979
  "enum": [
@@ -31134,6 +31261,46 @@
31134
31261
  "type": "object",
31135
31262
  "additionalProperties": true
31136
31263
  },
31264
+ "CreateCandidateStatus": {
31265
+ "type": "string",
31266
+ "enum": [
31267
+ "CREATED",
31268
+ "INTRODUCTION",
31269
+ "OFFER",
31270
+ "SIGNED",
31271
+ "ONBOARDING",
31272
+ "USER_CREATION_REVIEW",
31273
+ "OFFBOARDING",
31274
+ "REJECTED"
31275
+ ]
31276
+ },
31277
+ "CreateCandidateTrack": {
31278
+ "type": "string",
31279
+ "enum": [
31280
+ "developer",
31281
+ "data_engineer"
31282
+ ]
31283
+ },
31284
+ "CreateCandidateInput": {
31285
+ "properties": {
31286
+ "candidate": {
31287
+ "type": "string"
31288
+ },
31289
+ "status": {
31290
+ "$ref": "#/components/schemas/CreateCandidateStatus"
31291
+ },
31292
+ "track": {
31293
+ "$ref": "#/components/schemas/CreateCandidateTrack"
31294
+ }
31295
+ },
31296
+ "required": [
31297
+ "candidate",
31298
+ "status",
31299
+ "track"
31300
+ ],
31301
+ "type": "object",
31302
+ "additionalProperties": true
31303
+ },
31137
31304
  "File": {
31138
31305
  "description": "The **`File`** interface provides information about files and allows JavaScript in a web page to access their content.\n\n[MDN Reference](https://developer.mozilla.org/docs/Web/API/File)\nThe **`File`** interface provides information about files and allows JavaScript in a web page to access their content.\n\n[MDN Reference](https://developer.mozilla.org/docs/Web/API/File)",
31139
31306
  "properties": {},
@@ -50365,6 +50532,42 @@
50365
50532
  }
50366
50533
  }
50367
50534
  ]
50535
+ },
50536
+ "post": {
50537
+ "operationId": "CreateCandidate",
50538
+ "responses": {
50539
+ "200": {
50540
+ "description": "Ok",
50541
+ "content": {
50542
+ "application/json": {
50543
+ "schema": {
50544
+ "$ref": "#/components/schemas/SanityCandidate"
50545
+ }
50546
+ }
50547
+ }
50548
+ }
50549
+ },
50550
+ "tags": [
50551
+ "Candidates"
50552
+ ],
50553
+ "security": [
50554
+ {
50555
+ "Implicit": [
50556
+ "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
50557
+ ]
50558
+ }
50559
+ ],
50560
+ "parameters": [],
50561
+ "requestBody": {
50562
+ "required": true,
50563
+ "content": {
50564
+ "application/json": {
50565
+ "schema": {
50566
+ "$ref": "#/components/schemas/CreateCandidateInput"
50567
+ }
50568
+ }
50569
+ }
50570
+ }
50368
50571
  }
50369
50572
  },
50370
50573
  "/v1.0/candidates/{id}": {
package/specs/test/recruitment.json CHANGED
@@ -69,6 +69,60 @@
69
69
  ]
70
70
  }
71
71
  ]
72
+ },
73
+ "post": {
74
+ "tags": [
75
+ "Candidates"
76
+ ],
77
+ "summary": "Create a fresh admin-initiated candidate",
78
+ "description": "Creates a candidate document directly (not via the public application flow). Caller supplies name + status + track.",
79
+ "operationId": "CreateCandidate",
80
+ "requestBody": {
81
+ "description": "Initial candidate fields",
82
+ "content": {
83
+ "application/json": {
84
+ "schema": {
85
+ "$ref": "#/components/schemas/createCandidateInput"
86
+ }
87
+ }
88
+ },
89
+ "required": true
90
+ },
91
+ "responses": {
92
+ "201": {
93
+ "description": "The created candidate",
94
+ "content": {
95
+ "application/json": {
96
+ "schema": {
97
+ "$ref": "#/components/schemas/sanityCandidate"
98
+ }
99
+ }
100
+ },
101
+ "x-ms-summary": "Created"
102
+ },
103
+ "400": {
104
+ "description": "Payload of Object",
105
+ "content": {
106
+ "application/json": {
107
+ "schema": {
108
+ "type": "object"
109
+ }
110
+ }
111
+ },
112
+ "x-ms-summary": "Bad Request"
113
+ },
114
+ "401": {
115
+ "description": "No description",
116
+ "x-ms-summary": "Unauthorized"
117
+ }
118
+ },
119
+ "security": [
120
+ {
121
+ "Implicit": [
122
+ "api://050da74a-523f-48ba-a9de-e5c8d6805a93/.default"
123
+ ]
124
+ }
125
+ ]
72
126
  }
73
127
  },
74
128
  "/v1.0/protected/candidates/{id}": {
@@ -1139,6 +1193,42 @@
1139
1193
  }
1140
1194
  }
1141
1195
  },
1196
+ "createCandidateInput": {
1197
+ "type": "object",
1198
+ "properties": {
1199
+ "status": {
1200
+ "enum": [
1201
+ "CREATED",
1202
+ "INTRODUCTION",
1203
+ "OFFER",
1204
+ "SIGNED",
1205
+ "ONBOARDING",
1206
+ "USER_CREATION_REVIEW",
1207
+ "OFFBOARDING",
1208
+ "REJECTED"
1209
+ ],
1210
+ "type": "string",
1211
+ "default": "CREATED"
1212
+ },
1213
+ "track": {
1214
+ "enum": [
1215
+ "developer",
1216
+ "data_engineer"
1217
+ ],
1218
+ "type": "string",
1219
+ "default": "developer"
1220
+ },
1221
+ "candidate": {
1222
+ "type": "string"
1223
+ },
1224
+ "additionalProperties": {
1225
+ "type": "object",
1226
+ "additionalProperties": {
1227
+ "type": "object"
1228
+ }
1229
+ }
1230
+ }
1231
+ },
1142
1232
  "employeeReference": {
1143
1233
  "type": "object",
1144
1234
  "properties": {
package/specs/test/sanity.json CHANGED
@@ -29814,6 +29814,124 @@
29814
29814
  },
29815
29815
  "SanityCandidate": {
29816
29816
  "properties": {
29817
+ "employee": {
29818
+ "properties": {
29819
+ "tags": {
29820
+ "items": {
29821
+ "properties": {
29822
+ "slug": {
29823
+ "$ref": "#/components/schemas/Slug"
29824
+ },
29825
+ "name": {
29826
+ "type": "string"
29827
+ },
29828
+ "sanityType": {
29829
+ "type": "string",
29830
+ "enum": [
29831
+ "tag"
29832
+ ],
29833
+ "nullable": false
29834
+ },
29835
+ "sanityId": {
29836
+ "type": "string"
29837
+ }
29838
+ },
29839
+ "required": [
29840
+ "slug",
29841
+ "name",
29842
+ "sanityType",
29843
+ "sanityId"
29844
+ ],
29845
+ "type": "object"
29846
+ },
29847
+ "type": "array",
29848
+ "nullable": true
29849
+ },
29850
+ "image": {
29851
+ "properties": {
29852
+ "asset": {
29853
+ "properties": {
29854
+ "mimeType": {
29855
+ "type": "string"
29856
+ },
29857
+ "originalFilename": {
29858
+ "type": "string",
29859
+ "nullable": true
29860
+ },
29861
+ "url": {
29862
+ "type": "string"
29863
+ },
29864
+ "sanityType": {
29865
+ "type": "string",
29866
+ "enum": [
29867
+ "sanity.imageAsset"
29868
+ ],
29869
+ "nullable": false
29870
+ },
29871
+ "sanityId": {
29872
+ "type": "string"
29873
+ }
29874
+ },
29875
+ "required": [
29876
+ "mimeType",
29877
+ "originalFilename",
29878
+ "url",
29879
+ "sanityType",
29880
+ "sanityId"
29881
+ ],
29882
+ "type": "object",
29883
+ "nullable": true
29884
+ },
29885
+ "sanityType": {
29886
+ "type": "string",
29887
+ "enum": [
29888
+ "image"
29889
+ ],
29890
+ "nullable": false
29891
+ }
29892
+ },
29893
+ "required": [
29894
+ "asset",
29895
+ "sanityType"
29896
+ ],
29897
+ "type": "object"
29898
+ },
29899
+ "slug": {
29900
+ "$ref": "#/components/schemas/Slug"
29901
+ },
29902
+ "email": {
29903
+ "type": "string"
29904
+ },
29905
+ "telephone": {
29906
+ "type": "string"
29907
+ },
29908
+ "name": {
29909
+ "type": "string"
29910
+ },
29911
+ "sanityType": {
29912
+ "type": "string",
29913
+ "enum": [
29914
+ "employee"
29915
+ ],
29916
+ "nullable": false
29917
+ },
29918
+ "sanityId": {
29919
+ "type": "string"
29920
+ }
29921
+ },
29922
+ "required": [
29923
+ "tags",
29924
+ "image",
29925
+ "slug",
29926
+ "email",
29927
+ "telephone",
29928
+ "name",
29929
+ "sanityType",
29930
+ "sanityId"
29931
+ ],
29932
+ "type": "object",
29933
+ "nullable": true
29934
+ },
29817
29935
  "githubUsername": {
29818
29936
  "type": "string"
29819
29937
  },
@@ -30766,6 +30884,7 @@
30766
30884
  }
30767
30885
  },
30768
30886
  "required": [
30887
+ "employee",
30769
30888
  "profileImage",
30770
30889
  "systemsActive",
30771
30890
  "buddy",
@@ -30847,6 +30966,14 @@
30847
30966
  "type": "string",
30848
30967
  "nullable": true
30849
30968
  },
30969
+ "employee": {
30970
+ "allOf": [
30971
+ {
30972
+ "$ref": "#/components/schemas/EmployeeReference"
30973
+ }
30974
+ ],
30975
+ "nullable": true
30976
+ },
30850
30977
  "status": {
30851
30978
  "type": "string",
30852
30979
  "enum": [
@@ -31134,6 +31261,46 @@
31134
31261
  "type": "object",
31135
31262
  "additionalProperties": true
31136
31263
  },
31264
+ "CreateCandidateStatus": {
31265
+ "type": "string",
31266
+ "enum": [
31267
+ "CREATED",
31268
+ "INTRODUCTION",
31269
+ "OFFER",
31270
+ "SIGNED",
31271
+ "ONBOARDING",
31272
+ "USER_CREATION_REVIEW",
31273
+ "OFFBOARDING",
31274
+ "REJECTED"
31275
+ ]
31276
+ },
31277
+ "CreateCandidateTrack": {
31278
+ "type": "string",
31279
+ "enum": [
31280
+ "developer",
31281
+ "data_engineer"
31282
+ ]
31283
+ },
31284
+ "CreateCandidateInput": {
31285
+ "properties": {
31286
+ "candidate": {
31287
+ "type": "string"
31288
+ },
31289
+ "status": {
31290
+ "$ref": "#/components/schemas/CreateCandidateStatus"
31291
+ },
31292
+ "track": {
31293
+ "$ref": "#/components/schemas/CreateCandidateTrack"
31294
+ }
31295
+ },
31296
+ "required": [
31297
+ "candidate",
31298
+ "status",
31299
+ "track"
31300
+ ],
31301
+ "type": "object",
31302
+ "additionalProperties": true
31303
+ },
31137
31304
  "File": {
31138
31305
  "description": "The **`File`** interface provides information about files and allows JavaScript in a web page to access their content.\n\n[MDN Reference](https://developer.mozilla.org/docs/Web/API/File)\nThe **`File`** interface provides information about files and allows JavaScript in a web page to access their content.\n\n[MDN Reference](https://developer.mozilla.org/docs/Web/API/File)",
31139
31306
  "properties": {},
@@ -50365,6 +50532,42 @@
50365
50532
  }
50366
50533
  }
50367
50534
  ]
50535
+ },
50536
+ "post": {
50537
+ "operationId": "CreateCandidate",
50538
+ "responses": {
50539
+ "200": {
50540
+ "description": "Ok",
50541
+ "content": {
50542
+ "application/json": {
50543
+ "schema": {
50544
+ "$ref": "#/components/schemas/SanityCandidate"
50545
+ }
50546
+ }
50547
+ }
50548
+ }
50549
+ },
50550
+ "tags": [
50551
+ "Candidates"
50552
+ ],
50553
+ "security": [
50554
+ {
50555
+ "Implicit": [
50556
+ "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
50557
+ ]
50558
+ }
50559
+ ],
50560
+ "parameters": [],
50561
+ "requestBody": {
50562
+ "required": true,
50563
+ "content": {
50564
+ "application/json": {
50565
+ "schema": {
50566
+ "$ref": "#/components/schemas/CreateCandidateInput"
50567
+ }
50568
+ }
50569
+ }
50570
+ }
50368
50571
  }
50369
50572
  },
50370
50573
  "/v1.0/candidates/{id}": {