@khorsheed/dsh-client-message-tools 0.3.3 → 0.3.5

package/lib/typert.host.js

@@ -1,18 +1,20 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
 import { z } from 'zod'
 
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
 let _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'targetSeq': z.number().readonly(),
-  'text': z.string().readonly(),
+  'sessionId': z.string().readonly().describe('Session that owns the target message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the editable user message (an original or a previous edit\'s replacement).'),
+  'text': z.string().readonly().describe('The edited text (non-blank).'),
 }))
 let _khorsheed_dsh_client_message_tools_messageTools_edit_result$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_edit_result$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_edit_result$schema$value ??= z.union([z.object({
   'ok': z.literal(true).readonly(),
   'value': z.object({
-  'replacementSeq': z.number().readonly(),
-  'triggered': z.boolean().readonly(),
+  'replacementSeq': z.number().readonly().describe('Seq of the replacement event carrying the edited text.'),
+  'triggered': z.boolean().readonly().describe('Whether the regeneration turn was triggered (false when no live agent).'),
 }).readonly(),
 }), z.object({
   'ok': z.literal(false).readonly(),
@@ -30,14 +32,14 @@ const _khorsheed_dsh_client_message_tools_messageTools_edit_result$schema = () =
 })]))
 let _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'targetSeq': z.number().readonly(),
+  'sessionId': z.string().readonly().describe('Session that owns the withdrawn message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the withdrawn append-surface `user/message` event to restore.'),
 }))
 let _khorsheed_dsh_client_message_tools_messageTools_restore_result$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_restore_result$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_restore_result$schema$value ??= z.union([z.object({
   'ok': z.literal(true).readonly(),
   'value': z.object({
-  'restoredSeq': z.number().readonly(),
+  'restoredSeq': z.number().readonly().describe('Seq of the appended replay event.'),
 }).readonly(),
 }), z.object({
   'ok': z.literal(false).readonly(),
@@ -53,15 +55,15 @@ const _khorsheed_dsh_client_message_tools_messageTools_restore_result$schema = (
 })]))
 let _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'targetSeq': z.number().readonly(),
+  'sessionId': z.string().readonly().describe('Session that owns the target message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the append-surface `user/message` event to withdraw.'),
 }))
 let _khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema$value ??= z.union([z.object({
   'ok': z.literal(true).readonly(),
   'value': z.object({
-  'replacementSeq': z.number().readonly(),
-  'shadowedCount': z.number().readonly(),
+  'replacementSeq': z.number().readonly().describe('Seq of the replacement event now standing in for the withdrawn span.'),
+  'shadowedCount': z.number().readonly().describe('Count of surface nodes the replacement shadows.'),
 }).readonly(),
 }), z.object({
   'ok': z.literal(false).readonly(),
@@ -75,29 +77,48 @@ const _khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema =
   'code': z.literal("already-withdrawn").readonly(),
 })]).readonly(),
 })]))
+let _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0_strict$schema$value
+const _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0_strict$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly().describe('Session that owns the target message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the editable user message (an original or a previous edit\'s replacement).'),
+  'text': z.string().readonly().describe('The edited text (non-blank).'),
+}))
+let _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0_strict$schema$value
+const _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0_strict$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly().describe('Session that owns the withdrawn message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the withdrawn append-surface `user/message` event to restore.'),
+}))
+let _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0_strict$schema$value
+const _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0_strict$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly().describe('Session that owns the target message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the append-surface `user/message` event to withdraw.'),
+}))
 
