@geekity/cms 0.42.2 → 0.44.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 (241) hide show
  1. package/admin/pages/federation/followers.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/admin/static/editor.js +22 -21
  6. package/dist/admin/app-activity.d.ts +8 -3
  7. package/dist/admin/app-activity.d.ts.map +1 -1
  8. package/dist/admin/app-activity.js +10 -3
  9. package/dist/admin/app-activity.js.map +1 -1
  10. package/dist/admin/connected-apps.d.ts +1 -1
  11. package/dist/admin/connected-apps.d.ts.map +1 -1
  12. package/dist/admin/connected-apps.js +99 -28
  13. package/dist/admin/connected-apps.js.map +1 -1
  14. package/dist/admin/indieauth-consent.d.ts.map +1 -1
  15. package/dist/admin/indieauth-consent.js +20 -2
  16. package/dist/admin/indieauth-consent.js.map +1 -1
  17. package/dist/admin/list-indent.d.ts +19 -0
  18. package/dist/admin/list-indent.d.ts.map +1 -0
  19. package/dist/admin/list-indent.js +73 -0
  20. package/dist/admin/list-indent.js.map +1 -0
  21. package/dist/admin/widget-health.d.ts.map +1 -1
  22. package/dist/admin/widget-health.js +2 -0
  23. package/dist/admin/widget-health.js.map +1 -1
  24. package/dist/cms/app.d.ts.map +1 -1
  25. package/dist/cms/app.js +3 -0
  26. package/dist/cms/app.js.map +1 -1
  27. package/dist/cms/services.d.ts.map +1 -1
  28. package/dist/cms/services.js +21 -2
  29. package/dist/cms/services.js.map +1 -1
  30. package/dist/{micropub/create.d.ts → content/micropub-create.d.ts} +5 -5
  31. package/dist/content/micropub-create.d.ts.map +1 -0
  32. package/dist/{micropub/create.js → content/micropub-create.js} +8 -8
  33. package/dist/content/micropub-create.js.map +1 -0
  34. package/dist/{micropub/update.d.ts → content/micropub-update.d.ts} +9 -9
  35. package/dist/content/micropub-update.d.ts.map +1 -0
  36. package/dist/{micropub/update.js → content/micropub-update.js} +8 -8
  37. package/dist/content/micropub-update.js.map +1 -0
  38. package/dist/federation/delivery.d.ts +20 -2
  39. package/dist/federation/delivery.d.ts.map +1 -1
  40. package/dist/federation/delivery.js +37 -23
  41. package/dist/federation/delivery.js.map +1 -1
  42. package/dist/federation/federation.d.ts.map +1 -1
  43. package/dist/federation/federation.js +2 -8
  44. package/dist/federation/federation.js.map +1 -1
  45. package/dist/federation/inbox.d.ts +5 -2
  46. package/dist/federation/inbox.d.ts.map +1 -1
  47. package/dist/federation/inbox.js +3 -3
  48. package/dist/federation/inbox.js.map +1 -1
  49. package/dist/federation/keys.d.ts +10 -0
  50. package/dist/federation/keys.d.ts.map +1 -1
  51. package/dist/federation/keys.js +13 -8
  52. package/dist/federation/keys.js.map +1 -1
  53. package/dist/federation/outbox-observer.d.ts +17 -0
  54. package/dist/federation/outbox-observer.d.ts.map +1 -0
  55. package/dist/federation/outbox-observer.js +98 -0
  56. package/dist/federation/outbox-observer.js.map +1 -0
  57. package/dist/federation/relays.d.ts.map +1 -1
  58. package/dist/federation/relays.js +32 -7
  59. package/dist/federation/relays.js.map +1 -1
  60. package/dist/federation/resend-job.d.ts +2 -1
  61. package/dist/federation/resend-job.d.ts.map +1 -1
  62. package/dist/federation/resend-job.js +11 -10
  63. package/dist/federation/resend-job.js.map +1 -1
  64. package/dist/federation/retry-job.d.ts +44 -0
  65. package/dist/federation/retry-job.d.ts.map +1 -0
  66. package/dist/federation/retry-job.js +102 -0
  67. package/dist/federation/retry-job.js.map +1 -0
  68. package/dist/files/data-files.d.ts +1 -0
  69. package/dist/files/data-files.d.ts.map +1 -1
  70. package/dist/files/data-files.js +6 -0
  71. package/dist/files/data-files.js.map +1 -1
  72. package/dist/indieauth/request.d.ts +4 -3
  73. package/dist/indieauth/request.d.ts.map +1 -1
  74. package/dist/indieauth/request.js +21 -3
  75. package/dist/indieauth/request.js.map +1 -1
  76. package/dist/mcp/audit.d.ts +3 -0
  77. package/dist/mcp/audit.d.ts.map +1 -0
  78. package/dist/mcp/audit.js +35 -0
  79. package/dist/mcp/audit.js.map +1 -0
  80. package/dist/mcp/authoring/create.d.ts +2 -0
  81. package/dist/mcp/authoring/create.d.ts.map +1 -0
  82. package/dist/mcp/authoring/create.js +79 -0
  83. package/dist/mcp/authoring/create.js.map +1 -0
  84. package/dist/mcp/authoring/publish.d.ts +2 -0
  85. package/dist/mcp/authoring/publish.d.ts.map +1 -0
  86. package/dist/mcp/authoring/publish.js +75 -0
  87. package/dist/mcp/authoring/publish.js.map +1 -0
  88. package/dist/mcp/authoring/shared.d.ts +23 -0
  89. package/dist/mcp/authoring/shared.d.ts.map +1 -0
  90. package/dist/mcp/authoring/shared.js +35 -0
  91. package/dist/mcp/authoring/shared.js.map +1 -0
  92. package/dist/mcp/authoring/source.d.ts +2 -0
  93. package/dist/mcp/authoring/source.d.ts.map +1 -0
  94. package/dist/mcp/authoring/source.js +48 -0
  95. package/dist/mcp/authoring/source.js.map +1 -0
  96. package/dist/mcp/authoring/update.d.ts +2 -0
  97. package/dist/mcp/authoring/update.d.ts.map +1 -0
  98. package/dist/mcp/authoring/update.js +97 -0
  99. package/dist/mcp/authoring/update.js.map +1 -0
  100. package/dist/mcp/authoring/upload.d.ts +3 -0
  101. package/dist/mcp/authoring/upload.d.ts.map +1 -0
  102. package/dist/mcp/authoring/upload.js +71 -0
  103. package/dist/mcp/authoring/upload.js.map +1 -0
  104. package/dist/mcp/call-limit.d.ts +18 -0
  105. package/dist/mcp/call-limit.d.ts.map +1 -0
  106. package/dist/mcp/call-limit.js +24 -0
  107. package/dist/mcp/call-limit.js.map +1 -0
  108. package/dist/mcp/endpoint.d.ts +7 -0
  109. package/dist/mcp/endpoint.d.ts.map +1 -0
  110. package/dist/mcp/endpoint.js +161 -0
  111. package/dist/mcp/endpoint.js.map +1 -0
  112. package/dist/mcp/inspect/inbox.d.ts +2 -0
  113. package/dist/mcp/inspect/inbox.d.ts.map +1 -0
  114. package/dist/mcp/inspect/inbox.js +123 -0
  115. package/dist/mcp/inspect/inbox.js.map +1 -0
  116. package/dist/mcp/inspect/paging.d.ts +71 -0
  117. package/dist/mcp/inspect/paging.d.ts.map +1 -0
  118. package/dist/mcp/inspect/paging.js +59 -0
  119. package/dist/mcp/inspect/paging.js.map +1 -0
  120. package/dist/mcp/inspect/post.d.ts +9 -0
  121. package/dist/mcp/inspect/post.d.ts.map +1 -0
  122. package/dist/mcp/inspect/post.js +161 -0
  123. package/dist/mcp/inspect/post.js.map +1 -0
  124. package/dist/mcp/inspect/records.d.ts +4 -0
  125. package/dist/mcp/inspect/records.d.ts.map +1 -0
  126. package/dist/mcp/inspect/records.js +213 -0
  127. package/dist/mcp/inspect/records.js.map +1 -0
  128. package/dist/mcp/inspect/remote.d.ts +85 -0
  129. package/dist/mcp/inspect/remote.d.ts.map +1 -0
  130. package/dist/mcp/inspect/remote.js +274 -0
  131. package/dist/mcp/inspect/remote.js.map +1 -0
  132. package/dist/mcp/inspect/schemas.d.ts +70 -0
  133. package/dist/mcp/inspect/schemas.d.ts.map +1 -0
  134. package/dist/mcp/inspect/schemas.js +46 -0
  135. package/dist/mcp/inspect/schemas.js.map +1 -0
  136. package/dist/mcp/inspect/status.d.ts +2 -0
  137. package/dist/mcp/inspect/status.d.ts.map +1 -0
  138. package/dist/mcp/inspect/status.js +194 -0
  139. package/dist/mcp/inspect/status.js.map +1 -0
  140. package/dist/mcp/inspect/webmentions.d.ts +2 -0
  141. package/dist/mcp/inspect/webmentions.d.ts.map +1 -0
  142. package/dist/mcp/inspect/webmentions.js +130 -0
  143. package/dist/mcp/inspect/webmentions.js.map +1 -0
  144. package/dist/mcp/plugin-tools.d.ts +4 -0
  145. package/dist/mcp/plugin-tools.d.ts.map +1 -0
  146. package/dist/mcp/plugin-tools.js +29 -0
  147. package/dist/mcp/plugin-tools.js.map +1 -0
  148. package/dist/mcp/protocol.d.ts +67 -0
  149. package/dist/mcp/protocol.d.ts.map +1 -0
  150. package/dist/mcp/protocol.js +130 -0
  151. package/dist/mcp/protocol.js.map +1 -0
  152. package/dist/mcp/repair/refresh.d.ts +2 -0
  153. package/dist/mcp/repair/refresh.d.ts.map +1 -0
  154. package/dist/mcp/repair/refresh.js +111 -0
  155. package/dist/mcp/repair/refresh.js.map +1 -0
  156. package/dist/mcp/repair/resend.d.ts +2 -0
  157. package/dist/mcp/repair/resend.d.ts.map +1 -0
  158. package/dist/mcp/repair/resend.js +46 -0
  159. package/dist/mcp/repair/resend.js.map +1 -0
  160. package/dist/mcp/repair/retry.d.ts +2 -0
  161. package/dist/mcp/repair/retry.d.ts.map +1 -0
  162. package/dist/mcp/repair/retry.js +91 -0
  163. package/dist/mcp/repair/retry.js.map +1 -0
  164. package/dist/mcp/repair/schemas.d.ts +30 -0
  165. package/dist/mcp/repair/schemas.d.ts.map +1 -0
  166. package/dist/mcp/repair/schemas.js +26 -0
  167. package/dist/mcp/repair/schemas.js.map +1 -0
  168. package/dist/mcp/tools.d.ts +84 -0
  169. package/dist/mcp/tools.d.ts.map +1 -0
  170. package/dist/mcp/tools.js +102 -0
  171. package/dist/mcp/tools.js.map +1 -0
  172. package/dist/mcp/whoami.d.ts +2 -0
  173. package/dist/mcp/whoami.d.ts.map +1 -0
  174. package/dist/mcp/whoami.js +40 -0
  175. package/dist/mcp/whoami.js.map +1 -0
  176. package/dist/micropub/endpoint.d.ts.map +1 -1
  177. package/dist/micropub/endpoint.js +2 -2
  178. package/dist/micropub/endpoint.js.map +1 -1
  179. package/dist/plugin.d.ts +77 -1
  180. package/dist/plugin.d.ts.map +1 -1
  181. package/dist/plugin.js +16 -1
  182. package/dist/plugin.js.map +1 -1
  183. package/dist/plugins/registry.d.ts +7 -1
  184. package/dist/plugins/registry.d.ts.map +1 -1
  185. package/dist/plugins/registry.js +23 -5
  186. package/dist/plugins/registry.js.map +1 -1
  187. package/dist/store/admin-store.d.ts +3 -3
  188. package/dist/store/admin-store.d.ts.map +1 -1
  189. package/dist/store/admin-store.js.map +1 -1
  190. package/dist/store/deliveries.d.ts +35 -4
  191. package/dist/store/deliveries.d.ts.map +1 -1
  192. package/dist/store/deliveries.js +64 -2
  193. package/dist/store/deliveries.js.map +1 -1
  194. package/dist/store/inbox.d.ts +17 -1
  195. package/dist/store/inbox.d.ts.map +1 -1
  196. package/dist/store/inbox.js +35 -0
  197. package/dist/store/inbox.js.map +1 -1
  198. package/dist/store/rows.d.ts +5 -0
  199. package/dist/store/rows.d.ts.map +1 -1
  200. package/dist/store/rows.js.map +1 -1
  201. package/dist/util/json-schema.d.ts +68 -0
  202. package/dist/util/json-schema.d.ts.map +1 -0
  203. package/dist/util/json-schema.js +60 -0
  204. package/dist/util/json-schema.js.map +1 -0
  205. package/dist/util/package-version.d.ts +2 -0
  206. package/dist/util/package-version.d.ts.map +1 -0
  207. package/dist/util/package-version.js +3 -0
  208. package/dist/util/package-version.js.map +1 -0
  209. package/dist/web/env.d.ts +2 -0
  210. package/dist/web/env.d.ts.map +1 -1
  211. package/dist/web/federation-routes.d.ts +1 -0
  212. package/dist/web/federation-routes.d.ts.map +1 -1
  213. package/dist/web/federation-routes.js +10 -7
  214. package/dist/web/federation-routes.js.map +1 -1
  215. package/dist/web/indieauth-activity-log.d.ts +23 -5
  216. package/dist/web/indieauth-activity-log.d.ts.map +1 -1
  217. package/dist/web/indieauth-activity-log.js +62 -23
  218. package/dist/web/indieauth-activity-log.js.map +1 -1
  219. package/dist/web/indieauth-bearer.d.ts +8 -1
  220. package/dist/web/indieauth-bearer.d.ts.map +1 -1
  221. package/dist/web/indieauth-bearer.js +24 -18
  222. package/dist/web/indieauth-bearer.js.map +1 -1
  223. package/dist/web/indieauth-discovery.d.ts +11 -2
  224. package/dist/web/indieauth-discovery.d.ts.map +1 -1
  225. package/dist/web/indieauth-discovery.js +22 -4
  226. package/dist/web/indieauth-discovery.js.map +1 -1
  227. package/dist/web/llms.d.ts.map +1 -1
  228. package/dist/web/llms.js +2 -0
  229. package/dist/web/llms.js.map +1 -1
  230. package/dist/web/routes.d.ts.map +1 -1
  231. package/dist/web/routes.js +4 -3
  232. package/dist/web/routes.js.map +1 -1
  233. package/dist/webmention/fetch-public.d.ts +9 -0
  234. package/dist/webmention/fetch-public.d.ts.map +1 -1
  235. package/dist/webmention/fetch-public.js +6 -4
  236. package/dist/webmention/fetch-public.js.map +1 -1
  237. package/package.json +3 -1
  238. package/dist/micropub/create.d.ts.map +0 -1
  239. package/dist/micropub/create.js.map +0 -1
  240. package/dist/micropub/update.d.ts.map +0 -1
  241. 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"}