@geekity/cms 0.43.0 → 0.45.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 (256) hide show
  1. package/admin/pages/indieauth/consent.njk +1 -1
  2. package/admin/pages/users/activity.njk +3 -1
  3. package/admin/pages/users/apps.njk +55 -19
  4. package/admin/static/admin.css +9 -1
  5. package/dist/admin/app-activity.d.ts +8 -3
  6. package/dist/admin/app-activity.d.ts.map +1 -1
  7. package/dist/admin/app-activity.js +10 -3
  8. package/dist/admin/app-activity.js.map +1 -1
  9. package/dist/admin/connected-apps.d.ts +1 -1
  10. package/dist/admin/connected-apps.d.ts.map +1 -1
  11. package/dist/admin/connected-apps.js +99 -28
  12. package/dist/admin/connected-apps.js.map +1 -1
  13. package/dist/admin/indieauth-consent.d.ts.map +1 -1
  14. package/dist/admin/indieauth-consent.js +44 -13
  15. package/dist/admin/indieauth-consent.js.map +1 -1
  16. package/dist/admin/widget-health.d.ts.map +1 -1
  17. package/dist/admin/widget-health.js +2 -0
  18. package/dist/admin/widget-health.js.map +1 -1
  19. package/dist/avatars/avatars.d.ts +1 -1
  20. package/dist/avatars/avatars.d.ts.map +1 -1
  21. package/dist/avatars/avatars.js +14 -5
  22. package/dist/avatars/avatars.js.map +1 -1
  23. package/dist/cms/app.d.ts.map +1 -1
  24. package/dist/cms/app.js +5 -4
  25. package/dist/cms/app.js.map +1 -1
  26. package/dist/cms/create.d.ts.map +1 -1
  27. package/dist/cms/create.js +7 -6
  28. package/dist/cms/create.js.map +1 -1
  29. package/dist/cms/lifecycle.d.ts +13 -1
  30. package/dist/cms/lifecycle.d.ts.map +1 -1
  31. package/dist/cms/lifecycle.js +31 -3
  32. package/dist/cms/lifecycle.js.map +1 -1
  33. package/dist/cms/services.d.ts.map +1 -1
  34. package/dist/cms/services.js +36 -15
  35. package/dist/cms/services.js.map +1 -1
  36. package/dist/{micropub/create.d.ts → content/micropub-create.d.ts} +5 -5
  37. package/dist/content/micropub-create.d.ts.map +1 -0
  38. package/dist/{micropub/create.js → content/micropub-create.js} +8 -8
  39. package/dist/content/micropub-create.js.map +1 -0
  40. package/dist/{micropub/update.d.ts → content/micropub-update.d.ts} +9 -9
  41. package/dist/content/micropub-update.d.ts.map +1 -0
  42. package/dist/{micropub/update.js → content/micropub-update.js} +8 -8
  43. package/dist/content/micropub-update.js.map +1 -0
  44. package/dist/federation/backfill.d.ts +1 -2
  45. package/dist/federation/backfill.d.ts.map +1 -1
  46. package/dist/federation/backfill.js +14 -5
  47. package/dist/federation/backfill.js.map +1 -1
  48. package/dist/federation/delivery.d.ts +20 -2
  49. package/dist/federation/delivery.d.ts.map +1 -1
  50. package/dist/federation/delivery.js +23 -20
  51. package/dist/federation/delivery.js.map +1 -1
  52. package/dist/federation/federation.d.ts.map +1 -1
  53. package/dist/federation/federation.js +2 -8
  54. package/dist/federation/federation.js.map +1 -1
  55. package/dist/federation/inbox.d.ts +5 -2
  56. package/dist/federation/inbox.d.ts.map +1 -1
  57. package/dist/federation/inbox.js +3 -3
  58. package/dist/federation/inbox.js.map +1 -1
  59. package/dist/federation/keys.d.ts +10 -0
  60. package/dist/federation/keys.d.ts.map +1 -1
  61. package/dist/federation/keys.js +13 -8
  62. package/dist/federation/keys.js.map +1 -1
  63. package/dist/federation/profiles.d.ts +1 -3
  64. package/dist/federation/profiles.d.ts.map +1 -1
  65. package/dist/federation/profiles.js +17 -7
  66. package/dist/federation/profiles.js.map +1 -1
  67. package/dist/federation/resend-job.d.ts +2 -1
  68. package/dist/federation/resend-job.d.ts.map +1 -1
  69. package/dist/federation/resend-job.js +11 -10
  70. package/dist/federation/resend-job.js.map +1 -1
  71. package/dist/federation/retry-job.d.ts +44 -0
  72. package/dist/federation/retry-job.d.ts.map +1 -0
  73. package/dist/federation/retry-job.js +102 -0
  74. package/dist/federation/retry-job.js.map +1 -0
  75. package/dist/files/data-files.d.ts +1 -0
  76. package/dist/files/data-files.d.ts.map +1 -1
  77. package/dist/files/data-files.js +6 -0
  78. package/dist/files/data-files.js.map +1 -1
  79. package/dist/indieauth/registration.d.ts +16 -0
  80. package/dist/indieauth/registration.d.ts.map +1 -0
  81. package/dist/indieauth/registration.js +107 -0
  82. package/dist/indieauth/registration.js.map +1 -0
  83. package/dist/indieauth/request.d.ts +4 -3
  84. package/dist/indieauth/request.d.ts.map +1 -1
  85. package/dist/indieauth/request.js +21 -3
  86. package/dist/indieauth/request.js.map +1 -1
  87. package/dist/mcp/audit.d.ts +3 -0
  88. package/dist/mcp/audit.d.ts.map +1 -0
  89. package/dist/mcp/audit.js +35 -0
  90. package/dist/mcp/audit.js.map +1 -0
  91. package/dist/mcp/authoring/create.d.ts +2 -0
  92. package/dist/mcp/authoring/create.d.ts.map +1 -0
  93. package/dist/mcp/authoring/create.js +79 -0
  94. package/dist/mcp/authoring/create.js.map +1 -0
  95. package/dist/mcp/authoring/publish.d.ts +2 -0
  96. package/dist/mcp/authoring/publish.d.ts.map +1 -0
  97. package/dist/mcp/authoring/publish.js +75 -0
  98. package/dist/mcp/authoring/publish.js.map +1 -0
  99. package/dist/mcp/authoring/shared.d.ts +23 -0
  100. package/dist/mcp/authoring/shared.d.ts.map +1 -0
  101. package/dist/mcp/authoring/shared.js +35 -0
  102. package/dist/mcp/authoring/shared.js.map +1 -0
  103. package/dist/mcp/authoring/source.d.ts +2 -0
  104. package/dist/mcp/authoring/source.d.ts.map +1 -0
  105. package/dist/mcp/authoring/source.js +48 -0
  106. package/dist/mcp/authoring/source.js.map +1 -0
  107. package/dist/mcp/authoring/update.d.ts +2 -0
  108. package/dist/mcp/authoring/update.d.ts.map +1 -0
  109. package/dist/mcp/authoring/update.js +97 -0
  110. package/dist/mcp/authoring/update.js.map +1 -0
  111. package/dist/mcp/authoring/upload.d.ts +3 -0
  112. package/dist/mcp/authoring/upload.d.ts.map +1 -0
  113. package/dist/mcp/authoring/upload.js +71 -0
  114. package/dist/mcp/authoring/upload.js.map +1 -0
  115. package/dist/mcp/call-limit.d.ts +18 -0
  116. package/dist/mcp/call-limit.d.ts.map +1 -0
  117. package/dist/mcp/call-limit.js +24 -0
  118. package/dist/mcp/call-limit.js.map +1 -0
  119. package/dist/mcp/endpoint.d.ts +7 -0
  120. package/dist/mcp/endpoint.d.ts.map +1 -0
  121. package/dist/mcp/endpoint.js +161 -0
  122. package/dist/mcp/endpoint.js.map +1 -0
  123. package/dist/mcp/inspect/inbox.d.ts +2 -0
  124. package/dist/mcp/inspect/inbox.d.ts.map +1 -0
  125. package/dist/mcp/inspect/inbox.js +123 -0
  126. package/dist/mcp/inspect/inbox.js.map +1 -0
  127. package/dist/mcp/inspect/paging.d.ts +71 -0
  128. package/dist/mcp/inspect/paging.d.ts.map +1 -0
  129. package/dist/mcp/inspect/paging.js +59 -0
  130. package/dist/mcp/inspect/paging.js.map +1 -0
  131. package/dist/mcp/inspect/post.d.ts +9 -0
  132. package/dist/mcp/inspect/post.d.ts.map +1 -0
  133. package/dist/mcp/inspect/post.js +161 -0
  134. package/dist/mcp/inspect/post.js.map +1 -0
  135. package/dist/mcp/inspect/records.d.ts +4 -0
  136. package/dist/mcp/inspect/records.d.ts.map +1 -0
  137. package/dist/mcp/inspect/records.js +213 -0
  138. package/dist/mcp/inspect/records.js.map +1 -0
  139. package/dist/mcp/inspect/remote.d.ts +85 -0
  140. package/dist/mcp/inspect/remote.d.ts.map +1 -0
  141. package/dist/mcp/inspect/remote.js +274 -0
  142. package/dist/mcp/inspect/remote.js.map +1 -0
  143. package/dist/mcp/inspect/schemas.d.ts +70 -0
  144. package/dist/mcp/inspect/schemas.d.ts.map +1 -0
  145. package/dist/mcp/inspect/schemas.js +46 -0
  146. package/dist/mcp/inspect/schemas.js.map +1 -0
  147. package/dist/mcp/inspect/status.d.ts +2 -0
  148. package/dist/mcp/inspect/status.d.ts.map +1 -0
  149. package/dist/mcp/inspect/status.js +194 -0
  150. package/dist/mcp/inspect/status.js.map +1 -0
  151. package/dist/mcp/inspect/webmentions.d.ts +2 -0
  152. package/dist/mcp/inspect/webmentions.d.ts.map +1 -0
  153. package/dist/mcp/inspect/webmentions.js +130 -0
  154. package/dist/mcp/inspect/webmentions.js.map +1 -0
  155. package/dist/mcp/plugin-tools.d.ts +4 -0
  156. package/dist/mcp/plugin-tools.d.ts.map +1 -0
  157. package/dist/mcp/plugin-tools.js +29 -0
  158. package/dist/mcp/plugin-tools.js.map +1 -0
  159. package/dist/mcp/protocol.d.ts +67 -0
  160. package/dist/mcp/protocol.d.ts.map +1 -0
  161. package/dist/mcp/protocol.js +130 -0
  162. package/dist/mcp/protocol.js.map +1 -0
  163. package/dist/mcp/repair/refresh.d.ts +2 -0
  164. package/dist/mcp/repair/refresh.d.ts.map +1 -0
  165. package/dist/mcp/repair/refresh.js +111 -0
  166. package/dist/mcp/repair/refresh.js.map +1 -0
  167. package/dist/mcp/repair/resend.d.ts +2 -0
  168. package/dist/mcp/repair/resend.d.ts.map +1 -0
  169. package/dist/mcp/repair/resend.js +46 -0
  170. package/dist/mcp/repair/resend.js.map +1 -0
  171. package/dist/mcp/repair/retry.d.ts +2 -0
  172. package/dist/mcp/repair/retry.d.ts.map +1 -0
  173. package/dist/mcp/repair/retry.js +91 -0
  174. package/dist/mcp/repair/retry.js.map +1 -0
  175. package/dist/mcp/repair/schemas.d.ts +30 -0
  176. package/dist/mcp/repair/schemas.d.ts.map +1 -0
  177. package/dist/mcp/repair/schemas.js +26 -0
  178. package/dist/mcp/repair/schemas.js.map +1 -0
  179. package/dist/mcp/tools.d.ts +84 -0
  180. package/dist/mcp/tools.d.ts.map +1 -0
  181. package/dist/mcp/tools.js +102 -0
  182. package/dist/mcp/tools.js.map +1 -0
  183. package/dist/mcp/whoami.d.ts +2 -0
  184. package/dist/mcp/whoami.d.ts.map +1 -0
  185. package/dist/mcp/whoami.js +40 -0
  186. package/dist/mcp/whoami.js.map +1 -0
  187. package/dist/micropub/endpoint.d.ts.map +1 -1
  188. package/dist/micropub/endpoint.js +2 -2
  189. package/dist/micropub/endpoint.js.map +1 -1
  190. package/dist/plugin.d.ts +77 -1
  191. package/dist/plugin.d.ts.map +1 -1
  192. package/dist/plugin.js +16 -1
  193. package/dist/plugin.js.map +1 -1
  194. package/dist/plugins/registry.d.ts +7 -1
  195. package/dist/plugins/registry.d.ts.map +1 -1
  196. package/dist/plugins/registry.js +23 -5
  197. package/dist/plugins/registry.js.map +1 -1
  198. package/dist/store/admin-store.d.ts +3 -3
  199. package/dist/store/admin-store.d.ts.map +1 -1
  200. package/dist/store/admin-store.js.map +1 -1
  201. package/dist/store/deliveries.d.ts +23 -0
  202. package/dist/store/deliveries.d.ts.map +1 -1
  203. package/dist/store/deliveries.js +56 -1
  204. package/dist/store/deliveries.js.map +1 -1
  205. package/dist/store/inbox.d.ts +17 -1
  206. package/dist/store/inbox.d.ts.map +1 -1
  207. package/dist/store/inbox.js +35 -0
  208. package/dist/store/inbox.js.map +1 -1
  209. package/dist/store/rows.d.ts +5 -0
  210. package/dist/store/rows.d.ts.map +1 -1
  211. package/dist/store/rows.js.map +1 -1
  212. package/dist/util/json-schema.d.ts +68 -0
  213. package/dist/util/json-schema.d.ts.map +1 -0
  214. package/dist/util/json-schema.js +60 -0
  215. package/dist/util/json-schema.js.map +1 -0
  216. package/dist/util/package-version.d.ts +2 -0
  217. package/dist/util/package-version.d.ts.map +1 -0
  218. package/dist/util/package-version.js +3 -0
  219. package/dist/util/package-version.js.map +1 -0
  220. package/dist/web/env.d.ts +2 -0
  221. package/dist/web/env.d.ts.map +1 -1
  222. package/dist/web/federation-routes.d.ts +1 -0
  223. package/dist/web/federation-routes.d.ts.map +1 -1
  224. package/dist/web/federation-routes.js +10 -7
  225. package/dist/web/federation-routes.js.map +1 -1
  226. package/dist/web/indieauth-activity-log.d.ts +23 -5
  227. package/dist/web/indieauth-activity-log.d.ts.map +1 -1
  228. package/dist/web/indieauth-activity-log.js +62 -23
  229. package/dist/web/indieauth-activity-log.js.map +1 -1
  230. package/dist/web/indieauth-bearer.d.ts +8 -1
  231. package/dist/web/indieauth-bearer.d.ts.map +1 -1
  232. package/dist/web/indieauth-bearer.js +24 -18
  233. package/dist/web/indieauth-bearer.js.map +1 -1
  234. package/dist/web/indieauth-discovery.d.ts +14 -2
  235. package/dist/web/indieauth-discovery.d.ts.map +1 -1
  236. package/dist/web/indieauth-discovery.js +25 -4
  237. package/dist/web/indieauth-discovery.js.map +1 -1
  238. package/dist/web/indieauth-registration.d.ts +5 -0
  239. package/dist/web/indieauth-registration.d.ts.map +1 -0
  240. package/dist/web/indieauth-registration.js +51 -0
  241. package/dist/web/indieauth-registration.js.map +1 -0
  242. package/dist/web/llms.d.ts.map +1 -1
  243. package/dist/web/llms.js +2 -0
  244. package/dist/web/llms.js.map +1 -1
  245. package/dist/web/routes.d.ts.map +1 -1
  246. package/dist/web/routes.js +4 -3
  247. package/dist/web/routes.js.map +1 -1
  248. package/dist/webmention/fetch-public.d.ts +9 -0
  249. package/dist/webmention/fetch-public.d.ts.map +1 -1
  250. package/dist/webmention/fetch-public.js +6 -4
  251. package/dist/webmention/fetch-public.js.map +1 -1
  252. package/package.json +1 -1
  253. package/dist/micropub/create.d.ts.map +0 -1
  254. package/dist/micropub/create.js.map +0 -1
  255. package/dist/micropub/update.d.ts.map +0 -1
  256. package/dist/micropub/update.js.map +0 -1
