@khorsheed/dsh-reader 0.2.1 → 0.3.1

package/lib/typert.remote-client.js

@@ -1,32 +1,99 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host 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(),
 })),
 }))
@@ -103,6 +258,17 @@ const _khorsheed_dsh_reader_reader_fetchEntryBody_result$schema = () => (_khorsh
   'truncated': z.boolean().optional(),
   'error': z.string().optional(),
 }))
+let _khorsheed_dsh_reader_reader_fetchImage_parameter_0$schema$value
+const _khorsheed_dsh_reader_reader_fetchImage_parameter_0$schema = () => (_khorsheed_dsh_reader_reader_fetchImage_parameter_0$schema$value ??= z.object({
+  'url': z.string(),
+}))
+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().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({
   'ids': z.array(z.string()),
@@ -113,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
@@ -133,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({
@@ -181,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({
@@ -205,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
@@ -214,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
@@ -226,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(),
@@ -260,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(),
@@ -287,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(),
@@ -309,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(),
@@ -324,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(),
@@ -333,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({
@@ -356,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(),
@@ -366,27 +686,359 @@ 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_REMOTE = {
+export const TYPERT_REMOTE = createTypertRemoteInfo({
   package: '@khorsheed/dsh-reader',
-  descriptors: [
-    {
-      id: '@khorsheed/dsh-reader#reader/addSource',
+  methods: {
+    'reader/addNote': {
+      service: 'readerRemote',
+      description: 'Keep one excerpt (and its comment).',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            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/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/reader/src/remote.ts","line":322,"column":3},
+    },
+    'reader/addReply': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'addSource',
+      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',
-          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(),
+            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},
           },
         },
       ],
@@ -395,14 +1047,46 @@ export const TYPERT_REMOTE = {
         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/dsh-reader/src/remote.ts","line":71,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":410,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/capabilities',
+    'reader/capabilities': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'capabilities',
+      description: 'Capability handshake: what the browser may rely on in this composition.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -411,14 +1095,13 @@ export const TYPERT_REMOTE = {
         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":59,"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: [
       ],
@@ -427,14 +1110,13 @@ export const TYPERT_REMOTE = {
         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":274,"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: [
       ],
@@ -443,25 +1125,31 @@ export const TYPERT_REMOTE = {
         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":198,"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},
           },
         },
       ],
@@ -470,25 +1158,97 @@ export const TYPERT_REMOTE = {
         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":210,"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},
           },
         },
       ],
@@ -497,25 +1257,64 @@ export const TYPERT_REMOTE = {
         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/dsh-reader/src/remote.ts","line":222,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":240,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/entryFetchStates',
+    'reader/editReply': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'entryFetchStates',
+      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/reader/src/remote.ts","line":352,"column":3},
+    },
+    'reader/entryFetchStates': {
+      service: 'readerRemote',
+      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},
           },
         },
       ],
@@ -524,25 +1323,64 @@ export const TYPERT_REMOTE = {
         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/dsh-reader/src/remote.ts","line":145,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":163,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/entryTags',
+    'reader/entryNotes': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'entryTags',
+      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/reader/src/remote.ts","line":309,"column":9},
+    },
+    'reader/entryTags': {
+      service: 'readerRemote',
+      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},
           },
         },
       ],
@@ -551,25 +1389,31 @@ export const TYPERT_REMOTE = {
         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":234,"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},
           },
         },
       ],
@@ -578,25 +1422,64 @@ export const TYPERT_REMOTE = {
         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":115,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":123,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/getBodies',
+    'reader/fetchImage': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'getBodies',
+      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',
+          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},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        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/reader/src/remote.ts","line":140,"column":3},
+    },
+    'reader/getBodies': {
+      service: 'readerRemote',
+      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},
           },
         },
       ],