-export const TYPERT = {
+const $remote = createTypertRemoteInfo({
   package: '@khorsheed/dsh-client-message-tools',
-  face: 'host',
-  schemas: [
-  ],
-  invocations: [
-    {
-      id: '@khorsheed/dsh-client-message-tools#messageTools/edit',
+  methods: {
+    'messageTools/edit': {
       service: 'messageTools',
-      namespace: 'messageTools',
-      method: 'edit',
+      description: 'Edit a user message in place: replace it and every surface node after it with the edited text itself (no placeholder, no tail duplicate — the edited text appears exactly once, in the replacement event), then start a regeneration turn. The harness has no wake-without-append path, so the turn is started by `agent.followup` carrying a minimal producer-sourced trigger message (the ankh-guard/schedule pattern); the trigger is not the edited text and lands once, as itself.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'session identity, target seq, edited text.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsEditRequest',
             create: _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0$schema,
             schema: _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the target message."},"targetSeq":{"type":"number","description":"Seq of the editable user message (an original or a previous edit's replacement)."},"text":{"type":"string","description":"The edited text (non-blank)."}},"required":["sessionId","targetSeq","text"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsEditRequest',
+            create: _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the target message."},"targetSeq":{"type":"number","description":"Seq of the editable user message (an original or a previous edit's replacement)."},"text":{"type":"string","description":"The edited text (non-blank)."}},"required":["sessionId","targetSeq","text"],"additionalProperties":false},
           },
         },
       ],
@@ -106,25 +127,33 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsEditResult',
         create: _khorsheed_dsh_client_message_tools_messageTools_edit_result$schema,
         schema: _khorsheed_dsh_client_message_tools_messageTools_edit_result$schema(),
+        description: 'the replacement receipt and whether the turn was triggered, or a rejection.',
+        jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"value":{"type":"object","properties":{"replacementSeq":{"type":"number","description":"Seq of the replacement event carrying the edited text."},"triggered":{"type":"boolean","description":"Whether the regeneration turn was triggered (false when no live agent)."}},"required":["replacementSeq","triggered"],"additionalProperties":true}},"required":["ok","value"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"session-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"target-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"not-a-user-message"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"already-withdrawn"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"empty-text"}},"required":["code"],"additionalProperties":true}]}},"required":["ok","error"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/message-tools/src/index.ts","line":140,"column":9},
+      sourceLocation: {"file":"packages/client-message-tools/src/index.ts","line":140,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-client-message-tools#messageTools/restore',
+    'messageTools/restore': {
       service: 'messageTools',
-      namespace: 'messageTools',
-      method: 'restore',
+      description: 'Restore a withdrawn span: replay every replayable entry of it (user messages verbatim — including the last edit\'s new text — and framed assistant text; tool calls/results never replay) as fresh producer-sourced `user/message` appends at the conversation tail, in original order, each citing its original event in `sourceEventSeqs`. The surface replace model is positional — a replaced span folds into one node — so the span cannot be restored in place; the replayed entries are simply the newest messages the model sees. Assistant text replays as framed user-role messages: `assistant/message` requires the model source and the turn/step trace forbids assistant appends outside a step.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'session identity and withdrawn message seq.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsRestoreRequest',
             create: _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0$schema,
             schema: _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the withdrawn message."},"targetSeq":{"type":"number","description":"Seq of the withdrawn append-surface `user/message` event to restore."}},"required":["sessionId","targetSeq"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsRestoreRequest',
+            create: _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the withdrawn message."},"targetSeq":{"type":"number","description":"Seq of the withdrawn append-surface `user/message` event to restore."}},"required":["sessionId","targetSeq"],"additionalProperties":false},
           },
         },
       ],
@@ -133,25 +162,33 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsRestoreResult',
         create: _khorsheed_dsh_client_message_tools_messageTools_restore_result$schema,
         schema: _khorsheed_dsh_client_message_tools_messageTools_restore_result$schema(),
