@khorsheed/dsh-client-message-tools 0.3.0 → 0.3.1

package/lib/types/restore-projection.js

@@ -0,0 +1,123 @@
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+// Value: the branded seq constructor the probe events require.
+import { SessionSeq } from '@deepseek-ai/dsh-session';
+// Namespace: foldSurface/deriveEventMessage are 0.1.6 additions — a named
+// import would fail module linking on a 0.1.5 host, so the probe reaches them
+// through the namespace object (absent members read as undefined).
+import * as sessionApi from '@deepseek-ai/dsh-session';
+import { RESTORED_ASSISTANT_NOTICE, messageToolsOp, restoreAssistantSource, stripRestoreAssistantFrame, } from './marker.js';
+/**
+ * The `user/message` projection correcting restore replays at derivation
+ * time. It registers on the SHARED user-message vocabulary (a custom event
+ * type could never persist — S2), so the fold calls `project` synchronously
+ * for EVERY user message, inside append validation: it must be a pure
+ * pass-through (empty map) for anything without the restore mark, and it must
+ * NEVER throw — a throw atomically rejects the candidate append, so a
+ * throwing projection would break ordinary user messages instance-wide. Any
+ * malformed durable payload therefore also yields an empty map.
+ */
+export const restoreAssistantProjection = {
+    type: 'user/message',
+    project(event, context) {
+        try {
+            const source = event.data?.source;
+            if (messageToolsOp(source) !== 'restore-assistant')
+                return new Map();
+            // The current message at the candidate's own seq: a prior projection's
+            // rewrite wins, then the committed window entry (fold replay), then the
+            // candidate's own data (live append validation, where the window
+            // excludes the candidate). Mirrors the official image-offload
+            // projection's message fetch.
+            const committed = context.events[event.seq - context.baseSeq];
+            const message = context.messages.get(event.seq)
+                ?? (committed?.type === 'user/message' ? committed.data : undefined)
+                ?? event.data;
+            const content = message.content.map(block => block.type === 'text' && typeof block.text === 'string'
+                ? { ...block, text: stripRestoreAssistantFrame(block.text) }
+                : block);
+            return new Map([[event.seq, { ...message, role: 'assistant', content }]]);
+        }
+        catch {
+            return new Map();
+        }
+    },
+};
+/** One synthetic user/message event for the fold-semantics probe. */
+function probeEvent(seq, text, source) {
+    return {
+        type: 'user/message',
+        seq: SessionSeq(seq),
+        time: 0,
+        data: createUserMessage({ content: [{ type: 'text', text }], source }),
+        surfaceOp: 'append',
+    };
+}
+/**
+ * Whether this host's surface fold can carry a `user/message` projection at
+ * all. 0.1.6-alpha.1 routes every event of a projected type through the
+ * projection plan and never joins it to the surface (probe-verified): a
+ * registered user/message projection would silently drop EVERY user message
+ * from the model context. This probe folds two synthetic events through the
+ * real `foldSurface` and accepts only the composing semantics the design
+ * needs — plain messages keep their node, and a restore replay keeps its
+ * node AND derives assistant-role with the frame stripped — so the channel
+ * stays dormant on 0.1.6-alpha.1 and lights up by itself on a host whose
+ * fold composes. Pure, synchronous, side-effect-free.
+ * @param fold - the host's surface fold, injectable for tests.
+ * @param derive - the host's single-event derivation, injectable for tests.
+ * @returns true when a registered user/message projection is safe.
+ */
+export function restoreProjectionFoldSupported(fold = sessionApi.foldSurface, derive = sessionApi.deriveEventMessage) {
+    try {
+        if (typeof fold !== 'function' || typeof derive !== 'function')
+            return false;
+        const events = [
+            probeEvent(0, 'probe', { kind: 'user' }),
+            probeEvent(1, `${RESTORED_ASSISTANT_NOTICE}\nprobe answer`, restoreAssistantSource()),
+        ];
+        const folded = fold(events, [restoreAssistantProjection]);
+        if (folded.nodes.length !== events.length)
+            return false;
+        const derived = derive(events[1], folded.projectedMessages);
+        return derived?.role === 'assistant'
+            && derived.content.some(block => block.type === 'text' && block.text === 'probe answer');
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Probe and register the restore-assistant projection, degrading to the
+ * framed user-role channel (which the durable events already carry) whenever
+ * the host cannot carry the projection: pre-0.1.6 (`registerMessageProjection`
+ * absent), a fold that cannot compose projections with surface membership, or
+ * a registration conflict (the projection slot is one-per-type per instance —
+ * a future official projection claiming user/message throws, and the plugin
+ * must not take the instance down with it).
+ * @param ctx - host context carrying the session store.
+ * @param foldSupported - fold-semantics probe, injectable for tests.
+ * @returns true when the projection channel is active.
+ */
+export function registerRestoreProjection(ctx, foldSupported = restoreProjectionFoldSupported) {
+    const sessions = ctx.sessions;
+    if (typeof sessions.registerMessageProjection !== 'function') {
+        ctx.logger.info('message-tools: host has no sessions.registerMessageProjection — restored assistant text stays in the framed user-role channel');
+        return false;
+    }
+    if (!foldSupported()) {
+        ctx.logger.warn('message-tools: host message-projection fold drops projected user/message events from the surface — restored assistant text stays in the framed user-role channel');
+        return false;
+    }
+    try {
+        const dispose = sessions.registerMessageProjection(restoreAssistantProjection);
+        // The host's returned disposer is fiber-owned and idempotent (cordis
+        // effect disposal re-entry is a no-op); wiring it here as well keeps
+        // unregister-on-unload exact even if a future host binds it elsewhere.
+        ctx.effect(() => () => dispose(), 'message-tools: restore-assistant projection');
+        return true;
+    }
+    catch {
+        ctx.logger.warn('message-tools: a user/message message-projection is already registered — restored assistant text stays in the framed user-role channel');
+        return false;
+    }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Message Tools",
+    "description": "Edit or withdraw sent messages; withdrawal truly leaves the model context."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "消息工具",
+    "description": "编辑或撤回已发送的消息，撤回内容真正离开模型上下文。"
+  }
+}

package/package.json

@@ -7,7 +7,7 @@
     "cordis",
     "messages"
   ],
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -37,7 +37,8 @@
       "default": "./lib/typert.remote-client.js"
     },
     "./src/*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "dsh": {
     "bundle": {
@@ -54,10 +55,13 @@
     },
     "compat": {
       "minHost": "0.1.5-rc.1",
-      "verifiedHost": "0.1.5-rc.1"
+      "verifiedHost": "0.1.7-rc.1"
     }
   },
   "license": "MIT",
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.6",
@@ -72,30 +76,6 @@
     "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.6",
     "react": "^18.2.0"
   },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-chat": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-model-selection": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.1",
-    "@testing-library/react": "^16.1.0",
-    "@types/node": "^26.2.0",
-    "@types/react": "~18.3.1",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0"
-  },
   "files": [
     "lib",
     "cordis.patch.yml",
@@ -104,6 +84,7 @@
     "lib/typert.remote-client.d.ts",
     "lib/typert.remote-client.js",
     "LICENSE",
+    "locale/*.json",
     "CHANGELOG.md"
   ]
 }