@deepseek-ai/dsh-client-ui-conversation 0.1.7-rc.2 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -6,8 +6,8 @@
   en: 0ca51f37788dcbdb
   zh: 14d73c6bc8d4e17f
 /deepseek-ai-dsh-client-ui-conversation:
-  en: 71d52109076d859d
-  zh: 8e63171fbd9bde48
+  en: 77ecbd074ef3a3ce
+  zh: 2c0e2b720e3b201e
 /deepseek-ai-dsh-client-ui-conversation/summary:
   en: bac0bf0d7330f3b1
   zh: 84a895f4b26d8490
@@ -18,8 +18,8 @@
   en: 13ae68865fa315d7
   zh: c152f020abf20f35
 /deepseek-ai-dsh-client-ui-conversation/shell-and-standard-props:
-  en: ea2f1e81b1f9a38a
-  zh: a2d4745b3e93e5a9
+  en: 7f1d7a29d2238f3a
+  zh: f7a66d2f34a1cd42
 /deepseek-ai-dsh-client-ui-conversation/temporary-composer-entries:
   en: bb1244310f5c0382
   zh: 824b84077432b559

package/README.md

@@ -7,6 +7,8 @@ kind: "package-reference"
 
 English | [中文](README.zh.md)
 
+Desktop product events use the optional [product analytics service](../product-analytics/README.md); ordinary Web interactions are excluded.
+
 ## Summary
 
 `ui-conversation` owns target-neutral Conversation assembly and the shared browser shell. It consumes Session Controller `SessionEventLikeEntry` feeds, exposes React-free registries and per-Session bindings through `ctx.uiConversation`, and contributes the `useConversation`, `useInput`, and `inputActions` standard props through `ctx.uiSession`. It also owns the per-session durable image URL cache: `ctx.uiConversation.imageUrl(sessionId, attachment)` resolves one session-authorized browser URL per attachment and revokes it with the Session binding, so every Conversation target shares one `session.attachment` read. Concrete targets such as Chat are separate packages that register their own Definitions, snapshot builders, Views, and renderers.
@@ -74,6 +76,8 @@ The resident composer survives no-Session and Session transitions. Whitespace hi
 
 Plain Enter uses the configured delivery mode, exactly Ctrl+Enter or Cmd+Enter uses its complement, and Shift+Enter inserts a line break. Enter with Alt, AltGraph, both Ctrl and Cmd, or Shift plus Ctrl/Cmd leaves the draft and command menu unchanged and keeps the DOM event available to application shortcuts. The Conversation plugin registers the fixed send, newline, complementary-delivery, command-menu, and reference-menu rows and reserves their bindings until it unloads.
 
