@khorsheed/dsh-reader 0.3.0 → 0.3.2

package/lib/typert.host.js

@@ -1,32 +1,99 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
 import { z } from 'zod'
 
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
+let _khorsheed_dsh_reader_reader_addNote_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_addNote_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_addNote_parameter_0$schema$value ??= z.object({
+  'block': z.number().readonly(),
+  'start': z.number().readonly().optional(),
+  'quote': z.string().readonly(),
+  'translated': z.string().readonly().optional(),
+  'comment': z.string().readonly().optional(),
+  'time': z.number().readonly().optional(),
+  'entryId': z.string().readonly(),
+  'title': z.string().readonly(),
+  'url': z.string().readonly().optional(),
+  'source': z.string().readonly().optional(),
+}))
+let _khorsheed_dsh_reader_reader_addNote_result$schema$value
+const _khorsheed_dsh_reader_reader_addNote_result$schema = () => (_khorsheed_dsh_reader_reader_addNote_result$schema$value ??= z.union([z.literal("empty"), z.object({
+  'id': z.string().readonly().describe('`n1`, `n2`… per article, never reused — the model cites notes by it.'),
+  'anchor': z.object({
+  'block': z.number().readonly(),
+  'start': z.number().readonly().optional(),
+  'quote': z.string().readonly(),
+  'translated': z.string().readonly().optional().describe('The translated text, when the selection was made in the translated view.'),
+  'time': z.number().readonly().optional().describe('A video / audio transcript paragraph\'s start (seconds): where ▶ plays from.'),
+}).readonly(),
+  'comment': z.string().readonly().optional(),
+  'replies': z.array(z.object({
+  'by': z.union([z.literal("user"), z.literal("agent")]).readonly(),
+  'text': z.string().readonly(),
+  'sessionId': z.string().readonly().optional().describe('The conversation it came from, so the reader can go back to it.'),
+  'editedFrom': z.literal("agent").readonly().optional().describe('Set when the reader rewrote a line the model wrote.'),
+  'at': z.string().readonly(),
+})).readonly().optional().describe('Conclusions and additions, oldest first.'),
+  'syncedTo': z.array(z.object({
+  'canvasId': z.string().readonly(),
+  'cardId': z.string().readonly(),
+  'canvasTitle': z.string().readonly().describe('The canvas\'s title when it was synced (for the 「已在…」 mark).'),
+  'at': z.string().readonly(),
+})).readonly().optional().describe('Canvas cards made from it (a later edit does not reach them).'),
+  'createdAt': z.string().readonly(),
+  'updatedAt': z.string().readonly(),
+}), z.literal("full")]))
+let _khorsheed_dsh_reader_reader_addReply_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_addReply_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_addReply_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'noteId': z.string(),
+  'text': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_addReply_result$schema$value
+const _khorsheed_dsh_reader_reader_addReply_result$schema = () => (_khorsheed_dsh_reader_reader_addReply_result$schema$value ??= z.union([z.literal("not-found"), z.literal("ok"), z.literal("empty"), z.literal("full")]))
 let _khorsheed_dsh_reader_reader_addSource_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_addSource_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_addSource_parameter_0$schema$value ??= z.object({
   'url': z.string(),
   'label': z.string().optional(),
 }))
 let _khorsheed_dsh_reader_reader_addSource_result$schema$value
-const _khorsheed_dsh_reader_reader_addSource_result$schema = () => (_khorsheed_dsh_reader_reader_addSource_result$schema$value ??= z.union([z.literal("unavailable"), z.object({
+const _khorsheed_dsh_reader_reader_addSource_result$schema = () => (_khorsheed_dsh_reader_reader_addSource_result$schema$value ??= z.union([z.literal("unavailable"), z.literal("duplicate"), z.object({
   'outcome': z.union([z.literal("subscribed"), z.literal("saved-link")]).readonly(),
   'kind': z.union([z.literal("rss"), z.literal("link")]).readonly(),
   'id': z.string().readonly(),
   'label': z.string().readonly(),
   'failure': z.object({
-  'code': z.union([z.literal("unreadable"), z.literal("empty"), z.literal("blocked"), z.literal("login"), z.literal("unsupported-type"), z.literal("redirected"), z.literal("unreachable"), z.literal("http")]).readonly(),
+  'code': z.union([z.literal("blocked"), z.literal("http"), z.literal("unreadable"), z.literal("empty"), z.literal("login"), z.literal("unsupported-type"), z.literal("redirected"), z.literal("unreachable")]).readonly(),
   'message': z.string().readonly(),
-}).readonly().optional(),
-}), z.literal("invalid-url"), z.literal("duplicate"), z.literal("unsupported-content"), z.literal("fetch-failed"), z.object({
+}).readonly().optional().describe('Present when the source was saved but its body cannot be previewed. The add still succeeded: the URL is a link the reader now owns. This is the verdict\'s reason, not a failure — which is why it rides the outcome instead of becoming one more refusal that loses the link.'),
+}), z.literal("invalid-url"), z.literal("unsupported-content"), z.literal("fetch-failed"), z.object({
   'outcome': z.literal("fetch-failed").readonly(),
-  'reason': z.string().readonly(),
+  'reason': z.string().readonly().describe('The fetch seam\'s message, verbatim — a refused connection, a timeout, a byte cap.'),
 })]))
+let _khorsheed_dsh_reader_reader_cancelLocalTranscript_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_cancelLocalTranscript_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_cancelLocalTranscript_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'force': z.boolean(),
+}))
+let _khorsheed_dsh_reader_reader_cancelLocalTranscript_result$schema$value
+const _khorsheed_dsh_reader_reader_cancelLocalTranscript_result$schema = () => (_khorsheed_dsh_reader_reader_cancelLocalTranscript_result$schema$value ??= z.object({
+  'entryId': z.string().readonly(),
+  'state': z.union([z.literal("failed"), z.literal("unavailable"), z.literal("done"), z.literal("idle"), z.literal("queued"), z.literal("fetching"), z.literal("needs-models"), z.literal("transcribing"), z.literal("speakers")]).readonly(),
+  'progress': z.number().readonly().optional().describe('0–1 across fetching the audio and transcribing it.'),
+  'ahead': z.number().readonly().optional().describe('Jobs ahead in the engine\'s queue.'),
+  'bytes': z.number().readonly().optional().describe('Bytes of speech models still to download (`needs-models`).'),
+  'html': z.string().readonly().optional().describe('The transcript so far (or in full, once `done`).'),
+  'language': z.string().readonly().optional().describe('The language the transcript is in, once known.'),
+  'speakers': z.number().readonly().optional().describe('How many voices the transcript has, once the speakers pass settled it.'),
+  'error': z.string().readonly().optional(),
+}))
 let _khorsheed_dsh_reader_reader_capabilities_result$schema$value
 const _khorsheed_dsh_reader_reader_capabilities_result$schema = () => (_khorsheed_dsh_reader_reader_capabilities_result$schema$value ??= z.object({
   'protocolVersion': z.literal(1).readonly(),
-  'hasFs': z.boolean().readonly(),
-  'hasSideChat': z.boolean().readonly(),
-  'nextRefreshAt': z.string().readonly().optional(),
-  'lastRefreshAt': z.string().readonly().optional(),
+  'hasFs': z.boolean().readonly().describe('False when no filesystem is mounted: state lives in memory and is lost on restart.'),
+  'hasSideChat': z.boolean().readonly().describe('False when no side-chat service is mounted: the side-chat gesture must hide.'),
+  'nextRefreshAt': z.string().readonly().optional().describe('ISO-8601 timestamp of the next scheduled refresh, when one is armed.'),
+  'lastRefreshAt': z.string().readonly().optional().describe('ISO-8601 timestamp of the last completed refresh run, when there was one. The list shows it so a reader can decide whether the snapshot is stale enough to be worth a fetch.'),
 }))
 let _khorsheed_dsh_reader_reader_clearRecent_result$schema$value
 const _khorsheed_dsh_reader_reader_clearRecent_result$schema = () => (_khorsheed_dsh_reader_reader_clearRecent_result$schema$value ??= z.object({
@@ -42,17 +109,40 @@ const _khorsheed_dsh_reader_reader_createTag_parameter_0$schema = () => (_khorsh
   'name': z.string(),
 }))
 let _khorsheed_dsh_reader_reader_createTag_result$schema$value
-const _khorsheed_dsh_reader_reader_createTag_result$schema = () => (_khorsheed_dsh_reader_reader_createTag_result$schema$value ??= z.union([z.literal("unavailable"), z.literal("ok"), z.literal("empty"), z.literal("not-found"), z.literal("duplicate"), z.object({
-  'id': z.string().readonly(),
-  'name': z.string().readonly(),
+const _khorsheed_dsh_reader_reader_createTag_result$schema = () => (_khorsheed_dsh_reader_reader_createTag_result$schema$value ??= z.union([z.literal("not-found"), z.literal("unavailable"), z.literal("duplicate"), z.literal("ok"), z.literal("empty"), z.literal("invalid"), z.object({
+  'id': z.string().readonly().describe('Stable id — renaming a tag must not rewrite every entry that carries it.'),
+  'name': z.string().readonly().describe('The reader-facing name, unique case-insensitively.'),
   'createdAt': z.string().readonly(),
-}), z.literal("invalid")]))
+})]))
+let _khorsheed_dsh_reader_reader_deleteDiscussion_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_deleteDiscussion_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_deleteDiscussion_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'discussionId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_deleteDiscussion_result$schema$value
+const _khorsheed_dsh_reader_reader_deleteDiscussion_result$schema = () => (_khorsheed_dsh_reader_reader_deleteDiscussion_result$schema$value ??= z.union([z.literal("not-found"), z.literal("ok"), z.literal("empty"), z.literal("full")]))
+let _khorsheed_dsh_reader_reader_deleteNote_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_deleteNote_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_deleteNote_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'noteId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_deleteNote_result$schema$value
+const _khorsheed_dsh_reader_reader_deleteNote_result$schema = () => (_khorsheed_dsh_reader_reader_deleteNote_result$schema$value ??= z.union([z.literal("not-found"), z.literal("ok"), z.literal("empty"), z.literal("full")]))
 let _khorsheed_dsh_reader_reader_deleteTag_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_deleteTag_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_deleteTag_parameter_0$schema$value ??= z.object({
   'id': z.string(),
 }))
 let _khorsheed_dsh_reader_reader_deleteTag_result$schema$value
-const _khorsheed_dsh_reader_reader_deleteTag_result$schema = () => (_khorsheed_dsh_reader_reader_deleteTag_result$schema$value ??= z.union([z.literal("unavailable"), z.literal("ok"), z.literal("empty"), z.literal("not-found"), z.literal("duplicate"), z.literal("invalid")]))
+const _khorsheed_dsh_reader_reader_deleteTag_result$schema = () => (_khorsheed_dsh_reader_reader_deleteTag_result$schema$value ??= z.union([z.literal("not-found"), z.literal("unavailable"), z.literal("duplicate"), z.literal("ok"), z.literal("empty"), z.literal("invalid")]))
+let _khorsheed_dsh_reader_reader_editReply_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_editReply_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_editReply_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'noteId': z.string(),
+  'index': z.number(),
+  'text': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_editReply_result$schema$value
+const _khorsheed_dsh_reader_reader_editReply_result$schema = () => (_khorsheed_dsh_reader_reader_editReply_result$schema$value ??= z.union([z.literal("not-found"), z.literal("ok"), z.literal("empty"), z.literal("full")]))
 let _khorsheed_dsh_reader_reader_entryFetchStates_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_entryFetchStates_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_entryFetchStates_parameter_0$schema$value ??= z.object({
   'entryIds': z.array(z.string()),
@@ -74,9 +164,74 @@ const _khorsheed_dsh_reader_reader_entryFetchStates_result$schema = () => (_khor
   'state': z.literal("failed").readonly(),
   'at': z.string().readonly(),
   'message': z.string().readonly(),
-  'code': z.union([z.literal("unreadable"), z.literal("empty"), z.literal("blocked"), z.literal("login"), z.literal("unsupported-type"), z.literal("redirected"), z.literal("unreachable"), z.literal("http")]).readonly().optional(),
+  'code': z.union([z.literal("blocked"), z.literal("http"), z.literal("unreadable"), z.literal("empty"), z.literal("login"), z.literal("unsupported-type"), z.literal("redirected"), z.literal("unreachable")]).readonly().optional(),
 })])),
 }))
+let _khorsheed_dsh_reader_reader_entryNotes_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_entryNotes_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_entryNotes_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_entryNotes_result$schema$value
+const _khorsheed_dsh_reader_reader_entryNotes_result$schema = () => (_khorsheed_dsh_reader_reader_entryNotes_result$schema$value ??= z.object({
+  'entry': z.object({
+  'entryId': z.string().readonly(),
+  'title': z.string().readonly(),
+  'url': z.string().readonly().optional(),
+  'source': z.string().readonly().optional().describe('The source\'s display label (the feed\'s name, or the site).'),
+  'notes': z.array(z.object({
+  'id': z.string().readonly().describe('`n1`, `n2`… per article, never reused — the model cites notes by it.'),
+  'anchor': z.object({
+  'block': z.number().readonly(),
+  'start': z.number().readonly().optional(),
+  'quote': z.string().readonly(),
+  'translated': z.string().readonly().optional().describe('The translated text, when the selection was made in the translated view.'),
+  'time': z.number().readonly().optional().describe('A video / audio transcript paragraph\'s start (seconds): where ▶ plays from.'),
+}).readonly(),
+  'comment': z.string().readonly().optional(),
+  'replies': z.array(z.object({
+  'by': z.union([z.literal("user"), z.literal("agent")]).readonly(),
+  'text': z.string().readonly(),
+  'sessionId': z.string().readonly().optional().describe('The conversation it came from, so the reader can go back to it.'),
+  'editedFrom': z.literal("agent").readonly().optional().describe('Set when the reader rewrote a line the model wrote.'),
+  'at': z.string().readonly(),
+})).readonly().optional().describe('Conclusions and additions, oldest first.'),
+  'syncedTo': z.array(z.object({
+  'canvasId': z.string().readonly(),
+  'cardId': z.string().readonly(),
+  'canvasTitle': z.string().readonly().describe('The canvas\'s title when it was synced (for the 「已在…」 mark).'),
+  'at': z.string().readonly(),
+})).readonly().optional().describe('Canvas cards made from it (a later edit does not reach them).'),
+  'createdAt': z.string().readonly(),
+  'updatedAt': z.string().readonly(),
+})).readonly(),
+  'sessions': z.array(z.object({
+  'sessionId': z.string().readonly(),
+  'title': z.string().readonly().optional(),
+  'lastAt': z.string().readonly(),
+})).readonly(),
+  'discussions': z.array(z.object({
+  'id': z.string().readonly().describe('`d1`, `d2`… per article, never reused.'),
+  'kind': z.union([z.literal("check"), z.literal("discussion")]).readonly(),
+  'sessionId': z.string().readonly().optional(),
+  'title': z.string().readonly(),
+  'points': z.array(z.object({
+  'text': z.string().readonly(),
+  'para': z.number().readonly().optional().describe('¶ number (1-based), when the point cites the article.'),
+})).readonly(),
+  'aside': z.string().readonly().optional().describe('One line for what went fine (「其余 2 题讲到位了」).'),
+  'syncedTo': z.array(z.object({
+  'canvasId': z.string().readonly(),
+  'cardId': z.string().readonly(),
+  'canvasTitle': z.string().readonly().describe('The canvas\'s title when it was synced (for the 「已在…」 mark).'),
+  'at': z.string().readonly(),
+})).readonly().optional().describe('Canvas cards made from it.'),
+  'createdAt': z.string().readonly(),
+})).readonly().optional().describe('Discussion notes, newest first.'),
+  'nextNote': z.number().readonly().describe('The next note number; ids are never reused, so a deleted n3 stays deleted.'),
+  'nextDiscussion': z.number().readonly().optional().describe('The next discussion number, never reused either.'),
+  'updatedAt': z.string().readonly(),
+}).optional(),
+}))
 let _khorsheed_dsh_reader_reader_entryTags_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_entryTags_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_entryTags_parameter_0$schema$value ??= z.object({
   'entryId': z.string(),
@@ -84,8 +239,8 @@ const _khorsheed_dsh_reader_reader_entryTags_parameter_0$schema = () => (_khorsh
 let _khorsheed_dsh_reader_reader_entryTags_result$schema$value
 const _khorsheed_dsh_reader_reader_entryTags_result$schema = () => (_khorsheed_dsh_reader_reader_entryTags_result$schema$value ??= z.object({
   'tags': z.array(z.object({
-  'id': z.string().readonly(),
-  'name': z.string().readonly(),
+  'id': z.string().readonly().describe('Stable id — renaming a tag must not rewrite every entry that carries it.'),
+  'name': z.string().readonly().describe('The reader-facing name, unique case-insensitively.'),
   'createdAt': z.string().readonly(),
 })),
 }))
@@ -109,10 +264,10 @@ const _khorsheed_dsh_reader_reader_fetchImage_parameter_0$schema = () => (_khors
 }))
 let _khorsheed_dsh_reader_reader_fetchImage_result$schema$value
 const _khorsheed_dsh_reader_reader_fetchImage_result$schema = () => (_khorsheed_dsh_reader_reader_fetchImage_result$schema$value ??= z.object({
-  'url': z.string().readonly(),
-  'mime': z.string().readonly().optional(),
-  'base64': z.string().readonly().optional(),
-  'error': z.string().readonly().optional(),
+  'url': z.string().readonly().describe('The URL the pane asked about (echoed, so a late answer can be matched).'),
+  'mime': z.string().readonly().optional().describe('The image\'s declared content type, when the fetch produced bytes.'),
+  'base64': z.string().readonly().optional().describe('The image bytes, base64-encoded, when the fetch produced them.'),
+  'error': z.string().readonly().optional().describe('Why the rescue failed, when it did.'),
 }))
 let _khorsheed_dsh_reader_reader_getBodies_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_getBodies_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_getBodies_parameter_0$schema$value ??= z.object({
@@ -124,9 +279,9 @@ const _khorsheed_dsh_reader_reader_getBodies_result$schema = () => (_khorsheed_d
   'id': z.string().readonly(),
   'raw': z.string().readonly().optional(),
   'truncated': z.boolean().readonly().optional(),
-  'error': z.string().readonly().optional(),
-  'title': z.string().readonly().optional(),
-  'excerpt': z.string().readonly().optional(),
+  'error': z.string().readonly().optional().describe('Present when the payload could not be produced (fetch failed, no fs, …).'),
+  'title': z.string().readonly().optional().describe('The captured article title for a link source\'s single entry, when a past extraction stored it (see {@link ReaderEntryAnnotation.title}). The wall prefers it over the URL-derived label.'),
+  'excerpt': z.string().readonly().optional().describe('The captured excerpt, with the title.'),
 })),
 }))
 let _khorsheed_dsh_reader_reader_getCachePolicy_result$schema$value