+        description: 'the restore receipt, or a rejection from the closed failure union.',
+        jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"value":{"type":"object","properties":{"restoredSeq":{"type":"number","description":"Seq of the appended replay event."}},"required":["restoredSeq"],"additionalProperties":true}},"required":["ok","value"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"session-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"target-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"not-a-user-message"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"not-withdrawn"}},"required":["code"],"additionalProperties":true}]}},"required":["ok","error"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/message-tools/src/index.ts","line":102,"column":9},
+      sourceLocation: {"file":"packages/client-message-tools/src/index.ts","line":102,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-client-message-tools#messageTools/withdraw',
+    'messageTools/withdraw': {
       service: 'messageTools',
-      namespace: 'messageTools',
-      method: 'withdraw',
+      description: 'Withdraw a user message: replace it and every surface node after it with a minimal producer-sourced placeholder, hiding the span from the model.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'session identity and target message seq.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsWithdrawRequest',
             create: _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0$schema,
             schema: _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the target message."},"targetSeq":{"type":"number","description":"Seq of the append-surface `user/message` event to withdraw."}},"required":["sessionId","targetSeq"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsWithdrawRequest',
+            create: _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the target message."},"targetSeq":{"type":"number","description":"Seq of the append-surface `user/message` event to withdraw."}},"required":["sessionId","targetSeq"],"additionalProperties":false},
           },
         },
       ],
@@ -160,10 +197,20 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsWithdrawResult',
         create: _khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema,
         schema: _khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema(),
+        description: 'the replacement receipt, or a rejection from the closed failure union.',
+        jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"value":{"type":"object","properties":{"replacementSeq":{"type":"number","description":"Seq of the replacement event now standing in for the withdrawn span."},"shadowedCount":{"type":"number","description":"Count of surface nodes the replacement shadows."}},"required":["replacementSeq","shadowedCount"],"additionalProperties":true}},"required":["ok","value"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"session-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"target-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"not-a-user-message"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"already-withdrawn"}},"required":["code"],"additionalProperties":true}]}},"required":["ok","error"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/message-tools/src/index.ts","line":68,"column":9},
+      sourceLocation: {"file":"packages/client-message-tools/src/index.ts","line":68,"column":9},
     },