+Each composer attempt carries its original occurrence time, gesture, delivery intent, and Session model/run-state snapshot through asynchronous command arbitration. The ordinary-message notification fires once before reference serialization, including attachment-only submissions; handled or claimed commands do not notify. Snapshot and notification failures cannot block sending.
+
 Default sends commit optimistically: Enter clears the draft, occurrence table, and undo history in the same transaction, keeps the composer in `plain`, and runs the send as a detached attempt, so typing and further sends continue during the flight. `sendSession` registers a Session submission echo (`session.beginSubmission`) with the delivery mode before serializing, preserving selected image and file order in `pendingSubmissions`; Session derives the placement from that mode and its current running state, so idle sends use the transcript, busy Queue sends use QueueDock, and busy Steer sends use the pending-steering surface. It then yields one paint, encodes images through the browser's native `FileReader` data-URL path, and cites staged file receipts. Command submissions use the same receipts for generic files, so sending `/goal` or `/plan` never reads those browser files again. The prompt reuses the submission `requestId`; Session retires the echo once at its display handoff, correlated by that `rpcId`. Concurrent failures are restored together in submission order until the user edits the restored content; command submissions keep the frozen `submitting` phase. Detached attempts retain their attachment ids through admission and Session scope disposal. An observed retirement immediately exposes each image preview through the durable cache, replaces it with the canonical URL after fetching the admitted attachment, revokes each URL after its use ends, and releases file cards. Selected generic files enter one FIFO background-upload queue; `maxConcurrentFileUploads` defaults to two active Worker transports, the Conversation service retains queued and active operations plus byte progress across Session navigation, and removing a draft skips its queued transfer or aborts its active transport. Where the browser shell exposes `__DSH_HOST_PATHS__` (the Desktop application), dropped or pasted folders and dropped, picked, or pasted non-image files with a real path become `@path` chips; images keep uploading. Drag-and-drop and paste identify directories through the browser entry API; when that API is absent or returns no entry, pasted items retain ordinary file handling. The file picker cannot select directories. References require the `ui-reference` plugin and the original paths to remain readable by the model's file tools. Paths inside the workspace are relative; others remain absolute. The whole batch is validated before insertion, retains source order and selected text, and uses whitespace-separated, closed-quote mentions. A browser without the bridge refuses dropped or pasted folders; a Desktop folder without a reported path is rejected separately. Continuable subagents disable attachment intake and skip local echoes because their transport does not preserve the browser request id.
 
 Queued submission echoes show “Sending…” beside disabled edit, remove, and steer buttons; a collapsed dock keeps the sending status in its header. A matching Host queue row replaces the echo and enables each action according to its normal text-content and running-state requirements. Prompt acknowledgement alone does not enable queue actions. A failed submission removes its echo and displays an error; the composer restores the failed draft when it is empty or still contains the previous automatic restoration, preserving subsequently typed text.

package/README.zh.md

@@ -7,6 +7,8 @@ kind: "package-reference"
 
 [English](README.md) | 中文
 
+桌面端产品事件使用可选的[产品埋点服务](../product-analytics/README.zh.md)，不包含普通 Web 交互。
+
 ## 概述
 
 `ui-conversation` 拥有与 target 无关的 Conversation 组装和共享浏览器 shell。它消费 Session Controller 的 `SessionEventLikeEntry` feed，通过 `ctx.uiConversation` 暴露不依赖 React 的注册表与逐 Session binding，并通过 `ctx.uiSession` 提供 `useConversation`、`useInput` 和 `inputActions` 标准 props。它还拥有按会话的持久化图片 URL 缓存：`ctx.uiConversation.imageUrl(sessionId, attachment)` 为每个附件解析一个经会话授权的浏览器 URL，并随 Session binding 释放而撤销，因此所有 Conversation target 共享一次 `session.attachment` 读取。Chat 等具体 target 位于独立包，由各自包注册 Definition、快照 builder、View 和 renderer。
@@ -74,6 +76,8 @@ Session 首次绑定或缓存的 Session 成为 current 时，shell 会在渲染
 
 普通 Enter 使用已配置的投递模式，严格的 Ctrl+Enter 或 Cmd+Enter 使用互补模式，Shift+Enter 插入换行。带 Alt、AltGraph、同时带 Ctrl 与 Cmd，或 Shift 与 Ctrl/Cmd 的 Enter 保持草稿和指令菜单不变，并将 DOM 事件留给应用快捷键。Conversation 插件注册发送、换行、互补投递、命令菜单和引用菜单的固定条目，并在卸载前保留这些键位。
 