@@ -605,14 +1488,13 @@ export const TYPERT_REMOTE = {
         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":101,"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: [
       ],
@@ -621,25 +1503,31 @@ export const TYPERT_REMOTE = {
         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":240,"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(),
+            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},
           },
         },
       ],
@@ -648,25 +1536,31 @@ export const TYPERT_REMOTE = {
         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":109,"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},
           },
         },
       ],
@@ -675,25 +1569,31 @@ export const TYPERT_REMOTE = {
         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":168,"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},
           },
         },
       ],
@@ -702,25 +1602,31 @@ export const TYPERT_REMOTE = {
         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":151,"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},
           },
         },
       ],
@@ -729,14 +1635,13 @@ export const TYPERT_REMOTE = {
         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":174,"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: [
       ],
@@ -745,25 +1650,31 @@ export const TYPERT_REMOTE = {
         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":192,"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},
           },
         },
       ],
@@ -772,14 +1683,13 @@ export const TYPERT_REMOTE = {
         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":157,"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: [
       ],
@@ -788,14 +1698,13 @@ export const TYPERT_REMOTE = {
         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":268,"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: [
       ],
@@ -804,14 +1713,13 @@ export const TYPERT_REMOTE = {
         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":65,"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: [
       ],
@@ -820,14 +1728,226 @@ export const TYPERT_REMOTE = {
         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/reader/src/remote.ts","line":222,"column":3},
+    },
+    'reader/localTranscript': {
+      service: 'readerRemote',
+      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/dsh-reader/src/remote.ts","line":204,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":416,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/pruneTags',
+    'reader/pruneTags': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'pruneTags',
+      description: 'Drop tags nothing references any more.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -836,25 +1956,31 @@ export const TYPERT_REMOTE = {
         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":251,"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},
           },
         },
       ],
@@ -863,25 +1989,64 @@ export const TYPERT_REMOTE = {
         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/reader/src/remote.ts","line":298,"column":3},
+    },
+    'reader/recordDiscussion': {
+      service: 'readerRemote',
+      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/dsh-reader/src/remote.ts","line":280,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":340,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/recordRead',
+    'reader/recordRead': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'recordRead',
+      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},
           },
         },
       ],
@@ -890,25 +2055,31 @@ export const TYPERT_REMOTE = {
         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":257,"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},
           },
         },
       ],
@@ -917,25 +2088,31 @@ export const TYPERT_REMOTE = {
         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":95,"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},
           },
         },
       ],
@@ -944,25 +2121,31 @@ export const TYPERT_REMOTE = {
         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":180,"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},
           },
         },
       ],
@@ -971,25 +2154,31 @@ export const TYPERT_REMOTE = {
         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":89,"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},
           },
         },
       ],
@@ -998,25 +2187,30 @@ export const TYPERT_REMOTE = {
         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":216,"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},
           },
         },
       ],
@@ -1025,25 +2219,163 @@ export const TYPERT_REMOTE = {
         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/reader/src/remote.ts","line":392,"column":3},
+    },
+    'reader/startLocalTranscript': {
+      service: 'readerRemote',
+      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/dsh-reader/src/remote.ts","line":245,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":380,"column":3},
     },
-    {
-      id: '@khorsheed/dsh-reader#reader/storeEntryBody',
+    'reader/storeEntryBody': {
       service: 'readerRemote',
-      namespace: 'reader',
-      method: 'storeEntryBody',
+      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},
           },
         },
       ],
@@ -1052,25 +2384,31 @@ export const TYPERT_REMOTE = {
         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":128,"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},
           },
         },
       ],
@@ -1079,25 +2417,64 @@ export const TYPERT_REMOTE = {
         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#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":228,"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},
           },
         },
       ],
@@ -1106,10 +2483,11 @@ export const TYPERT_REMOTE = {
         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":77,"column":3},
+      sourceLocation: {"file":"packages/reader/src/remote.ts","line":85,"column":3},
     },
-  ],
-}
+  },
+}, z)
 
 export default TYPERT_REMOTE