@@ -144,15 +299,15 @@ const _khorsheed_dsh_reader_reader_getEntryBody_parameter_0$schema = () => (_kho
 let _khorsheed_dsh_reader_reader_getEntryBody_result$schema$value
 const _khorsheed_dsh_reader_reader_getEntryBody_result$schema = () => (_khorsheed_dsh_reader_reader_getEntryBody_result$schema$value ??= z.object({
   'entryId': z.string().readonly(),
-  'cached': z.boolean().readonly(),
-  'fresh': z.boolean().readonly(),
-  'fromFeed': z.boolean().readonly(),
+  'cached': z.boolean().readonly().describe('True when this body is a cached fetch rather than the feed\'s own payload.'),
+  'fresh': z.boolean().readonly().describe('False when the cache\'s deadline has passed: the view offers the fetch.'),
+  'fromFeed': z.boolean().readonly().describe('True when the feed\'s payload already carries full text for this entry.'),
   'html': z.string().readonly().optional(),
   'fetchedAt': z.string().readonly().optional(),
   'truncated': z.boolean().readonly().optional(),
-  'scriptFigures': z.number().readonly().optional(),
-  'rendered': z.boolean().readonly().optional(),
-  'error': z.string().readonly().optional(),
+  'scriptFigures': z.number().readonly().optional().describe('Figures this page draws with scripts — the detail view says so.'),
+  'rendered': z.boolean().readonly().optional().describe('True when this body came from a rendered fetch (the「重新抓取」route reads it).'),
+  'error': z.string().readonly().optional().describe('Why a fetch could not produce a body, when one was attempted.'),
 }))
 let _khorsheed_dsh_reader_reader_getEntryTranslation_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_getEntryTranslation_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_getEntryTranslation_parameter_0$schema$value ??= z.object({
@@ -192,13 +347,13 @@ const _khorsheed_dsh_reader_reader_getStorageStats_result$schema = () => (_khors
   'bodies': z.object({
   'entries': z.number().readonly(),
   'chars': z.number().readonly(),
-}).readonly(),
+}).readonly().describe('The cached article bodies (what TTL + maxEntries govern).'),
   'translations': z.object({
-  'entries': z.number().readonly(),
-  'chars': z.number().readonly(),
-  'memoryEntries': z.number().readonly(),
-  'memoryChars': z.number().readonly(),
-}).readonly(),
+  'entries': z.number().readonly().describe('How many entries carry a segment map.'),
+  'chars': z.number().readonly().describe('The maps\' combined size.'),
+  'memoryEntries': z.number().readonly().describe('The global memory\'s sentence count (0 when no table exists).'),
+  'memoryChars': z.number().readonly().describe('The global memory\'s size (0 when no table exists).'),
+}).readonly().describe('The two translation tiers: per-entry maps, and the global sentence memory.'),
 }))
 let _khorsheed_dsh_reader_reader_listBackfillCandidates_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_listBackfillCandidates_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_listBackfillCandidates_parameter_0$schema$value ??= z.object({
@@ -216,7 +371,7 @@ const _khorsheed_dsh_reader_reader_listBackfillCandidates_result$schema = () =>
   'entryId': z.string().readonly(),
   'url': z.string().readonly(),
   'label': z.string().readonly(),
-  'lastError': z.string().readonly().optional(),
+  'lastError': z.string().readonly().optional().describe('Why a previous attempt failed, when one did (and when it is worth retrying).'),
 })),
 }))
 let _khorsheed_dsh_reader_reader_listRecent_result$schema$value
@@ -225,8 +380,8 @@ const _khorsheed_dsh_reader_reader_listRecent_result$schema = () => (_khorsheed_
   'entryId': z.string().readonly(),
   'sourceId': z.string().readonly(),
   'title': z.string().readonly(),
-  'url': z.string().readonly().optional(),
-  'readAt': z.string().readonly(),
+  'url': z.string().readonly().optional().describe('The article URL, for reopening an entry the feed no longer publishes.'),
+  'readAt': z.string().readonly().describe('When it was opened (ISO-8601).'),
 })),
 }))
 let _khorsheed_dsh_reader_reader_listSources_result$schema$value
@@ -237,28 +392,106 @@ const _khorsheed_dsh_reader_reader_listSources_result$schema = () => (_khorsheed
   'url': z.string().readonly(),
   'label': z.string().readonly(),
   'enabled': z.boolean().readonly(),
-  'addedAt': z.string().readonly(),
+  'addedAt': z.string().readonly().describe('When the reader added it (ISO-8601). The browser needs this to order the wall and the management list by "when did this arrive": a saved link carries no publication date at all, so without this field it sorts as the oldest thing on the wall — which is exactly where a reader who just added it will not look.'),
   'fetchedAt': z.string().readonly().optional(),
-  'status': z.union([z.literal("ok"), z.literal("error"), z.literal("fetching")]).readonly().optional(),
+  'status': z.union([z.literal("error"), z.literal("ok"), z.literal("fetching")]).readonly().optional(),
   'error': z.string().readonly().optional(),
   'truncated': z.boolean().readonly().optional(),
   'hasBody': z.boolean().readonly(),
   'failure': z.object({
-  'code': z.union([z.literal("unreadable"), z.literal("empty"), z.literal("blocked"), z.literal("login"), z.literal("unsupported-type"), z.literal("redirected"), z.literal("unreachable"), z.literal("http")]).readonly(),
+  'code': z.union([z.literal("blocked"), z.literal("http"), z.literal("unreadable"), z.literal("empty"), z.literal("login"), z.literal("unsupported-type"), z.literal("redirected"), z.literal("unreachable")]).readonly(),
   'message': z.string().readonly(),
-}).readonly().optional(),
-  'resolvedFrom': z.string().readonly().optional(),
+}).readonly().optional().describe('Present when this source has no previewable body (see {@link ReaderPreviewFailure}).'),
+  'resolvedFrom': z.string().readonly().optional().describe('The URL the reader pasted, when the source was resolved to a canonical version (see {@link ReaderSource.resolvedFrom}).'),
 })),
 }))
 let _khorsheed_dsh_reader_reader_listTags_result$schema$value
 const _khorsheed_dsh_reader_reader_listTags_result$schema = () => (_khorsheed_dsh_reader_reader_listTags_result$schema$value ??= z.object({
   'tags': z.array(z.object({
-  'id': z.string().readonly(),
-  'name': z.string().readonly(),
+  'id': z.string().readonly().describe('Stable id — renaming a tag must not rewrite every entry that carries it.'),
+  'name': z.string().readonly().describe('The reader-facing name, unique case-insensitively.'),
   'createdAt': z.string().readonly(),
 })),
   'counts': z.record(z.string(), z.number()),
 }))
+let _khorsheed_dsh_reader_reader_localTranscript_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_localTranscript_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_localTranscript_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_localTranscript_result$schema$value
+const _khorsheed_dsh_reader_reader_localTranscript_result$schema = () => (_khorsheed_dsh_reader_reader_localTranscript_result$schema$value ??= z.object({
+  'entryId': z.string().readonly(),
+  'state': z.union([z.literal("failed"), z.literal("unavailable"), z.literal("done"), z.literal("idle"), z.literal("queued"), z.literal("fetching"), z.literal("needs-models"), z.literal("transcribing"), z.literal("speakers")]).readonly(),
+  'progress': z.number().readonly().optional().describe('0–1 across fetching the audio and transcribing it.'),
+  'ahead': z.number().readonly().optional().describe('Jobs ahead in the engine\'s queue.'),
+  'bytes': z.number().readonly().optional().describe('Bytes of speech models still to download (`needs-models`).'),
+  'html': z.string().readonly().optional().describe('The transcript so far (or in full, once `done`).'),
+  'language': z.string().readonly().optional().describe('The language the transcript is in, once known.'),
+  'speakers': z.number().readonly().optional().describe('How many voices the transcript has, once the speakers pass settled it.'),
+  'error': z.string().readonly().optional(),
+}))
+let _khorsheed_dsh_reader_reader_markSynced_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_markSynced_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_markSynced_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'noteId': z.string().optional(),
+  'discussionId': z.string().optional(),
+  'canvasId': z.string(),
+  'cardId': z.string(),
+  'canvasTitle': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_markSynced_result$schema$value
+const _khorsheed_dsh_reader_reader_markSynced_result$schema = () => (_khorsheed_dsh_reader_reader_markSynced_result$schema$value ??= z.union([z.literal("not-found"), z.literal("ok"), z.literal("empty"), z.literal("full")]))
+let _khorsheed_dsh_reader_reader_mediaStates_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_mediaStates_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_mediaStates_parameter_0$schema$value ??= z.object({
+  'entryIds': z.array(z.string()),
+}))
+let _khorsheed_dsh_reader_reader_mediaStates_result$schema$value
+const _khorsheed_dsh_reader_reader_mediaStates_result$schema = () => (_khorsheed_dsh_reader_reader_mediaStates_result$schema$value ??= z.object({
+  'engine': z.boolean().readonly(),
+  'states': z.record(z.string(), z.object({
+  'state': z.union([z.literal("failed"), z.literal("none"), z.literal("local"), z.literal("queued"), z.literal("fetching"), z.literal("platform"), z.literal("transcribing")]).readonly(),
+  'progress': z.number().readonly().optional().describe('0–1, while transcribing.'),
+  'ahead': z.number().readonly().optional().describe('Jobs ahead in the engine\'s queue, while queued.'),
+})).readonly().readonly(),
+}))
+let _khorsheed_dsh_reader_reader_mediaTranscript_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_mediaTranscript_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_mediaTranscript_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'url': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_mediaTranscript_result$schema$value
+const _khorsheed_dsh_reader_reader_mediaTranscript_result$schema = () => (_khorsheed_dsh_reader_reader_mediaTranscript_result$schema$value ??= z.object({
+  'entryId': z.string(),
+  'html': z.string().optional(),
+  'captions': z.union([z.literal("failed"), z.literal("none"), z.literal("platform")]),
+  'language': z.string().optional(),
+  'error': z.string().optional(),
+}))
+let _khorsheed_dsh_reader_reader_nameSpeaker_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_nameSpeaker_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_nameSpeaker_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'speaker': z.number(),
+  'name': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_nameSpeaker_result$schema$value
+const _khorsheed_dsh_reader_reader_nameSpeaker_result$schema = () => (_khorsheed_dsh_reader_reader_nameSpeaker_result$schema$value ??= z.record(z.string(), z.string()))
+let _khorsheed_dsh_reader_reader_noteCounts_result$schema$value
+const _khorsheed_dsh_reader_reader_noteCounts_result$schema = () => (_khorsheed_dsh_reader_reader_noteCounts_result$schema$value ??= z.object({
+  'counts': z.record(z.string(), z.number()),
+}))
+let _khorsheed_dsh_reader_reader_polish_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_polish_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_polish_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_polish_result$schema$value
+const _khorsheed_dsh_reader_reader_polish_result$schema = () => (_khorsheed_dsh_reader_reader_polish_result$schema$value ??= z.union([z.literal(null), z.object({
+  'total': z.number().readonly().describe('Paragraphs in the article (the ¶ numbering the model read).'),
+  'done': z.number().readonly(),
+  'paragraphs': z.record(z.string(), z.string()).readonly().readonly().describe('¶ number (1-based, as a string key) → the agent\'s translation.'),
+  'off': z.array(z.number()).readonly().describe('Paragraphs the reader turned back to the machine translation.'),
+  'updatedAt': z.string().readonly(),
+  'complete': z.boolean().readonly(),
+})]))
 let _khorsheed_dsh_reader_reader_pruneTags_result$schema$value
 const _khorsheed_dsh_reader_reader_pruneTags_result$schema = () => (_khorsheed_dsh_reader_reader_pruneTags_result$schema$value ??= z.object({
   'removed': z.number(),
@@ -271,6 +504,17 @@ const _khorsheed_dsh_reader_reader_quoteToSideChat_parameter_0$schema = () => (_
 }))
 let _khorsheed_dsh_reader_reader_quoteToSideChat_result$schema$value
 const _khorsheed_dsh_reader_reader_quoteToSideChat_result$schema = () => (_khorsheed_dsh_reader_reader_quoteToSideChat_result$schema$value ??= z.union([z.literal("unavailable"), z.literal("ok")]))
+let _khorsheed_dsh_reader_reader_recordDiscussion_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_recordDiscussion_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_recordDiscussion_parameter_0$schema$value ??= z.object({
+  'entryId': z.string().readonly(),
+  'title': z.string().readonly(),
+  'url': z.string().readonly().optional(),
+  'source': z.string().readonly().optional(),
+  'sessionId': z.string(),
+  'sessionTitle': z.string().optional(),
+}))
+let _khorsheed_dsh_reader_reader_recordDiscussion_result$schema$value
+const _khorsheed_dsh_reader_reader_recordDiscussion_result$schema = () => (_khorsheed_dsh_reader_reader_recordDiscussion_result$schema$value ??= z.union([z.literal("ok"), z.literal("empty")]))
 let _khorsheed_dsh_reader_reader_recordRead_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_recordRead_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_recordRead_parameter_0$schema$value ??= z.object({
   'entryId': z.string(),
@@ -298,12 +542,12 @@ let _khorsheed_dsh_reader_reader_rememberSentences_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_rememberSentences_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_rememberSentences_parameter_0$schema$value ??= z.object({
   'pair': z.string(),
   'entries': z.array(z.object({
-  'hash': z.string().readonly(),
+  'hash': z.string().readonly().describe('The client\'s `translationHash(source)`, stored opaquely.'),
   'source': z.string().readonly(),
   'target': z.string().readonly(),
 })),
   'recalled': z.array(z.object({
-  'hash': z.string().readonly(),
+  'hash': z.string().readonly().describe('The client\'s `translationHash(source)`, stored opaquely.'),
   'source': z.string().readonly(),
   'target': z.string().readonly(),
 })).optional(),
@@ -320,14 +564,14 @@ const _khorsheed_dsh_reader_reader_removeSource_parameter_0$schema = () => (_kho
   'entryIds': z.array(z.string()).optional(),
 }))
 let _khorsheed_dsh_reader_reader_removeSource_result$schema$value
-const _khorsheed_dsh_reader_reader_removeSource_result$schema = () => (_khorsheed_dsh_reader_reader_removeSource_result$schema$value ??= z.union([z.literal("unavailable"), z.literal("ok"), z.literal("not-found"), z.literal("invalid-url"), z.literal("invalid-time"), z.literal("duplicate")]))
+const _khorsheed_dsh_reader_reader_removeSource_result$schema = () => (_khorsheed_dsh_reader_reader_removeSource_result$schema$value ??= z.union([z.literal("not-found"), z.literal("unavailable"), z.literal("duplicate"), z.literal("ok"), z.literal("invalid-url"), z.literal("invalid-time")]))
 let _khorsheed_dsh_reader_reader_renameTag_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_renameTag_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_renameTag_parameter_0$schema$value ??= z.object({
   'id': z.string(),
   'name': z.string(),
 }))
 let _khorsheed_dsh_reader_reader_renameTag_result$schema$value
-const _khorsheed_dsh_reader_reader_renameTag_result$schema = () => (_khorsheed_dsh_reader_reader_renameTag_result$schema$value ??= z.union([z.literal("unavailable"), z.literal("ok"), z.literal("empty"), z.literal("not-found"), z.literal("duplicate"), z.literal("invalid")]))
+const _khorsheed_dsh_reader_reader_renameTag_result$schema = () => (_khorsheed_dsh_reader_reader_renameTag_result$schema$value ??= z.union([z.literal("not-found"), z.literal("unavailable"), z.literal("duplicate"), z.literal("ok"), z.literal("empty"), z.literal("invalid")]))
 let _khorsheed_dsh_reader_reader_setCachePolicy_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_setCachePolicy_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_setCachePolicy_parameter_0$schema$value ??= z.object({
   'ttlHours': z.number(),
@@ -335,7 +579,64 @@ const _khorsheed_dsh_reader_reader_setCachePolicy_parameter_0$schema = () => (_k
   'translationBudgetChars': z.number().optional(),
 }))
 let _khorsheed_dsh_reader_reader_setCachePolicy_result$schema$value
-const _khorsheed_dsh_reader_reader_setCachePolicy_result$schema = () => (_khorsheed_dsh_reader_reader_setCachePolicy_result$schema$value ??= z.union([z.literal("unavailable"), z.literal("ok"), z.literal("empty"), z.literal("not-found"), z.literal("duplicate"), z.literal("invalid")]))
+const _khorsheed_dsh_reader_reader_setCachePolicy_result$schema = () => (_khorsheed_dsh_reader_reader_setCachePolicy_result$schema$value ??= z.union([z.literal("not-found"), z.literal("unavailable"), z.literal("duplicate"), z.literal("ok"), z.literal("empty"), z.literal("invalid")]))
+let _khorsheed_dsh_reader_reader_setPolishOff_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_setPolishOff_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_setPolishOff_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'paragraph': z.number(),
+  'off': z.boolean(),
+}))
+let _khorsheed_dsh_reader_reader_setPolishOff_result$schema$value
+const _khorsheed_dsh_reader_reader_setPolishOff_result$schema = () => (_khorsheed_dsh_reader_reader_setPolishOff_result$schema$value ??= z.union([z.literal(null), z.object({
+  'total': z.number().readonly().describe('Paragraphs in the article (the ¶ numbering the model read).'),
+  'done': z.number().readonly(),
+  'paragraphs': z.record(z.string(), z.string()).readonly().readonly().describe('¶ number (1-based, as a string key) → the agent\'s translation.'),
+  'off': z.array(z.number()).readonly().describe('Paragraphs the reader turned back to the machine translation.'),
+  'updatedAt': z.string().readonly(),
+  'complete': z.boolean().readonly(),
+})]))
+let _khorsheed_dsh_reader_reader_snapshotEntry_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_snapshotEntry_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_snapshotEntry_parameter_0$schema$value ??= z.object({
+  'entryId': z.string().readonly(),
+  'title': z.string().readonly(),
+  'url': z.string().readonly().optional(),
+  'source': z.string().readonly().optional(),
+  'paragraphs': z.array(z.string()),
+}))
+let _khorsheed_dsh_reader_reader_snapshotEntry_result$schema$value
+const _khorsheed_dsh_reader_reader_snapshotEntry_result$schema = () => (_khorsheed_dsh_reader_reader_snapshotEntry_result$schema$value ??= z.union([z.literal("ok"), z.literal("empty")]))
+let _khorsheed_dsh_reader_reader_speakerNames_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_speakerNames_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_speakerNames_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_speakerNames_result$schema$value
+const _khorsheed_dsh_reader_reader_speakerNames_result$schema = () => (_khorsheed_dsh_reader_reader_speakerNames_result$schema$value ??= z.record(z.string(), z.string()))
+let _khorsheed_dsh_reader_reader_startLocalTranscript_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_startLocalTranscript_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_startLocalTranscript_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'url': z.string(),
+  'media': z.object({
+  'kind': z.union([z.literal("video"), z.literal("audio")]).readonly(),
+  'provider': z.union([z.literal("youtube"), z.literal("bilibili"), z.literal("xiaoyuzhou"), z.literal("enclosure")]).readonly(),
+  'ref': z.string().readonly().describe('The platform\'s id (YouTube video id, Bilibili BV id) or the audio URL.'),
+  'durationSec': z.number().readonly().optional(),
+  'thumbnail': z.string().readonly().optional(),
+}),
+  'title': z.string().optional(),
+  'confirmModels': z.boolean().optional(),
+}))
+let _khorsheed_dsh_reader_reader_startLocalTranscript_result$schema$value
+const _khorsheed_dsh_reader_reader_startLocalTranscript_result$schema = () => (_khorsheed_dsh_reader_reader_startLocalTranscript_result$schema$value ??= z.object({
+  'entryId': z.string().readonly(),
+  'state': z.union([z.literal("failed"), z.literal("unavailable"), z.literal("done"), z.literal("idle"), z.literal("queued"), z.literal("fetching"), z.literal("needs-models"), z.literal("transcribing"), z.literal("speakers")]).readonly(),
+  'progress': z.number().readonly().optional().describe('0–1 across fetching the audio and transcribing it.'),
+  'ahead': z.number().readonly().optional().describe('Jobs ahead in the engine\'s queue.'),
+  'bytes': z.number().readonly().optional().describe('Bytes of speech models still to download (`needs-models`).'),
+  'html': z.string().readonly().optional().describe('The transcript so far (or in full, once `done`).'),
+  'language': z.string().readonly().optional().describe('The language the transcript is in, once known.'),
+  'speakers': z.number().readonly().optional().describe('How many voices the transcript has, once the speakers pass settled it.'),
+  'error': z.string().readonly().optional(),
+}))
 let _khorsheed_dsh_reader_reader_storeEntryBody_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_storeEntryBody_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_storeEntryBody_parameter_0$schema$value ??= z.object({
   'entryId': z.string(),
@@ -344,21 +645,21 @@ const _khorsheed_dsh_reader_reader_storeEntryBody_parameter_0$schema = () => (_k
   'truncated': z.boolean().optional(),
   'scriptFigures': z.number().optional(),
   'bodyHash': z.string().optional(),
-  'title': z.string().optional(),
-  'excerpt': z.string().optional(),
+  'title': z.string().optional().describe('The article\'s own title, as extracted — the saved link\'s card upgrade.'),
+  'excerpt': z.string().optional().describe('A short excerpt (abstract / first paragraph), with the title.'),
 }))
 let _khorsheed_dsh_reader_reader_storeEntryBody_result$schema$value
 const _khorsheed_dsh_reader_reader_storeEntryBody_result$schema = () => (_khorsheed_dsh_reader_reader_storeEntryBody_result$schema$value ??= z.object({
   'entryId': z.string().readonly(),
-  'cached': z.boolean().readonly(),
-  'fresh': z.boolean().readonly(),
-  'fromFeed': z.boolean().readonly(),
+  'cached': z.boolean().readonly().describe('True when this body is a cached fetch rather than the feed\'s own payload.'),
+  'fresh': z.boolean().readonly().describe('False when the cache\'s deadline has passed: the view offers the fetch.'),
+  'fromFeed': z.boolean().readonly().describe('True when the feed\'s payload already carries full text for this entry.'),
   'html': z.string().readonly().optional(),
   'fetchedAt': z.string().readonly().optional(),
   'truncated': z.boolean().readonly().optional(),
-  'scriptFigures': z.number().readonly().optional(),
-  'rendered': z.boolean().readonly().optional(),
-  'error': z.string().readonly().optional(),
+  'scriptFigures': z.number().readonly().optional().describe('Figures this page draws with scripts — the detail view says so.'),
+  'rendered': z.boolean().readonly().optional().describe('True when this body came from a rendered fetch (the「重新抓取」route reads it).'),
+  'error': z.string().readonly().optional().describe('Why a fetch could not produce a body, when one was attempted.'),
 }))
 let _khorsheed_dsh_reader_reader_tagEntry_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_tagEntry_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_tagEntry_parameter_0$schema$value ??= z.object({
@@ -367,7 +668,15 @@ const _khorsheed_dsh_reader_reader_tagEntry_parameter_0$schema = () => (_khorshe
   'on': z.boolean(),
 }))
 let _khorsheed_dsh_reader_reader_tagEntry_result$schema$value