+每次输入框提交都携带原始发生时间、操作来源、投递意图以及会话模型和运行状态快照，贯穿异步命令裁决。普通消息通知在引用序列化前发出一次，纯附件提交也遵循这一规则；已处理或认领的命令不发出通知。快照读取与通知消费异常不能阻断发送。
+
 默认发送采用乐观提交：Enter 在同一事务里清空草稿、occurrence 表和撤销历史，composer 保持 `plain`，发送作为 detached attempt 运行，发送期间可以继续输入和提交。`sendSession` 在序列化之前用投递模式注册 Session 提交回显（`session.beginSubmission`），并在 `pendingSubmissions` 中保留图片与文件的选择顺序；Session 根据该模式与当前运行状态推导位置，因此空闲发送进入 transcript（文本记录），繁忙时 Queue 进入 QueueDock，繁忙时 Steer 进入 pending-steering 区域。随后让出一帧，图片经浏览器原生 `FileReader` data-URL 路径编码，文件则引用已暂存凭证。命令提交也用同一凭证表示通用文件，因此发送 `/goal` 或 `/plan` 时不会再次读取这些浏览器文件。提示词复用提交 `requestId`；Session 按同一 `rpcId` 关联展示接管，并仅退休回显一次。多个并发发送失败时，在用户编辑还原内容之前按提交顺序合并还原；命令提交保持冻结的 `submitting` 阶段。Detached attempt 持有附件 id，直到 admission 完成或 Session scope 销毁。回显以 observed 退休时，durable 图片缓存立即公开每个预览 URL，读取 admitted 附件后用规范化 URL 替换预览，并在各 URL 停止使用后撤销，同时释放文件卡。选中的通用文件进入同一个先进先出的后台上传队列；`maxConcurrentFileUploads` 默认允许两个 Worker transport 同时运行，Conversation 服务在切换 Session 时继续持有排队和运行中的传输操作及字节进度，移除草稿会跳过排队中的传输或中止正在运行的传输。浏览器 shell 暴露 `__DSH_HOST_PATHS__` 时（桌面应用），拖入或粘贴的文件夹以及拖入、选择或粘贴的带真实路径的非图片文件会成为 `@路径` chip；图片仍然上传。拖放和粘贴通过浏览器 entry API 识别目录；该 API 不可用或没有返回 entry 时，粘贴项沿用普通文件处理。文件选择器不能选择目录。引用需要启用 `ui-reference` 插件，原路径也必须仍可由模型的文件工具读取。工作区内的路径使用相对形式，其他路径保留绝对形式。整批文件先校验再插入，保留来源顺序和已选中的文字，引用之间有空白分隔，含空格的路径使用闭合引号。没有该桥的浏览器会拒绝拖入或粘贴的文件夹，桌面端无法获取文件夹路径时单独报错。continuable 子代理禁用附件入口，也不创建本地回显，因为其 transport 不保留浏览器 request id。
 
 排队提交的本地回显在禁用的编辑、删除、插话按钮旁显示“发送中…”；折叠后的队列在标题栏保留发送状态。匹配的 Host 队列行替换回显后，各操作按原有的纯文本内容和运行状态要求启用。仅收到提示词确认不会启用队列操作。提交失败会移除回显并显示错误；输入框为空或仍保留上一次自动恢复的内容时，composer 恢复失败草稿，保留用户随后输入的文字。

package/lib/client.js

