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

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},
     },
-    {
-      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},
     },
-    {
-      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},
     },
+  },
+}, 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},
     },
-    {
-      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},
     },
-    {
-      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},
     },
-  ],
-}
+  },
+}, z)
 
 export default TYPERT_REMOTE

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

@@ -3,14 +3,15 @@
  * 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.
  */
 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, useModelDirectory, modelsAvailable, loadModels, selectModel, ...standard }: UserMessageViewProps) => ReactNode>;
 //# sourceMappingURL=UserMessageView.d.ts.map

package/lib/types/client/UserMessageView.js

@@ -4,11 +4,12 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  * 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.
  */
 import { memo, useEffect, useRef, useState } from 'react';
 import { shallowEqual } from '@deepseek-ai/dsh-client-store';
@@ -17,6 +18,7 @@ import { IconCheckOutlineMedium, IconCopyOutlineMedium, IconEditOutlineMedium }
 import { IconUndoOutlineMedium } from './icons-local.js';
 import { foldHiddenRanges, isSeqHidden } from './withdrawn-node.js';
 import { chatHookOf } from './chat-hook.js';
+import { renderImageGallery } from './message-images.js';
 import { withdrawAndBackfill } from './withdraw-backfill.js';
 import { ModelChip } from './ModelChip.js';
 import css from './UserMessageView.module.css';
@@ -134,7 +136,7 @@ function InlineEditor({ initial, busy, t, onSave, onCancel, models }) {
                 } }), _jsxs("div", { className: css.editorActions, children: [_jsx("div", { className: css.editorTrailing, children: models !== undefined && _jsx(ModelChip, { ...models }) }), _jsx(Button, { variant: "outline", disabled: busy, onClick: onCancel, children: t('cancel') }), _jsx(Button, { variant: "primary", disabled: busy || draft.trim() === '', onClick: save, children: t('editor.save') })] })] }));
 }
 /** The shadowed user-message view: bubble plus copy/edit/withdraw actions. */
-export const UserMessageView = memo(function UserMessageView({ node, renderMessageImages, t, editMessage, withdrawMessage, backfillDraft, useModelDirectory, modelsAvailable, loadModels, selectModel, ...standard }) {
+export const UserMessageView = memo(function UserMessageView({ node, renderMessageImages, loadImage, renderFactorySlot, t, editMessage, withdrawMessage, backfillDraft, useModelDirectory, modelsAvailable, loadModels, selectModel, ...standard }) {
     // Chat data lives in the `useChat` session standard prop on host 0.1.2
     // (the helper degrades to the frozen empty snapshot without it).
     const ranges = chatHookOf(standard)(selectHiddenRanges, shallowEqual);
@@ -175,5 +177,5 @@ export const UserMessageView = memo(function UserMessageView({ node, renderMessa
                             ? { useModelDirectory, loadModels, selectModel, t }
                             : undefined }), failed === 'edit' && _jsx("div", { className: css.actionError, role: "status", children: t('error.edit') })] }) }));
     }