-const _khorsheed_dsh_reader_reader_tagEntry_result$schema = () => (_khorsheed_dsh_reader_reader_tagEntry_result$schema$value ??= z.union([z.literal("unavailable"), z.literal("ok"), z.literal("empty"), z.literal("not-found"), z.literal("duplicate"), z.literal("invalid")]))
+const _khorsheed_dsh_reader_reader_tagEntry_result$schema = () => (_khorsheed_dsh_reader_reader_tagEntry_result$schema$value ??= z.union([z.literal("not-found"), z.literal("unavailable"), z.literal("duplicate"), z.literal("ok"), z.literal("empty"), z.literal("invalid")]))
+let _khorsheed_dsh_reader_reader_updateNote_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_updateNote_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_updateNote_parameter_0$schema$value ??= z.object({
+  'entryId': z.string(),
+  'noteId': z.string(),
+  'comment': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_updateNote_result$schema$value
+const _khorsheed_dsh_reader_reader_updateNote_result$schema = () => (_khorsheed_dsh_reader_reader_updateNote_result$schema$value ??= z.union([z.literal("not-found"), z.literal("ok"), z.literal("empty"), z.literal("full")]))
 let _khorsheed_dsh_reader_reader_updateSource_parameter_0$schema$value
 const _khorsheed_dsh_reader_reader_updateSource_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_updateSource_parameter_0$schema$value ??= z.object({
   'id': z.string(),
@@ -377,46 +686,407 @@ const _khorsheed_dsh_reader_reader_updateSource_parameter_0$schema = () => (_kho
   'timeOfDay': z.string().optional(),
 }))
 let _khorsheed_dsh_reader_reader_updateSource_result$schema$value
-const _khorsheed_dsh_reader_reader_updateSource_result$schema = () => (_khorsheed_dsh_reader_reader_updateSource_result$schema$value ??= z.union([z.literal("unavailable"), z.literal("ok"), z.literal("not-found"), z.literal("invalid-url"), z.literal("invalid-time"), z.literal("duplicate")]))
+const _khorsheed_dsh_reader_reader_updateSource_result$schema = () => (_khorsheed_dsh_reader_reader_updateSource_result$schema$value ??= z.union([z.literal("not-found"), z.literal("unavailable"), z.literal("duplicate"), z.literal("ok"), z.literal("invalid-url"), z.literal("invalid-time")]))
+let _khorsheed_dsh_reader_reader_addNote_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_addNote_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_addNote_parameter_0_strict$schema$value ??= z.strictObject({
+  'block': z.number().readonly(),
+  'start': z.number().readonly().optional(),
+  'quote': z.string().readonly(),
+  'translated': z.string().readonly().optional(),
+  'comment': z.string().readonly().optional(),
+  'time': z.number().readonly().optional(),
+  'entryId': z.string().readonly(),
+  'title': z.string().readonly(),
+  'url': z.string().readonly().optional(),
+  'source': z.string().readonly().optional(),
+}))
+let _khorsheed_dsh_reader_reader_addReply_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_addReply_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_addReply_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'noteId': z.string(),
+  'text': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_addSource_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_addSource_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_addSource_parameter_0_strict$schema$value ??= z.strictObject({
+  'url': z.string(),
+  'label': z.string().optional(),
+}))
+let _khorsheed_dsh_reader_reader_cancelLocalTranscript_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_cancelLocalTranscript_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_cancelLocalTranscript_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'force': z.boolean(),
+}))
+let _khorsheed_dsh_reader_reader_createTag_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_createTag_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_createTag_parameter_0_strict$schema$value ??= z.strictObject({
+  'name': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_deleteDiscussion_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_deleteDiscussion_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_deleteDiscussion_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'discussionId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_deleteNote_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_deleteNote_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_deleteNote_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'noteId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_deleteTag_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_deleteTag_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_deleteTag_parameter_0_strict$schema$value ??= z.strictObject({
+  'id': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_editReply_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_editReply_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_editReply_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'noteId': z.string(),
+  'index': z.number(),
+  'text': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_entryFetchStates_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_entryFetchStates_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_entryFetchStates_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryIds': z.array(z.string()),
+}))
+let _khorsheed_dsh_reader_reader_entryNotes_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_entryNotes_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_entryNotes_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_entryTags_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_entryTags_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_entryTags_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_fetchEntryBody_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_fetchEntryBody_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_fetchEntryBody_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'url': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_fetchImage_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_fetchImage_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_fetchImage_parameter_0_strict$schema$value ??= z.strictObject({
+  'url': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_getBodies_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_getBodies_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_getBodies_parameter_0_strict$schema$value ??= z.strictObject({
+  'ids': z.array(z.string()),
+}))
+let _khorsheed_dsh_reader_reader_getEntryBody_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_getEntryBody_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_getEntryBody_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'url': z.string(),
+  'feedHtml': z.string().optional(),
+}))
+let _khorsheed_dsh_reader_reader_getEntryTranslation_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_getEntryTranslation_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_getEntryTranslation_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_getRawBody_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_getRawBody_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_getRawBody_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_getSentenceTranslations_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_getSentenceTranslations_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_getSentenceTranslations_parameter_0_strict$schema$value ??= z.strictObject({
+  'pair': z.string(),
+  'hashes': z.array(z.string()),
+}))
+let _khorsheed_dsh_reader_reader_listBackfillCandidates_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_listBackfillCandidates_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_listBackfillCandidates_parameter_0_strict$schema$value ??= z.strictObject({
+  'entries': z.array(z.strictObject({
+  'entryId': z.string(),
+  'url': z.string(),
+  'label': z.string(),
+  'hasBody': z.boolean(),
+})),
+  'limit': z.number().optional(),
+}))
+let _khorsheed_dsh_reader_reader_localTranscript_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_localTranscript_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_localTranscript_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_markSynced_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_markSynced_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_markSynced_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'noteId': z.string().optional(),
+  'discussionId': z.string().optional(),
+  'canvasId': z.string(),
+  'cardId': z.string(),
+  'canvasTitle': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_mediaStates_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_mediaStates_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_mediaStates_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryIds': z.array(z.string()),
+}))
+let _khorsheed_dsh_reader_reader_mediaTranscript_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_mediaTranscript_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_mediaTranscript_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'url': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_nameSpeaker_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_nameSpeaker_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_nameSpeaker_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'speaker': z.number(),
+  'name': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_polish_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_polish_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_polish_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_quoteToSideChat_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_quoteToSideChat_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_quoteToSideChat_parameter_0_strict$schema$value ??= z.strictObject({
+  'contextKey': z.string(),
+  'label': z.string(),
+  'text': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_recordDiscussion_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_recordDiscussion_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_recordDiscussion_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string().readonly(),
+  'title': z.string().readonly(),
+  'url': z.string().readonly().optional(),
+  'source': z.string().readonly().optional(),
+  'sessionId': z.string(),
+  'sessionTitle': z.string().optional(),
+}))
+let _khorsheed_dsh_reader_reader_recordRead_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_recordRead_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_recordRead_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'sourceId': z.string(),
+  'title': z.string(),
+  'url': z.string().optional(),
+}))
+let _khorsheed_dsh_reader_reader_refresh_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_refresh_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_refresh_parameter_0_strict$schema$value ??= z.strictObject({
+  'ids': z.array(z.string()).optional(),
+}))
+let _khorsheed_dsh_reader_reader_rememberSentences_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_rememberSentences_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_rememberSentences_parameter_0_strict$schema$value ??= z.strictObject({
+  'pair': z.string(),
+  'entries': z.array(z.strictObject({
+  'hash': z.string().readonly().describe('The client\'s `translationHash(source)`, stored opaquely.'),
+  'source': z.string().readonly(),
+  'target': z.string().readonly(),
+})),
+  'recalled': z.array(z.strictObject({
+  'hash': z.string().readonly().describe('The client\'s `translationHash(source)`, stored opaquely.'),
+  'source': z.string().readonly(),
+  'target': z.string().readonly(),
+})).optional(),
+  'entryId': z.string().optional(),
+  'bodyHash': z.string().optional(),
+}))
+let _khorsheed_dsh_reader_reader_removeSource_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_removeSource_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_removeSource_parameter_0_strict$schema$value ??= z.strictObject({
+  'id': z.string(),
+  'entryIds': z.array(z.string()).optional(),
+}))
+let _khorsheed_dsh_reader_reader_renameTag_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_renameTag_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_renameTag_parameter_0_strict$schema$value ??= z.strictObject({
+  'id': z.string(),
+  'name': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_setCachePolicy_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_setCachePolicy_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_setCachePolicy_parameter_0_strict$schema$value ??= z.strictObject({
+  'ttlHours': z.number(),
+  'maxEntries': z.number().optional(),
+  'translationBudgetChars': z.number().optional(),
+}))
+let _khorsheed_dsh_reader_reader_setPolishOff_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_setPolishOff_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_setPolishOff_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'paragraph': z.number(),
+  'off': z.boolean(),
+}))
+let _khorsheed_dsh_reader_reader_snapshotEntry_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_snapshotEntry_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_snapshotEntry_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string().readonly(),
+  'title': z.string().readonly(),
+  'url': z.string().readonly().optional(),
+  'source': z.string().readonly().optional(),
+  'paragraphs': z.array(z.string()),
+}))
+let _khorsheed_dsh_reader_reader_speakerNames_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_speakerNames_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_speakerNames_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_startLocalTranscript_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_startLocalTranscript_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_startLocalTranscript_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'url': z.string(),
+  'media': z.strictObject({
+  'kind': z.union([z.literal("video"), z.literal("audio")]).readonly(),
+  'provider': z.union([z.literal("youtube"), z.literal("bilibili"), z.literal("xiaoyuzhou"), z.literal("enclosure")]).readonly(),
+  'ref': z.string().readonly().describe('The platform\'s id (YouTube video id, Bilibili BV id) or the audio URL.'),
+  'durationSec': z.number().readonly().optional(),
+  'thumbnail': z.string().readonly().optional(),
+}),
+  'title': z.string().optional(),
+  'confirmModels': z.boolean().optional(),
+}))
+let _khorsheed_dsh_reader_reader_storeEntryBody_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_storeEntryBody_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_storeEntryBody_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'url': z.string(),
+  'html': z.string(),
+  'truncated': z.boolean().optional(),
+  'scriptFigures': z.number().optional(),
+  'bodyHash': z.string().optional(),
+  'title': z.string().optional().describe('The article\'s own title, as extracted — the saved link\'s card upgrade.'),
+  'excerpt': z.string().optional().describe('A short excerpt (abstract / first paragraph), with the title.'),
+}))
+let _khorsheed_dsh_reader_reader_tagEntry_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_tagEntry_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_tagEntry_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'tagId': z.string(),
+  'on': z.boolean(),
+}))
+let _khorsheed_dsh_reader_reader_updateNote_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_updateNote_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_updateNote_parameter_0_strict$schema$value ??= z.strictObject({
+  'entryId': z.string(),
+  'noteId': z.string(),
+  'comment': z.string(),
+}))
+let _khorsheed_dsh_reader_reader_updateSource_parameter_0_strict$schema$value
+const _khorsheed_dsh_reader_reader_updateSource_parameter_0_strict$schema = () => (_khorsheed_dsh_reader_reader_updateSource_parameter_0_strict$schema$value ??= z.strictObject({
+  'id': z.string(),
+  'enabled': z.boolean().optional(),
+  'label': z.string().optional(),
+  'url': z.string().optional(),
+  'timeOfDay': z.string().optional(),
+}))
 