@@ -3831,7 +3831,7 @@ window.__ModuleLoader__.load({
 				switch (ev.type) {
 					case "draft-changed": return this.onDraftChanged(ev.draft);
 					case "claim": return this.onClaim(ev.claim);
-					case "enter": return this.onEnter(ev.mode, ev.draft);
+					case "enter": return this.onEnter(ev.mode, ev.draft, ev.submission);
 					case "adjudicated": return this.onAdjudicated(ev.attempt, ev.outcome);
 					case "adjudication-failed": return this.onAdjudicationFailed(ev.attempt, ev.message);
 					case "submit-settled": return this.onSubmitSettled(ev);
@@ -3857,7 +3857,7 @@ window.__ModuleLoader__.load({
 				return [];
 			}
 			/** Mint an attempt and controller without assigning its lifecycle owner. */
-			mintAttempt(mode, draft) {
+			mintAttempt(mode, draft, submission) {
 				const controller = new AbortController();
 				this.seq += 1;
 				return {
@@ -3865,20 +3865,21 @@ window.__ModuleLoader__.load({
 						seq: this.seq,
 						signal: controller.signal,
 						draftSnapshot: draft,
-						mode
+						mode,
+						...submission === void 0 ? {} : { submission }
 					},
 					controller
 				};
 			}
 			/** Mint the frozen command/adjudication attempt. */
-			beginAttempt(mode, draft) {
-				const flight = this.mintAttempt(mode, draft);
+			beginAttempt(mode, draft, submission) {
+				const flight = this.mintAttempt(mode, draft, submission);
 				this.inflight = flight;
 				return flight.attempt;
 			}
 			/** Mint an ordinary send that leaves the phase plain. */
-			beginDetached(mode, draft) {
-				const flight = this.mintAttempt(mode, draft);
+			beginDetached(mode, draft, submission) {
+				const flight = this.mintAttempt(mode, draft, submission);
 				this.detached.set(flight.attempt.seq, flight.controller);
 				this.claim = void 0;
 				this.phase = "plain";
@@ -3896,10 +3897,10 @@ window.__ModuleLoader__.load({
 					retainSuffixOf: attempt.draftSnapshot
 				}];
 			}
-			onEnter(mode, draft) {
+			onEnter(mode, draft, submission) {
 				if (this.phase === "adjudicating" || this.phase === "submitting") return [];
 				if (this.phase === "claimed" && this.claim !== void 0) {
-					const attempt = this.beginAttempt(mode, draft);
+					const attempt = this.beginAttempt(mode, draft, submission);
 					this.phase = "submitting";
 					return [{
 						type: "begin-submit",
@@ -3911,7 +3912,7 @@ window.__ModuleLoader__.load({
 				const trimmed = draft.trim();
 				if (trimmed === "") return [];
 				if (trimmed.startsWith("/")) {
-					const attempt = this.beginAttempt(mode, draft);
+					const attempt = this.beginAttempt(mode, draft, submission);
 					this.phase = "adjudicating";
 					return [{
 						type: "adjudicate",
@@ -3919,7 +3920,7 @@ window.__ModuleLoader__.load({
 						draft
 					}];
 				}
-				return this.detachedEffects(this.beginDetached(mode, draft));
+				return this.detachedEffects(this.beginDetached(mode, draft, submission));
 			}
 			onAdjudicated(attempt, outcome) {
 				const flight = this.inflight;
@@ -13622,7 +13623,19 @@ window.__ModuleLoader__.load({
 			* (adjudicating/submitting) force-closes the transient layers: the popup
 			* dismisses and the menu tracks frozen.
 			*/
-			submit(mode = "queue") {
+			submit(mode = "queue", source) {
+				if (this.disposed) return;
+				const timestamp = Date.now();
+				let state;
+				if (this.snapshot.phase === "plain" && (this.snapshot.draft.trim() !== "" || this.attachmentIds.length > 0)) try {
+					state = this.deps.submissionState?.();
+				} catch (_error) {}
+				const submission = Object.freeze({
+					timestamp,
+					mode,
+					...source === void 0 ? {} : { source },
+					...state === void 0 ? {} : { state }
+				});
 				if (this.snapshot.draft.trim() === "" && this.attachmentIds.length > 0) {
 					if (this.snapshot.phase === "plain") {
 						const attachmentIds = [...this.attachmentIds];
@@ -13634,6 +13647,7 @@ window.__ModuleLoader__.load({
 							attachmentIds
 						});
 						this.commitSend(attachmentIds);
+						this.notifySubmission(submission);
 						this.deps.defaultSink("", attachmentIds, mode, controller.signal).then((outcome) => {
 							if (this.disposed || !this.attachmentFlights.delete(flight)) return;
 							if (outcome.kind === "success") return;
@@ -13655,7 +13669,8 @@ window.__ModuleLoader__.load({
 				this.dispatchRun({
 					type: "enter",
 					mode,
-					draft: this.projection.clipboardText
+					draft: this.projection.clipboardText,
+					submission
 				});
 				const phase = this.snapshot.phase;
 				if (phase === "adjudicating" || phase === "submitting") {
@@ -13881,7 +13896,8 @@ window.__ModuleLoader__.load({
 			/** Dispatch + execute, refreshing the claim decoration when the styled token flips. */
 			dispatchRun(ev) {
 				const beforeToken = this.activeClaimToken();
-				this.run(this.core.dispatch(ev));
+				const effects = this.core.dispatch(ev);
+				this.run(effects);
 				if (this.activeClaimToken() !== beforeToken) this.draftEditor.refreshClaimDecoration();
 			}
 			run(effects) {
@@ -13931,6 +13947,7 @@ window.__ModuleLoader__.load({
 			* its editor snapshot. Chip-free drafts skip the async detour.
 			*/
 			sinkSerialized(attempt, draft, mode) {
+				this.notifySubmission(attempt.submission);
 				const attachmentIds = [...this.attachmentIds];
 				this.attachmentIds = [];
 				const occurrences = this.projection.occurrences;
@@ -13972,6 +13989,12 @@ window.__ModuleLoader__.load({
 					this.settleDetachedFailure(attempt, message);
 				});
 			}
+			notifySubmission(submission) {
+				if (submission === void 0) return;
+				try {
+					this.deps.messageSubmitted?.(submission);
+				} catch (_error) {}
+			}
 			/** Settle one detached default send independently of other sends. */
 			settleSink(attempt, pending) {
 				pending.then((outcome) => {
@@ -14135,6 +14158,27 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
+		//#region lib/types/client/input/submission-analytics.js
+		/**
+		* Report the original message occurrence without reading newer Session facts.
+		* @param ctx - client context.
+		* @param submission - original occurrence and Session snapshot.
+		*/
+		function reportMessageSubmission(ctx, submission) {
+			const { state, timestamp, mode } = submission;
+			if (state === void 0) return;
+			const model = state.model;
+			ctx.get("productAnalytics")?.track("send_button_click", {
+				...state.sessionId === void 0 ? {} : { session_id: state.sessionId },
+				...model === void 0 ? {} : {
+					model_name: `${model.provider}/${model.name}`,
+					...model.effort === void 0 ? {} : { thinking_effort: model.effort }
+				},
+				run_mode: state.runMode,
+				msg_type: state.running ? mode : "default"
+			}, timestamp);
+		}
+		//#endregion
 		//#region lib/types/client/input/hub.js
 		/** Session-addressed input facade registry (SessionInputResolver face + composer-layer extras). */
 		var InputHub = class {
@@ -14175,6 +14219,26 @@ window.__ModuleLoader__.load({
 				const { session, ctx: actx } = binding;
 				const shell = new SessionInputShell({
 					actx,
+					submissionState: () => {
+						const state = session.getSnapshot();
+						const model = session.projections.faceOf("modelSelection").getSnapshot();
+						const plan = session.projections.faceOf("plan").getSnapshot();
+						const goal = session.projections.faceOf("goal").getSnapshot();
+						const selection = model?.next ?? model?.lastUsed;
+						return Object.freeze({
+							...state.blank ? {} : { sessionId: state.sessionId },
+							...selection == null ? {} : { model: Object.freeze({
+								provider: selection.provider,
+								name: selection.model,
+								...selection.reasoningEffort === void 0 ? {} : { effort: selection.reasoningEffort }
+							}) },
+							runMode: plan?.active ? "plan" : goal?.goal.phase === "active" ? "goal" : "default",
+							running: state.running
+						});
+					},
+					messageSubmitted: (submission) => {
+						reportMessageSubmission(this.rootCtx, submission);
+					},
 					inputTriggers: () => this.controller(actx),
 					popup: () => this.popup(actx),
 					inbox: session.projections.faceOf("inbox"),
@@ -14549,10 +14613,10 @@ window.__ModuleLoader__.load({
 			"tool.title.searchSessions": "搜索会话",
 			"tool.title.traceSession": "追踪会话",
 			"tool.title.listModels": "查看可用模型",
-			"tool.title.subagent": "创建代理",
-			"tool.title.listAgents": "查看代理",
+			"tool.title.subagent": "创建子智能体",
+			"tool.title.listAgents": "查看子智能体",
 			"tool.title.sendMessage": "发送消息",
-			"tool.title.interruptAgent": "中断代理",
+			"tool.title.interruptAgent": "中断智能体",
 			"tool.title.listJobs": "查看后台任务",
 			"tool.title.readJob": "读取任务输出",
 			"tool.title.killJob": "取消后台任务",
@@ -14625,14 +14689,14 @@ window.__ModuleLoader__.load({
 			"detail.field.turn": "轮次",
 			"detail.field.step": "步骤",
 			"detail.field.callId": "调用 ID",
-			"detail.field.agents": "启动代理数",
+			"detail.field.agents": "启动智能体数",
 			"detail.field.result": "结果",
 			"detail.field.parent": "父级",
 			"detail.field.depth": "层级",
 			"detail.field.exitCode": "退出码",
 			"detail.field.signal": "信号",
 			"detail.field.previousStatus": "中断前状态",
-			"detail.field.agent": "代理 ID",
+			"detail.field.agent": "智能体 ID",
 			"detail.field.job": "任务 ID",
 			"detail.field.task": "任务内容",
 			"detail.field.processGroup": "进程组",
@@ -14640,7 +14704,7 @@ window.__ModuleLoader__.load({
 			"detail.field.bestMatch": "最相关事件",
 			"detail.field.target": "目标事件",
 			"detail.field.surface": "记录状态",
-			"detail.agents.count": "{count} 个代理",
+			"detail.agents.count": "{count} 个智能体",
 			"detail.jobs.count": "{count} 个后台任务",
 			"detail.terminals.count": "{count} 个终端",
 			"detail.tasks.count": "{count} 个团队任务",
@@ -14659,15 +14723,15 @@ window.__ModuleLoader__.load({
 			"detail.wait.title": "子智能体状态",
 			"detail.wait.timeout": "等待超时",
 			"detail.wait.changed": "检测到变化",
-			"detail.agent.reply": "代理回复",
+			"detail.agent.reply": "智能体回复",
 			"detail.models.title": "可用模型",
 			"detail.output.lines": "第 {begin}–{end} 行，共 {total} 行",
 			"detail.output.truncated": "输出已截断",
 			"detail.providers.count": "{count} 个检查提供方",
 			"detail.plugins.count": "{count} 个动态插件",
 			"detail.workflow.script": "工作流脚本",
-			"detail.ralph.reportedComplete": "代理报告完成",
-			"detail.ralph.reportedBlocker": "代理报告受阻",
+			"detail.ralph.reportedComplete": "智能体报告完成",
+			"detail.ralph.reportedBlocker": "智能体报告受阻",
 			"detail.ralph.limit": "已达到轮次上限",
 			"detail.report.nextSteps": "待完成事项",
 			"detail.trace.replacedBy": "被替换为",
@@ -16759,7 +16823,7 @@ window.__ModuleLoader__.load({
 						g.showToast(g.t("file.stillUploading"));
 						return;
 					}
-					keyboard.submit(resolveSubmitMode(g.busyEnter, g.running, accelerated ? "accelerated" : "enter", g.steeringAvailable));
+					keyboard.submit(resolveSubmitMode(g.busyEnter, g.running, accelerated ? "accelerated" : "enter", g.steeringAvailable), "enter");
 				},
 				intakeFiles: (files, directories) => {
 					gate.current.intakeFiles(files, directories);
@@ -17335,7 +17399,7 @@ window.__ModuleLoader__.load({
 				}
 				if (keyboard === void 0) return;
 				/* v8 ignore next -- defensive: the primary button is disabled for empty, disabled, and pending-upload states. */
-				if (!empty && !disabled && !machineBusy && !uploadsPending) keyboard.submit(primarySubmitMode);
+				if (!empty && !disabled && !machineBusy && !uploadsPending) keyboard.submit(primarySubmitMode, "click");
 			};
 			const claimActive = (input?.phase === "claimed" || input?.phase === "submitting") && input.claim !== void 0 && draft.startsWith(input.claim.token);
 			const rawHint = claimActive && input.claim.hint !== void 0 && draft.slice(input.claim.token.length).trim() === "" ? input.claim.hint : null;

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

@@ -1,4 +1,3 @@
-/** Registers the target-neutral Conversation assembly, shell, input, and docks. */
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import { type ConversationKey } from './locales.ts';

package/lib/types/client/contract/composer-submission.d.ts

@@ -5,4 +5,22 @@ export type { BusyEnterBehavior } from '../../submission-settings.ts';
 export type InputSubmitMode = BusyEnterBehavior;
 /** Keyboard gesture whose delivery mode the submission policy resolves. */
 export type ComposerSubmitGesture = 'enter' | 'accelerated';
+/** Session facts captured when a message submission starts, before asynchronous command arbitration. */
+export interface MessageSubmissionState {
+    readonly sessionId?: import('@deepseek-ai/dsh-session/types').SessionId;
+    readonly model?: {
+        readonly provider: string;
+        readonly name: string;
+        readonly effort?: string;
+    };
+    readonly runMode: 'default' | 'plan' | 'goal';
+    readonly running: boolean;
+}
+/** Immutable occurrence and delivery intent carried by one composer attempt. */
+export interface MessageSubmission {
+    readonly timestamp: number;
+    readonly source?: 'click' | 'enter';
+    readonly mode: InputSubmitMode;
+    readonly state?: MessageSubmissionState;
+}
 //# sourceMappingURL=composer-submission.d.ts.map

package/lib/types/client/contract/draft-editor.d.ts

@@ -35,7 +35,7 @@ export interface ComposerKeyboard {
     /** The shell-owned Lexical editor the composer binds its contenteditable to. */
     readonly editor: LexicalEditor;
     /** Submit with an explicit delivery mode resolved by the submission policy (Enter gestures and the primary Send button). */
-    submit(mode: InputSubmitMode): void;
+    submit(mode: InputSubmitMode, source?: 'click' | 'enter'): void;
     /**
      * Steer every still-pending queued message into the running turn (the
      * empty-draft accelerated-Enter gesture; the queue dock's per-row steer

package/lib/types/client/contract/input.d.ts

@@ -11,7 +11,7 @@ import type { InboxState } from '@deepseek-ai/dsh-agent/types';
 import type { ObservableSnapshot, SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { Branded } from '@deepseek-ai/dsh-brand';
 import type { ArbitrateKey, ArbitrateOutcome, Occurrence, ReferenceInsert, TokenSpan } from './draft-editor.ts';
-import type { InputSubmitMode } from './composer-submission.ts';
+import type { InputSubmitMode, MessageSubmission } from './composer-submission.ts';
 /** Attachment payload passed to a claimed command submission. */
 export type SubmitAttachment = {
     readonly type: 'image';
@@ -173,7 +173,7 @@ export interface SessionInput extends InputTarget {
      * THE complexity sink: enter adjudication, submit transaction, and the default sink live inside.
      * @param mode - delivery intent retained through asynchronous adjudication and serialization.
      */
-    submit(mode?: InputSubmitMode): void;
+    submit(mode?: InputSubmitMode, source?: 'click' | 'enter'): void;
     /**
      * Surface a notice outside the machine's own effect stream: detached
      * command results and business notifications render through here.
@@ -268,6 +268,8 @@ export interface SubmitAttempt {
     readonly draftSnapshot: string;
     /** Default-message delivery intent retained while slash adjudication is pending. */
     readonly mode: InputSubmitMode;
+    /** Original message occurrence, retained across command arbitration. */
+    readonly submission?: MessageSubmission;
 }
 /**
  * Submit-machine input events (the machine's single write path). Text
@@ -290,6 +292,7 @@ export type InputEvent =
     readonly type: 'enter';
     readonly mode: InputSubmitMode;
     readonly draft: string;
+    readonly submission?: MessageSubmission;
 } | {
     readonly type: 'adjudicated';
     readonly attempt: SubmitAttempt;

package/lib/types/client/input/facade.d.ts

@@ -14,7 +14,7 @@ import { type ObservableSnapshot, type SnapshotStore } from '@deepseek-ai/dsh-cl
 import type { LexicalEditor } from 'lexical';
 import type { CommandClaim, ConsumeTokenRequest, DraftAttachmentId, InputActions, InputNotice, InputState, InputTriggerController, SessionInput, SubmitAttachment, SubmitOutcome } from '../contract/input.ts';
 import type { ArbitrateKey, ArbitrateOutcome, ComposerKeyboard, ReferenceInsert, TokenSpan } from '../contract/draft-editor.ts';
-import type { InputSubmitMode } from '../contract/composer-submission.ts';
+import type { InputSubmitMode, MessageSubmission, MessageSubmissionState } from '../contract/composer-submission.ts';
 /** Popup face the shell needs (dismissal only; typed structurally to avoid a value import). */
 export interface PopupDismissFace {
     dismiss(): void;
@@ -28,6 +28,10 @@ export interface PopupDismissFace {
 export interface SessionInputDeps {
     /** Session-scope ctx handed to claim.submit transactions. */
     actx: Context;
+    /** Snapshot the Session facts before asynchronous command arbitration. */
+    submissionState?: () => MessageSubmissionState;
+    /** Notify one ordinary message attempt before reference serialization. */
+    messageSubmitted?: (submission: MessageSubmission) => void;
     /** Enter adjudication face resolver; absent/undefined answer = every '/' line falls to the default sink. */
     inputTriggers?: (() => InputTriggerController | undefined) | undefined;
     /** PopupSelect shell face resolver (dismissal on submit lock / escape). */
@@ -141,7 +145,7 @@ export declare class SessionInputShell implements SessionInput {
      * (adjudicating/submitting) force-closes the transient layers: the popup
      * dismisses and the menu tracks frozen.
      */
-    submit(mode?: InputSubmitMode): void;
+    submit(mode?: InputSubmitMode, source?: 'click' | 'enter'): void;
     /**
      * Keyboard arbitration while the menu is open.
      * @param key - the intercepted key.
@@ -284,6 +288,7 @@ export declare class SessionInputShell implements SessionInput {
      * its editor snapshot. Chip-free drafts skip the async detour.
      */
     private sinkSerialized;
+    private notifySubmission;
     /** Settle one detached default send independently of other sends. */
     private settleSink;
     /** Restore one failed detached send without overwriting text entered after a restoration. */

package/lib/types/client/input/hub.d.ts

@@ -1,12 +1,3 @@
-/**
- * InputHub: the SessionInputResolver implementation (`ctx.conversation.input`) — one
- * SessionInputShell per session, created inside the uiSession provide
- * materialization (the 'input' standard-kit entry IS the
- * creation trigger) and torn down by the scope disposer (instance-and-scope
- * share one lifecycle). The hub registers the scoped input-mutation
- * listeners on each Session context and owns the default-sink choreography: every session is a
- * real host entity, so the sink is one unconditional prompt path.
- */
 import type { Context } from '@deepseek-ai/cordis';
 import type { SessionBinding } from '@deepseek-ai/dsh-api-session-controller/client';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';

package/lib/types/client/input/submission-analytics.d.ts

@@ -0,0 +1,10 @@
+/** Maps ordinary message occurrences to Desktop product events. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { MessageSubmission } from '../contract/composer-submission.ts';
+/**
+ * Report the original message occurrence without reading newer Session facts.
+ * @param ctx - client context.
+ * @param submission - original occurrence and Session snapshot.
+ */
+export declare function reportMessageSubmission(ctx: Context, submission: MessageSubmission): void;
+//# sourceMappingURL=submission-analytics.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-conversation",
   "description": "Target-neutral Conversation assembly, shell, composer, queue, and view navigation",
-  "version": "0.1.7-rc.2",
+  "version": "0.2.0-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -61,38 +61,39 @@
     "@lexical/plain-text": "^0.49.0",
     "@lexical/history": "^0.49.0",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-attachment": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-brand": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-file-upload": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-workspace": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-commands": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-goal": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm-retry": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-plan-mode": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-values": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-token-meter": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-tool-todo": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-crypto": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-workspace": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-file-reference": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-shortcuts": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-attachment": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-file-upload": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-commands": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-goal": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm-retry": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-plan-mode": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-token-meter": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-tool-todo": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-util-crypto": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-workspace": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-file-reference": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-shortcuts": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-product-analytics": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1"
   },
   "files": [
     "lib/index.js",