-    return (_jsxs("div", { className: css.userRow, "data-time-hover-root": true, children: [_jsxs("div", { className: css.userStack, children: [node.kind === 'message-tools-edited' && (_jsx("div", { className: css.editedLabel, children: t('edited.badge') })), node.kind === 'message-tools-restored' && (_jsx("div", { className: css.editedLabel, children: t('withdrawn.restored') })), images.length > 0 ? renderMessageImages({ images, align: 'end' }) : null, showBubble && (_jsxs("div", { className: css.bubble, children: [projectUserText(text), rest.map((block, index) => (_jsx(JsonBlock, { label: t('message.extraBlock'), payload: block, truncatedLabel: truncated }, index)))] }))] }), _jsxs("div", { className: css.actions, children: [_jsx(CopyButton, { text: text, t: t }), _jsx(Tooltip, { label: t('edit'), side: "bottom", children: _jsx("button", { type: "button", className: css.action, "aria-label": t('edit'), onClick: () => { setFailed(null); setEditing(true); }, children: _jsx(IconEditOutlineMedium, {}) }) }), _jsx(Tooltip, { label: t('action.withdraw'), side: "bottom", children: _jsx("button", { type: "button", className: css.action, "aria-label": t('action.withdraw'), onClick: () => { setFailed(null); setAcknowledged(false); setConfirming(true); }, children: _jsx(IconUndoOutlineMedium, {}) }) })] }), failed === 'withdraw' && _jsx("div", { className: css.actionError, role: "status", children: t('error.withdraw') }), confirming && (_jsx(RiskConfirmation, { open: true, title: t('withdraw.title'), description: t('withdraw.description'), acknowledgeLabel: t('withdraw.acknowledge'), cancelLabel: t('cancel'), closeLabel: t('close'), confirmLabel: t('withdraw.confirm'), acknowledged: acknowledged, disabled: busy, onAcknowledgedChange: setAcknowledged, onCancel: () => { setConfirming(false); setAcknowledged(false); }, onConfirm: confirmWithdraw }))] }));
+    return (_jsxs("div", { className: css.userRow, "data-time-hover-root": true, children: [_jsxs("div", { className: css.userStack, children: [node.kind === 'message-tools-edited' && (_jsx("div", { className: css.editedLabel, children: t('edited.badge') })), node.kind === 'message-tools-restored' && (_jsx("div", { className: css.editedLabel, children: t('withdrawn.restored') })), images.length > 0 ? renderImageGallery(renderMessageImages, renderFactorySlot, loadImage, { images, align: 'end' }) : null, showBubble && (_jsxs("div", { className: css.bubble, children: [projectUserText(text), rest.map((block, index) => (_jsx(JsonBlock, { label: t('message.extraBlock'), payload: block, truncatedLabel: truncated }, index)))] }))] }), _jsxs("div", { className: css.actions, children: [_jsx(CopyButton, { text: text, t: t }), _jsx(Tooltip, { label: t('edit'), side: "bottom", children: _jsx("button", { type: "button", className: css.action, "aria-label": t('edit'), onClick: () => { setFailed(null); setEditing(true); }, children: _jsx(IconEditOutlineMedium, {}) }) }), _jsx(Tooltip, { label: t('action.withdraw'), side: "bottom", children: _jsx("button", { type: "button", className: css.action, "aria-label": t('action.withdraw'), onClick: () => { setFailed(null); setAcknowledged(false); setConfirming(true); }, children: _jsx(IconUndoOutlineMedium, {}) }) })] }), failed === 'withdraw' && _jsx("div", { className: css.actionError, role: "status", children: t('error.withdraw') }), confirming && (_jsx(RiskConfirmation, { open: true, title: t('withdraw.title'), description: t('withdraw.description'), acknowledgeLabel: t('withdraw.acknowledge'), cancelLabel: t('cancel'), closeLabel: t('close'), confirmLabel: t('withdraw.confirm'), acknowledged: acknowledged, disabled: busy, onAcknowledgedChange: setAcknowledged, onCancel: () => { setConfirming(false); setAcknowledged(false); }, onConfirm: confirmWithdraw }))] }));
 });

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

@@ -9,10 +9,13 @@
  * restoration is impossible — and the divider carries a「已恢复」badge while
  * a live restore row cites the span (withdrawing the restored rows clears
  * the badge and re-enables the action). The「重新编辑」action was removed
- * once withdrawals backfill the draft automatically.
+ * once withdrawals backfill the draft automatically. Replayed 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.
  */
 import { type ReactNode } from 'react';
 import type { WithdrawnDividerViewProps } from './slots.ts';
 /** The withdrawal divider: collapsed marker row plus the expandable replay. */
-export declare function WithdrawnDividerView({ node, t, restoreMessage, renderMessageImages, ...standard }: WithdrawnDividerViewProps): ReactNode;
+export declare function WithdrawnDividerView({ node, t, restoreMessage, renderMessageImages, loadImage, renderFactorySlot, ...standard }: WithdrawnDividerViewProps): ReactNode;
 //# sourceMappingURL=WithdrawnDividerView.d.ts.map