-export const TYPERT = {
+const $remote = createTypertRemoteInfo({
   package: '@khorsheed/dsh-reader',
-  face: 'host',
-  schemas: [
-  ],
-  invocations: [
-    {
-      id: '@khorsheed/dsh-reader#reader/addSource',
+  methods: {
+    'reader/addNote': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'addSource',
+      description: 'Keep one excerpt (and its comment).',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
-            typeSymbol: '@khorsheed/dsh-reader#reader/addSource:request',
-            create: _khorsheed_dsh_reader_reader_addSource_parameter_0$schema,
-            schema: _khorsheed_dsh_reader_reader_addSource_parameter_0$schema(),
+            typeSymbol: '@khorsheed/dsh-reader/types#ReaderNoteInput',
+            create: _khorsheed_dsh_reader_reader_addNote_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_addNote_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"block":{"type":"number"},"start":{"type":"number"},"quote":{"type":"string"},"translated":{"type":"string"},"comment":{"type":"string"},"time":{"type":"number"},"entryId":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string"}},"required":["block","quote","entryId","title"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader/types#ReaderNoteInput',
+            create: _khorsheed_dsh_reader_reader_addNote_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_addNote_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"block":{"type":"number"},"start":{"type":"number"},"quote":{"type":"string"},"translated":{"type":"string"},"comment":{"type":"string"},"time":{"type":"number"},"entryId":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string"}},"required":["block","quote","entryId","title"],"additionalProperties":false},
           },
         },
       ],
       result: {
         mode: 'strict',
-        typeSymbol: '@khorsheed/dsh-reader#reader/addSource:result',
-        create: _khorsheed_dsh_reader_reader_addSource_result$schema,
-        schema: _khorsheed_dsh_reader_reader_addSource_result$schema(),
+        typeSymbol: '@khorsheed/dsh-reader#reader/addNote:result',
+        create: _khorsheed_dsh_reader_reader_addNote_result$schema,
+        schema: _khorsheed_dsh_reader_reader_addNote_result$schema(),
+        jsonSchema: {"oneOf":[{"type":"string","enum":["empty","full"]},{"type":"object","properties":{"id":{"type":"string","description":"`n1`, `n2`… per article, never reused — the model cites notes by it."},"anchor":{"type":"object","properties":{"block":{"type":"number"},"start":{"type":"number"},"quote":{"type":"string"},"translated":{"type":"string","description":"The translated text, when the selection was made in the translated view."},"time":{"type":"number","description":"A video / audio transcript paragraph's start (seconds): where ▶ plays from."}},"required":["block","quote"],"additionalProperties":true},"comment":{"type":"string"},"replies":{"type":"array","items":{"type":"object","properties":{"by":{"type":"string","enum":["user","agent"]},"text":{"type":"string"},"sessionId":{"type":"string","description":"The conversation it came from, so the reader can go back to it."},"editedFrom":{"type":"string","const":"agent","description":"Set when the reader rewrote a line the model wrote."},"at":{"type":"string"}},"required":["by","text","at"],"additionalProperties":true},"description":"Conclusions and additions, oldest first."},"syncedTo":{"type":"array","items":{"type":"object","properties":{"canvasId":{"type":"string"},"cardId":{"type":"string"},"canvasTitle":{"type":"string","description":"The canvas's title when it was synced (for the 「已在…」 mark)."},"at":{"type":"string"}},"required":["canvasId","cardId","canvasTitle","at"],"additionalProperties":true},"description":"Canvas cards made from it (a later edit does not reach them)."},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","anchor","createdAt","updatedAt"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":72,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":322,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/capabilities',
+    'reader/addReply': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'capabilities',
+      description: 'Add the reader\'s own line under a note.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/addReply:request',
+            create: _khorsheed_dsh_reader_reader_addReply_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_addReply_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"noteId":{"type":"string"},"text":{"type":"string"}},"required":["entryId","noteId","text"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/addReply:request',
+            create: _khorsheed_dsh_reader_reader_addReply_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_addReply_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"noteId":{"type":"string"},"text":{"type":"string"}},"required":["entryId","noteId","text"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader/types#ReaderNoteOutcome',
+        create: _khorsheed_dsh_reader_reader_addReply_result$schema,
+        schema: _khorsheed_dsh_reader_reader_addReply_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","ok","empty","full"]},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":346,"column":3},
+    },
+    'reader/addSource': {
+      service: 'readerRemote',
+      description: 'Add a source; the host decides whether the URL is a feed or an article.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/addSource:request',
+            create: _khorsheed_dsh_reader_reader_addSource_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_addSource_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"url":{"type":"string"},"label":{"type":"string"}},"required":["url"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/addSource:request',
+            create: _khorsheed_dsh_reader_reader_addSource_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_addSource_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"url":{"type":"string"},"label":{"type":"string"}},"required":["url"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader#reader/addSource:result',
+        create: _khorsheed_dsh_reader_reader_addSource_result$schema,
+        schema: _khorsheed_dsh_reader_reader_addSource_result$schema(),
+        jsonSchema: {"oneOf":[{"type":"string","enum":["unavailable","duplicate","invalid-url","unsupported-content","fetch-failed"]},{"type":"object","properties":{"outcome":{"type":"string","enum":["subscribed","saved-link"]},"kind":{"type":"string","enum":["rss","link"]},"id":{"type":"string"},"label":{"type":"string"},"failure":{"type":"object","properties":{"code":{"type":"string","enum":["blocked","http","unreadable","empty","login","unsupported-type","redirected","unreachable"]},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":true,"description":"Present when the source was saved but its body cannot be previewed. The add still succeeded: the URL is a link the reader now owns. This is the verdict's reason, not a failure — which is why it rides the outcome instead of becoming one more refusal that loses the link."}},"required":["outcome","kind","id","label"],"additionalProperties":true},{"type":"object","properties":{"outcome":{"type":"string","const":"fetch-failed"},"reason":{"type":"string","description":"The fetch seam's message, verbatim — a refused connection, a timeout, a byte cap."}},"required":["outcome","reason"],"additionalProperties":true}]},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":79,"column":3},
+    },
+    'reader/cancelLocalTranscript': {
+      service: 'readerRemote',
+      description: 'Leave (withdraws a queued job) or, with `force`, stop an entry\'s local transcription.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/cancelLocalTranscript:request',
+            create: _khorsheed_dsh_reader_reader_cancelLocalTranscript_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_cancelLocalTranscript_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"force":{"type":"boolean"}},"required":["entryId","force"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/cancelLocalTranscript:request',
+            create: _khorsheed_dsh_reader_reader_cancelLocalTranscript_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_cancelLocalTranscript_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"force":{"type":"boolean"}},"required":["entryId","force"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader/types#LocalTranscriptStatus',
+        create: _khorsheed_dsh_reader_reader_cancelLocalTranscript_result$schema,
+        schema: _khorsheed_dsh_reader_reader_cancelLocalTranscript_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"state":{"type":"string","enum":["failed","unavailable","done","idle","queued","fetching","needs-models","transcribing","speakers"]},"progress":{"type":"number","description":"0–1 across fetching the audio and transcribing it."},"ahead":{"type":"number","description":"Jobs ahead in the engine's queue."},"bytes":{"type":"number","description":"Bytes of speech models still to download (`needs-models`)."},"html":{"type":"string","description":"The transcript so far (or in full, once `done`)."},"language":{"type":"string","description":"The language the transcript is in, once known."},"speakers":{"type":"number","description":"How many voices the transcript has, once the speakers pass settled it."},"error":{"type":"string"}},"required":["entryId","state"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":410,"column":3},
+    },
+    'reader/capabilities': {
+      service: 'readerRemote',
+      description: 'Capability handshake: what the browser may rely on in this composition.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -425,14 +1095,13 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader/types#ReaderCapabilities',
         create: _khorsheed_dsh_reader_reader_capabilities_result$schema,
         schema: _khorsheed_dsh_reader_reader_capabilities_result$schema(),
+        jsonSchema: {"type":"object","properties":{"protocolVersion":{"type":"number","const":1},"hasFs":{"type":"boolean","description":"False when no filesystem is mounted: state lives in memory and is lost on restart."},"hasSideChat":{"type":"boolean","description":"False when no side-chat service is mounted: the side-chat gesture must hide."},"nextRefreshAt":{"type":"string","description":"ISO-8601 timestamp of the next scheduled refresh, when one is armed."},"lastRefreshAt":{"type":"string","description":"ISO-8601 timestamp of the last completed refresh run, when there was one. The list shows it so a reader can decide whether the snapshot is stale enough to be worth a fetch."}},"required":["protocolVersion","hasFs","hasSideChat"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":60,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":67,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/clearRecent',
+    'reader/clearRecent': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'clearRecent',
+      description: 'Forget every recent entry.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -441,14 +1110,13 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/clearRecent:result',
         create: _khorsheed_dsh_reader_reader_clearRecent_result$schema,
         schema: _khorsheed_dsh_reader_reader_clearRecent_result$schema(),
+        jsonSchema: {"type":"object","properties":{"removed":{"type":"number"}},"required":["removed"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":285,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":292,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/clearTranslations',
+    'reader/clearTranslations': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'clearTranslations',
+      description: 'Forget every translation: the global memory and every entry map.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -457,25 +1125,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/clearTranslations:result',
         create: _khorsheed_dsh_reader_reader_clearTranslations_result$schema,
         schema: _khorsheed_dsh_reader_reader_clearTranslations_result$schema(),
+        jsonSchema: {"type":"object","properties":{"clearedEntries":{"type":"number"},"clearedMemory":{"type":"boolean"}},"required":["clearedEntries","clearedMemory"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":209,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":216,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/createTag',
+    'reader/createTag': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'createTag',
+      description: 'Create a tag, or return the existing one with the same name.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/createTag:request',
             create: _khorsheed_dsh_reader_reader_createTag_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_createTag_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/createTag:request',
+            create: _khorsheed_dsh_reader_reader_createTag_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_createTag_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},
           },
         },
       ],
@@ -484,25 +1158,97 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/createTag:result',
         create: _khorsheed_dsh_reader_reader_createTag_result$schema,
         schema: _khorsheed_dsh_reader_reader_createTag_result$schema(),
+        jsonSchema: {"oneOf":[{"type":"string","enum":["not-found","unavailable","duplicate","ok","empty","invalid"]},{"type":"object","properties":{"id":{"type":"string","description":"Stable id — renaming a tag must not rewrite every entry that carries it."},"name":{"type":"string","description":"The reader-facing name, unique case-insensitively."},"createdAt":{"type":"string"}},"required":["id","name","createdAt"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":221,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":228,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/deleteTag',
+    'reader/deleteDiscussion': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'deleteTag',
+      description: 'Delete one discussion note.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/deleteDiscussion:request',
+            create: _khorsheed_dsh_reader_reader_deleteDiscussion_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_deleteDiscussion_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"discussionId":{"type":"string"}},"required":["entryId","discussionId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/deleteDiscussion:request',
+            create: _khorsheed_dsh_reader_reader_deleteDiscussion_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_deleteDiscussion_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"discussionId":{"type":"string"}},"required":["entryId","discussionId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader/types#ReaderNoteOutcome',
+        create: _khorsheed_dsh_reader_reader_deleteDiscussion_result$schema,
+        schema: _khorsheed_dsh_reader_reader_deleteDiscussion_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","ok","empty","full"]},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":364,"column":3},
+    },
+    'reader/deleteNote': {
+      service: 'readerRemote',
+      description: 'Delete one note.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/deleteNote:request',
+            create: _khorsheed_dsh_reader_reader_deleteNote_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_deleteNote_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"noteId":{"type":"string"}},"required":["entryId","noteId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/deleteNote:request',
+            create: _khorsheed_dsh_reader_reader_deleteNote_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_deleteNote_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"noteId":{"type":"string"}},"required":["entryId","noteId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader/types#ReaderNoteOutcome',
+        create: _khorsheed_dsh_reader_reader_deleteNote_result$schema,
+        schema: _khorsheed_dsh_reader_reader_deleteNote_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","ok","empty","full"]},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":334,"column":3},
+    },
+    'reader/deleteTag': {
+      service: 'readerRemote',
+      description: 'Delete a tag and remove it from every entry.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/deleteTag:request',
             create: _khorsheed_dsh_reader_reader_deleteTag_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_deleteTag_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/deleteTag:request',
+            create: _khorsheed_dsh_reader_reader_deleteTag_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_deleteTag_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false},
           },
         },
       ],
@@ -511,25 +1257,64 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader/types#ReaderAnnotationOutcome',
         create: _khorsheed_dsh_reader_reader_deleteTag_result$schema,
         schema: _khorsheed_dsh_reader_reader_deleteTag_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","unavailable","duplicate","ok","empty","invalid"]},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":240,"column":3},
+    },
+    'reader/editReply': {
+      service: 'readerRemote',
+      description: 'Rewrite (or, with empty text, remove) one line under a note.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/editReply:request',
+            create: _khorsheed_dsh_reader_reader_editReply_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_editReply_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"noteId":{"type":"string"},"index":{"type":"number"},"text":{"type":"string"}},"required":["entryId","noteId","index","text"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/editReply:request',
+            create: _khorsheed_dsh_reader_reader_editReply_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_editReply_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"noteId":{"type":"string"},"index":{"type":"number"},"text":{"type":"string"}},"required":["entryId","noteId","index","text"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader/types#ReaderNoteOutcome',
+        create: _khorsheed_dsh_reader_reader_editReply_result$schema,
+        schema: _khorsheed_dsh_reader_reader_editReply_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","ok","empty","full"]},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":233,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":352,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/entryFetchStates',
+    'reader/entryFetchStates': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'entryFetchStates',
+      description: 'What the plugin holds per entry: a body, a stored raw payload, or a failure.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/entryFetchStates:request',
             create: _khorsheed_dsh_reader_reader_entryFetchStates_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_entryFetchStates_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryIds":{"type":"array","items":{"type":"string"}}},"required":["entryIds"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/entryFetchStates:request',
+            create: _khorsheed_dsh_reader_reader_entryFetchStates_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_entryFetchStates_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryIds":{"type":"array","items":{"type":"string"}}},"required":["entryIds"],"additionalProperties":false},
           },
         },
       ],
@@ -538,25 +1323,64 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/entryFetchStates:result',
         create: _khorsheed_dsh_reader_reader_entryFetchStates_result$schema,
         schema: _khorsheed_dsh_reader_reader_entryFetchStates_result$schema(),
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":163,"column":3},
+    },
+    'reader/entryNotes': {
+      service: 'readerRemote',
+      description: 'One article\'s notes and the conversations that discussed it.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/entryNotes:request',
+            create: _khorsheed_dsh_reader_reader_entryNotes_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_entryNotes_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/entryNotes:request',
+            create: _khorsheed_dsh_reader_reader_entryNotes_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_entryNotes_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader#reader/entryNotes:result',
+        create: _khorsheed_dsh_reader_reader_entryNotes_result$schema,
+        schema: _khorsheed_dsh_reader_reader_entryNotes_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entry":{"type":"object","properties":{"entryId":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string","description":"The source's display label (the feed's name, or the site)."},"notes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"`n1`, `n2`… per article, never reused — the model cites notes by it."},"anchor":{"type":"object","properties":{"block":{"type":"number"},"start":{"type":"number"},"quote":{"type":"string"},"translated":{"type":"string","description":"The translated text, when the selection was made in the translated view."},"time":{"type":"number","description":"A video / audio transcript paragraph's start (seconds): where ▶ plays from."}},"required":["block","quote"],"additionalProperties":true},"comment":{"type":"string"},"replies":{"type":"array","items":{"type":"object","properties":{"by":{"type":"string","enum":["user","agent"]},"text":{"type":"string"},"sessionId":{"type":"string","description":"The conversation it came from, so the reader can go back to it."},"editedFrom":{"type":"string","const":"agent","description":"Set when the reader rewrote a line the model wrote."},"at":{"type":"string"}},"required":["by","text","at"],"additionalProperties":true},"description":"Conclusions and additions, oldest first."},"syncedTo":{"type":"array","items":{"type":"object","properties":{"canvasId":{"type":"string"},"cardId":{"type":"string"},"canvasTitle":{"type":"string","description":"The canvas's title when it was synced (for the 「已在…」 mark)."},"at":{"type":"string"}},"required":["canvasId","cardId","canvasTitle","at"],"additionalProperties":true},"description":"Canvas cards made from it (a later edit does not reach them)."},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","anchor","createdAt","updatedAt"],"additionalProperties":true}},"sessions":{"type":"array","items":{"type":"object","properties":{"sessionId":{"type":"string"},"title":{"type":"string"},"lastAt":{"type":"string"}},"required":["sessionId","lastAt"],"additionalProperties":true}},"discussions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"`d1`, `d2`… per article, never reused."},"kind":{"type":"string","enum":["check","discussion"]},"sessionId":{"type":"string"},"title":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"para":{"type":"number","description":"¶ number (1-based), when the point cites the article."}},"required":["text"],"additionalProperties":true}},"aside":{"type":"string","description":"One line for what went fine (「其余 2 题讲到位了」)."},"syncedTo":{"type":"array","items":{"type":"object","properties":{"canvasId":{"type":"string"},"cardId":{"type":"string"},"canvasTitle":{"type":"string","description":"The canvas's title when it was synced (for the 「已在…」 mark)."},"at":{"type":"string"}},"required":["canvasId","cardId","canvasTitle","at"],"additionalProperties":true},"description":"Canvas cards made from it."},"createdAt":{"type":"string"}},"required":["id","kind","title","points","createdAt"],"additionalProperties":true},"description":"Discussion notes, newest first."},"nextNote":{"type":"number","description":"The next note number; ids are never reused, so a deleted n3 stays deleted."},"nextDiscussion":{"type":"number","description":"The next discussion number, never reused either."},"updatedAt":{"type":"string"}},"required":["entryId","title","notes","sessions","nextNote","updatedAt"],"additionalProperties":true}},"required":[],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":156,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":309,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/entryTags',
+    'reader/entryTags': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'entryTags',
+      description: 'The tags on one entry.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/entryTags:request',
             create: _khorsheed_dsh_reader_reader_entryTags_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_entryTags_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/entryTags:request',
+            create: _khorsheed_dsh_reader_reader_entryTags_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_entryTags_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":false},
           },
         },
       ],
@@ -565,25 +1389,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/entryTags:result',
         create: _khorsheed_dsh_reader_reader_entryTags_result$schema,
         schema: _khorsheed_dsh_reader_reader_entryTags_result$schema(),
+        jsonSchema: {"type":"object","properties":{"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable id — renaming a tag must not rewrite every entry that carries it."},"name":{"type":"string","description":"The reader-facing name, unique case-insensitively."},"createdAt":{"type":"string"}},"required":["id","name","createdAt"],"additionalProperties":true}}},"required":["tags"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":245,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":252,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/fetchEntryBody',
+    'reader/fetchEntryBody': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'fetchEntryBody',
+      description: 'Fetch one entry\'s article (the network half; the browser extracts).',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/fetchEntryBody:request',
             create: _khorsheed_dsh_reader_reader_fetchEntryBody_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_fetchEntryBody_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"}},"required":["entryId","url"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/fetchEntryBody:request',
+            create: _khorsheed_dsh_reader_reader_fetchEntryBody_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_fetchEntryBody_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"}},"required":["entryId","url"],"additionalProperties":false},
           },
         },
       ],
@@ -592,25 +1422,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/fetchEntryBody:result',
         create: _khorsheed_dsh_reader_reader_fetchEntryBody_result$schema,
         schema: _khorsheed_dsh_reader_reader_fetchEntryBody_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"},"raw":{"type":"string"},"rawFile":{"type":"string"},"truncated":{"type":"boolean"},"error":{"type":"string"}},"required":["entryId"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":116,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":123,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/fetchImage',
+    'reader/fetchImage': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'fetchImage',
+      description: 'Fetch one image the browser could not load cross-origin (CORP / hotlink-protected), so the pane can re-point the failed `<img>` at the bytes. Called per failed image, never for a healthy one.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/fetchImage:request',
             create: _khorsheed_dsh_reader_reader_fetchImage_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_fetchImage_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/fetchImage:request',
+            create: _khorsheed_dsh_reader_reader_fetchImage_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_fetchImage_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false},
           },
         },
       ],
@@ -619,25 +1455,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader/types#ReaderImageResult',
         create: _khorsheed_dsh_reader_reader_fetchImage_result$schema,
         schema: _khorsheed_dsh_reader_reader_fetchImage_result$schema(),
+        jsonSchema: {"type":"object","properties":{"url":{"type":"string","description":"The URL the pane asked about (echoed, so a late answer can be matched)."},"mime":{"type":"string","description":"The image's declared content type, when the fetch produced bytes."},"base64":{"type":"string","description":"The image bytes, base64-encoded, when the fetch produced them."},"error":{"type":"string","description":"Why the rescue failed, when it did."}},"required":["url"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":133,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":140,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/getBodies',
+    'reader/getBodies': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'getBodies',
+      description: 'Hand back raw payloads for the browser to parse.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/getBodies:request',
             create: _khorsheed_dsh_reader_reader_getBodies_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_getBodies_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}}},"required":["ids"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/getBodies:request',
+            create: _khorsheed_dsh_reader_reader_getBodies_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_getBodies_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}}},"required":["ids"],"additionalProperties":false},
           },
         },
       ],