+  },
+}, z)
+
+export const TYPERT = {
+  package: '@khorsheed/dsh-client-message-tools',
+  face: 'host',
+  schemas: [
   ],
+  get invocations() { return $remote.descriptors },
   model: {
     "services": [
       {

package/lib/typert.remote-client.d.ts

@@ -1,7 +1,8 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import type {
   RemoteResult,
-  TypertRemoteContribution,
+  TypertRemoteInfo,
+  TypertRemoteMethod,
 } from '@deepseek-ai/dsh-typert-protocol'
 import type { MessageToolsEditRequest, MessageToolsEditResult, MessageToolsRestoreRequest, MessageToolsRestoreResult, MessageToolsWithdrawRequest, MessageToolsWithdrawResult } from '@khorsheed/dsh-client-message-tools/types'
 
@@ -21,6 +22,10 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
   }
 }
 
-export declare const TYPERT_REMOTE: TypertRemoteContribution
+export declare const TYPERT_REMOTE: TypertRemoteInfo<{
+  readonly 'messageTools/edit': TypertRemoteMethod<{ readonly 'request': MessageToolsEditRequest }, MessageToolsEditResult>
+  readonly 'messageTools/restore': TypertRemoteMethod<{ readonly 'request': MessageToolsRestoreRequest }, MessageToolsRestoreResult>
+  readonly 'messageTools/withdraw': TypertRemoteMethod<{ readonly 'request': MessageToolsWithdrawRequest }, MessageToolsWithdrawResult>
+}>
 export default TYPERT_REMOTE
 //# sourceMappingURL=typert.remote-client.d.ts.map

package/lib/typert.remote-client.js

@@ -1,18 +1,20 @@
 /* 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_client_message_tools_messageTools_edit_parameter_0$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'targetSeq': z.number().readonly(),
-  'text': z.string().readonly(),
+  'sessionId': z.string().readonly().describe('Session that owns the target message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the editable user message (an original or a previous edit\'s replacement).'),
+  'text': z.string().readonly().describe('The edited text (non-blank).'),
 }))
 let _khorsheed_dsh_client_message_tools_messageTools_edit_result$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_edit_result$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_edit_result$schema$value ??= z.union([z.object({
   'ok': z.literal(true).readonly(),
   'value': z.object({
-  'replacementSeq': z.number().readonly(),
-  'triggered': z.boolean().readonly(),
+  'replacementSeq': z.number().readonly().describe('Seq of the replacement event carrying the edited text.'),
+  'triggered': z.boolean().readonly().describe('Whether the regeneration turn was triggered (false when no live agent).'),
 }).readonly(),
 }), z.object({
   'ok': z.literal(false).readonly(),
@@ -30,14 +32,14 @@ const _khorsheed_dsh_client_message_tools_messageTools_edit_result$schema = () =
 })]))
 let _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'targetSeq': z.number().readonly(),
+  'sessionId': z.string().readonly().describe('Session that owns the withdrawn message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the withdrawn append-surface `user/message` event to restore.'),
 }))
 let _khorsheed_dsh_client_message_tools_messageTools_restore_result$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_restore_result$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_restore_result$schema$value ??= z.union([z.object({
   'ok': z.literal(true).readonly(),
   'value': z.object({
-  'restoredSeq': z.number().readonly(),
+  'restoredSeq': z.number().readonly().describe('Seq of the appended replay event.'),
 }).readonly(),
 }), z.object({
   'ok': z.literal(false).readonly(),
@@ -53,15 +55,15 @@ const _khorsheed_dsh_client_message_tools_messageTools_restore_result$schema = (
 })]))
 let _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'targetSeq': z.number().readonly(),
+  'sessionId': z.string().readonly().describe('Session that owns the target message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the append-surface `user/message` event to withdraw.'),
 }))
 let _khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema$value
 const _khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema$value ??= z.union([z.object({
   'ok': z.literal(true).readonly(),
   'value': z.object({
-  'replacementSeq': z.number().readonly(),
-  'shadowedCount': z.number().readonly(),
+  'replacementSeq': z.number().readonly().describe('Seq of the replacement event now standing in for the withdrawn span.'),
+  'shadowedCount': z.number().readonly().describe('Count of surface nodes the replacement shadows.'),
 }).readonly(),
 }), z.object({
   'ok': z.literal(false).readonly(),
@@ -75,26 +77,48 @@ const _khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema =
   'code': z.literal("already-withdrawn").readonly(),
 })]).readonly(),
 })]))
+let _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0_strict$schema$value
+const _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0_strict$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly().describe('Session that owns the target message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the editable user message (an original or a previous edit\'s replacement).'),
+  'text': z.string().readonly().describe('The edited text (non-blank).'),
+}))
+let _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0_strict$schema$value
+const _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0_strict$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly().describe('Session that owns the withdrawn message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the withdrawn append-surface `user/message` event to restore.'),
+}))
+let _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0_strict$schema$value
+const _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0_strict$schema = () => (_khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly().describe('Session that owns the target message.'),
+  'targetSeq': z.number().readonly().describe('Seq of the append-surface `user/message` event to withdraw.'),
+}))
 
-export const TYPERT_REMOTE = {
+export const TYPERT_REMOTE = createTypertRemoteInfo({
   package: '@khorsheed/dsh-client-message-tools',
-  descriptors: [
-    {
-      id: '@khorsheed/dsh-client-message-tools#messageTools/edit',
+  methods: {
+    'messageTools/edit': {
       service: 'messageTools',
-      namespace: 'messageTools',
-      method: 'edit',
+      description: 'Edit a user message in place: replace it and every surface node after it with the edited text itself (no placeholder, no tail duplicate — the edited text appears exactly once, in the replacement event), then start a regeneration turn. The harness has no wake-without-append path, so the turn is started by `agent.followup` carrying a minimal producer-sourced trigger message (the ankh-guard/schedule pattern); the trigger is not the edited text and lands once, as itself.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'session identity, target seq, edited text.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsEditRequest',
             create: _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0$schema,
             schema: _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the target message."},"targetSeq":{"type":"number","description":"Seq of the editable user message (an original or a previous edit's replacement)."},"text":{"type":"string","description":"The edited text (non-blank)."}},"required":["sessionId","targetSeq","text"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsEditRequest',
+            create: _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_client_message_tools_messageTools_edit_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the target message."},"targetSeq":{"type":"number","description":"Seq of the editable user message (an original or a previous edit's replacement)."},"text":{"type":"string","description":"The edited text (non-blank)."}},"required":["sessionId","targetSeq","text"],"additionalProperties":false},
           },
         },
       ],
@@ -103,25 +127,33 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsEditResult',
         create: _khorsheed_dsh_client_message_tools_messageTools_edit_result$schema,
         schema: _khorsheed_dsh_client_message_tools_messageTools_edit_result$schema(),
+        description: 'the replacement receipt and whether the turn was triggered, or a rejection.',
+        jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"value":{"type":"object","properties":{"replacementSeq":{"type":"number","description":"Seq of the replacement event carrying the edited text."},"triggered":{"type":"boolean","description":"Whether the regeneration turn was triggered (false when no live agent)."}},"required":["replacementSeq","triggered"],"additionalProperties":true}},"required":["ok","value"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"session-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"target-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"not-a-user-message"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"already-withdrawn"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"empty-text"}},"required":["code"],"additionalProperties":true}]}},"required":["ok","error"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/message-tools/src/index.ts","line":140,"column":9},
+      sourceLocation: {"file":"packages/client-message-tools/src/index.ts","line":140,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-client-message-tools#messageTools/restore',
+    'messageTools/restore': {
       service: 'messageTools',
-      namespace: 'messageTools',
-      method: 'restore',
+      description: 'Restore a withdrawn span: replay every replayable entry of it (user messages verbatim — including the last edit\'s new text — and framed assistant text; tool calls/results never replay) as fresh producer-sourced `user/message` appends at the conversation tail, in original order, each citing its original event in `sourceEventSeqs`. The surface replace model is positional — a replaced span folds into one node — so the span cannot be restored in place; the replayed entries are simply the newest messages the model sees. Assistant text replays as framed user-role messages: `assistant/message` requires the model source and the turn/step trace forbids assistant appends outside a step.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'session identity and withdrawn message seq.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsRestoreRequest',
             create: _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0$schema,
             schema: _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the withdrawn message."},"targetSeq":{"type":"number","description":"Seq of the withdrawn append-surface `user/message` event to restore."}},"required":["sessionId","targetSeq"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsRestoreRequest',
+            create: _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_client_message_tools_messageTools_restore_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the withdrawn message."},"targetSeq":{"type":"number","description":"Seq of the withdrawn append-surface `user/message` event to restore."}},"required":["sessionId","targetSeq"],"additionalProperties":false},
           },
         },
       ],
@@ -130,25 +162,33 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsRestoreResult',
         create: _khorsheed_dsh_client_message_tools_messageTools_restore_result$schema,
         schema: _khorsheed_dsh_client_message_tools_messageTools_restore_result$schema(),
+        description: 'the restore receipt, or a rejection from the closed failure union.',
+        jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"value":{"type":"object","properties":{"restoredSeq":{"type":"number","description":"Seq of the appended replay event."}},"required":["restoredSeq"],"additionalProperties":true}},"required":["ok","value"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"session-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"target-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"not-a-user-message"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"not-withdrawn"}},"required":["code"],"additionalProperties":true}]}},"required":["ok","error"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/message-tools/src/index.ts","line":102,"column":9},
+      sourceLocation: {"file":"packages/client-message-tools/src/index.ts","line":102,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-client-message-tools#messageTools/withdraw',
+    'messageTools/withdraw': {
       service: 'messageTools',
-      namespace: 'messageTools',
-      method: 'withdraw',
+      description: 'Withdraw a user message: replace it and every surface node after it with a minimal producer-sourced placeholder, hiding the span from the model.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'session identity and target message seq.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsWithdrawRequest',
             create: _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0$schema,
             schema: _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the target message."},"targetSeq":{"type":"number","description":"Seq of the append-surface `user/message` event to withdraw."}},"required":["sessionId","targetSeq"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsWithdrawRequest',
+            create: _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_client_message_tools_messageTools_withdraw_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"Session that owns the target message."},"targetSeq":{"type":"number","description":"Seq of the append-surface `user/message` event to withdraw."}},"required":["sessionId","targetSeq"],"additionalProperties":false},
           },
         },
       ],
@@ -157,10 +197,12 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@khorsheed/dsh-client-message-tools/types#MessageToolsWithdrawResult',
         create: _khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema,
         schema: _khorsheed_dsh_client_message_tools_messageTools_withdraw_result$schema(),
+        description: 'the replacement receipt, or a rejection from the closed failure union.',
+        jsonSchema: {"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"value":{"type":"object","properties":{"replacementSeq":{"type":"number","description":"Seq of the replacement event now standing in for the withdrawn span."},"shadowedCount":{"type":"number","description":"Count of surface nodes the replacement shadows."}},"required":["replacementSeq","shadowedCount"],"additionalProperties":true}},"required":["ok","value"],"additionalProperties":true},{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"session-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"target-not-found"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"not-a-user-message"}},"required":["code"],"additionalProperties":true},{"type":"object","properties":{"code":{"type":"string","const":"already-withdrawn"}},"required":["code"],"additionalProperties":true}]}},"required":["ok","error"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/message-tools/src/index.ts","line":68,"column":9},
+      sourceLocation: {"file":"packages/client-message-tools/src/index.ts","line":68,"column":9},
     },
-  ],
-}
+  },
+}, z)
 
 export default TYPERT_REMOTE

package/lib/types/client/UserMessageView.d.ts

@@ -3,14 +3,17 @@
  * the plugin's own 'message-tools-edited' and 'message-tools-restored' rows):
  * a visual clone of the official bubble chrome — ui-conversation ships no
  * public components, so the structure is replicated against ui-primitives
- * platform modules, with historical images rendered through the owner-prop
- * `renderMessageImages` attachment slot (rc8 contract) — plus the
- * copy/edit/withdraw action row and the「已编辑」/「已恢复」labels. User
- * messages inside a withdrawn span render nothing; the withdrawal divider
- * marks the spot.
+ * platform modules — plus the copy/edit/withdraw action row and the
+ * 「已编辑」/「已恢复」labels. Attached images render through the host's
+ * gallery surface (see message-images.ts): the pre-0.2.1 `renderMessageImages`
+ * owner prop when the host still passes it, otherwise the root-scoped
+ * `conversation.images.content` factory. User messages inside a withdrawn
+ * span render nothing; the withdrawal divider marks the spot. A long message
+ * folds behind a fade; a small chevron seated in the bubble's bottom-right
+ * corner expands / collapses it (see fold.ts).
  */
 import { type ReactNode } from 'react';
 import type { UserMessageViewProps } from './slots.ts';
 /** The shadowed user-message view: bubble plus copy/edit/withdraw actions. */
-export declare const UserMessageView: import("react").MemoExoticComponent<({ node, renderMessageImages, t, editMessage, withdrawMessage, backfillDraft, useModelDirectory, modelsAvailable, loadModels, selectModel, ...standard }: UserMessageViewProps) => ReactNode>;
+export declare const UserMessageView: import("react").MemoExoticComponent<({ node, renderMessageImages, loadImage, renderFactorySlot, t, editMessage, withdrawMessage, backfillDraft, foldScope, useModelDirectory, modelsAvailable, loadModels, selectModel, ...standard }: UserMessageViewProps) => ReactNode>;
 //# sourceMappingURL=UserMessageView.d.ts.map