@jant/core 0.8.0 → 0.9.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 (160) hide show
  1. package/dist/{app-CFsmRVJN.js → app-BzH8jmh3.js} +1619 -500
  2. package/dist/client/.vite/manifest.json +2 -2
  3. package/dist/client/_assets/{client-DTLBOHqD.js → client-S8oryJ0m.js} +1 -1
  4. package/dist/client/_assets/{client-auth-D6Ix6SmE.js → client-auth-Ds9G0IgR.js} +1 -1
  5. package/dist/index.js +1 -1
  6. package/dist/node.js +2 -2
  7. package/package.json +1 -1
  8. package/src/__tests__/fixtures/releases/0.8.0/site-export/README.md +130 -0
  9. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/2thjq/_index.md +25 -0
  10. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/2u5e5/_index.md +35 -0
  11. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/0x4nv/index.md +18 -0
  12. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/_index.md +44 -0
  13. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/faqyt/index.md +30 -0
  14. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
  15. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5kayp/_index.md +23 -0
  16. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5ynfs/_index.md +31 -0
  17. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5ynfs/hu597/index.md +21 -0
  18. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/_index.md +5 -0
  19. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
  20. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
  21. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/archive/_index.md +8 -0
  22. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +30 -0
  23. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/bought-too-many-lemons-again/_index.md +37 -0
  24. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/city-walks/_index.md +12 -0
  25. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/cleanshot-for-screenshots-ocr-and-screen-recording-on-the-mac/_index.md +33 -0
  26. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/cleanshotmac-shang-de-jie-tu-ocr-lu-ping-gong-ju/_index.md +32 -0
  27. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/co344/_index.md +25 -0
  28. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/collections/_index.md +5 -0
  29. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/current-tea-rotation/_index.md +34 -0
  30. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +30 -0
  31. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/desk-but-better/_index.md +25 -0
  32. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/e0kcg/_index.md +22 -0
  33. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/egi3c/_index.md +24 -0
  34. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/evf9j/_index.md +152 -0
  35. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/featured/_index.md +8 -0
  36. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-basho/_index.md +25 -0
  37. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-epictetus/_index.md +25 -0
  38. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-marcus-aurelius/_index.md +25 -0
  39. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-seneca/_index.md +26 -0
  40. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-thoreau/_index.md +25 -0
  41. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/2cl6d/index.md +18 -0
  42. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/3zqv7/index.md +30 -0
  43. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/5oxsv/index.md +18 -0
  44. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/_index.md +39 -0
  45. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gwob9/_index.md +25 -0
  46. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/home-cooking/_index.md +12 -0
  47. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/hz729/_index.md +24 -0
  48. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +44 -0
  49. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/j4v0q/_index.md +35 -0
  50. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k278t/_index.md +25 -0
  51. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k4eee/_index.md +22 -0
  52. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/_index.md +32 -0
  53. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
  54. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/a83qu/index.md +18 -0
  55. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
  56. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/kan-qi-lai-bi-jiao-ku-de-gong-si-men/_index.md +41 -0
  57. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/l2m7y/_index.md +29 -0
  58. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/lan-ya-yao-kong-qi-chuang-shang-yue-du-de-fan-ye-shen-qi/_index.md +57 -0
  59. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
  60. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/n09le/_index.md +23 -0
  61. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/ni-fu-jin-de-wei-ji-bai-ke-tiao-mu/_index.md +42 -0
  62. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
  63. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/_index.md +32 -0
  64. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/c91j0/index.md +18 -0
  65. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/qyucy/index.md +18 -0
  66. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/wsgck/index.md +18 -0
  67. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +46 -0
  68. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/reading-notes/_index.md +12 -0
  69. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/s4r3e/_index.md +25 -0
  70. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
  71. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/_index.md +44 -0
  72. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/cxiu6/index.md +18 -0
  73. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/t77ms/index.md +18 -0
  74. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
  75. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/telk3/_index.md +30 -0
  76. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
  77. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +36 -0
  78. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
  79. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
  80. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tiny-projects/_index.md +12 -0
  81. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
  82. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tou-ma-yan-jiang-ju-le-bu-chu-ti-yan/_index.md +62 -0
  83. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/useful-links/_index.md +12 -0
  84. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/weekend-notes/_index.md +12 -0
  85. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +52 -0
  86. package/src/__tests__/fixtures/releases/0.8.0/site-export/data/jant.toml +124 -0
  87. package/src/__tests__/fixtures/releases/0.8.0/site-export/hugo.toml +45 -0
  88. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/_redirects +25 -0
  89. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/15d51730a4f7-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  90. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  91. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  92. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  93. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  94. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  95. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  96. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  97. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  98. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
  99. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
  100. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
  101. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
  102. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
  103. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
  104. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
  105. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
  106. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
  107. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
  108. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
  109. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
  110. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
  111. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
  112. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
  113. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
  114. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
  115. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
  116. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
  117. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
  118. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  119. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/custom.css +0 -0
  120. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/favicon.ico +0 -0
  121. package/src/__tests__/fixtures/releases/0.8.0/site-export/wrangler.jsonc +24 -0
  122. package/src/__tests__/fixtures/releases/0.8.0/snapshot/db.sql +322 -0
  123. package/src/__tests__/fixtures/releases/0.8.0/snapshot/meta.json +11 -0
  124. package/src/__tests__/helpers/cursor-walk.ts +82 -0
  125. package/src/__tests__/release-fixtures.test.ts +6 -2
  126. package/src/app.tsx +4 -0
  127. package/src/lib/__tests__/post-list-cursor.test.ts +105 -0
  128. package/src/lib/__tests__/thread-fold.test.ts +43 -0
  129. package/src/lib/__tests__/timeline.test.ts +14 -14
  130. package/src/lib/api-posts.ts +110 -2
  131. package/src/lib/api-public-posts.ts +263 -0
  132. package/src/lib/api-threads.ts +207 -0
  133. package/src/lib/post-list-cursor.ts +211 -0
  134. package/src/lib/thread-fold.ts +83 -41
  135. package/src/lib/thread-query.ts +143 -0
  136. package/src/middleware/cors.ts +8 -1
  137. package/src/middleware/deprecation.ts +48 -0
  138. package/src/routes/api/__tests__/mcp.test.ts +147 -0
  139. package/src/routes/api/__tests__/posts.test.ts +157 -0
  140. package/src/routes/api/__tests__/public-access.test.ts +5 -0
  141. package/src/routes/api/__tests__/threads.test.ts +115 -0
  142. package/src/routes/api/posts.ts +19 -112
  143. package/src/routes/api/public/__tests__/archive.test.ts +261 -0
  144. package/src/routes/api/public/__tests__/posts.test.ts +344 -19
  145. package/src/routes/api/public/__tests__/threads.test.ts +363 -0
  146. package/src/routes/api/public/archive.ts +82 -79
  147. package/src/routes/api/public/posts.ts +97 -299
  148. package/src/routes/api/public/threads.ts +141 -0
  149. package/src/routes/api/threads.ts +128 -0
  150. package/src/services/__tests__/post.test.ts +342 -36
  151. package/src/services/__tests__/thread.test.ts +495 -0
  152. package/src/services/index.ts +4 -0
  153. package/src/services/mcp.ts +213 -63
  154. package/src/services/post.ts +734 -361
  155. package/src/services/thread.ts +392 -0
  156. package/src/types/constants.ts +25 -0
  157. package/src/ui/feed/ThreadPreview.tsx +9 -14
  158. package/src/ui/feed/__tests__/thread-preview.test.ts +18 -22
  159. package/src/ui/feed/thread-preview-state.ts +0 -35
  160. package/src/ui/shared/Pagination.tsx +1 -1