@@ -646,14 +1488,13 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/getBodies:result',
         create: _khorsheed_dsh_reader_reader_getBodies_result$schema,
         schema: _khorsheed_dsh_reader_reader_getBodies_result$schema(),
+        jsonSchema: {"type":"object","properties":{"bodies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"raw":{"type":"string"},"truncated":{"type":"boolean"},"error":{"type":"string","description":"Present when the payload could not be produced (fetch failed, no fs, …)."},"title":{"type":"string","description":"The captured article title for a link source's single entry, when a past extraction stored it (see {@link ReaderEntryAnnotation.title}). The wall prefers it over the URL-derived label."},"excerpt":{"type":"string","description":"The captured excerpt, with the title."}},"required":["id"],"additionalProperties":true}}},"required":["bodies"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":102,"column":9},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":109,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/getCachePolicy',
+    'reader/getCachePolicy': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'getCachePolicy',
+      description: 'Read or set how long a fetched body is served (and the translation budget).',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -662,25 +1503,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/getCachePolicy:result',
         create: _khorsheed_dsh_reader_reader_getCachePolicy_result$schema,
         schema: _khorsheed_dsh_reader_reader_getCachePolicy_result$schema(),
+        jsonSchema: {"type":"object","properties":{"ttlHours":{"type":"number"},"maxEntries":{"type":"number"},"translationBudgetChars":{"type":"number"}},"required":["ttlHours","maxEntries","translationBudgetChars"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":251,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":258,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/getEntryBody',
+    'reader/getEntryBody': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'getEntryBody',
+      description: 'What the detail view should render for one entry, and whether a fetch is worth offering.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/getEntryBody:request',
             create: _khorsheed_dsh_reader_reader_getEntryBody_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_getEntryBody_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"},"feedHtml":{"type":"string"}},"required":["entryId","url"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/getEntryBody:request',
+            create: _khorsheed_dsh_reader_reader_getEntryBody_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_getEntryBody_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"},"feedHtml":{"type":"string"}},"required":["entryId","url"],"additionalProperties":false},
           },
         },
       ],
@@ -689,25 +1536,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader/types#ReaderEntryBodyView',
         create: _khorsheed_dsh_reader_reader_getEntryBody_result$schema,
         schema: _khorsheed_dsh_reader_reader_getEntryBody_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"cached":{"type":"boolean","description":"True when this body is a cached fetch rather than the feed's own payload."},"fresh":{"type":"boolean","description":"False when the cache's deadline has passed: the view offers the fetch."},"fromFeed":{"type":"boolean","description":"True when the feed's payload already carries full text for this entry."},"html":{"type":"string"},"fetchedAt":{"type":"string"},"truncated":{"type":"boolean"},"scriptFigures":{"type":"number","description":"Figures this page draws with scripts — the detail view says so."},"rendered":{"type":"boolean","description":"True when this body came from a rendered fetch (the「重新抓取」route reads it)."},"error":{"type":"string","description":"Why a fetch could not produce a body, when one was attempted."}},"required":["entryId","cached","fresh","fromFeed"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":110,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":117,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/getEntryTranslation',
+    'reader/getEntryTranslation': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'getEntryTranslation',
+      description: 'One entry\'s exact-fit translation record (segment map resolved), when usable.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/getEntryTranslation:request',
             create: _khorsheed_dsh_reader_reader_getEntryTranslation_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_getEntryTranslation_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/getEntryTranslation:request',
+            create: _khorsheed_dsh_reader_reader_getEntryTranslation_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_getEntryTranslation_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":false},
           },
         },
       ],
@@ -716,25 +1569,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/getEntryTranslation:result',
         create: _khorsheed_dsh_reader_reader_getEntryTranslation_result$schema,
         schema: _khorsheed_dsh_reader_reader_getEntryTranslation_result$schema(),
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":179,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":186,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/getRawBody',
+    'reader/getRawBody': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'getRawBody',
+      description: 'A stored raw payload, so the browser can extract it later.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/getRawBody:request',
             create: _khorsheed_dsh_reader_reader_getRawBody_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_getRawBody_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/getRawBody:request',
+            create: _khorsheed_dsh_reader_reader_getRawBody_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_getRawBody_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":false},
           },
         },
       ],
@@ -743,25 +1602,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/getRawBody:result',
         create: _khorsheed_dsh_reader_reader_getRawBody_result$schema,
         schema: _khorsheed_dsh_reader_reader_getRawBody_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"raw":{"type":"string"},"url":{"type":"string"},"truncated":{"type":"boolean"},"error":{"type":"string"}},"required":["entryId"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":162,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":169,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/getSentenceTranslations',
+    'reader/getSentenceTranslations': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'getSentenceTranslations',
+      description: 'Translations for exactly the asked sentence hashes of one pair — never the whole table.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/getSentenceTranslations:request',
             create: _khorsheed_dsh_reader_reader_getSentenceTranslations_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_getSentenceTranslations_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"pair":{"type":"string"},"hashes":{"type":"array","items":{"type":"string"}}},"required":["pair","hashes"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/getSentenceTranslations:request',
+            create: _khorsheed_dsh_reader_reader_getSentenceTranslations_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_getSentenceTranslations_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"pair":{"type":"string"},"hashes":{"type":"array","items":{"type":"string"}}},"required":["pair","hashes"],"additionalProperties":false},
           },
         },
       ],
@@ -770,14 +1635,13 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/getSentenceTranslations:result',
         create: _khorsheed_dsh_reader_reader_getSentenceTranslations_result$schema,
         schema: _khorsheed_dsh_reader_reader_getSentenceTranslations_result$schema(),
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":185,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":192,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/getStorageStats',
+    'reader/getStorageStats': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'getStorageStats',
+      description: 'Per-tier cache usage, aggregated on the host (the tables never cross).',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -786,25 +1650,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader/types#ReaderStorageStats',
         create: _khorsheed_dsh_reader_reader_getStorageStats_result$schema,
         schema: _khorsheed_dsh_reader_reader_getStorageStats_result$schema(),
+        jsonSchema: {"type":"object","properties":{"bodies":{"type":"object","properties":{"entries":{"type":"number"},"chars":{"type":"number"}},"required":["entries","chars"],"additionalProperties":true,"description":"The cached article bodies (what TTL + maxEntries govern)."},"translations":{"type":"object","properties":{"entries":{"type":"number","description":"How many entries carry a segment map."},"chars":{"type":"number","description":"The maps' combined size."},"memoryEntries":{"type":"number","description":"The global memory's sentence count (0 when no table exists)."},"memoryChars":{"type":"number","description":"The global memory's size (0 when no table exists)."}},"required":["entries","chars","memoryEntries","memoryChars"],"additionalProperties":true,"description":"The two translation tiers: per-entry maps, and the global sentence memory."}},"required":["bodies","translations"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":203,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":210,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/listBackfillCandidates',
+    'reader/listBackfillCandidates': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'listBackfillCandidates',
+      description: 'Which entries still need their full text (the automatic backfill\'s work list).',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/listBackfillCandidates:request',
             create: _khorsheed_dsh_reader_reader_listBackfillCandidates_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_listBackfillCandidates_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"},"label":{"type":"string"},"hasBody":{"type":"boolean"}},"required":["entryId","url","label","hasBody"],"additionalProperties":true}},"limit":{"type":"number"}},"required":["entries"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/listBackfillCandidates:request',
+            create: _khorsheed_dsh_reader_reader_listBackfillCandidates_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_listBackfillCandidates_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"},"label":{"type":"string"},"hasBody":{"type":"boolean"}},"required":["entryId","url","label","hasBody"],"additionalProperties":false}},"limit":{"type":"number"}},"required":["entries"],"additionalProperties":false},
           },
         },
       ],
@@ -813,14 +1683,13 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/listBackfillCandidates:result',
         create: _khorsheed_dsh_reader_reader_listBackfillCandidates_result$schema,
         schema: _khorsheed_dsh_reader_reader_listBackfillCandidates_result$schema(),
+        jsonSchema: {"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"},"label":{"type":"string"},"lastError":{"type":"string","description":"Why a previous attempt failed, when one did (and when it is worth retrying)."}},"required":["entryId","url","label"],"additionalProperties":true}}},"required":["candidates"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":168,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":175,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/listRecent',
+    'reader/listRecent': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'listRecent',
+      description: 'The entries the reader opened, newest first.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -829,14 +1698,13 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/listRecent:result',
         create: _khorsheed_dsh_reader_reader_listRecent_result$schema,
         schema: _khorsheed_dsh_reader_reader_listRecent_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"entryId":{"type":"string"},"sourceId":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","description":"The article URL, for reopening an entry the feed no longer publishes."},"readAt":{"type":"string","description":"When it was opened (ISO-8601)."}},"required":["entryId","sourceId","title","readAt"],"additionalProperties":true}}},"required":["entries"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":279,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":286,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/listSources',
+    'reader/listSources': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'listSources',
+      description: 'The configured sources, without payloads.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -845,14 +1713,13 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/listSources:result',
         create: _khorsheed_dsh_reader_reader_listSources_result$schema,
         schema: _khorsheed_dsh_reader_reader_listSources_result$schema(),
+        jsonSchema: {"type":"object","properties":{"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["rss","link"]},"url":{"type":"string"},"label":{"type":"string"},"enabled":{"type":"boolean"},"addedAt":{"type":"string","description":"When the reader added it (ISO-8601). The browser needs this to order the wall and the management list by \"when did this arrive\": a saved link carries no publication date at all, so without this field it sorts as the oldest thing on the wall — which is exactly where a reader who just added it will not look."},"fetchedAt":{"type":"string"},"status":{"type":"string","enum":["error","ok","fetching"]},"error":{"type":"string"},"truncated":{"type":"boolean"},"hasBody":{"type":"boolean"},"failure":{"type":"object","properties":{"code":{"type":"string","enum":["blocked","http","unreadable","empty","login","unsupported-type","redirected","unreachable"]},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":true,"description":"Present when this source has no previewable body (see {@link ReaderPreviewFailure})."},"resolvedFrom":{"type":"string","description":"The URL the reader pasted, when the source was resolved to a canonical version (see {@link ReaderSource.resolvedFrom})."}},"required":["id","kind","url","label","enabled","addedAt","hasBody"],"additionalProperties":true}}},"required":["sources"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":66,"column":9},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":73,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/listTags',
+    'reader/listTags': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'listTags',
+      description: 'The tag vocabulary, with how many entries carry each tag.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -861,14 +1728,226 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/listTags:result',
         create: _khorsheed_dsh_reader_reader_listTags_result$schema,
         schema: _khorsheed_dsh_reader_reader_listTags_result$schema(),
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":215,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":222,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/pruneTags',
+    'reader/localTranscript': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'pruneTags',
+      description: 'Where an entry\'s local transcription stands, with the transcript so far.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/localTranscript:request',
+            create: _khorsheed_dsh_reader_reader_localTranscript_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_localTranscript_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/localTranscript:request',
+            create: _khorsheed_dsh_reader_reader_localTranscript_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_localTranscript_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader/types#LocalTranscriptStatus',
+        create: _khorsheed_dsh_reader_reader_localTranscript_result$schema,
+        schema: _khorsheed_dsh_reader_reader_localTranscript_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"state":{"type":"string","enum":["failed","unavailable","done","idle","queued","fetching","needs-models","transcribing","speakers"]},"progress":{"type":"number","description":"0–1 across fetching the audio and transcribing it."},"ahead":{"type":"number","description":"Jobs ahead in the engine's queue."},"bytes":{"type":"number","description":"Bytes of speech models still to download (`needs-models`)."},"html":{"type":"string","description":"The transcript so far (or in full, once `done`)."},"language":{"type":"string","description":"The language the transcript is in, once known."},"speakers":{"type":"number","description":"How many voices the transcript has, once the speakers pass settled it."},"error":{"type":"string"}},"required":["entryId","state"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":386,"column":3},
+    },
+    'reader/markSynced': {
+      service: 'readerRemote',
+      description: 'Remember that a note or a discussion note became a canvas card.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/markSynced:request',
+            create: _khorsheed_dsh_reader_reader_markSynced_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_markSynced_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"noteId":{"type":"string"},"discussionId":{"type":"string"},"canvasId":{"type":"string"},"cardId":{"type":"string"},"canvasTitle":{"type":"string"}},"required":["entryId","canvasId","cardId","canvasTitle"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/markSynced:request',
+            create: _khorsheed_dsh_reader_reader_markSynced_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_markSynced_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"noteId":{"type":"string"},"discussionId":{"type":"string"},"canvasId":{"type":"string"},"cardId":{"type":"string"},"canvasTitle":{"type":"string"}},"required":["entryId","canvasId","cardId","canvasTitle"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader/types#ReaderNoteOutcome',
+        create: _khorsheed_dsh_reader_reader_markSynced_result$schema,
+        schema: _khorsheed_dsh_reader_reader_markSynced_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","ok","empty","full"]},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":358,"column":3},
+    },
+    'reader/mediaStates': {
+      service: 'readerRemote',
+      description: 'The wall\'s video / audio cards: what each one\'s transcript is (captions, local, transcribing…).',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/mediaStates:request',
+            create: _khorsheed_dsh_reader_reader_mediaStates_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_mediaStates_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryIds":{"type":"array","items":{"type":"string"}}},"required":["entryIds"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/mediaStates:request',
+            create: _khorsheed_dsh_reader_reader_mediaStates_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_mediaStates_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryIds":{"type":"array","items":{"type":"string"}}},"required":["entryIds"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader/types#MediaCardStates',
+        create: _khorsheed_dsh_reader_reader_mediaStates_result$schema,
+        schema: _khorsheed_dsh_reader_reader_mediaStates_result$schema(),
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":404,"column":3},
+    },
+    'reader/mediaTranscript': {
+      service: 'readerRemote',
+      description: 'A video entry\'s transcript from its platform captions (stored; `none` when it has none).',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/mediaTranscript:request',
+            create: _khorsheed_dsh_reader_reader_mediaTranscript_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_mediaTranscript_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"}},"required":["entryId","url"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/mediaTranscript:request',
+            create: _khorsheed_dsh_reader_reader_mediaTranscript_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_mediaTranscript_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"}},"required":["entryId","url"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader#reader/mediaTranscript:result',
+        create: _khorsheed_dsh_reader_reader_mediaTranscript_result$schema,
+        schema: _khorsheed_dsh_reader_reader_mediaTranscript_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"html":{"type":"string"},"captions":{"type":"string","enum":["failed","none","platform"]},"language":{"type":"string"},"error":{"type":"string"}},"required":["entryId","captions"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":370,"column":3},
+    },
+    'reader/nameSpeaker': {
+      service: 'readerRemote',
+      description: 'Name one speaker of a transcript (empty: back to 说话人 A…); answers all the names.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/nameSpeaker:request',
+            create: _khorsheed_dsh_reader_reader_nameSpeaker_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_nameSpeaker_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"speaker":{"type":"number"},"name":{"type":"string"}},"required":["entryId","speaker","name"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/nameSpeaker:request',
+            create: _khorsheed_dsh_reader_reader_nameSpeaker_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_nameSpeaker_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"speaker":{"type":"number"},"name":{"type":"string"}},"required":["entryId","speaker","name"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader#reader/nameSpeaker:result',
+        create: _khorsheed_dsh_reader_reader_nameSpeaker_result$schema,
+        schema: _khorsheed_dsh_reader_reader_nameSpeaker_result$schema(),
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":398,"column":3},
+    },
+    'reader/noteCounts': {
+      service: 'readerRemote',
+      description: 'How many notes each article carries.',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader#reader/noteCounts:result',
+        create: _khorsheed_dsh_reader_reader_noteCounts_result$schema,
+        schema: _khorsheed_dsh_reader_reader_noteCounts_result$schema(),
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":316,"column":9},
+    },
+    'reader/polish': {
+      service: 'readerRemote',
+      description: 'The article\'s 润色 layer (the agent\'s translation), when there is one for its current text.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/polish:request',
+            create: _khorsheed_dsh_reader_reader_polish_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_polish_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/polish:request',
+            create: _khorsheed_dsh_reader_reader_polish_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_polish_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader#reader/polish:result',
+        create: _khorsheed_dsh_reader_reader_polish_result$schema,
+        schema: _khorsheed_dsh_reader_reader_polish_result$schema(),
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":416,"column":3},
+    },
+    'reader/pruneTags': {
+      service: 'readerRemote',
+      description: 'Drop tags nothing references any more.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -877,25 +1956,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/pruneTags:result',
         create: _khorsheed_dsh_reader_reader_pruneTags_result$schema,
         schema: _khorsheed_dsh_reader_reader_pruneTags_result$schema(),
+        jsonSchema: {"type":"object","properties":{"removed":{"type":"number"}},"required":["removed"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":262,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":269,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/quoteToSideChat',
+    'reader/quoteToSideChat': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'quoteToSideChat',
+      description: 'Forward a ref block to the side-chat service when one is composed.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/quoteToSideChat:request',
             create: _khorsheed_dsh_reader_reader_quoteToSideChat_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_quoteToSideChat_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"contextKey":{"type":"string"},"label":{"type":"string"},"text":{"type":"string"}},"required":["contextKey","label","text"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/quoteToSideChat:request',
+            create: _khorsheed_dsh_reader_reader_quoteToSideChat_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_quoteToSideChat_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"contextKey":{"type":"string"},"label":{"type":"string"},"text":{"type":"string"}},"required":["contextKey","label","text"],"additionalProperties":false},
           },
         },
       ],
@@ -904,25 +1989,64 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/quoteToSideChat:result',
         create: _khorsheed_dsh_reader_reader_quoteToSideChat_result$schema,
         schema: _khorsheed_dsh_reader_reader_quoteToSideChat_result$schema(),
