@geekity/cms 0.43.0 → 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 (228) hide show
  1. package/admin/pages/users/activity.njk +3 -1
  2. package/admin/pages/users/apps.njk +55 -19
  3. package/admin/static/admin.css +9 -1
  4. package/dist/admin/app-activity.d.ts +8 -3
  5. package/dist/admin/app-activity.d.ts.map +1 -1
  6. package/dist/admin/app-activity.js +10 -3
  7. package/dist/admin/app-activity.js.map +1 -1
  8. package/dist/admin/connected-apps.d.ts +1 -1
  9. package/dist/admin/connected-apps.d.ts.map +1 -1
  10. package/dist/admin/connected-apps.js +99 -28
  11. package/dist/admin/connected-apps.js.map +1 -1
  12. package/dist/admin/indieauth-consent.d.ts.map +1 -1
  13. package/dist/admin/indieauth-consent.js +20 -2
  14. package/dist/admin/indieauth-consent.js.map +1 -1
  15. package/dist/admin/widget-health.d.ts.map +1 -1
  16. package/dist/admin/widget-health.js +2 -0
  17. package/dist/admin/widget-health.js.map +1 -1
  18. package/dist/cms/app.d.ts.map +1 -1
  19. package/dist/cms/app.js +3 -0
  20. package/dist/cms/app.js.map +1 -1
  21. package/dist/cms/services.d.ts.map +1 -1
  22. package/dist/cms/services.js +2 -0
  23. package/dist/cms/services.js.map +1 -1
  24. package/dist/{micropub/create.d.ts → content/micropub-create.d.ts} +5 -5
  25. package/dist/content/micropub-create.d.ts.map +1 -0
  26. package/dist/{micropub/create.js → content/micropub-create.js} +8 -8
  27. package/dist/content/micropub-create.js.map +1 -0
  28. package/dist/{micropub/update.d.ts → content/micropub-update.d.ts} +9 -9
  29. package/dist/content/micropub-update.d.ts.map +1 -0
  30. package/dist/{micropub/update.js → content/micropub-update.js} +8 -8
  31. package/dist/content/micropub-update.js.map +1 -0
  32. package/dist/federation/delivery.d.ts +20 -2
  33. package/dist/federation/delivery.d.ts.map +1 -1
  34. package/dist/federation/delivery.js +23 -20
  35. package/dist/federation/delivery.js.map +1 -1
  36. package/dist/federation/federation.d.ts.map +1 -1
  37. package/dist/federation/federation.js +2 -8
  38. package/dist/federation/federation.js.map +1 -1
  39. package/dist/federation/inbox.d.ts +5 -2
  40. package/dist/federation/inbox.d.ts.map +1 -1
  41. package/dist/federation/inbox.js +3 -3
  42. package/dist/federation/inbox.js.map +1 -1
  43. package/dist/federation/keys.d.ts +10 -0
  44. package/dist/federation/keys.d.ts.map +1 -1
  45. package/dist/federation/keys.js +13 -8
  46. package/dist/federation/keys.js.map +1 -1
  47. package/dist/federation/resend-job.d.ts +2 -1
  48. package/dist/federation/resend-job.d.ts.map +1 -1
  49. package/dist/federation/resend-job.js +11 -10
  50. package/dist/federation/resend-job.js.map +1 -1
  51. package/dist/federation/retry-job.d.ts +44 -0
  52. package/dist/federation/retry-job.d.ts.map +1 -0
  53. package/dist/federation/retry-job.js +102 -0
  54. package/dist/federation/retry-job.js.map +1 -0
  55. package/dist/files/data-files.d.ts +1 -0
  56. package/dist/files/data-files.d.ts.map +1 -1
  57. package/dist/files/data-files.js +6 -0
  58. package/dist/files/data-files.js.map +1 -1
  59. package/dist/indieauth/request.d.ts +4 -3
  60. package/dist/indieauth/request.d.ts.map +1 -1
  61. package/dist/indieauth/request.js +21 -3
  62. package/dist/indieauth/request.js.map +1 -1
  63. package/dist/mcp/audit.d.ts +3 -0
  64. package/dist/mcp/audit.d.ts.map +1 -0
  65. package/dist/mcp/audit.js +35 -0
  66. package/dist/mcp/audit.js.map +1 -0
  67. package/dist/mcp/authoring/create.d.ts +2 -0
  68. package/dist/mcp/authoring/create.d.ts.map +1 -0
  69. package/dist/mcp/authoring/create.js +79 -0
  70. package/dist/mcp/authoring/create.js.map +1 -0
  71. package/dist/mcp/authoring/publish.d.ts +2 -0
  72. package/dist/mcp/authoring/publish.d.ts.map +1 -0
  73. package/dist/mcp/authoring/publish.js +75 -0
  74. package/dist/mcp/authoring/publish.js.map +1 -0
  75. package/dist/mcp/authoring/shared.d.ts +23 -0
  76. package/dist/mcp/authoring/shared.d.ts.map +1 -0
  77. package/dist/mcp/authoring/shared.js +35 -0
  78. package/dist/mcp/authoring/shared.js.map +1 -0
  79. package/dist/mcp/authoring/source.d.ts +2 -0
  80. package/dist/mcp/authoring/source.d.ts.map +1 -0
  81. package/dist/mcp/authoring/source.js +48 -0
  82. package/dist/mcp/authoring/source.js.map +1 -0
  83. package/dist/mcp/authoring/update.d.ts +2 -0
  84. package/dist/mcp/authoring/update.d.ts.map +1 -0
  85. package/dist/mcp/authoring/update.js +97 -0
  86. package/dist/mcp/authoring/update.js.map +1 -0
  87. package/dist/mcp/authoring/upload.d.ts +3 -0
  88. package/dist/mcp/authoring/upload.d.ts.map +1 -0
  89. package/dist/mcp/authoring/upload.js +71 -0
  90. package/dist/mcp/authoring/upload.js.map +1 -0
  91. package/dist/mcp/call-limit.d.ts +18 -0
  92. package/dist/mcp/call-limit.d.ts.map +1 -0
  93. package/dist/mcp/call-limit.js +24 -0
  94. package/dist/mcp/call-limit.js.map +1 -0
  95. package/dist/mcp/endpoint.d.ts +7 -0
  96. package/dist/mcp/endpoint.d.ts.map +1 -0
  97. package/dist/mcp/endpoint.js +161 -0
  98. package/dist/mcp/endpoint.js.map +1 -0
  99. package/dist/mcp/inspect/inbox.d.ts +2 -0
  100. package/dist/mcp/inspect/inbox.d.ts.map +1 -0
  101. package/dist/mcp/inspect/inbox.js +123 -0
  102. package/dist/mcp/inspect/inbox.js.map +1 -0
  103. package/dist/mcp/inspect/paging.d.ts +71 -0
  104. package/dist/mcp/inspect/paging.d.ts.map +1 -0
  105. package/dist/mcp/inspect/paging.js +59 -0
  106. package/dist/mcp/inspect/paging.js.map +1 -0
  107. package/dist/mcp/inspect/post.d.ts +9 -0
  108. package/dist/mcp/inspect/post.d.ts.map +1 -0
  109. package/dist/mcp/inspect/post.js +161 -0
  110. package/dist/mcp/inspect/post.js.map +1 -0
  111. package/dist/mcp/inspect/records.d.ts +4 -0
  112. package/dist/mcp/inspect/records.d.ts.map +1 -0
  113. package/dist/mcp/inspect/records.js +213 -0
  114. package/dist/mcp/inspect/records.js.map +1 -0
  115. package/dist/mcp/inspect/remote.d.ts +85 -0
  116. package/dist/mcp/inspect/remote.d.ts.map +1 -0
  117. package/dist/mcp/inspect/remote.js +274 -0
  118. package/dist/mcp/inspect/remote.js.map +1 -0
  119. package/dist/mcp/inspect/schemas.d.ts +70 -0
  120. package/dist/mcp/inspect/schemas.d.ts.map +1 -0
  121. package/dist/mcp/inspect/schemas.js +46 -0
  122. package/dist/mcp/inspect/schemas.js.map +1 -0
  123. package/dist/mcp/inspect/status.d.ts +2 -0
  124. package/dist/mcp/inspect/status.d.ts.map +1 -0
  125. package/dist/mcp/inspect/status.js +194 -0
  126. package/dist/mcp/inspect/status.js.map +1 -0
  127. package/dist/mcp/inspect/webmentions.d.ts +2 -0
  128. package/dist/mcp/inspect/webmentions.d.ts.map +1 -0
  129. package/dist/mcp/inspect/webmentions.js +130 -0
  130. package/dist/mcp/inspect/webmentions.js.map +1 -0
  131. package/dist/mcp/plugin-tools.d.ts +4 -0
  132. package/dist/mcp/plugin-tools.d.ts.map +1 -0
  133. package/dist/mcp/plugin-tools.js +29 -0
  134. package/dist/mcp/plugin-tools.js.map +1 -0
  135. package/dist/mcp/protocol.d.ts +67 -0
  136. package/dist/mcp/protocol.d.ts.map +1 -0
  137. package/dist/mcp/protocol.js +130 -0
  138. package/dist/mcp/protocol.js.map +1 -0
  139. package/dist/mcp/repair/refresh.d.ts +2 -0
  140. package/dist/mcp/repair/refresh.d.ts.map +1 -0
  141. package/dist/mcp/repair/refresh.js +111 -0
  142. package/dist/mcp/repair/refresh.js.map +1 -0
  143. package/dist/mcp/repair/resend.d.ts +2 -0
  144. package/dist/mcp/repair/resend.d.ts.map +1 -0
  145. package/dist/mcp/repair/resend.js +46 -0
  146. package/dist/mcp/repair/resend.js.map +1 -0
  147. package/dist/mcp/repair/retry.d.ts +2 -0
  148. package/dist/mcp/repair/retry.d.ts.map +1 -0
  149. package/dist/mcp/repair/retry.js +91 -0
  150. package/dist/mcp/repair/retry.js.map +1 -0
  151. package/dist/mcp/repair/schemas.d.ts +30 -0
  152. package/dist/mcp/repair/schemas.d.ts.map +1 -0
  153. package/dist/mcp/repair/schemas.js +26 -0
  154. package/dist/mcp/repair/schemas.js.map +1 -0
  155. package/dist/mcp/tools.d.ts +84 -0
  156. package/dist/mcp/tools.d.ts.map +1 -0
  157. package/dist/mcp/tools.js +102 -0
  158. package/dist/mcp/tools.js.map +1 -0
  159. package/dist/mcp/whoami.d.ts +2 -0
  160. package/dist/mcp/whoami.d.ts.map +1 -0
  161. package/dist/mcp/whoami.js +40 -0
  162. package/dist/mcp/whoami.js.map +1 -0
  163. package/dist/micropub/endpoint.d.ts.map +1 -1
  164. package/dist/micropub/endpoint.js +2 -2
  165. package/dist/micropub/endpoint.js.map +1 -1
  166. package/dist/plugin.d.ts +77 -1
  167. package/dist/plugin.d.ts.map +1 -1
  168. package/dist/plugin.js +16 -1
  169. package/dist/plugin.js.map +1 -1
  170. package/dist/plugins/registry.d.ts +7 -1
  171. package/dist/plugins/registry.d.ts.map +1 -1
  172. package/dist/plugins/registry.js +23 -5
  173. package/dist/plugins/registry.js.map +1 -1
  174. package/dist/store/admin-store.d.ts +3 -3
  175. package/dist/store/admin-store.d.ts.map +1 -1
  176. package/dist/store/admin-store.js.map +1 -1
  177. package/dist/store/deliveries.d.ts +23 -0
  178. package/dist/store/deliveries.d.ts.map +1 -1
  179. package/dist/store/deliveries.js +56 -1
  180. package/dist/store/deliveries.js.map +1 -1
  181. package/dist/store/inbox.d.ts +17 -1
  182. package/dist/store/inbox.d.ts.map +1 -1
  183. package/dist/store/inbox.js +35 -0
  184. package/dist/store/inbox.js.map +1 -1
  185. package/dist/store/rows.d.ts +5 -0
  186. package/dist/store/rows.d.ts.map +1 -1
  187. package/dist/store/rows.js.map +1 -1
  188. package/dist/util/json-schema.d.ts +68 -0
  189. package/dist/util/json-schema.d.ts.map +1 -0
  190. package/dist/util/json-schema.js +60 -0
  191. package/dist/util/json-schema.js.map +1 -0
  192. package/dist/util/package-version.d.ts +2 -0
  193. package/dist/util/package-version.d.ts.map +1 -0
  194. package/dist/util/package-version.js +3 -0
  195. package/dist/util/package-version.js.map +1 -0
  196. package/dist/web/env.d.ts +2 -0
  197. package/dist/web/env.d.ts.map +1 -1
  198. package/dist/web/federation-routes.d.ts +1 -0
  199. package/dist/web/federation-routes.d.ts.map +1 -1
  200. package/dist/web/federation-routes.js +10 -7
  201. package/dist/web/federation-routes.js.map +1 -1
  202. package/dist/web/indieauth-activity-log.d.ts +23 -5
  203. package/dist/web/indieauth-activity-log.d.ts.map +1 -1
  204. package/dist/web/indieauth-activity-log.js +62 -23
  205. package/dist/web/indieauth-activity-log.js.map +1 -1
  206. package/dist/web/indieauth-bearer.d.ts +8 -1
  207. package/dist/web/indieauth-bearer.d.ts.map +1 -1
  208. package/dist/web/indieauth-bearer.js +24 -18
  209. package/dist/web/indieauth-bearer.js.map +1 -1
  210. package/dist/web/indieauth-discovery.d.ts +11 -2
  211. package/dist/web/indieauth-discovery.d.ts.map +1 -1
  212. package/dist/web/indieauth-discovery.js +22 -4
  213. package/dist/web/indieauth-discovery.js.map +1 -1
  214. package/dist/web/llms.d.ts.map +1 -1
  215. package/dist/web/llms.js +2 -0
  216. package/dist/web/llms.js.map +1 -1
  217. package/dist/web/routes.d.ts.map +1 -1
  218. package/dist/web/routes.js +4 -3
  219. package/dist/web/routes.js.map +1 -1
  220. package/dist/webmention/fetch-public.d.ts +9 -0
  221. package/dist/webmention/fetch-public.d.ts.map +1 -1
  222. package/dist/webmention/fetch-public.js +6 -4
  223. package/dist/webmention/fetch-public.js.map +1 -1
  224. package/package.json +1 -1
  225. package/dist/micropub/create.d.ts.map +0 -1
  226. package/dist/micropub/create.js.map +0 -1
  227. package/dist/micropub/update.d.ts.map +0 -1
  228. package/dist/micropub/update.js.map +0 -1