@@ -3,6 +3,7 @@ import {
3
3
  CollectionDescriptionValueSchema,
4
4
  CollectionIdSchema,
5
5
  CollectionSortOrderSchema,
6
+ ContentLanguageSchema,
6
7
  CreateCollectionSchema,
7
8
  CreatePostApiSchema,
8
9
  FormatSchema,
@@ -15,7 +16,9 @@ import {
15
16
  COLLECTION_SORT_ORDERS,
16
17
  FORMATS,
17
18
  STATUSES,
19
+ THREAD_SORTS,
18
20
  VISIBILITIES,
21
+ type Post,
19
22
  } from "../types.js";
20
23
  import type { AppConfig } from "../types/config.js";
21
24
  import type { StorageDriver } from "../lib/storage.js";
@@ -25,8 +28,14 @@ import {
25
28
  buildEditableSettingsResponse,
26
29
  partitionEditableSettingUpdates,
27
30
  } from "../lib/api-settings.js";
28
- import { toApiAttachment, toApiPost } from "../lib/api-posts.js";
31
+ import {
32
+ apiPostListOrder,
33
+ loadApiPostResponse,
34
+ loadApiPostResponses,
35
+ } from "../lib/api-posts.js";
29
36
  import { toSearchApiResult } from "../lib/api-search.js";
37
+ import { loadApiThreadResponses } from "../lib/api-threads.js";
38
+ import { parseThreadSelection } from "../lib/thread-query.js";
30
39
  import {
31
40
  ConfigurationError,
32
41
  ExternalServiceError,
@@ -140,11 +149,73 @@ const AddCollectionThreadToolSchema = z.object({
140
149
 
141
150
  const RemoveCollectionThreadToolSchema = AddCollectionThreadToolSchema;
142
151
 
152
+ /**
153
+ * The filter dimensions `jant_threads_list` takes, spelled as the HTTP API
154
+ * and the archive spell them. They reach the same registry parser as a query
155
+ * string would, so the vocabularies can't drift.
156
+ */
157
+ const THREAD_FILTER_TOOL_PROPERTIES = {
158
+ format: { type: "string", enum: [...FORMATS] },
159
+ collection: {
160
+ type: "string",
161
+ description: "Collection slug, or several comma-separated",
162
+ },
163
+ year: { type: "integer", description: "Publication year (UTC)" },
164
+ media: {
165
+ type: "string",
166
+ description:
167
+ "any, none, or comma-separated kinds: image, video, audio, text, document",
168
+ },
169
+ title: { type: "string", enum: ["any", "none"] },
170
+ replies: { type: "string", enum: ["any", "none"] },
171
+ visibility: {
172
+ type: "string",
173
+ enum: ["public", "featured", "hidden", "private"],
174
+ },
175
+ } as const;
176
+
177
+ const ListThreadsToolSchema = z.object({
178
+ cursor: z.string().optional(),
179
+ limit: z.coerce.number().int().min(1).max(100).optional().default(20),
180
+ status: StatusSchema.optional(),
181
+ sort: z.enum(THREAD_SORTS).optional(),
182
+ fold: z.boolean().optional(),
183
+ lang: ContentLanguageSchema.optional(),
184
+ format: z.string().optional(),
185
+ collection: z.string().optional(),
186
+ year: z.number().int().optional(),
187
+ media: z.string().optional(),
188
+ title: z.string().optional(),
189
+ replies: z.string().optional(),
190
+ visibility: z.string().optional(),
191
+ });
192
+
193
+ const LIST_THREADS_OWN_PARAMS = [
194
+ "cursor",
195
+ "limit",
196
+ "status",
197
+ "sort",
198
+ "fold",
199
+ "lang",
200
+ ] as const;
201
+
202
+ const GetThreadToolSchema = z.object({
203
+ id: PostIdSchema,
204
+ fold: z.boolean().optional(),
205
+ });
206
+
207
+ const ListThreadPostsToolSchema = z.object({
208
+ id: PostIdSchema,
209
+ cursor: z.string().optional(),
210
+ limit: z.coerce.number().int().min(1).max(100).optional().default(100),
211
+ status: StatusSchema.optional(),
212
+ });
213
+
143
214
  const mcpTools: McpToolDefinition[] = [
144
215
  {
145
216
  name: "jant_posts_list",
146
217
  description:
147
- "List posts, with optional format, status, cursor, and limit filters.",
218
+ "List posts, with optional format, status, cursor, and limit filters. Pass nextCursor back as cursor for the next page.",
148
219
  inputSchema: {
149
220
  type: "object",
150
221
  properties: {
@@ -157,19 +228,15 @@ const mcpTools: McpToolDefinition[] = [
157
228
  },
158
229
  async execute(args, context) {
159
230
  const input = ListPostsToolSchema.parse(args ?? {});
160
- const posts = await context.services.posts.list({
161
- cursor: input.cursor ?? undefined,
162
- format: input.format,
163
- limit: input.limit,
164
- status: input.status ?? "published",
165
- });
231
+ const status = input.status ?? "published";
232
+ const { posts, nextCursor } = await context.services.posts.listPage(
233
+ { format: input.format, status, ...apiPostListOrder(status) },
234
+ { cursor: input.cursor, limit: input.limit },
235
+ );
166
236
 
167
237
  return {
168
238
  posts: await serializePosts(posts, context),
169
- nextCursor:
170
- posts.length === input.limit
171
- ? (posts[posts.length - 1]?.id ?? null)
172
- : null,
239
+ nextCursor,
173
240
  };
174
241
  },
175
242
  },
@@ -216,6 +283,136 @@ const mcpTools: McpToolDefinition[] = [
216
283
  return content;
217
284
  },
218
285
  },
286
+ {
287
+ name: "jant_threads_list",
288
+ description:
289
+ "List Threads (a root post and its replies), each with its post count. Takes the archive's filters; sort is activity (default), published, updated, oldest, or rating. Set fold to include the replies the homepage shows. Pass nextCursor back as cursor for the next page.",
290
+ inputSchema: {
291
+ type: "object",
292
+ properties: {
293
+ cursor: { type: "string" },
294
+ limit: { type: "integer", minimum: 1, maximum: 100, default: 20 },
295
+ status: { type: "string", enum: [...STATUSES] },
296
+ sort: { type: "string", enum: [...THREAD_SORTS] },
297
+ fold: { type: "boolean" },
298
+ lang: { type: "string", description: "BCP 47 content language" },
299
+ ...THREAD_FILTER_TOOL_PROPERTIES,
300
+ },
301
+ additionalProperties: false,
302
+ },
303
+ async execute(args, context) {
304
+ const input = ListThreadsToolSchema.parse(args ?? {});
305
+ const filterArgs = Object.fromEntries(
306
+ Object.entries(input).filter(
307
+ ([key, value]) =>
308
+ value !== undefined &&
309
+ !(LIST_THREADS_OWN_PARAMS as readonly string[]).includes(key),
310
+ ),
311
+ );
312
+ const parsed = await parseThreadSelection(
313
+ (key) => {
314
+ const value = filterArgs[key];
315
+ return value === undefined ? undefined : String(value);
316
+ },
317
+ Object.keys(filterArgs),
318
+ {
319
+ allow: [],
320
+ audience: "author",
321
+ loadCollections: () => context.services.collections.list(),
322
+ },
323
+ );
324
+ if (parsed.kind === "empty") {
325
+ return { threads: [], nextCursor: null };
326
+ }
327
+
328
+ const { threads, nextCursor } =
329
+ await context.services.threads.listThreads(
330
+ {
331
+ audience: "author",
332
+ status: input.status,
333
+ selection: parsed.selection,
334
+ lang: input.lang,
335
+ sort: input.sort,
336
+ fold: input.fold,
337
+ },
338
+ { cursor: input.cursor, limit: input.limit },
339
+ );
340
+ return {
341
+ threads: await loadApiThreadResponses(context, threads),
342
+ nextCursor,
343
+ };
344
+ },
345
+ },
346
+ {
347
+ name: "jant_threads_get",
348
+ description:
349
+ "Get the Thread any post belongs to: its root and post count, and with fold the replies the homepage shows.",
350
+ inputSchema: {
351
+ type: "object",
352
+ properties: {
353
+ id: {
354
+ type: "string",
355
+ description: "TypeID of any post in the Thread",
356
+ },
357
+ fold: { type: "boolean" },
358
+ },
359
+ required: ["id"],
360
+ additionalProperties: false,
361
+ },
362
+ async execute(args, context) {
363
+ const input = GetThreadToolSchema.parse(args ?? {});
364
+ const root = await context.services.threads.findRoot(
365
+ { id: input.id },
366
+ "author",
367
+ );
368
+ if (!root) {
369
+ throw new NotFoundError("Thread");
370
+ }
371
+ const summaries = await context.services.threads.summarize([root], {
372
+ fold: input.fold,
373
+ });
374
+ const [thread] = await loadApiThreadResponses(context, summaries);
375
+ return thread;
376
+ },
377
+ },
378
+ {
379
+ name: "jant_threads_list_posts",
380
+ description:
381
+ "List the posts of the Thread any post belongs to, root first, in Thread order. Pass nextCursor back as cursor for the next page.",
382
+ inputSchema: {
383
+ type: "object",
384
+ properties: {
385
+ id: {
386
+ type: "string",
387
+ description: "TypeID of any post in the Thread",
388
+ },
389
+ cursor: { type: "string" },
390
+ limit: { type: "integer", minimum: 1, maximum: 100, default: 100 },
391
+ status: { type: "string", enum: [...STATUSES] },
392
+ },
393
+ required: ["id"],
394
+ additionalProperties: false,
395
+ },
396
+ async execute(args, context) {
397
+ const input = ListThreadPostsToolSchema.parse(args ?? {});
398
+ const root = await context.services.threads.findRoot(
399
+ { id: input.id },
400
+ "author",
401
+ );
402
+ if (!root) {
403
+ throw new NotFoundError("Thread");
404
+ }
405
+ const { posts, nextCursor } = await context.services.threads.listPosts(
406
+ root.id,
407
+ { audience: "author", status: input.status },
408
+ { cursor: input.cursor, limit: input.limit },
409
+ );
410
+ return {
411
+ posts: await serializePosts(posts, context),
412
+ nextCursor,
413
+ };
414
+ },
415
+ },
219
416
  {
220
417
  name: "jant_posts_create",
221
418
  description:
@@ -1286,46 +1483,15 @@ async function uploadMediaFromBase64(
1286
1483
  return serializeMedia(media, context.appConfig);
1287
1484
  }
1288
1485
 
1289
- async function serializePosts(
1486
+ function serializePosts(
1290
1487
  posts: Awaited<ReturnType<Services["posts"]["list"]>>,
1291
1488
  context: McpToolContext,
1292
1489
  ) {
1293
- if (posts.length === 0) {
1294
- return [];
1295
- }
1296
-
1297
- const postIds = posts.map((post) => post.id);
1298
- const [mediaMap, collectionMap] = await Promise.all([
1299
- context.services.media.getByPostIds(postIds),
1300
- context.services.collections.getCollectionsByPostIds(postIds),
1301
- ]);
1302
-
1303
- return posts.map((post) =>
1304
- toApiPost(post, {
1305
- attachments: serializeAttachments(
1306
- mediaMap.get(post.id) ?? [],
1307
- context.appConfig,
1308
- ),
1309
- collectionIds: (collectionMap.get(post.id) ?? []).map(
1310
- (collection) => collection.id,
1311
- ),
1312
- }),
1313
- );
1490
+ return loadApiPostResponses(context, posts, { collectionIds: true });
1314
1491
  }
1315
1492
 
1316
- async function serializePost(
1317
- post: Parameters<typeof toApiPost>[0],
1318
- context: McpToolContext,
1319
- ) {
1320
- const [mediaList, threadCollections] = await Promise.all([
1321
- context.services.media.getByPostId(post.id),
1322
- context.services.collections.getCollectionsByPostId(post.id),
1323
- ]);
1324
-
1325
- return toApiPost(post, {
1326
- attachments: serializeAttachments(mediaList, context.appConfig),
1327
- collectionIds: threadCollections.map((collection) => collection.id),
1328
- });
1493
+ function serializePost(post: Post, context: McpToolContext) {
1494
+ return loadApiPostResponse(context, post, { collectionIds: true });
1329
1495
  }
1330
1496
 
1331
1497
  function serializeMedia(
@@ -1336,19 +1502,3 @@ function serializeMedia(
1336
1502
  ) {
1337
1503
  return toApiMedia(media, appConfig);
1338
1504
  }
1339
-
1340
- function serializeAttachments(
1341
- mediaList: Awaited<ReturnType<Services["media"]["getByPostId"]>>,
1342
- appConfig: AppConfig,
1343
- ) {
1344
- return mediaList.map((media) =>
1345
- toApiAttachment(
1346
- media,
1347
- appConfig.r2PublicUrl,
1348
- appConfig.imageTransformUrl,
1349
- appConfig.s3PublicUrl,
1350
- appConfig.localPublicUrl,
1351
- appConfig.sitePathPrefix,
1352
- ),
1353
- );
1354
- }