@@ -0,0 +1,70 @@
1
+ import type { McpToolAnnotations } from '../../plugin.ts';
2
+ export declare const READ_ONLY: McpToolAnnotations;
3
+ export declare function countsOf<const V extends readonly [string, ...string[]]>(values: V): {
4
+ readonly type: 'object';
5
+ readonly properties: Record<V[number], {
6
+ readonly type: 'integer';
7
+ }>;
8
+ readonly required: V;
9
+ };
10
+ export declare const STATUS_COUNTS: {
11
+ readonly type: 'object';
12
+ readonly properties: Record<"failed" | "queued" | "retrying" | "sent", {
13
+ readonly type: 'integer';
14
+ }>;
15
+ readonly required: readonly ["sent", "queued", "retrying", "failed"];
16
+ readonly description: 'How many recipients stand at each delivery status.';
17
+ };
18
+ export declare const DELIVERY: {
19
+ readonly type: 'object';
20
+ readonly properties: {
21
+ readonly activityId: {
22
+ readonly type: 'string';
23
+ };
24
+ readonly activityType: {
25
+ readonly type: 'string';
26
+ readonly description: 'Create, Update or Delete.';
27
+ };
28
+ readonly objectId: {
29
+ readonly type: 'string';
30
+ readonly description: 'What the activity was about.';
31
+ };
32
+ readonly slug: {
33
+ readonly anyOf: readonly [{
34
+ readonly type: "string";
35
+ readonly description: "The post it was about, when it was one.";
36
+ }, {
37
+ readonly type: 'null';
38
+ }];
39
+ };
40
+ readonly actorId: {
41
+ readonly type: 'string';
42
+ readonly description: 'The follower or relay it went to.';
43
+ };
44
+ readonly inboxId: {
45
+ readonly type: 'string';
46
+ readonly description: 'The inbox used, often the shared one.';
47
+ };
48
+ readonly status: {
49
+ readonly type: 'string';
50
+ readonly enum: readonly ["sent", "queued", "retrying", "failed"];
51
+ };
52
+ readonly error: {
53
+ readonly anyOf: readonly [{
54
+ readonly type: "string";
55
+ readonly description: "Why it failed or is being retried.";
56
+ }, {
57
+ readonly type: 'null';
58
+ }];
59
+ };
60
+ readonly attemptedAt: {
61
+ readonly type: 'string';
62
+ };
63
+ };
64
+ readonly required: readonly ['activityId', 'activityType', 'objectId', 'slug', 'actorId', 'inboxId', 'status', 'error', 'attemptedAt'];
65
+ };
66
+ export declare const ANY_OBJECT: {
67
+ readonly type: 'object';
68
+ readonly properties: {};
69
+ };
70
+ //# sourceMappingURL=schemas.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/mcp/inspect/schemas.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,eAAO,MAAM,SAAS,EAAE,kBAKvB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;aAE9E,IAAI,EAAE,QAAQ;aACd,UAAU,EAA6E,MAAM,CAC3F,CAAC,CAAC,MAAM,CAAC,EACT;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAC7B;aACD,QAAQ;EAEX;AAED,eAAO,MAAM,aAAa;mBAThB,QAAQ;;uBAGK,SAAS;;;0BAQjB,oDAAoD;CACzD,CAAC;AAEX,eAAO,MAAM,QAAQ;aACnB,IAAI,EAAE,QAAQ;aACd,UAAU;iBACR,UAAU;qBAAI,IAAI,EAAE,QAAQ;;iBAC5B,YAAY;qBAAI,IAAI,EAAE,QAAQ;qBAAE,WAAW,EAAE,2BAA2B;;iBACxE,QAAQ;qBAAI,IAAI,EAAE,QAAQ;qBAAE,WAAW,EAAE,8BAA8B;;iBACvE,IAAI;;;;;;;;iBACJ,OAAO;qBAAI,IAAI,EAAE,QAAQ;qBAAE,WAAW,EAAE,mCAAmC;;iBAC3E,OAAO;qBAAI,IAAI,EAAE,QAAQ;qBAAE,WAAW,EAAE,uCAAuC;;iBAC/E,MAAM;qBAAI,IAAI,EAAE,QAAQ;qBAAE,IAAI;;iBAC9B,KAAK;;;;;;;;iBACL,WAAW;qBAAI,IAAI,EAAE,QAAQ;;;aAE/B,QAAQ,YACN,YAAY,EACZ,cAAc,EACd,UAAU,EACV,MAAM,EACN,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,aAAa;CAEP,CAAC;AAEX,eAAO,MAAM,UAAU;aAAK,IAAI,EAAE,QAAQ;aAAE,UAAU;CAAe,CAAC"}
@@ -0,0 +1,46 @@
1
+ import { DELIVERY_STATUSES } from '../../store/deliveries.js';
2
+ import { nullable } from '../../util/json-schema.js';
3
+ export const READ_ONLY = {
4
+ readOnlyHint: true,
5
+ destructiveHint: false,
6
+ idempotentHint: true,
7
+ openWorldHint: false,
8
+ };
9
+ export function countsOf(values) {
10
+ return {
11
+ type: 'object',
12
+ properties: Object.fromEntries(values.map((value) => [value, { type: 'integer' }])),
13
+ required: values,
14
+ };
15
+ }
16
+ export const STATUS_COUNTS = {
17
+ ...countsOf(DELIVERY_STATUSES),
18
+ description: 'How many recipients stand at each delivery status.',
19
+ };
20
+ export const DELIVERY = {
21
+ type: 'object',
22
+ properties: {
23
+ activityId: { type: 'string' },
24
+ activityType: { type: 'string', description: 'Create, Update or Delete.' },
25
+ objectId: { type: 'string', description: 'What the activity was about.' },
26
+ slug: nullable({ type: 'string', description: 'The post it was about, when it was one.' }),
27
+ actorId: { type: 'string', description: 'The follower or relay it went to.' },
28
+ inboxId: { type: 'string', description: 'The inbox used, often the shared one.' },
29
+ status: { type: 'string', enum: DELIVERY_STATUSES },
30
+ error: nullable({ type: 'string', description: 'Why it failed or is being retried.' }),
31
+ attemptedAt: { type: 'string' },
32
+ },
33
+ required: [
34
+ 'activityId',
35
+ 'activityType',
36
+ 'objectId',
37
+ 'slug',
38
+ 'actorId',
39
+ 'inboxId',
40
+ 'status',
41
+ 'error',
42
+ 'attemptedAt',
43
+ ],
44
+ };
45
+ export const ANY_OBJECT = { type: 'object', properties: {} };
46
+ //# sourceMappingURL=schemas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/mcp/inspect/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,MAAM,CAAC,MAAM,SAAS,GAAuB;IAC3C,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;CACrB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAiD,MAAS;IAChF,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAGjF;QACD,QAAQ,EAAE,MAAM;KACR,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,QAAQ,CAAC,iBAAiB,CAAC;IAC9B,WAAW,EAAE,oDAAoD;CACzD,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;QAC1E,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;QACzE,IAAI,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;QAC1F,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;QAC7E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;QACjF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE;QACnD,KAAK,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC;QACtF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAChC;IACD,QAAQ,EAAE;QACR,YAAY;QACZ,cAAc;QACd,UAAU;QACV,MAAM;QACN,SAAS;QACT,SAAS;QACT,QAAQ;QACR,OAAO;QACP,aAAa;KACd;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAW,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare const federationStatus: import("../tools.ts").McpTool;
2
+ //# sourceMappingURL=status.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/mcp/inspect/status.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,gBAAgB,+BAkL3B,CAAC"}
@@ -0,0 +1,194 @@
1
+ import { actorSummary } from '../../admin/federation.js';
2
+ import { actorKeyHealth, ACTOR_KEY_ALGORITHMS } from '../../federation/keys.js';
3
+ import { JOB_STATES } from '../../jobs/types.js';
4
+ import { listUsers } from '../../site/users.js';
5
+ import { RELAY_STATES } from '../../store/relays.js';
6
+ import { countRetryingDeliveries, countWaitingMessages } from '../../store/queue-database.js';
7
+ import { messageOf } from '../../util/errors.js';
8
+ import { nullable } from '../../util/json-schema.js';
9
+ import { defineTool } from '../tools.js';
10
+ import { countsOf, DELIVERY, READ_ONLY } from './schemas.js';
11
+ const RECENT = 10;
12
+ const DAY_MS = 24 * 60 * 60 * 1000;
13
+ export const federationStatus = defineTool({
14
+ name: 'federation_status',
15
+ title: 'Federation status',
16
+ description: 'Summarises the site’s federation: each user’s actor with its follower count and key files, relay subscriptions by state, messages waiting in the federation queue, deliveries being retried, the newest failed or retrying deliveries with their errors, failed webmentions, and the newest jobs with how they ended.',
17
+ scope: 'inspect',
18
+ annotations: READ_ONLY,
19
+ inputSchema: {
20
+ type: 'object',
21
+ properties: {
22
+ days: {
23
+ type: 'integer',
24
+ minimum: 1,
25
+ maximum: 90,
26
+ description: 'How many days back the failure counts reach. 7 unless given.',
27
+ },
28
+ },
29
+ additionalProperties: false,
30
+ },
31
+ outputSchema: {
32
+ type: 'object',
33
+ properties: {
34
+ since: { type: 'string', description: 'Where the failure counts start.' },
35
+ actors: {
36
+ type: 'array',
37
+ items: {
38
+ type: 'object',
39
+ properties: {
40
+ username: { type: 'string' },
41
+ handle: { type: 'string' },
42
+ actorId: { type: 'string' },
43
+ followerCount: { type: 'integer' },
44
+ keys: {
45
+ type: 'array',
46
+ items: {
47
+ type: 'object',
48
+ properties: {
49
+ algorithm: { type: 'string', enum: ACTOR_KEY_ALGORITHMS },
50
+ state: {
51
+ type: 'string',
52
+ enum: ['usable', 'missing', 'unusable'],
53
+ description: 'missing is normal before the first request that signs; unusable stops the site booting.',
54
+ },
55
+ problem: nullable({ type: 'string' }),
56
+ },
57
+ required: ['algorithm', 'state', 'problem'],
58
+ },
59
+ },
60
+ },
61
+ required: ['username', 'handle', 'actorId', 'followerCount', 'keys'],
62
+ },
63
+ },
64
+ relays: countsOf(RELAY_STATES),
65
+ queue: {
66
+ type: 'object',
67
+ properties: {
68
+ waiting: {
69
+ type: 'integer',
70
+ description: 'Messages waiting in the federation queue: deliveries, retries and inbox activities.',
71
+ },
72
+ retrying: {
73
+ type: 'integer',
74
+ description: 'Of those, deliveries first tried since `since` waiting for another attempt.',
75
+ },
76
+ },
77
+ required: ['waiting', 'retrying'],
78
+ },
79
+ failedDeliveries: { type: 'integer', description: 'Deliveries that failed since `since`.' },
80
+ failedWebmentions: { type: 'integer', description: 'Webmentions that failed since `since`.' },
81
+ recentFailures: {
82
+ type: 'array',
83
+ description: 'The newest failed or retrying deliveries.',
84
+ items: DELIVERY,
85
+ },
86
+ jobs: {
87
+ type: 'array',
88
+ description: 'The newest jobs, whatever their state.',
89
+ items: {
90
+ type: 'object',
91
+ properties: {
92
+ id: { type: 'string' },
93
+ name: { type: 'string' },
94
+ state: { type: 'string', enum: JOB_STATES },
95
+ attempt: { type: 'integer' },
96
+ queuedAt: { type: 'string' },
97
+ endedAt: nullable({
98
+ type: 'string',
99
+ description: 'When it finished, failed or was interrupted.',
100
+ }),
101
+ error: nullable({ type: 'string' }),
102
+ },
103
+ required: ['id', 'name', 'state', 'attempt', 'queuedAt', 'endedAt', 'error'],
104
+ },
105
+ },
106
+ },
107
+ required: [
108
+ 'since',
109
+ 'actors',
110
+ 'relays',
111
+ 'queue',
112
+ 'failedDeliveries',
113
+ 'failedWebmentions',
114
+ 'recentFailures',
115
+ 'jobs',
116
+ ],
117
+ },
118
+ run: async (args, { site }) => {
119
+ const { admin, config } = site;
120
+ const since = new Date(config.now().getTime() - (args.days ?? 7) * DAY_MS).toISOString();
121
+ const actors = listUsers(config.dataDir).map((user) => {
122
+ const summary = actorSummary(user, {
123
+ baseUrl: config.baseUrl,
124
+ followerCount: admin.countFollowers(user.username),
125
+ followers: [],
126
+ });
127
+ return {
128
+ username: summary.username,
129
+ handle: summary.handle,
130
+ actorId: summary.actorId,
131
+ followerCount: summary.followerCount,
132
+ keys: actorKeyHealth(config.dataDir, user.username).map((key) => ({
133
+ algorithm: key.algorithm,
134
+ state: key.state,
135
+ problem: key.state === 'unusable' ? messageOf(key.cause) : null,
136
+ })),
137
+ };
138
+ });
139
+ const relayList = admin.listRelays();
140
+ const relays = Object.fromEntries(RELAY_STATES.map((state) => [
141
+ state,
142
+ relayList.filter((relay) => relay.state === state).length,
143
+ ]));
144
+ const queue = {
145
+ waiting: countWaitingMessages(config.dataDir),
146
+ retrying: countRetryingDeliveries(config.dataDir, since),
147
+ };
148
+ const failedDeliveries = admin.countFailedDeliveriesSince(since);
149
+ const failedWebmentions = admin.countFailedWebmentionsSince(since);
150
+ const recentFailures = admin.searchDeliveries({ statuses: ['failed', 'retrying'] }, { limit: RECENT }).items;
151
+ const jobs = (await site.jobs.list(JOB_STATES))
152
+ .toSorted((a, b) => b.queuedAt.localeCompare(a.queuedAt))
153
+ .slice(0, RECENT)
154
+ .map(jobRow);
155
+ const unusable = actors
156
+ .filter((actor) => actor.keys.some((key) => key.state === 'unusable'))
157
+ .map((actor) => actor.username);
158
+ return {
159
+ ok: true,
160
+ summary: [
161
+ `${String(actors.length)} ${actors.length === 1 ? 'actor' : 'actors'}`,
162
+ `${String(queue.waiting)} queued, ${String(queue.retrying)} retrying`,
163
+ `${String(failedDeliveries)} failed deliveries and ${String(failedWebmentions)} failed webmentions since ${since}`,
164
+ ...(unusable.length > 0 ? [`unusable key files for ${unusable.join(', ')}`] : []),
165
+ ].join('; '),
166
+ structured: {
167
+ since,
168
+ actors,
169
+ relays,
170
+ queue,
171
+ failedDeliveries,
172
+ failedWebmentions,
173
+ recentFailures,
174
+ jobs,
175
+ },
176
+ };
177
+ },
178
+ });
179
+ function jobRow(job) {
180
+ return {
181
+ id: job.id,
182
+ name: job.name,
183
+ state: job.state,
184
+ attempt: job.attempt,
185
+ queuedAt: job.queuedAt,
186
+ endedAt: job.state === 'finished' || job.state === 'failed'
187
+ ? job.finishedAt
188
+ : job.state === 'interrupted'
189
+ ? job.interruptedAt
190
+ : null,
191
+ error: job.state === 'failed' ? job.error : null,
192
+ };
193
+ }
194
+ //# sourceMappingURL=status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/mcp/inspect/status.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare const webmentions: import("../tools.ts").McpTool;
2
+ //# sourceMappingURL=webmentions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webmentions.d.ts","sourceRoot":"","sources":["../../../src/mcp/inspect/webmentions.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,WAAW,+BAgItB,CAAC"}
@@ -0,0 +1,130 @@
1
+ import { COMMENT_KINDS, COMMENT_STATUSES } from '../../store/comments.js';
2
+ import { WEBMENTION_SEND_STATUSES } from '../../store/webmentions.js';
3
+ import { nullable } from '../../util/json-schema.js';
4
+ import { defineTool, isRefused } from '../tools.js';
5
+ import { instants, PAGE_INPUT, PAGE_OUTPUT, PAGE_REQUIRED, pageAt, pageFields, pageOfList, TIME_INPUT, within, } from './paging.js';
6
+ import { findPost, POST_INPUT } from './post.js';
7
+ import { READ_ONLY } from './schemas.js';
8
+ const STATUSES = { sent: WEBMENTION_SEND_STATUSES, received: COMMENT_STATUSES };
9
+ export const webmentions = defineTool({
10
+ name: 'webmentions',
11
+ title: 'Webmentions of a post',
12
+ description: 'For one post, newest first: the webmentions it sent to the pages it links to, with each endpoint, outcome and error; or the webmentions it received, with their moderation status.',
13
+ scope: 'inspect',
14
+ annotations: READ_ONLY,
15
+ inputSchema: {
16
+ type: 'object',
17
+ properties: {
18
+ post: POST_INPUT,
19
+ direction: { type: 'string', enum: ['sent', 'received'] },
20
+ status: {
21
+ type: 'string',
22
+ description: `Only this status: ${WEBMENTION_SEND_STATUSES.join(', ')} for sent; ${COMMENT_STATUSES.join(', ')} for received.`,
23
+ },
24
+ ...TIME_INPUT,
25
+ ...PAGE_INPUT,
26
+ },
27
+ required: ['post', 'direction'],
28
+ additionalProperties: false,
29
+ },
30
+ outputSchema: {
31
+ type: 'object',
32
+ properties: {
33
+ ...PAGE_OUTPUT,
34
+ sent: {
35
+ type: 'array',
36
+ description: 'With direction sent.',
37
+ items: {
38
+ type: 'object',
39
+ properties: {
40
+ source: { type: 'string' },
41
+ target: { type: 'string' },
42
+ endpoint: nullable({
43
+ type: 'string',
44
+ description: 'null when the target advertised none.',
45
+ }),
46
+ status: { type: 'string', enum: WEBMENTION_SEND_STATUSES },
47
+ error: nullable({ type: 'string' }),
48
+ attemptedAt: { type: 'string' },
49
+ },
50
+ required: ['source', 'target', 'endpoint', 'status', 'error', 'attemptedAt'],
51
+ },
52
+ },
53
+ received: {
54
+ type: 'array',
55
+ description: 'With direction received.',
56
+ items: {
57
+ type: 'object',
58
+ properties: {
59
+ id: { type: 'string' },
60
+ source: nullable({ type: 'string', description: 'The page that mentioned the post.' }),
61
+ kind: { type: 'string', enum: COMMENT_KINDS },
62
+ status: { type: 'string', enum: COMMENT_STATUSES },
63
+ authorName: { type: 'string' },
64
+ authorUrl: nullable({ type: 'string' }),
65
+ submitted: { type: 'string' },
66
+ },
67
+ required: ['id', 'source', 'kind', 'status', 'authorName', 'authorUrl', 'submitted'],
68
+ },
69
+ },
70
+ },
71
+ required: [...PAGE_REQUIRED],
72
+ },
73
+ run: (args, { site }) => {
74
+ const range = instants(args);
75
+ if (!range.ok)
76
+ return Promise.resolve(range);
77
+ const allowed = STATUSES[args.direction];
78
+ if (args.status !== undefined && !allowed.includes(args.status)) {
79
+ return Promise.resolve({
80
+ ok: false,
81
+ message: `status must be one of ${allowed.join(', ')} for ${args.direction} webmentions.`,
82
+ });
83
+ }
84
+ const document = findPost(site, args.post);
85
+ if (isRefused(document))
86
+ return Promise.resolve(document);
87
+ const at = pageAt(args);
88
+ const wanted = (status, time) => (args.status === undefined || status === args.status) && within(time, range);
89
+ if (args.direction === 'sent') {
90
+ const page = pageOfList(site.admin
91
+ .listSentWebmentions(document.slug)
92
+ .filter((sent) => wanted(sent.status, sent.attemptedAt))
93
+ .toSorted((a, b) => b.attemptedAt.localeCompare(a.attemptedAt))
94
+ .map(({ source, target, endpoint, status, error, attemptedAt }) => ({
95
+ source,
96
+ target,
97
+ endpoint,
98
+ status,
99
+ error,
100
+ attemptedAt,
101
+ })), at);
102
+ const failed = page.items.filter((sent) => sent.status === 'failed').length;
103
+ return Promise.resolve({
104
+ ok: true,
105
+ summary: `${document.slug} sent ${String(page.total)} matching ${page.total === 1 ? 'webmention' : 'webmentions'}; ${String(failed)} failed on this page.`,
106
+ structured: { ...pageFields(page, at), sent: page.items },
107
+ });
108
+ }
109
+ const page = pageOfList(site.admin
110
+ .listCommentsFor(document.slug)
111
+ .filter((comment) => comment.source === 'webmention')
112
+ .filter((comment) => wanted(comment.status, comment.submitted))
113
+ .toSorted((a, b) => b.submitted.localeCompare(a.submitted))
114
+ .map((comment) => ({
115
+ id: comment.id,
116
+ source: comment.url,
117
+ kind: comment.kind,
118
+ status: comment.status,
119
+ authorName: comment.author.name,
120
+ authorUrl: comment.author.url,
121
+ submitted: comment.submitted,
122
+ })), at);
123
+ return Promise.resolve({
124
+ ok: true,
125
+ summary: `${document.slug} received ${String(page.total)} matching ${page.total === 1 ? 'webmention' : 'webmentions'}.`,
126
+ structured: { ...pageFields(page, at), received: page.items },
127
+ });
128
+ },
129
+ });
130
+ //# sourceMappingURL=webmentions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webmentions.js","sourceRoot":"","sources":["../../../src/mcp/inspect/webmentions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { GeekityEnv } from '../web/env.ts';
2
+ import type { McpTool } from './tools.ts';
3
+ export declare function activePluginTools(vars: Readonly<GeekityEnv['Variables']>): McpTool[];
4
+ //# sourceMappingURL=plugin-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/plugin-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,CA2BpF"}
@@ -0,0 +1,29 @@
1
+ import { pluginSite } from '../plugins/site.js';
2
+ import { callingClient, defineTool } from './tools.js';
3
+ export function activePluginTools(vars) {
4
+ const declared = [...vars.activePlugins].flatMap((name) => vars.plugins.find(name)?.tools ?? []);
5
+ if (declared.length === 0)
6
+ return [];
7
+ const site = pluginSite({ admin: vars.admin, config: vars.config });
8
+ const timezone = vars.siteAtRequestStart.timezone;
9
+ return declared.map(({ name, tool }) => defineTool({
10
+ name,
11
+ title: tool.title,
12
+ description: tool.description,
13
+ scope: tool.scope,
14
+ annotations: tool.annotations,
15
+ inputSchema: tool.inputSchema,
16
+ outputSchema: tool.outputSchema,
17
+ run: (args, { user, token, signal }) => tool.run(args, {
18
+ user: {
19
+ username: user.username,
20
+ ...(user.actorId === undefined ? {} : { actorId: user.actorId }),
21
+ },
22
+ ...callingClient(token),
23
+ signal,
24
+ site,
25
+ timezone,
26
+ }),
27
+ }));
28
+ }
29
+ //# sourceMappingURL=plugin-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-tools.js","sourceRoot":"","sources":["../../src/mcp/plugin-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGvD,MAAM,UAAU,iBAAiB,CAAC,IAAuC;IACvE,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACjG,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC;IAClD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CACrC,UAAU,CAAC;QACT,IAAI;QACJ,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CACrC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;YACb,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;aACjE;YACD,GAAG,aAAa,CAAC,KAAK,CAAC;YACvB,MAAM;YACN,IAAI;YACJ,QAAQ;SACT,CAAC;KACL,CAAC,CACH,CAAC;AACJ,CAAC"}
@@ -0,0 +1,67 @@
1
+ import type { McpScope } from '../plugin.ts';
2
+ import type { ToolCall, ToolRegistry } from './tools.ts';
3
+ export declare const PROTOCOL_VERSIONS: readonly ['2025-11-25', '2025-06-18', '2025-03-26'];
4
+ export type ProtocolVersion = (typeof PROTOCOL_VERSIONS)[number];
5
+ export declare const LATEST_PROTOCOL_VERSION: "2025-11-25";
6
+ /**
7
+ * What the server can do: list and call tools. The list changes when a
8
+ * plugin is enabled or disabled, but a stateless server holds no stream to
9
+ * announce that on, so a client finds out when it lists again.
10
+ */
11
+ export declare const SERVER_CAPABILITIES: {
12
+ readonly tools: {
13
+ readonly listChanged: false;
14
+ };
15
+ };
16
+ export declare const JSON_RPC_ERRORS: {
17
+ readonly parseError: -32700;
18
+ readonly invalidRequest: -32600;
19
+ readonly methodNotFound: -32601;
20
+ readonly invalidParams: -32602;
21
+ /** In the range JSON-RPC leaves to servers. */
22
+ readonly insufficientScope: -32001;
23
+ readonly rateLimited: -32002;
24
+ };
25
+ type RequestId = string | number;
26
+ interface JsonRpcError {
27
+ readonly code: number;
28
+ readonly message: string;
29
+ readonly data?: unknown;
30
+ }
31
+ export type JsonRpcResponse = {
32
+ readonly jsonrpc: '2.0';
33
+ readonly id: RequestId;
34
+ readonly result: unknown;
35
+ } | {
36
+ readonly jsonrpc: '2.0';
37
+ readonly id: RequestId | null;
38
+ readonly error: JsonRpcError;
39
+ };
40
+ export interface ServerInfo {
41
+ readonly name: string;
42
+ readonly title: string;
43
+ readonly version: string;
44
+ }
45
+ export type McpReply = {
46
+ readonly kind: 'accepted';
47
+ } | {
48
+ readonly kind: 'answer';
49
+ readonly message: JsonRpcResponse;
50
+ } | {
51
+ readonly kind: 'malformed';
52
+ readonly message: JsonRpcResponse;
53
+ } | {
54
+ readonly kind: 'insufficient-scope';
55
+ readonly scope: McpScope;
56
+ readonly message: JsonRpcResponse;
57
+ };
58
+ export interface McpServer {
59
+ readonly registry: ToolRegistry;
60
+ readonly info: ServerInfo;
61
+ readonly call: ToolCall;
62
+ }
63
+ export declare function failure(id: RequestId | null, error: JsonRpcError): JsonRpcResponse;
64
+ export declare function reply(message: unknown, server: McpServer): Promise<McpReply>;
65
+ export declare function isSupportedVersion(version: unknown): version is ProtocolVersion;
66
+ export {};
67
+ //# sourceMappingURL=protocol.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/mcp/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,cAAc,CAAC;AAG7D,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD,eAAO,MAAM,iBAAiB,YAAI,YAAY,EAAE,YAAY,EAAE,YAAY,CAAU,CAAC;AAErF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,eAAO,MAAM,uBAAuB,cAAuB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;aAAK,KAAK;iBAAI,WAAW;;CAAoB,CAAC;AAE9E,eAAO,MAAM,eAAe;aAC1B,UAAU,EAAE,CAAC,KAAK;aAClB,cAAc,EAAE,CAAC,KAAK;aACtB,cAAc,EAAE,CAAC,KAAK;aACtB,aAAa,EAAE,CAAC,KAAK;IACrB,+CAA+C;aAC/C,iBAAiB,EAAE,CAAC,KAAK;aACzB,WAAW,EAAE,CAAC,KAAK;CACX,CAAC;AAEX,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjC,UAAU,YAAY;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAE7F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACjE;IACE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC,CAAC;AAEN,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,EAAE,KAAK,EAAE,YAAY,GAAG,eAAe,CAElF;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuClF;AA8DD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,eAAe,CAE/E"}