+        jsonSchema: {"type":"string","enum":["unavailable","ok"]},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":291,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":298,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/recordRead',
+    'reader/recordDiscussion': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'recordRead',
+      description: 'Remember that a conversation discussed this article.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/recordDiscussion:request',
+            create: _khorsheed_dsh_reader_reader_recordDiscussion_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_recordDiscussion_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string"},"sessionId":{"type":"string"},"sessionTitle":{"type":"string"}},"required":["entryId","title","sessionId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/recordDiscussion:request',
+            create: _khorsheed_dsh_reader_reader_recordDiscussion_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_recordDiscussion_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string"},"sessionId":{"type":"string"},"sessionTitle":{"type":"string"}},"required":["entryId","title","sessionId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader#reader/recordDiscussion:result',
+        create: _khorsheed_dsh_reader_reader_recordDiscussion_result$schema,
+        schema: _khorsheed_dsh_reader_reader_recordDiscussion_result$schema(),
+        jsonSchema: {"type":"string","enum":["ok","empty"]},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":340,"column":3},
+    },
+    'reader/recordRead': {
+      service: 'readerRemote',
+      description: 'Record that the reader opened one entry (the recent page\'s write half).',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/recordRead:request',
             create: _khorsheed_dsh_reader_reader_recordRead_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_recordRead_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"sourceId":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"}},"required":["entryId","sourceId","title"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/recordRead:request',
+            create: _khorsheed_dsh_reader_reader_recordRead_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_recordRead_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"sourceId":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"}},"required":["entryId","sourceId","title"],"additionalProperties":false},
           },
         },
       ],
@@ -931,25 +2055,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/recordRead:result',
         create: _khorsheed_dsh_reader_reader_recordRead_result$schema,
         schema: _khorsheed_dsh_reader_reader_recordRead_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entries":{"type":"number"}},"required":["entries"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":268,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":275,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/refresh',
+    'reader/refresh': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'refresh',
+      description: 'Fetch the named sources (or every enabled one) now.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/refresh:request',
             create: _khorsheed_dsh_reader_reader_refresh_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_refresh_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}}},"required":[],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/refresh:request',
+            create: _khorsheed_dsh_reader_reader_refresh_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_refresh_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}}},"required":[],"additionalProperties":false},
           },
         },
       ],
@@ -958,25 +2088,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/refresh:result',
         create: _khorsheed_dsh_reader_reader_refresh_result$schema,
         schema: _khorsheed_dsh_reader_reader_refresh_result$schema(),
+        jsonSchema: {"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["unavailable","ok","fetch-failed","truncated"]},"message":{"type":"string"}},"required":["id","status"],"additionalProperties":true}}},"required":["results"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":96,"column":9},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":103,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/rememberSentences',
+    'reader/rememberSentences': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'rememberSentences',
+      description: 'Persist what one translation run learned (and refresh what it reused), in one batch.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/rememberSentences:request',
             create: _khorsheed_dsh_reader_reader_rememberSentences_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_rememberSentences_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"pair":{"type":"string"},"entries":{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string","description":"The client's `translationHash(source)`, stored opaquely."},"source":{"type":"string"},"target":{"type":"string"}},"required":["hash","source","target"],"additionalProperties":true}},"recalled":{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string","description":"The client's `translationHash(source)`, stored opaquely."},"source":{"type":"string"},"target":{"type":"string"}},"required":["hash","source","target"],"additionalProperties":true}},"entryId":{"type":"string"},"bodyHash":{"type":"string"}},"required":["pair","entries"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/rememberSentences:request',
+            create: _khorsheed_dsh_reader_reader_rememberSentences_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_rememberSentences_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"pair":{"type":"string"},"entries":{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string","description":"The client's `translationHash(source)`, stored opaquely."},"source":{"type":"string"},"target":{"type":"string"}},"required":["hash","source","target"],"additionalProperties":false}},"recalled":{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string","description":"The client's `translationHash(source)`, stored opaquely."},"source":{"type":"string"},"target":{"type":"string"}},"required":["hash","source","target"],"additionalProperties":false}},"entryId":{"type":"string"},"bodyHash":{"type":"string"}},"required":["pair","entries"],"additionalProperties":false},
           },
         },
       ],
@@ -985,25 +2121,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader#reader/rememberSentences:result',
         create: _khorsheed_dsh_reader_reader_rememberSentences_result$schema,
         schema: _khorsheed_dsh_reader_reader_rememberSentences_result$schema(),
+        jsonSchema: {"type":"object","properties":{"stored":{"type":"number"}},"required":["stored"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":191,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":198,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/removeSource',
+    'reader/removeSource': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'removeSource',
+      description: 'Drop a source; its entries\' translations go with it (their bodies stay for the budget).',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/removeSource:request',
             create: _khorsheed_dsh_reader_reader_removeSource_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_removeSource_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"id":{"type":"string"},"entryIds":{"type":"array","items":{"type":"string"}}},"required":["id"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/removeSource:request',
+            create: _khorsheed_dsh_reader_reader_removeSource_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_removeSource_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"id":{"type":"string"},"entryIds":{"type":"array","items":{"type":"string"}}},"required":["id"],"additionalProperties":false},
           },
         },
       ],
@@ -1012,25 +2154,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader/types#ReaderMutationOutcome',
         create: _khorsheed_dsh_reader_reader_removeSource_result$schema,
         schema: _khorsheed_dsh_reader_reader_removeSource_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","unavailable","duplicate","ok","invalid-url","invalid-time"]},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":90,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":97,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/renameTag',
+    'reader/renameTag': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'renameTag',
+      description: 'Rename a tag without touching the entries that carry it.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/renameTag:request',
             create: _khorsheed_dsh_reader_reader_renameTag_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_renameTag_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/renameTag:request',
+            create: _khorsheed_dsh_reader_reader_renameTag_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_renameTag_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},
           },
         },
       ],
@@ -1039,25 +2187,30 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader/types#ReaderAnnotationOutcome',
         create: _khorsheed_dsh_reader_reader_renameTag_result$schema,
         schema: _khorsheed_dsh_reader_reader_renameTag_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","unavailable","duplicate","ok","empty","invalid"]},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":227,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":234,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/setCachePolicy',
+    'reader/setCachePolicy': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'setCachePolicy',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/setCachePolicy:request',
             create: _khorsheed_dsh_reader_reader_setCachePolicy_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_setCachePolicy_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"ttlHours":{"type":"number"},"maxEntries":{"type":"number"},"translationBudgetChars":{"type":"number"}},"required":["ttlHours"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/setCachePolicy:request',
+            create: _khorsheed_dsh_reader_reader_setCachePolicy_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_setCachePolicy_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"ttlHours":{"type":"number"},"maxEntries":{"type":"number"},"translationBudgetChars":{"type":"number"}},"required":["ttlHours"],"additionalProperties":false},
           },
         },
       ],
@@ -1066,25 +2219,163 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader/types#ReaderAnnotationOutcome',
         create: _khorsheed_dsh_reader_reader_setCachePolicy_result$schema,
         schema: _khorsheed_dsh_reader_reader_setCachePolicy_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","unavailable","duplicate","ok","empty","invalid"]},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":263,"column":3},
+    },
+    'reader/setPolishOff': {
+      service: 'readerRemote',
+      description: 'Show one paragraph\'s machine translation instead of the 润色 (or back).',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/setPolishOff:request',
+            create: _khorsheed_dsh_reader_reader_setPolishOff_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_setPolishOff_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"paragraph":{"type":"number"},"off":{"type":"boolean"}},"required":["entryId","paragraph","off"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/setPolishOff:request',
+            create: _khorsheed_dsh_reader_reader_setPolishOff_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_setPolishOff_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"paragraph":{"type":"number"},"off":{"type":"boolean"}},"required":["entryId","paragraph","off"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader#reader/setPolishOff:result',
+        create: _khorsheed_dsh_reader_reader_setPolishOff_result$schema,
+        schema: _khorsheed_dsh_reader_reader_setPolishOff_result$schema(),
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":422,"column":3},
+    },
+    'reader/snapshotEntry': {
+      service: 'readerRemote',
+      description: 'Hand the host the article\'s original text, block by block, for the model to read.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/snapshotEntry:request',
+            create: _khorsheed_dsh_reader_reader_snapshotEntry_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_snapshotEntry_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string"},"paragraphs":{"type":"array","items":{"type":"string"}}},"required":["entryId","title","paragraphs"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/snapshotEntry:request',
+            create: _khorsheed_dsh_reader_reader_snapshotEntry_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_snapshotEntry_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string"},"paragraphs":{"type":"array","items":{"type":"string"}}},"required":["entryId","title","paragraphs"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader#reader/snapshotEntry:result',
+        create: _khorsheed_dsh_reader_reader_snapshotEntry_result$schema,
+        schema: _khorsheed_dsh_reader_reader_snapshotEntry_result$schema(),
+        jsonSchema: {"type":"string","enum":["ok","empty"]},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":428,"column":3},
+    },
+    'reader/speakerNames': {
+      service: 'readerRemote',
+      description: 'The reader\'s names for a transcript\'s speakers, by index.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/speakerNames:request',
+            create: _khorsheed_dsh_reader_reader_speakerNames_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_speakerNames_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/speakerNames:request',
+            create: _khorsheed_dsh_reader_reader_speakerNames_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_speakerNames_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"}},"required":["entryId"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader#reader/speakerNames:result',
+        create: _khorsheed_dsh_reader_reader_speakerNames_result$schema,
+        schema: _khorsheed_dsh_reader_reader_speakerNames_result$schema(),
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":256,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":392,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/storeEntryBody',
+    'reader/startLocalTranscript': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'storeEntryBody',
+      description: 'Start (or rejoin) local transcription of an entry without captions. Answers `unavailable` without the transcription plugin and `needs-models` until the first model download is confirmed.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/startLocalTranscript:request',
+            create: _khorsheed_dsh_reader_reader_startLocalTranscript_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_startLocalTranscript_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["video","audio"]},"provider":{"type":"string","enum":["youtube","bilibili","xiaoyuzhou","enclosure"]},"ref":{"type":"string","description":"The platform's id (YouTube video id, Bilibili BV id) or the audio URL."},"durationSec":{"type":"number"},"thumbnail":{"type":"string"}},"required":["kind","provider","ref"],"additionalProperties":true},"title":{"type":"string"},"confirmModels":{"type":"boolean"}},"required":["entryId","url","media"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/startLocalTranscript:request',
+            create: _khorsheed_dsh_reader_reader_startLocalTranscript_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_startLocalTranscript_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["video","audio"]},"provider":{"type":"string","enum":["youtube","bilibili","xiaoyuzhou","enclosure"]},"ref":{"type":"string","description":"The platform's id (YouTube video id, Bilibili BV id) or the audio URL."},"durationSec":{"type":"number"},"thumbnail":{"type":"string"}},"required":["kind","provider","ref"],"additionalProperties":false},"title":{"type":"string"},"confirmModels":{"type":"boolean"}},"required":["entryId","url","media"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader/types#LocalTranscriptStatus',
+        create: _khorsheed_dsh_reader_reader_startLocalTranscript_result$schema,
+        schema: _khorsheed_dsh_reader_reader_startLocalTranscript_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"state":{"type":"string","enum":["failed","unavailable","done","idle","queued","fetching","needs-models","transcribing","speakers"]},"progress":{"type":"number","description":"0–1 across fetching the audio and transcribing it."},"ahead":{"type":"number","description":"Jobs ahead in the engine's queue."},"bytes":{"type":"number","description":"Bytes of speech models still to download (`needs-models`)."},"html":{"type":"string","description":"The transcript so far (or in full, once `done`)."},"language":{"type":"string","description":"The language the transcript is in, once known."},"speakers":{"type":"number","description":"How many voices the transcript has, once the speakers pass settled it."},"error":{"type":"string"}},"required":["entryId","state"],"additionalProperties":true},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":380,"column":3},
+    },
+    'reader/storeEntryBody': {
+      service: 'readerRemote',
+      description: 'Cache the markup the browser extracted for one entry.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/storeEntryBody:request',
             create: _khorsheed_dsh_reader_reader_storeEntryBody_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_storeEntryBody_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"},"html":{"type":"string"},"truncated":{"type":"boolean"},"scriptFigures":{"type":"number"},"bodyHash":{"type":"string"},"title":{"type":"string","description":"The article's own title, as extracted — the saved link's card upgrade."},"excerpt":{"type":"string","description":"A short excerpt (abstract / first paragraph), with the title."}},"required":["entryId","url","html"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/storeEntryBody:request',
+            create: _khorsheed_dsh_reader_reader_storeEntryBody_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_storeEntryBody_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"url":{"type":"string"},"html":{"type":"string"},"truncated":{"type":"boolean"},"scriptFigures":{"type":"number"},"bodyHash":{"type":"string"},"title":{"type":"string","description":"The article's own title, as extracted — the saved link's card upgrade."},"excerpt":{"type":"string","description":"A short excerpt (abstract / first paragraph), with the title."}},"required":["entryId","url","html"],"additionalProperties":false},
           },
         },
       ],
@@ -1093,52 +2384,97 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader/types#ReaderEntryBodyView',
         create: _khorsheed_dsh_reader_reader_storeEntryBody_result$schema,
         schema: _khorsheed_dsh_reader_reader_storeEntryBody_result$schema(),
+        jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"cached":{"type":"boolean","description":"True when this body is a cached fetch rather than the feed's own payload."},"fresh":{"type":"boolean","description":"False when the cache's deadline has passed: the view offers the fetch."},"fromFeed":{"type":"boolean","description":"True when the feed's payload already carries full text for this entry."},"html":{"type":"string"},"fetchedAt":{"type":"string"},"truncated":{"type":"boolean"},"scriptFigures":{"type":"number","description":"Figures this page draws with scripts — the detail view says so."},"rendered":{"type":"boolean","description":"True when this body came from a rendered fetch (the「重新抓取」route reads it)."},"error":{"type":"string","description":"Why a fetch could not produce a body, when one was attempted."}},"required":["entryId","cached","fresh","fromFeed"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":139,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":146,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/tagEntry',
+    'reader/tagEntry': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'tagEntry',
+      description: 'Add or remove one tag on one entry.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/tagEntry:request',
             create: _khorsheed_dsh_reader_reader_tagEntry_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_tagEntry_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"tagId":{"type":"string"},"on":{"type":"boolean"}},"required":["entryId","tagId","on"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/tagEntry:request',
+            create: _khorsheed_dsh_reader_reader_tagEntry_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_tagEntry_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"tagId":{"type":"string"},"on":{"type":"boolean"}},"required":["entryId","tagId","on"],"additionalProperties":false},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@khorsheed/dsh-reader/types#ReaderAnnotationOutcome',
+        create: _khorsheed_dsh_reader_reader_tagEntry_result$schema,
+        schema: _khorsheed_dsh_reader_reader_tagEntry_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","unavailable","duplicate","ok","empty","invalid"]},
+      },
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":246,"column":3},
+    },
+    'reader/updateNote': {
+      service: 'readerRemote',
+      description: 'Change or clear one note\'s comment.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/updateNote:request',
+            create: _khorsheed_dsh_reader_reader_updateNote_parameter_0$schema,
+            schema: _khorsheed_dsh_reader_reader_updateNote_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"noteId":{"type":"string"},"comment":{"type":"string"}},"required":["entryId","noteId","comment"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/updateNote:request',
+            create: _khorsheed_dsh_reader_reader_updateNote_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_updateNote_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"entryId":{"type":"string"},"noteId":{"type":"string"},"comment":{"type":"string"}},"required":["entryId","noteId","comment"],"additionalProperties":false},
           },
         },
       ],
       result: {
         mode: 'strict',
-        typeSymbol: '@khorsheed/dsh-reader/types#ReaderAnnotationOutcome',
-        create: _khorsheed_dsh_reader_reader_tagEntry_result$schema,
-        schema: _khorsheed_dsh_reader_reader_tagEntry_result$schema(),
+        typeSymbol: '@khorsheed/dsh-reader/types#ReaderNoteOutcome',
+        create: _khorsheed_dsh_reader_reader_updateNote_result$schema,
+        schema: _khorsheed_dsh_reader_reader_updateNote_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","ok","empty","full"]},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":239,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":328,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/updateSource',
+    'reader/updateSource': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'updateSource',
+      description: 'Change a source\'s label/enabled flag, or the global refresh time.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-reader#reader/updateSource:request',
             create: _khorsheed_dsh_reader_reader_updateSource_parameter_0$schema,
             schema: _khorsheed_dsh_reader_reader_updateSource_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"id":{"type":"string"},"enabled":{"type":"boolean"},"label":{"type":"string"},"url":{"type":"string"},"timeOfDay":{"type":"string"}},"required":["id"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-reader#reader/updateSource:request',
+            create: _khorsheed_dsh_reader_reader_updateSource_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_reader_reader_updateSource_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"id":{"type":"string"},"enabled":{"type":"boolean"},"label":{"type":"string"},"url":{"type":"string"},"timeOfDay":{"type":"string"}},"required":["id"],"additionalProperties":false},
           },
         },
       ],
@@ -1147,10 +2483,19 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-reader/types#ReaderMutationOutcome',
         create: _khorsheed_dsh_reader_reader_updateSource_result$schema,
         schema: _khorsheed_dsh_reader_reader_updateSource_result$schema(),
+        jsonSchema: {"type":"string","enum":["not-found","unavailable","duplicate","ok","invalid-url","invalid-time"]},
       },
-      sourceLocation: {"file":"packages/dsh-reader/src/remote.ts","line":78,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":85,"column":3},
     },