@@ -0,0 +1,97 @@
1
+ import { POST_KIND } from '../../content/document-kind.js';
2
+ import { writeDocument } from '../../content/write.js';
3
+ import { parseChanges, updateForm } from '../../content/micropub-update.js';
4
+ import { absoluteUrl } from '../../util/url.js';
5
+ import { documentSiteFrom } from '../../web/document-site.js';
6
+ import { POST_INPUT } from '../inspect/post.js';
7
+ import { ANY_OBJECT } from '../inspect/schemas.js';
8
+ import { defineTool, isRefused, refused } from '../tools.js';
9
+ import { ownPost, POST_WRITTEN, sourceSite, unsaved } from './shared.js';
10
+ export const updatePost = defineTool({
11
+ name: 'update_post',
12
+ title: 'Edit a post',
13
+ description: 'Change named properties of one of your posts, as a Micropub update does, leaving every other property as it is. Read the post with get_post_source first and pass its hash: when the post changed since, nothing is written. Changing a published post, or setting post-status to published, publishes: the post is stamped updated, federates an Update and sends webmentions, so it needs the publish scope as well.',
14
+ scope: 'update',
15
+ annotations: {
16
+ readOnlyHint: false,
17
+ destructiveHint: true,
18
+ idempotentHint: false,
19
+ openWorldHint: true,
20
+ },
21
+ inputSchema: {
22
+ type: 'object',
23
+ properties: {
24
+ post: POST_INPUT,
25
+ hash: { type: 'string', description: 'The hash get_post_source returned.' },
26
+ replace: {
27
+ ...ANY_OBJECT,
28
+ description: 'Properties whose values are replaced: {"content": ["New text"]}.',
29
+ },
30
+ add: { ...ANY_OBJECT, description: 'Values added to properties: {"category": ["new"]}.' },
31
+ delete: {
32
+ type: 'array',
33
+ items: { type: 'string' },
34
+ description: 'Properties taken away entirely: ["summary"].',
35
+ },
36
+ deleteValues: {
37
+ ...ANY_OBJECT,
38
+ description: 'Values taken out of properties: {"category": ["old"]}.',
39
+ },
40
+ },
41
+ required: ['post', 'hash'],
42
+ additionalProperties: false,
43
+ },
44
+ outputSchema: {
45
+ type: 'object',
46
+ properties: POST_WRITTEN,
47
+ required: ['url', 'slug', 'draft'],
48
+ },
49
+ run: async (args, { user, token, site }) => {
50
+ const document = ownPost(site, user, args.post);
51
+ if (isRefused(document))
52
+ return document;
53
+ const parsed = parseChanges({
54
+ replace: args.replace,
55
+ add: args.add,
56
+ delete: args.deleteValues,
57
+ });
58
+ if ('error' in parsed)
59
+ return refused(parsed.error);
60
+ const removed = (args.delete ?? []).map((property) => ({
61
+ op: 'delete',
62
+ property,
63
+ values: undefined,
64
+ }));
65
+ const changes = [...parsed, ...removed];
66
+ if (changes.length === 0)
67
+ return refused('Name a property to replace, add or delete.');
68
+ const { store, config } = site;
69
+ const updated = updateForm(document, changes, {
70
+ ...sourceSite(site),
71
+ timezone: site.siteAtRequestStart.timezone,
72
+ now: store.now(),
73
+ });
74
+ if ('errors' in updated)
75
+ return refused(updated.errors.join(' '));
76
+ const publishes = !document.draft || !updated.draft;
77
+ if (publishes && !token.scopes.includes('publish'))
78
+ return { needsScope: 'publish' };
79
+ const written = await writeDocument(documentSiteFrom(site, user.username), {
80
+ kind: POST_KIND,
81
+ document,
82
+ form: { ...updated.form, hash: args.hash },
83
+ draft: updated.draft,
84
+ keptProperties: updated.keptProperties,
85
+ });
86
+ if (written.outcome !== 'saved')
87
+ return unsaved(written, document.slug);
88
+ const { saved } = written;
89
+ const url = absoluteUrl(saved.permalink, config.baseUrl);
90
+ return {
91
+ ok: true,
92
+ summary: `Updated ${saved.slug} at ${url}${saved.draft ? ', still a draft' : ''}.`,
93
+ structured: { url, slug: saved.slug, draft: saved.draft },
94
+ };
95
+ },
96
+ });
97
+ //# sourceMappingURL=update.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/mcp/authoring/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;IACnC,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,aAAa;IACpB,WAAW,EACT,wZAAwZ;IAC1Z,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,IAAI;KACpB;IACD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC3E,OAAO,EAAE;gBACP,GAAG,UAAU;gBACb,WAAW,EAAE,kEAAkE;aAChF;YACD,GAAG,EAAE,EAAE,GAAG,UAAU,EAAE,WAAW,EAAE,oDAAoD,EAAE;YACzF,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,8CAA8C;aAC5D;YACD,YAAY,EAAE;gBACZ,GAAG,UAAU;gBACb,WAAW,EAAE,wDAAwD;aACtE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAC1B,oBAAoB,EAAE,KAAK;KAC5B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,YAAY;QACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;KACnC;IACD,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,SAAS,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QAEzC,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,IAAI,CAAC,YAAY;SAC1B,CAAC,CAAC;QACH,IAAI,OAAO,IAAI,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAU,EAAE,CAAC,CAAC;YAC7D,EAAE,EAAE,QAAQ;YACZ,QAAQ;YACR,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC,CAAC;QACJ,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;QACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,4CAA4C,CAAC,CAAC;QAEvF,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE;YAC5C,GAAG,UAAU,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,IAAI,CAAC,kBAAkB,CAAC,QAAQ;YAC1C,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE;SACjB,CAAC,CAAC;QACH,IAAI,QAAQ,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QACpD,IAAI,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QAErF,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;YACzE,IAAI,EAAE,SAAS;YACf,QAAQ;YACR,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YAC1C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,cAAc,EAAE,OAAO,CAAC,cAAc;SACvC,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACzD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,WAAW,KAAK,CAAC,IAAI,OAAO,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG;YAClF,UAAU,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;SAC1D,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}
@@ -0,0 +1,3 @@
1
+ export declare function base64Length(bytes: number): number;
2
+ export declare const uploadMedia: import("../tools.ts").McpTool;
3
+ //# sourceMappingURL=upload.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/mcp/authoring/upload.ts"],"names":[],"mappings":"AAcA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,eAAO,MAAM,WAAW,+BA+DtB,CAAC"}
@@ -0,0 +1,71 @@
1
+ import { writeAltText } from '../../content/alt-text.js';
2
+ import { uploadPath } from '../../content/image-tags.js';
3
+ import { largestUploadLimit, refusedUpload, storeUpload, tooLargeMessage, } from '../../media/uploads.js';
4
+ import { nullable } from '../../util/json-schema.js';
5
+ import { absoluteUrl } from '../../util/url.js';
6
+ import { defineTool, refused } from '../tools.js';
7
+ const BASE64 = /^[A-Za-z0-9+/]*={0,2}$/;
8
+ export function base64Length(bytes) {
9
+ return Math.ceil(bytes / 3) * 4;
10
+ }
11
+ export const uploadMedia = defineTool({
12
+ name: 'upload_media',
13
+ title: 'Upload media',
14
+ description: 'Store a file in the media library, under the same rules as the admin’s uploads and the Micropub media endpoint, with its alt text. Returns the file’s address, to use as a photo property or in a post’s content.',
15
+ scope: 'media',
16
+ annotations: {
17
+ readOnlyHint: false,
18
+ destructiveHint: false,
19
+ idempotentHint: false,
20
+ openWorldHint: false,
21
+ },
22
+ inputSchema: {
23
+ type: 'object',
24
+ properties: {
25
+ filename: {
26
+ type: 'string',
27
+ description: 'The file’s name with its extension, such as sunset.jpg. The extension decides what the file is.',
28
+ },
29
+ data: { type: 'string', description: 'The file’s bytes, base64-encoded.' },
30
+ alt: {
31
+ type: 'string',
32
+ description: 'What the image shows, for somebody who cannot see it.',
33
+ },
34
+ },
35
+ required: ['filename', 'data'],
36
+ additionalProperties: false,
37
+ },
38
+ outputSchema: {
39
+ type: 'object',
40
+ properties: {
41
+ url: { type: 'string', description: 'The file’s address.' },
42
+ kind: { type: 'string', description: 'image, audio, video or document.' },
43
+ alt: nullable({ type: 'string' }),
44
+ },
45
+ required: ['url', 'kind', 'alt'],
46
+ },
47
+ run: async (args, { site }) => {
48
+ const { config } = site;
49
+ const limit = largestUploadLimit(config);
50
+ const data = args.data.replace(/\s+/g, '');
51
+ if (data.length > base64Length(limit))
52
+ return refused(tooLargeMessage(limit));
53
+ if (!BASE64.test(data) || data.length % 4 === 1)
54
+ return refused('data is not base64.');
55
+ const stored = await storeUpload(new File([Buffer.from(data, 'base64')], args.filename), config);
56
+ if (refusedUpload(stored))
57
+ return refused(stored.error);
58
+ const alt = args.alt?.trim().replace(/\s+/g, ' ') ?? '';
59
+ const source = uploadPath(stored.url);
60
+ if (alt !== '' && source !== undefined) {
61
+ await writeAltText(config.contentDir, source, { kind: 'described', text: alt });
62
+ }
63
+ const url = absoluteUrl(stored.url, config.baseUrl);
64
+ return {
65
+ ok: true,
66
+ summary: `Stored ${url}${alt === '' ? ' with no alt text' : ''}.`,
67
+ structured: { url, kind: stored.media.kind, alt: alt === '' ? null : alt },
68
+ };
69
+ },
70
+ });
71
+ //# sourceMappingURL=upload.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload.js","sourceRoot":"","sources":["../../../src/mcp/authoring/upload.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import type { Clock } from '../util/clock.ts';
2
+ export type LimitDecision = {
3
+ readonly kind: 'allowed';
4
+ } | {
5
+ readonly kind: 'refused';
6
+ readonly retryAfter: number;
7
+ readonly first: boolean;
8
+ };
9
+ export interface CallLimit {
10
+ take(key: string): LimitDecision;
11
+ }
12
+ export interface CallLimitOptions {
13
+ readonly calls: number;
14
+ readonly windowSeconds: number;
15
+ readonly now: Clock;
16
+ }
17
+ export declare function createCallLimit(options: CallLimitOptions): CallLimit;
18
+ //# sourceMappingURL=call-limit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"call-limit.d.ts","sourceRoot":"","sources":["../../src/mcp/call-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvF,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAqBpE"}
@@ -0,0 +1,24 @@
1
+ export function createCallLimit(options) {
2
+ const window = options.windowSeconds * 1000;
3
+ const windows = new Map();
4
+ return {
5
+ take(key) {
6
+ const at = options.now().getTime();
7
+ for (const [each, entry] of windows) {
8
+ if (at >= entry.endsAt)
9
+ windows.delete(each);
10
+ }
11
+ const entry = windows.get(key) ?? { count: 0, endsAt: at + window };
12
+ entry.count += 1;
13
+ windows.set(key, entry);
14
+ if (entry.count <= options.calls)
15
+ return { kind: 'allowed' };
16
+ return {
17
+ kind: 'refused',
18
+ retryAfter: Math.max(1, Math.ceil((entry.endsAt - at) / 1000)),
19
+ first: entry.count === options.calls + 1,
20
+ };
21
+ },
22
+ };
23
+ }
24
+ //# sourceMappingURL=call-limit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"call-limit.js","sourceRoot":"","sources":["../../src/mcp/call-limit.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6C,CAAC;IAErE,OAAO;QACL,IAAI,CAAC,GAAG;YACN,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;YACnC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;gBACpC,IAAI,EAAE,IAAI,KAAK,CAAC,MAAM;oBAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC/C,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;YACpE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxB,IAAI,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK;gBAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC7D,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC9D,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,GAAG,CAAC;aACzC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,7 @@
1
+ import type { Hono } from 'hono';
2
+ import type { ResolvedConfig } from '../config.ts';
3
+ import type { GeekityEnv } from '../web/env.ts';
4
+ export declare const MCP_CALLS_PER_WINDOW = 60;
5
+ export declare const MCP_CALL_WINDOW_SECONDS = 60;
6
+ export declare function mountMcp(app: Hono<GeekityEnv>, config: ResolvedConfig): void;
7
+ //# sourceMappingURL=endpoint.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/mcp/endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAqB,MAAM,MAAM,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AA6DhD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,wBAAgB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CA0F5E"}
@@ -0,0 +1,161 @@
1
+ import { bearerChallenge, requireBearer } from '../web/indieauth-bearer.js';
2
+ import { MCP_PATH, MCP_RESOURCE_METADATA_PATH, MCP_SERVER_CARD_PATH, } from '../web/indieauth-discovery.js';
3
+ import { largestUploadLimit, UPLOAD_ENVELOPE_BYTES } from '../media/uploads.js';
4
+ import { PACKAGE_VERSION } from '../util/package-version.js';
5
+ import { readWithin } from '../webmention/fetch-public.js';
6
+ import { failure, isSupportedVersion, JSON_RPC_ERRORS, LATEST_PROTOCOL_VERSION, reply, SERVER_CAPABILITIES, } from './protocol.js';
7
+ import { auditToolCall } from './audit.js';
8
+ import { createCallLimit } from './call-limit.js';
9
+ import { createToolRegistry } from './tools.js';
10
+ import { activePluginTools } from './plugin-tools.js';
11
+ import { whoami } from './whoami.js';
12
+ import { createDraft } from './authoring/create.js';
13
+ import { publishPost } from './authoring/publish.js';
14
+ import { getPostSource } from './authoring/source.js';
15
+ import { updatePost } from './authoring/update.js';
16
+ import { base64Length, uploadMedia } from './authoring/upload.js';
17
+ import { inboxSearch } from './inspect/inbox.js';
18
+ import { postFederation } from './inspect/post.js';
19
+ import { followers, quoteApprovals, relays } from './inspect/records.js';
20
+ import { remoteLookup } from './inspect/remote.js';
21
+ import { federationStatus } from './inspect/status.js';
22
+ import { webmentions } from './inspect/webmentions.js';
23
+ import { refreshActor } from './repair/refresh.js';
24
+ import { resendPost } from './repair/resend.js';
25
+ import { retryDeliveries } from './repair/retry.js';
26
+ const CORE_TOOLS = [
27
+ whoami,
28
+ federationStatus,
29
+ inboxSearch,
30
+ postFederation,
31
+ followers,
32
+ relays,
33
+ quoteApprovals,
34
+ webmentions,
35
+ remoteLookup,
36
+ resendPost,
37
+ retryDeliveries,
38
+ refreshActor,
39
+ createDraft,
40
+ getPostSource,
41
+ updatePost,
42
+ publishPost,
43
+ uploadMedia,
44
+ ];
45
+ export const MCP_CALLS_PER_WINDOW = 60;
46
+ export const MCP_CALL_WINDOW_SECONDS = 60;
47
+ export function mountMcp(app, config) {
48
+ const guards = {
49
+ limit: createCallLimit({
50
+ calls: MCP_CALLS_PER_WINDOW,
51
+ windowSeconds: MCP_CALL_WINDOW_SECONDS,
52
+ now: config.now,
53
+ }),
54
+ record: (record) => {
55
+ auditToolCall(config.dataDir, record, config.now());
56
+ },
57
+ };
58
+ app.post(MCP_PATH, sameOriginOnly, requireMcpToken, async (c) => {
59
+ c.header('cache-control', 'no-store');
60
+ const version = c.req.header('mcp-protocol-version');
61
+ if (version !== undefined && !isSupportedVersion(version)) {
62
+ return c.json(failure(null, {
63
+ code: JSON_RPC_ERRORS.invalidRequest,
64
+ message: `This server does not speak MCP ${version}.`,
65
+ }), 400);
66
+ }
67
+ const limit = bodyLimit(c.var.config);
68
+ const read = await readWithin(c.req.raw, limit, 'refuse');
69
+ if (read === undefined) {
70
+ return c.json(failure(null, {
71
+ code: JSON_RPC_ERRORS.invalidRequest,
72
+ message: `The request is larger than the ${String(limit)} bytes this server takes.`,
73
+ }), 413);
74
+ }
75
+ let message;
76
+ try {
77
+ message = JSON.parse(new TextDecoder().decode(read.body));
78
+ }
79
+ catch {
80
+ return c.json(failure(null, { code: JSON_RPC_ERRORS.parseError, message: 'The body is not JSON.' }), 400);
81
+ }
82
+ const { user, token } = c.var.bearer;
83
+ const answered = await reply(message, {
84
+ registry: createToolRegistry(toolsFor(c.var), guards),
85
+ info: serverInfo(c.var.siteAtRequestStart.title),
86
+ call: { user, token, signal: c.req.raw.signal, site: c.var },
87
+ });
88
+ switch (answered.kind) {
89
+ case 'accepted':
90
+ return c.body(null, 202);
91
+ case 'answer':
92
+ return c.json(answered.message);
93
+ case 'malformed':
94
+ return c.json(answered.message, 400);
95
+ case 'insufficient-scope':
96
+ return refuseForScope(c, [...token.scopes, answered.scope], answered.message);
97
+ }
98
+ });
99
+ // Streamable HTTP lets a server that opens no stream and keeps no session
100
+ // answer GET and DELETE with 405.
101
+ app.on(['GET', 'DELETE'], MCP_PATH, sameOriginOnly, requireMcpToken, (c) => {
102
+ c.header('allow', 'POST');
103
+ return c.body(null, 405);
104
+ });
105
+ app.get(MCP_SERVER_CARD_PATH, (c) => {
106
+ const { baseUrl } = c.var.config;
107
+ return c.json({
108
+ serverInfo: serverInfo(c.var.siteAtRequestStart.title),
109
+ description: 'Tools for inspecting and running this Geekity CMS site.',
110
+ protocolVersion: LATEST_PROTOCOL_VERSION,
111
+ transport: { type: 'streamable-http', endpoint: `${baseUrl}${MCP_PATH}` },
112
+ capabilities: SERVER_CAPABILITIES,
113
+ authentication: {
114
+ required: true,
115
+ schemes: ['oauth2'],
116
+ resourceMetadata: `${baseUrl}${MCP_RESOURCE_METADATA_PATH}`,
117
+ },
118
+ tools: createToolRegistry(toolsFor(c.var), guards)
119
+ .list()
120
+ .map(({ name, title, description }) => ({ name, title, description })),
121
+ });
122
+ });
123
+ }
124
+ function bodyLimit(config) {
125
+ return base64Length(largestUploadLimit(config)) + UPLOAD_ENVELOPE_BYTES;
126
+ }
127
+ function toolsFor(vars) {
128
+ return { core: CORE_TOOLS, plugin: activePluginTools(vars) };
129
+ }
130
+ function serverInfo(title) {
131
+ return { name: 'geekity', title, version: PACKAGE_VERSION };
132
+ }
133
+ const requireMcpToken = async (c, next) => await requireBearer({
134
+ audience: { resource: `${c.var.config.baseUrl}${MCP_PATH}`, acceptsUnbound: false },
135
+ resourceMetadataPath: MCP_RESOURCE_METADATA_PATH,
136
+ })(c, next);
137
+ /**
138
+ * A browser sends an Origin header, and a page on another origin must not
139
+ * reach the endpoint through it: the transport spec's guard against DNS
140
+ * rebinding. A client that is not a browser sends none and is let through.
141
+ */
142
+ const sameOriginOnly = async (c, next) => {
143
+ const origin = c.req.header('origin');
144
+ if (origin !== undefined && origin !== new URL(c.var.config.baseUrl).origin) {
145
+ return c.json(failure(null, {
146
+ code: JSON_RPC_ERRORS.invalidRequest,
147
+ message: 'Requests from another origin are refused.',
148
+ }), 403);
149
+ }
150
+ await next();
151
+ };
152
+ /**
153
+ * The MCP authorization spec's answer to a token short of a scope: 403 with a
154
+ * challenge naming the scopes the token holds and the one it lacks, so a
155
+ * client can ask the person for them all in one sign-in.
156
+ */
157
+ function refuseForScope(c, scopes, message) {
158
+ c.header('www-authenticate', bearerChallenge(c.var.config.baseUrl, { error: 'insufficient_scope', scope: [...new Set(scopes)].join(' ') }, MCP_RESOURCE_METADATA_PATH));
159
+ return c.json(message, 403);
160
+ }
161
+ //# sourceMappingURL=endpoint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/mcp/endpoint.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare const inboxSearch: import("../tools.ts").McpTool;
2
+ //# sourceMappingURL=inbox.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../../src/mcp/inspect/inbox.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,WAAW,+BA2HtB,CAAC"}
@@ -0,0 +1,123 @@
1
+ import { localPosts } from '../../admin/federation.js';
2
+ import { readObjectIds } from '../../federation/object-ids.js';
3
+ import { nullable } from '../../util/json-schema.js';
4
+ import { defineTool } from '../tools.js';
5
+ import { counted, instants, PAGE_INPUT, PAGE_OUTPUT, PAGE_REQUIRED, pageAt, pageFields, TIME_INPUT, } from './paging.js';
6
+ import { ANY_OBJECT, READ_ONLY } from './schemas.js';
7
+ function postResolver(site) {
8
+ return localPosts(site.store, site.config.baseUrl, readObjectIds(site.config.contentDir), (url) => site.replyContexts.read(url, site.siteAtRequestStart), (url) => site.conversation.documentOf(url));
9
+ }
10
+ export const inboxSearch = defineTool({
11
+ name: 'inbox_search',
12
+ title: 'Search the inbox log',
13
+ description: 'Searches the activities the site received: likes, boosts, replies, quotes, follows, undos and deletes, newest first. Narrow by type, actor, object, reply target, recipient and time. Each row names the site post it was about, or null when its id matches none, which is why a reply does not show. Set includeJson to get each activity as it arrived.',
14
+ scope: 'inspect',
15
+ annotations: READ_ONLY,
16
+ inputSchema: {
17
+ type: 'object',
18
+ properties: {
19
+ id: { type: 'integer', minimum: 1, description: 'One row by its log id.' },
20
+ activityId: { type: 'string', description: 'The activity’s own id.' },
21
+ type: { type: 'string', description: 'The activity type, such as Create, Like or Undo.' },
22
+ actor: { type: 'string', description: 'The actor id that sent it.' },
23
+ object: { type: 'string', description: 'The object id it was about.' },
24
+ inReplyTo: { type: 'string', description: 'The id a Create’s note replies to.' },
25
+ recipient: { type: 'string', description: 'The username whose inbox it was sent to.' },
26
+ ...TIME_INPUT,
27
+ includeJson: { type: 'boolean', description: 'Return each activity’s full JSON.' },
28
+ ...PAGE_INPUT,
29
+ },
30
+ additionalProperties: false,
31
+ },
32
+ outputSchema: {
33
+ type: 'object',
34
+ properties: {
35
+ ...PAGE_OUTPUT,
36
+ activities: {
37
+ type: 'array',
38
+ items: {
39
+ type: 'object',
40
+ properties: {
41
+ id: { type: 'integer' },
42
+ activityId: nullable({ type: 'string' }),
43
+ type: { type: 'string' },
44
+ actorId: { type: 'string' },
45
+ objectId: nullable({ type: 'string' }),
46
+ inReplyTo: nullable({ type: 'string' }),
47
+ recipient: nullable({ type: 'string' }),
48
+ receivedAt: { type: 'string' },
49
+ fetched: {
50
+ type: 'boolean',
51
+ description: 'Whether the site read it from a replies collection rather than was sent it.',
52
+ },
53
+ post: nullable({
54
+ type: 'object',
55
+ description: 'The site post it was about, or that its note replies to.',
56
+ properties: {
57
+ slug: { type: 'string' },
58
+ title: { type: 'string' },
59
+ editUrl: { type: 'string' },
60
+ inThread: {
61
+ type: 'boolean',
62
+ description: 'Whether it named a reply in the post’s thread rather than the post.',
63
+ },
64
+ },
65
+ required: ['slug', 'title', 'editUrl', 'inThread'],
66
+ }),
67
+ activity: { ...ANY_OBJECT, description: 'The activity as received, with includeJson.' },
68
+ },
69
+ required: [
70
+ 'id',
71
+ 'activityId',
72
+ 'type',
73
+ 'actorId',
74
+ 'objectId',
75
+ 'inReplyTo',
76
+ 'recipient',
77
+ 'receivedAt',
78
+ 'fetched',
79
+ 'post',
80
+ ],
81
+ },
82
+ },
83
+ },
84
+ required: [...PAGE_REQUIRED, 'activities'],
85
+ },
86
+ run: (args, { site }) => {
87
+ const range = instants(args);
88
+ if (!range.ok)
89
+ return Promise.resolve(range);
90
+ const at = pageAt(args);
91
+ const page = site.admin.searchInboxActivities({
92
+ id: args.id,
93
+ activityId: args.activityId,
94
+ type: args.type,
95
+ actor: args.actor,
96
+ object: args.object,
97
+ inReplyTo: args.inReplyTo,
98
+ recipient: args.recipient,
99
+ since: range.since,
100
+ until: range.until,
101
+ }, at);
102
+ const post = postResolver(site);
103
+ const activities = page.items.map((row) => ({
104
+ id: row.id,
105
+ activityId: row.activityId,
106
+ type: row.activityType,
107
+ actorId: row.actorId,
108
+ objectId: row.objectId,
109
+ inReplyTo: row.inReplyTo,
110
+ recipient: row.recipient,
111
+ receivedAt: row.receivedAt,
112
+ fetched: row.fetched,
113
+ post: post(row.inReplyTo ?? row.objectId),
114
+ ...(args.includeJson === true ? { activity: JSON.parse(row.json) } : {}),
115
+ }));
116
+ return Promise.resolve({
117
+ ok: true,
118
+ summary: counted(page.total, 'logged activity matches', 'logged activities match', activities.length, at.offset),
119
+ structured: { ...pageFields(page, at), activities },
120
+ });
121
+ },
122
+ });
123
+ //# sourceMappingURL=inbox.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inbox.js","sourceRoot":"","sources":["../../../src/mcp/inspect/inbox.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,71 @@
1
+ import type { Page } from '../../store/rows.ts';
2
+ export declare const DEFAULT_LIMIT = 20;
3
+ export declare const PAGE_INPUT: {
4
+ readonly limit: {
5
+ readonly type: 'integer';
6
+ readonly minimum: 1;
7
+ readonly maximum: 100;
8
+ readonly description: `How many to return. ${string} unless given.`;
9
+ };
10
+ readonly offset: {
11
+ readonly type: 'integer';
12
+ readonly minimum: 0;
13
+ readonly description: 'How many matches to skip: the nextOffset of the page before.';
14
+ };
15
+ };
16
+ export declare const TIME_INPUT: {
17
+ readonly since: {
18
+ readonly type: 'string';
19
+ readonly description: 'Only records at or after this ISO 8601 instant.';
20
+ };
21
+ readonly until: {
22
+ readonly type: 'string';
23
+ readonly description: 'Only records before this ISO 8601 instant.';
24
+ };
25
+ };
26
+ export declare const PAGE_OUTPUT: {
27
+ readonly total: {
28
+ readonly type: 'integer';
29
+ readonly description: 'How many records match, across every page.';
30
+ };
31
+ readonly nextOffset: {
32
+ readonly anyOf: readonly [{
33
+ readonly type: "integer";
34
+ readonly description: "The offset that asks for the next page, or null on the last one.";
35
+ }, {
36
+ readonly type: 'null';
37
+ }];
38
+ };
39
+ };
40
+ export declare const PAGE_REQUIRED: readonly ['total', 'nextOffset'];
41
+ export interface PageAt {
42
+ readonly limit: number;
43
+ readonly offset: number;
44
+ }
45
+ export declare function pageAt(args: {
46
+ readonly limit?: number;
47
+ readonly offset?: number;
48
+ }): PageAt;
49
+ export declare function pageFields<T>(page: Page<T>, at: PageAt): {
50
+ total: number;
51
+ nextOffset: number | null;
52
+ };
53
+ export declare function counted(total: number, noun: string, plural: string, shown: number, offset: number): string;
54
+ export declare function pageOfList<T>(items: readonly T[], at: PageAt): Page<T>;
55
+ export type Instants = {
56
+ readonly ok: true;
57
+ readonly since?: string;
58
+ readonly until?: string;
59
+ } | {
60
+ readonly ok: false;
61
+ readonly message: string;
62
+ };
63
+ export declare function instants(args: {
64
+ readonly since?: string;
65
+ readonly until?: string;
66
+ }): Instants;
67
+ export declare function within(at: string, range: {
68
+ readonly since?: string;
69
+ readonly until?: string;
70
+ }): boolean;
71
+ //# sourceMappingURL=paging.d.ts.map