+  },
+}, z)
+
+export const TYPERT = {
+  package: '@khorsheed/dsh-reader',
+  face: 'host',
+  schemas: [
   ],
+  get invocations() { return $remote.descriptors },
   model: {
     "services": [
       {
@@ -1161,6 +2506,20 @@ export const TYPERT = {
         "key": "reader",
         "exportName": "ReaderService",
         "members": [
+          {
+            "kind": "property",
+            "name": "media",
+            "signature": "readonly media: ReaderMediaHost",
+            "summary": "Video and audio entries: synthetic pages, channel feeds, transcripts.",
+            "jsDoc": "/** Video and audio entries: synthetic pages, channel feeds, transcripts. */"
+          },
+          {
+            "kind": "property",
+            "name": "local",
+            "signature": "readonly local: LocalTranscriber",
+            "summary": "Local transcription of entries without captions (the optional `transcribe` engine).",
+            "jsDoc": "/** Local transcription of entries without captions (the optional `transcribe` engine). */"
+          },
           {
             "kind": "method",
             "name": "capabilities",
@@ -1255,7 +2614,7 @@ export const TYPERT = {
           {
             "kind": "method",
             "name": "storeEntryBody",
-            "signature": "async storeEntryBody(request: { entryId: string url: string html: string truncated?: boolean scriptFigures?: number /** True when this body came from the capture rendered fetch — 「重新抓取」 re-renders it. */ rendered?: boolean /** The caller's hash of `html`; the entry's translation map dies with a body it no longer matches. */ bodyHash?: string /** The article's own title, as the extraction read it — a saved link's card upgrade. */ title?: string /** A short excerpt (abstract / first paragraph), with the title. */ excerpt?: string }): Promise<ReaderEntryBodyView>",
+            "signature": "async storeEntryBody(request: { entryId: string url: string html: string truncated?: boolean scriptFigures?: number /** True when this body came from the capture rendered fetch — 「重新抓取」 re-renders it. */ rendered?: boolean /** The caller's hash of `html`; the entry's translation map dies with a body it no longer matches. */ bodyHash?: string /** The article's own title, as the extraction read it — a saved link's card upgrade. */ title?: string /** A short excerpt (abstract / first paragraph), with the title. */ excerpt?: string /** Keep regardless of the cache TTL (a transcript costs a yt-dlp run, not a page fetch). */ keep?: boolean }): Promise<ReaderEntryBodyView>",
             "summary": "Cache the markup the browser extracted for one entry.",
             "jsDoc": "/**\n * Cache the markup the browser extracted for one entry.\n *\n * The deadline is computed here, not on the client, so the policy has exactly\n * one owner (this service's document) — a client that guessed the TTL would\n * be a second implementation of it.\n *\n * @param request - the entry, the markup, and the URL it came from.\n * @returns the stored view.\n */"
           },
@@ -1384,9 +2743,73 @@ export const TYPERT = {
             "signature": "async clearRecent(): Promise<{ removed: number }>",
             "summary": "Forget every recent entry.",
             "jsDoc": "/**\n * Forget every recent entry.\n *\n * The reader's own list is theirs to erase: a \"recently read\" page that can\n * only grow is one nobody wants to open in company.\n *\n * @returns how many entries were dropped.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "mediaTranscript",
+            "signature": "async mediaTranscript(request: { entryId: string; url: string }): Promise<{ entryId: string; html?: string; captions: 'platform' | 'none' | 'failed'; language?: string; error?: string }>",
+            "summary": "A video entry's transcript: the stored one, else the platform captions fetched now and kept (no TTL — it costs a yt-dlp run).",
+            "jsDoc": "/**\n * A video entry's transcript: the stored one, else the platform captions\n * fetched now and kept (no TTL — it costs a yt-dlp run). A video known to\n * have no captions answers so without running yt-dlp again.\n *\n * @param request - the entry and its video page URL.\n * @returns the transcript markup, `none`, or why it failed.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "speakerNames",
+            "signature": "speakerNames(request: { entryId: string }): Record<string, string>",
+            "summary": "The reader's names for an entry's speakers, by index.",
+            "jsDoc": "/** The reader's names for an entry's speakers, by index. */"
+          },
+          {
+            "kind": "method",
+            "name": "nameSpeaker",
+            "signature": "nameSpeaker(request: { entryId: string; speaker: number; name: string }): Record<string, string>",
+            "summary": "Name one speaker of an entry's transcript (an empty name restores the default).",
+            "jsDoc": "/**\n * Name one speaker of an entry's transcript (an empty name restores the default).\n *\n * @param request - the entry, the speaker's index, the name.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "mediaStates",
+            "signature": "mediaStates(request: { entryIds: readonly string[] }): MediaCardStates",
+            "summary": "The wall's media cards: a live local job first, else what the captions record says (platform captions, a stored local transcript, none).",
+            "jsDoc": "/**\n * The wall's media cards: a live local job first, else what the captions\n * record says (platform captions, a stored local transcript, none).\n *\n * @param request - the card ids on screen.\n */"
           }
         ],
         "types": [
+          {
+            "name": "CaptionRecord",
+            "declaration": "export interface CaptionRecord {\n    readonly state: 'platform' | 'none' | 'local';\n    readonly language?: string;\n    readonly checkedAt: string;\n    readonly speakers?: number;\n    readonly names?: Readonly<Record<string, string>>;\n}"
+          },
+          {
+            "name": "CaptionTrack",
+            "declaration": "export interface CaptionTrack {\n    readonly lang: string;\n    readonly auto: boolean;\n    readonly ext: string;\n}"
+          },
+          {
+            "name": "Cue",
+            "declaration": "export interface Cue {\n    readonly start: number;\n    readonly end: number;\n    readonly text: string;\n}"
+          },
+          {
+            "name": "LocalTranscriber",
+            "declaration": "export class LocalTranscriber {\n    status(entryId: string): LocalTranscriptStatus;\n    start(request: { entryId: string; url: string; media: ReaderMedia; title?: string; confirmModels?: boolean; }): Promise<LocalTranscriptStatus>;\n    cancel(entryId: string, force: boolean): LocalTranscriptStatus;\n    engineAvailable(): boolean;\n    dispose(): void;\n}"
+          },
+          {
+            "name": "LocalTranscriptState",
+            "declaration": "export type LocalTranscriptState = 'unavailable' | 'needs-models' | 'fetching' | 'queued' | 'transcribing' | 'speakers' | 'done' | 'failed' | 'idle';"
+          },
+          {
+            "name": "LocalTranscriptStatus",
+            "declaration": "export interface LocalTranscriptStatus {\n    readonly entryId: string;\n    readonly state: LocalTranscriptState;\n    readonly progress?: number;\n    readonly ahead?: number;\n    readonly bytes?: number;\n    readonly html?: string;\n    readonly language?: string;\n    readonly speakers?: number;\n    readonly error?: string;\n}"
+          },
+          {
+            "name": "MediaCardState",
+            "declaration": "export type MediaCardState = 'platform' | 'local' | 'none' | 'fetching' | 'queued' | 'transcribing' | 'failed';"
+          },
+          {
+            "name": "MediaCardStates",
+            "declaration": "export interface MediaCardStates {\n    readonly engine: boolean;\n    readonly states: Readonly<Record<string, MediaCardStatus>>;\n}"
+          },
+          {
+            "name": "MediaCardStatus",
+            "declaration": "export interface MediaCardStatus {\n    readonly state: MediaCardState;\n    readonly progress?: number;\n    readonly ahead?: number;\n}"
+          },
           {
             "name": "ReaderAddFailure",
             "declaration": "export interface ReaderAddFailure {\n    readonly outcome: 'fetch-failed';\n    readonly reason: string;\n}"
@@ -1435,6 +2858,18 @@ export const TYPERT = {
             "name": "ReaderImageResult",
             "declaration": "export interface ReaderImageResult {\n    readonly url: string;\n    readonly mime?: string;\n    readonly base64?: string;\n    readonly error?: string;\n}"
           },
+          {
+            "name": "ReaderMedia",
+            "declaration": "export interface ReaderMedia {\n    readonly kind: 'video' | 'audio';\n    readonly provider: ReaderMediaProvider;\n    readonly ref: string;\n    readonly durationSec?: number;\n    readonly thumbnail?: string;\n}"
+          },
+          {
+            "name": "ReaderMediaHost",
+            "declaration": "export class ReaderMediaHost {\n    readonly ytdlp: YtDlp;\n    captions(entryId: string): CaptionRecord | undefined;\n    remember(entryId: string, record: CaptionRecord): void;\n    transcript(url: string): Promise<{ html: string; language: string; } | 'none'>;\n}"
+          },
+          {
+            "name": "ReaderMediaProvider",
+            "declaration": "export type ReaderMediaProvider = 'youtube' | 'bilibili' | 'xiaoyuzhou' | 'enclosure';"
+          },
           {
             "name": "ReaderMutationOutcome",
             "declaration": "export type ReaderMutationOutcome = 'ok' | 'not-found' | 'invalid-url' | 'invalid-time' | 'duplicate' | 'unavailable';"
@@ -1470,6 +2905,241 @@ export const TYPERT = {
           {
             "name": "ReaderTag",
             "declaration": "export interface ReaderTag {\n    readonly id: string;\n    readonly name: string;\n    readonly createdAt: string;\n}"
+          },
+          {
+            "name": "YtDlp",
+            "declaration": "export class YtDlp {\n    binary(): Promise<string>;\n    version(): Promise<string>;\n    info(url: string): Promise<YtDlpInfo>;\n    channel(url: string, limit: number = 15): Promise<{ title?: string; entries: YtDlpInfo[]; }>;\n    audio(url: string, dir: string, options: { signal?: AbortSignal; onProgress?: (fraction: number) => void; } = {}): Promise<string>;\n    captions(url: string, track: CaptionTrack): Promise<Cue[]>;\n}"
+          },
+          {
+            "name": "YtDlpInfo",
+            "declaration": "export interface YtDlpInfo {\n    readonly id?: string;\n    readonly title?: string;\n    readonly description?: string;\n    readonly duration?: number;\n    readonly thumbnail?: string;\n    readonly uploader?: string;\n    readonly channel?: string;\n    readonly channel_id?: string;\n    readonly upload_date?: string;\n    readonly timestamp?: number;\n    readonly language?: string;\n    readonly webpage_url?: string;\n    readonly subtitles?: Record<string, readonly { ext: string; }[]>;\n    readonly automatic_captions?: Record<string, readonly { ext: string; }[]>;\n}"
+          }
+        ]
+      },
+      {
+        "description": "The reader's notes store.",
+        "summary": "The reader's notes store.",
+        "tags": [],
+        "jsDoc": "/** The reader's notes store. */",
+        "key": "readerNotes",
+        "exportName": "ReaderNotesStore",
+        "members": [
+          {
+            "kind": "property",
+            "name": "polish",
+            "signature": "readonly polish: ReaderPolishStore",
+            "summary": "The agent's 润色 translations, per article (keyed to the snapshot's text).",
+            "jsDoc": "/** The agent's 润色 translations, per article (keyed to the snapshot's text). */"
+          },
+          {
+            "kind": "method",
+            "name": "polishView",
+            "signature": "polishView(entryId: string): ReaderPolishView | undefined",
+            "summary": "An article's 润色 layer, when it belongs to the text captured now.",
+            "jsDoc": "/** An article's 润色 layer, when it belongs to the text captured now. */"
+          },
+          {
+            "kind": "method",
+            "name": "setPolishOff",
+            "signature": "setPolishOff(entryId: string, paragraph: number, off: boolean): ReaderPolishView | undefined",
+            "summary": "Turn one paragraph back to the machine translation, or to the 润色 again.",
+            "jsDoc": "/** Turn one paragraph back to the machine translation, or to the 润色 again. */"
+          },
+          {
+            "kind": "getter",
+            "name": "available",
+            "signature": "get available(): boolean",
+            "summary": "Whether the notes persist (false means memory-only, for this process).",
+            "jsDoc": "/** Whether the notes persist (false means memory-only, for this process). */"
+          },
+          {
+            "kind": "method",
+            "name": "read",
+            "signature": "read(): ReaderNotesDoc",
+            "summary": "Read the document; a missing or unreadable file reads as empty.",
+            "jsDoc": "/** Read the document; a missing or unreadable file reads as empty. */"
+          },
+          {
+            "kind": "method",
+            "name": "entry",
+            "signature": "entry(entryId: string): ReaderEntryNotes | undefined",
+            "summary": "One article's notes and discussions, oldest note first.",
+            "jsDoc": "/** One article's notes and discussions, oldest note first. */"
+          },
+          {
+            "kind": "method",
+            "name": "entries",
+            "signature": "entries(): ReaderEntryNotes[]",
+            "summary": "Every article that carries notes or discussions.",
+            "jsDoc": "/** Every article that carries notes or discussions. */"
+          },
+          {
+            "kind": "method",
+            "name": "counts",
+            "signature": "counts(): Record<string, number>",
+            "summary": "How many notes each article carries (the wall's badge).",
+            "jsDoc": "/** How many notes each article carries (the wall's badge). */"
+          },
+          {
+            "kind": "method",
+            "name": "addNote",
+            "signature": "addNote(input: ReaderNoteInput): Promise<ReaderNote | 'empty' | 'full'>",
+            "summary": "Keep one excerpt.",
+            "jsDoc": "/**\n * Keep one excerpt.\n *\n * @param input - the article, the excerpt and where it sits, and the comment.\n * @returns the new note, or why none was kept.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "updateNote",
+            "signature": "updateNote(request: { entryId: string; noteId: string; comment: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Change (or clear) one note's comment.",
+            "jsDoc": "/** Change (or clear) one note's comment. */"
+          },
+          {
+            "kind": "method",
+            "name": "deleteNote",
+            "signature": "deleteNote(request: { entryId: string; noteId: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Delete one note (its id is not handed out again).",
+            "jsDoc": "/** Delete one note (its id is not handed out again). */"
+          },
+          {
+            "kind": "method",
+            "name": "addReply",
+            "signature": "addReply(request: { entryId: string; noteId: string; text: string; by: 'agent' | 'user'; sessionId?: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Add one line under a note: a conclusion (by the model, when the reader asked for it) or the reader's own addition.",
+            "jsDoc": "/**\n * Add one line under a note: a conclusion (by the model, when the reader asked\n * for it) or the reader's own addition.\n *\n * @param request - the article, the note, the line and who wrote it.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "editReply",
+            "signature": "editReply(request: { entryId: string; noteId: string; index: number; text: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Rewrite (or, with empty text, remove) one line under a note.",
+            "jsDoc": "/**\n * Rewrite (or, with empty text, remove) one line under a note. A line the\n * model wrote becomes the reader's, marked as rewritten from the model's.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "addDiscussion",
+            "signature": "addDiscussion(input: ReaderDiscussionInput): Promise<ReaderDiscussion | 'empty'>",
+            "summary": "Keep one discussion note (newest first).",
+            "jsDoc": "/**\n * Keep one discussion note (newest first). The conversation it came from is\n * remembered on the article too.\n *\n * @param input - the article, the kind, the points.\n * @returns the new discussion note, or why none was kept.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "markSynced",
+            "signature": "markSynced(request: { entryId: string; noteId?: string; discussionId?: string; canvasId: string; cardId: string; canvasTitle: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Remember that a note (or a discussion note) became a canvas card, so the notes face can say where it went and not offer the same sync twice blindly.",
+            "jsDoc": "/**\n * Remember that a note (or a discussion note) became a canvas card, so the\n * notes face can say where it went and not offer the same sync twice blindly.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "deleteDiscussion",
+            "signature": "deleteDiscussion(request: { entryId: string; discussionId: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Delete one discussion note.",
+            "jsDoc": "/** Delete one discussion note. */"
+          },
+          {
+            "kind": "method",
+            "name": "sessionEntry",
+            "signature": "sessionEntry(sessionId: string): string | undefined",
+            "summary": "The article this conversation discussed most recently, when there is one — where a model's write lands when it names no article.",
+            "jsDoc": "/**\n * The article this conversation discussed most recently, when there is one —\n * where a model's write lands when it names no article.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "recordSession",
+            "signature": "recordSession(request: ReaderEntryIdentity & { sessionId: string; sessionTitle?: string }): Promise<'ok' | 'empty'>",
+            "summary": "Remember that a conversation discussed this article (most recent first).",
+            "jsDoc": "/**\n * Remember that a conversation discussed this article (most recent first).\n *\n * @param request - the article and the conversation.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "snapshot",
+            "signature": "snapshot(request: ReaderEntryIdentity & { paragraphs: readonly string[] }): Promise<'ok' | 'empty'>",
+            "summary": "Keep the article's text for the model, replacing the previous snapshot.",
+            "jsDoc": "/**\n * Keep the article's text for the model, replacing the previous snapshot.\n *\n * Loose snapshots (articles with no notes and no discussions) are pruned to\n * the {@link MAX_LOOSE_SNAPSHOTS} most recent; the rest are kept as long as\n * their article carries anything.\n *\n * @param request - the article and its blocks' original text.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "readSnapshot",
+            "signature": "readSnapshot(entryId: string): ReaderEntrySnapshot | undefined",
+            "summary": "The article's text as last captured, when there is one.",
+            "jsDoc": "/** The article's text as last captured, when there is one. */"
+          },
+          {
+            "kind": "method",
+            "name": "snapshotIds",
+            "signature": "snapshotIds(): string[]",
+            "summary": "Every article with a snapshot, newest capture first.",
+            "jsDoc": "/** Every article with a snapshot, newest capture first. */"
+          }
+        ],
+        "types": [
+          {
+            "name": "ReaderDiscussion",
+            "declaration": "export interface ReaderDiscussion {\n    readonly id: string;\n    readonly kind: 'discussion' | 'check';\n    readonly sessionId?: string;\n    readonly title: string;\n    readonly points: readonly ReaderDiscussionPoint[];\n    readonly aside?: string;\n    readonly syncedTo?: readonly ReaderSyncedCard[];\n    readonly createdAt: string;\n}"
+          },
+          {
+            "name": "ReaderDiscussionInput",
+            "declaration": "export interface ReaderDiscussionInput extends ReaderEntryIdentity {\n    readonly kind: 'discussion' | 'check';\n    readonly sessionId?: string;\n    readonly heading?: string;\n    readonly points: readonly ReaderDiscussionPoint[];\n    readonly aside?: string;\n}"
+          },
+          {
+            "name": "ReaderDiscussionPoint",
+            "declaration": "export interface ReaderDiscussionPoint {\n    readonly text: string;\n    readonly para?: number;\n}"
+          },
+          {
+            "name": "ReaderEntryIdentity",
+            "declaration": "export interface ReaderEntryIdentity {\n    readonly entryId: string;\n    readonly title: string;\n    readonly url?: string;\n    readonly source?: string;\n}"
+          },
+          {
+            "name": "ReaderEntryNotes",
+            "declaration": "export interface ReaderEntryNotes {\n    readonly entryId: string;\n    readonly title: string;\n    readonly url?: string;\n    readonly source?: string;\n    readonly notes: readonly ReaderNote[];\n    readonly sessions: readonly ReaderEntrySession[];\n    readonly discussions?: readonly ReaderDiscussion[];\n    readonly nextNote: number;\n    readonly nextDiscussion?: number;\n    readonly updatedAt: string;\n}"
+          },
+          {
+            "name": "ReaderEntrySession",
+            "declaration": "export interface ReaderEntrySession {\n    readonly sessionId: string;\n    readonly title?: string;\n    readonly lastAt: string;\n}"
+          },
+          {
+            "name": "ReaderEntrySnapshot",
+            "declaration": "export interface ReaderEntrySnapshot {\n    readonly entryId: string;\n    readonly title: string;\n    readonly url?: string;\n    readonly source?: string;\n    readonly paragraphs: readonly string[];\n    readonly truncated?: boolean;\n    readonly capturedAt: string;\n}"
+          },
+          {
+            "name": "ReaderNote",
+            "declaration": "export interface ReaderNote {\n    readonly id: string;\n    readonly anchor: ReaderNoteAnchor;\n    readonly comment?: string;\n    readonly replies?: readonly ReaderNoteReply[];\n    readonly syncedTo?: readonly ReaderSyncedCard[];\n    readonly createdAt: string;\n    readonly updatedAt: string;\n}"
+          },
+          {
+            "name": "ReaderNoteAnchor",
+            "declaration": "export interface ReaderNoteAnchor {\n    readonly block: number;\n    readonly start?: number;\n    readonly quote: string;\n    readonly translated?: string;\n    readonly time?: number;\n}"
+          },
+          {
+            "name": "ReaderNoteInput",
+            "declaration": "export interface ReaderNoteInput extends ReaderEntryIdentity {\n    readonly block: number;\n    readonly start?: number;\n    readonly quote: string;\n    readonly translated?: string;\n    readonly comment?: string;\n    readonly time?: number;\n}"
+          },
+          {
+            "name": "ReaderNoteOutcome",
+            "declaration": "export type ReaderNoteOutcome = 'ok' | 'not-found' | 'empty' | 'full';"
+          },
+          {
+            "name": "ReaderNoteReply",
+            "declaration": "export interface ReaderNoteReply {\n    readonly by: 'agent' | 'user';\n    readonly text: string;\n    readonly sessionId?: string;\n    readonly editedFrom?: 'agent';\n    readonly at: string;\n}"
+          },
+          {
+            "name": "ReaderNotesDoc",
+            "declaration": "export interface ReaderNotesDoc {\n    readonly version: 1;\n    readonly entries: Readonly<Record<string, ReaderEntryNotes>>;\n    readonly snapshots: Readonly<Record<string, ReaderSnapshotRecord>>;\n}"
+          },
+          {
+            "name": "ReaderPolishStore",
+            "declaration": "export class ReaderPolishStore {\n    view(entryId: string, key: string | undefined): ReaderPolishView | undefined;\n    write(entryId: string, key: string, total: number, updates: ReadonlyMap<number, string>): ReaderPolishView;\n    setOff(entryId: string, key: string | undefined, paragraph: number, off: boolean): ReaderPolishView | undefined;\n    drop(entryId: string): void;\n}"
+          },
+          {
+            "name": "ReaderPolishView",
+            "declaration": "export interface ReaderPolishView {\n    readonly total: number;\n    readonly done: number;\n    readonly paragraphs: Readonly<Record<string, string>>;\n    readonly off: readonly number[];\n    readonly updatedAt: string;\n    readonly complete: boolean;\n}"
+          },
+          {
+            "name": "ReaderSnapshotRecord",
+            "declaration": "export interface ReaderSnapshotRecord {\n    readonly file: string;\n    readonly chars: number;\n    readonly capturedAt: string;\n}"
+          },
+          {
+            "name": "ReaderSyncedCard",
+            "declaration": "export interface ReaderSyncedCard {\n    readonly canvasId: string;\n    readonly cardId: string;\n    readonly canvasTitle: string;\n    readonly at: string;\n}"
           }
         ]
       },
@@ -1702,9 +3372,169 @@ export const TYPERT = {
             "signature": "@Remote('quoteToSideChat') quoteToSideChat(request: { contextKey: string label: string text: string }): Promise<'ok' | 'unavailable'>",
             "summary": "Forward a ref block to the side-chat service when one is composed.",
             "jsDoc": "/** Forward a ref block to the side-chat service when one is composed. */"
+          },
+          {
+            "kind": "method",
+            "name": "entryNotes",
+            "signature": "@Remote('entryNotes') async entryNotes(request: { entryId: string }): Promise<{ entry?: ReaderEntryNotes }>",
+            "summary": "One article's notes and the conversations that discussed it.",
+            "jsDoc": "/** One article's notes and the conversations that discussed it. */"
+          },
+          {
+            "kind": "method",
+            "name": "noteCounts",
+            "signature": "@Remote('noteCounts') async noteCounts(): Promise<{ counts: Record<string, number> }>",
+            "summary": "How many notes each article carries.",
+            "jsDoc": "/** How many notes each article carries. */"
+          },
+          {
+            "kind": "method",
+            "name": "addNote",
+            "signature": "@Remote('addNote') addNote(request: ReaderNoteInput): Promise<ReaderNote | 'empty' | 'full'>",
+            "summary": "Keep one excerpt (and its comment).",
+            "jsDoc": "/** Keep one excerpt (and its comment). */"
+          },
+          {
+            "kind": "method",
+            "name": "updateNote",
+            "signature": "@Remote('updateNote') updateNote(request: { entryId: string; noteId: string; comment: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Change or clear one note's comment.",
+            "jsDoc": "/** Change or clear one note's comment. */"
+          },
+          {
+            "kind": "method",
+            "name": "deleteNote",
+            "signature": "@Remote('deleteNote') deleteNote(request: { entryId: string; noteId: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Delete one note.",
+            "jsDoc": "/** Delete one note. */"
+          },
+          {
+            "kind": "method",
+            "name": "recordDiscussion",
+            "signature": "@Remote('recordDiscussion') recordDiscussion(request: ReaderEntryIdentity & { sessionId: string; sessionTitle?: string }): Promise<'ok' | 'empty'>",
+            "summary": "Remember that a conversation discussed this article.",
+            "jsDoc": "/** Remember that a conversation discussed this article. */"
+          },
+          {
+            "kind": "method",
+            "name": "addReply",
+            "signature": "@Remote('addReply') addReply(request: { entryId: string; noteId: string; text: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Add the reader's own line under a note.",
+            "jsDoc": "/** Add the reader's own line under a note. */"
+          },
+          {
+            "kind": "method",
+            "name": "editReply",
+            "signature": "@Remote('editReply') editReply(request: { entryId: string; noteId: string; index: number; text: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Rewrite (or, with empty text, remove) one line under a note.",
+            "jsDoc": "/** Rewrite (or, with empty text, remove) one line under a note. */"
+          },
+          {
+            "kind": "method",
+            "name": "markSynced",
+            "signature": "@Remote('markSynced') markSynced(request: { entryId: string; noteId?: string; discussionId?: string; canvasId: string; cardId: string; canvasTitle: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Remember that a note or a discussion note became a canvas card.",
+            "jsDoc": "/** Remember that a note or a discussion note became a canvas card. */"
+          },
+          {
+            "kind": "method",
+            "name": "deleteDiscussion",
+            "signature": "@Remote('deleteDiscussion') deleteDiscussion(request: { entryId: string; discussionId: string }): Promise<ReaderNoteOutcome>",
+            "summary": "Delete one discussion note.",
+            "jsDoc": "/** Delete one discussion note. */"
+          },
+          {
+            "kind": "method",
+            "name": "mediaTranscript",
+            "signature": "@Remote('mediaTranscript') mediaTranscript(request: { entryId: string; url: string }): Promise<{ entryId: string; html?: string; captions: 'platform' | 'none' | 'failed'; language?: string; error?: string }>",
+            "summary": "A video entry's transcript from its platform captions (stored; `none` when it has none).",
+            "jsDoc": "/** A video entry's transcript from its platform captions (stored; `none` when it has none). */"
+          },
+          {
+            "kind": "method",
+            "name": "startLocalTranscript",
+            "signature": "@Remote('startLocalTranscript') startLocalTranscript(request: { entryId: string; url: string; media: ReaderMedia; title?: string; confirmModels?: boolean }): Promise<LocalTranscriptStatus>",
+            "summary": "Start (or rejoin) local transcription of an entry without captions.",
+            "jsDoc": "/**\n * Start (or rejoin) local transcription of an entry without captions.\n * Answers `unavailable` without the transcription plugin and `needs-models`\n * until the first model download is confirmed.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "localTranscript",
+            "signature": "@Remote('localTranscript') localTranscript(request: { entryId: string }): Promise<LocalTranscriptStatus>",
+            "summary": "Where an entry's local transcription stands, with the transcript so far.",
+            "jsDoc": "/** Where an entry's local transcription stands, with the transcript so far. */"
+          },
+          {
+            "kind": "method",
+            "name": "speakerNames",
+            "signature": "@Remote('speakerNames') speakerNames(request: { entryId: string }): Promise<Record<string, string>>",
+            "summary": "The reader's names for a transcript's speakers, by index.",
+            "jsDoc": "/** The reader's names for a transcript's speakers, by index. */"
+          },
+          {
+            "kind": "method",
+            "name": "nameSpeaker",
+            "signature": "@Remote('nameSpeaker') nameSpeaker(request: { entryId: string; speaker: number; name: string }): Promise<Record<string, string>>",
+            "summary": "Name one speaker of a transcript (empty: back to 说话人 A…); answers all the names.",
+            "jsDoc": "/** Name one speaker of a transcript (empty: back to 说话人 A…); answers all the names. */"
+          },
+          {
+            "kind": "method",
+            "name": "mediaStates",
+            "signature": "@Remote('mediaStates') mediaStates(request: { entryIds: string[] }): Promise<MediaCardStates>",
+            "summary": "The wall's video / audio cards: what each one's transcript is (captions, local, transcribing…).",
+            "jsDoc": "/** The wall's video / audio cards: what each one's transcript is (captions, local, transcribing…). */"
+          },
+          {
+            "kind": "method",
+            "name": "cancelLocalTranscript",
+            "signature": "@Remote('cancelLocalTranscript') cancelLocalTranscript(request: { entryId: string; force: boolean }): Promise<LocalTranscriptStatus>",
+            "summary": "Leave (withdraws a queued job) or, with `force`, stop an entry's local transcription.",
+            "jsDoc": "/** Leave (withdraws a queued job) or, with `force`, stop an entry's local transcription. */"
+          },
+          {
+            "kind": "method",
+            "name": "polish",
+            "signature": "@Remote('polish') polish(request: { entryId: string }): Promise<ReaderPolishView | null>",
+            "summary": "The article's 润色 layer (the agent's translation), when there is one for its current text.",
+            "jsDoc": "/** The article's 润色 layer (the agent's translation), when there is one for its current text. */"
+          },
+          {
+            "kind": "method",
+            "name": "setPolishOff",
+            "signature": "@Remote('setPolishOff') setPolishOff(request: { entryId: string; paragraph: number; off: boolean }): Promise<ReaderPolishView | null>",
+            "summary": "Show one paragraph's machine translation instead of the 润色 (or back).",
+            "jsDoc": "/** Show one paragraph's machine translation instead of the 润色 (or back). */"
+          },
+          {
+            "kind": "method",
+            "name": "snapshotEntry",
+            "signature": "@Remote('snapshotEntry') snapshotEntry(request: ReaderEntryIdentity & { paragraphs: string[] }): Promise<'ok' | 'empty'>",
+            "summary": "Hand the host the article's original text, block by block, for the model to read.",
+            "jsDoc": "/** Hand the host the article's original text, block by block, for the model to read. */"
           }
         ],
         "types": [
+          {
+            "name": "LocalTranscriptState",
+            "declaration": "export type LocalTranscriptState = 'unavailable' | 'needs-models' | 'fetching' | 'queued' | 'transcribing' | 'speakers' | 'done' | 'failed' | 'idle';"
+          },
+          {
+            "name": "LocalTranscriptStatus",
+            "declaration": "export interface LocalTranscriptStatus {\n    readonly entryId: string;\n    readonly state: LocalTranscriptState;\n    readonly progress?: number;\n    readonly ahead?: number;\n    readonly bytes?: number;\n    readonly html?: string;\n    readonly language?: string;\n    readonly speakers?: number;\n    readonly error?: string;\n}"
+          },
+          {
+            "name": "MediaCardState",
+            "declaration": "export type MediaCardState = 'platform' | 'local' | 'none' | 'fetching' | 'queued' | 'transcribing' | 'failed';"
+          },
+          {
+            "name": "MediaCardStates",
+            "declaration": "export interface MediaCardStates {\n    readonly engine: boolean;\n    readonly states: Readonly<Record<string, MediaCardStatus>>;\n}"
+          },
+          {
+            "name": "MediaCardStatus",
+            "declaration": "export interface MediaCardStatus {\n    readonly state: MediaCardState;\n    readonly progress?: number;\n    readonly ahead?: number;\n}"
+          },
           {
             "name": "ReaderAddFailure",
             "declaration": "export interface ReaderAddFailure {\n    readonly outcome: 'fetch-failed';\n    readonly reason: string;\n}"
@@ -1733,6 +3563,14 @@ export const TYPERT = {
             "name": "ReaderCapabilities",
             "declaration": "export interface ReaderCapabilities {\n    readonly protocolVersion: 1;\n    readonly hasFs: boolean;\n    readonly hasSideChat: boolean;\n    readonly nextRefreshAt?: string;\n    readonly lastRefreshAt?: string;\n}"
           },
+          {
+            "name": "ReaderDiscussion",
+            "declaration": "export interface ReaderDiscussion {\n    readonly id: string;\n    readonly kind: 'discussion' | 'check';\n    readonly sessionId?: string;\n    readonly title: string;\n    readonly points: readonly ReaderDiscussionPoint[];\n    readonly aside?: string;\n    readonly syncedTo?: readonly ReaderSyncedCard[];\n    readonly createdAt: string;\n}"
+          },
+          {
+            "name": "ReaderDiscussionPoint",
+            "declaration": "export interface ReaderDiscussionPoint {\n    readonly text: string;\n    readonly para?: number;\n}"
+          },
           {
             "name": "ReaderEntryBodyView",
             "declaration": "export interface ReaderEntryBodyView {\n    readonly entryId: string;\n    readonly cached: boolean;\n    readonly fresh: boolean;\n    readonly fromFeed: boolean;\n    readonly html?: string;\n    readonly fetchedAt?: string;\n    readonly truncated?: boolean;\n    readonly scriptFigures?: number;\n    readonly rendered?: boolean;\n    readonly error?: string;\n}"
@@ -1741,6 +3579,18 @@ export const TYPERT = {
             "name": "ReaderEntryFetchState",
             "declaration": "export type ReaderEntryFetchState = { readonly state: 'none'; } | { readonly state: 'fetching'; readonly at: string; } | { readonly state: 'raw'; readonly at: string; } | { readonly state: 'ready'; readonly at?: string; } | { readonly state: 'failed'; readonly at: string; readonly message: string; readonly code?: ReaderPreviewFailureCode; };"
           },
+          {
+            "name": "ReaderEntryIdentity",
+            "declaration": "export interface ReaderEntryIdentity {\n    readonly entryId: string;\n    readonly title: string;\n    readonly url?: string;\n    readonly source?: string;\n}"
+          },
+          {
+            "name": "ReaderEntryNotes",
+            "declaration": "export interface ReaderEntryNotes {\n    readonly entryId: string;\n    readonly title: string;\n    readonly url?: string;\n    readonly source?: string;\n    readonly notes: readonly ReaderNote[];\n    readonly sessions: readonly ReaderEntrySession[];\n    readonly discussions?: readonly ReaderDiscussion[];\n    readonly nextNote: number;\n    readonly nextDiscussion?: number;\n    readonly updatedAt: string;\n}"
+          },
+          {
+            "name": "ReaderEntrySession",
+            "declaration": "export interface ReaderEntrySession {\n    readonly sessionId: string;\n    readonly title?: string;\n    readonly lastAt: string;\n}"
+          },
           {
             "name": "ReaderEntryTranslationView",
             "declaration": "export interface ReaderEntryTranslationView {\n    readonly pair: string;\n    readonly bodyHash: string;\n    readonly segments: Record<string, string>;\n}"
@@ -1753,10 +3603,42 @@ export const TYPERT = {
             "name": "ReaderImageResult",
             "declaration": "export interface ReaderImageResult {\n    readonly url: string;\n    readonly mime?: string;\n    readonly base64?: string;\n    readonly error?: string;\n}"
           },
+          {
+            "name": "ReaderMedia",
+            "declaration": "export interface ReaderMedia {\n    readonly kind: 'video' | 'audio';\n    readonly provider: ReaderMediaProvider;\n    readonly ref: string;\n    readonly durationSec?: number;\n    readonly thumbnail?: string;\n}"
+          },
+          {
+            "name": "ReaderMediaProvider",
+            "declaration": "export type ReaderMediaProvider = 'youtube' | 'bilibili' | 'xiaoyuzhou' | 'enclosure';"
+          },
           {
             "name": "ReaderMutationOutcome",
             "declaration": "export type ReaderMutationOutcome = 'ok' | 'not-found' | 'invalid-url' | 'invalid-time' | 'duplicate' | 'unavailable';"
           },
+          {
+            "name": "ReaderNote",
+            "declaration": "export interface ReaderNote {\n    readonly id: string;\n    readonly anchor: ReaderNoteAnchor;\n    readonly comment?: string;\n    readonly replies?: readonly ReaderNoteReply[];\n    readonly syncedTo?: readonly ReaderSyncedCard[];\n    readonly createdAt: string;\n    readonly updatedAt: string;\n}"
+          },
+          {
+            "name": "ReaderNoteAnchor",
+            "declaration": "export interface ReaderNoteAnchor {\n    readonly block: number;\n    readonly start?: number;\n    readonly quote: string;\n    readonly translated?: string;\n    readonly time?: number;\n}"
+          },
+          {
+            "name": "ReaderNoteInput",
+            "declaration": "export interface ReaderNoteInput extends ReaderEntryIdentity {\n    readonly block: number;\n    readonly start?: number;\n    readonly quote: string;\n    readonly translated?: string;\n    readonly comment?: string;\n    readonly time?: number;\n}"
+          },
+          {
+            "name": "ReaderNoteOutcome",
+            "declaration": "export type ReaderNoteOutcome = 'ok' | 'not-found' | 'empty' | 'full';"
+          },
+          {
+            "name": "ReaderNoteReply",
+            "declaration": "export interface ReaderNoteReply {\n    readonly by: 'agent' | 'user';\n    readonly text: string;\n    readonly sessionId?: string;\n    readonly editedFrom?: 'agent';\n    readonly at: string;\n}"
+          },
+          {
+            "name": "ReaderPolishView",
+            "declaration": "export interface ReaderPolishView {\n    readonly total: number;\n    readonly done: number;\n    readonly paragraphs: Readonly<Record<string, string>>;\n    readonly off: readonly number[];\n    readonly updatedAt: string;\n    readonly complete: boolean;\n}"
+          },
           {
             "name": "ReaderPreviewFailureCode",
             "declaration": "export type ReaderPreviewFailureCode = 'blocked' | 'login' | 'unsupported-type' | 'redirected' | 'empty' | 'unreachable' | 'http' | 'unreadable';"
@@ -1785,6 +3667,10 @@ export const TYPERT = {
             "name": "ReaderStorageStats",
             "declaration": "export interface ReaderStorageStats {\n    readonly bodies: { readonly entries: number; readonly chars: number; };\n    readonly translations: { readonly entries: number; readonly chars: number; readonly memoryEntries: number; readonly memoryChars: number; };\n}"
           },
+          {
+            "name": "ReaderSyncedCard",
+            "declaration": "export interface ReaderSyncedCard {\n    readonly canvasId: string;\n    readonly cardId: string;\n    readonly canvasTitle: string;\n    readonly at: string;\n}"
+          },
           {
             "name": "ReaderTag",
             "declaration": "export interface ReaderTag {\n    readonly id: string;\n    readonly name: string;\n    readonly createdAt: string;\n}"