@qilin-agent/client-ui-deliverables 3.1.3 → 3.1.4

package/README.i18n.yaml

@@ -5,54 +5,54 @@
 /:
   en: 91a4da87e2e078ed
   zh: 8d489c6cdf208c4d
-/qilin-client-ui-deliverables:
-  en: d9e6d3ea4b5cbbac
-  zh: 25b1fd8af2a4968c
-/qilin-client-ui-deliverables/summary:
+/qilin-agent-client-ui-deliverables:
+  en: 526218e958a05884
+  zh: 1db97342024d5de2
+/qilin-agent-client-ui-deliverables/summary:
   en: a17b97d16803f911
   zh: ad80cf4bcb5a8018
-/qilin-client-ui-deliverables/table-of-contents:
+/qilin-agent-client-ui-deliverables/table-of-contents:
   en: d152484eb41ac6b4
   zh: 09388d293f9be9cb
-/qilin-client-ui-deliverables/use-this-package:
+/qilin-agent-client-ui-deliverables/use-this-package:
   en: bec3addae05b0c63
   zh: 82ca127bb0db9db6
-/qilin-client-ui-deliverables/use-this-package/explicit-deliveries:
+/qilin-agent-client-ui-deliverables/use-this-package/explicit-deliveries:
   en: 6f99703dbe5bd915
   zh: 474a5887e41a61e6
-/qilin-client-ui-deliverables/use-this-package/the-changed-files-card:
+/qilin-agent-client-ui-deliverables/use-this-package/the-changed-files-card:
   en: 264e3d8c2c3308a0
   zh: 268655df9cc8ceb9
-/qilin-client-ui-deliverables/use-this-package/the-review-tab:
+/qilin-agent-client-ui-deliverables/use-this-package/the-review-tab:
   en: 3841abce6e33c564
   zh: 31175cf69c33b0c9
-/qilin-client-ui-deliverables/use-this-package/inline-code-links:
-  en: e36ccef8bf908ea4
-  zh: 30e11327a55e5dfa
-/qilin-client-ui-deliverables/understand-the-implementation:
-  en: 5e81e43b907c01ee
-  zh: d61a3c369ffad8d1
-/qilin-client-ui-deliverables/further-exploration:
+/qilin-agent-client-ui-deliverables/use-this-package/inline-code-links:
+  en: ef13aac8ac36a5c3
+  zh: d785795c6d9a31ec
+/qilin-agent-client-ui-deliverables/understand-the-implementation:
+  en: aa53866b7fa34726
+  zh: 2c1ad12c8c9f9d0d
+/qilin-agent-client-ui-deliverables/further-exploration:
   en: 7fbb38158f458cd4
   zh: e6bec53bc5f4fb58
-/qilin-client-ui-deliverables/model-experience:
+/qilin-agent-client-ui-deliverables/model-experience:
   en: 215e7ba838619b7b
   zh: a311da3843709f90
-/qilin-client-ui-deliverables/model-experience/clickable-file-reference-guidance:
+/qilin-agent-client-ui-deliverables/model-experience/clickable-file-reference-guidance:
   en: eb244aa21a4e5210
   zh: e3450addfa19cea5
-/qilin-client-ui-deliverables/model-experience/clickable-file-reference-guidance/what-the-model-sees:
+/qilin-agent-client-ui-deliverables/model-experience/clickable-file-reference-guidance/what-the-model-sees:
   en: b191a86a061cbb07
   zh: 1e080b8fedb3a4f8
-/qilin-client-ui-deliverables/model-experience/clickable-file-reference-guidance/token-effect:
+/qilin-agent-client-ui-deliverables/model-experience/clickable-file-reference-guidance/token-effect:
   en: b6c79433affb56a6
   zh: a084318c814aa03c
-/qilin-client-ui-deliverables/model-experience/clickable-file-reference-guidance/kv-cache-effect:
+/qilin-agent-client-ui-deliverables/model-experience/clickable-file-reference-guidance/kv-cache-effect:
   en: 52626a05acc8b320
   zh: 6a8e62b0d47d5297
-/qilin-client-ui-deliverables/known-limitations-and-deferred-work:
+/qilin-agent-client-ui-deliverables/known-limitations-and-deferred-work:
   en: 7cf1624dbf46ec53
   zh: 4cf51dd265f1965f
-/qilin-client-ui-deliverables/known-limitations-and-deferred-work/dev-note:
+/qilin-agent-client-ui-deliverables/known-limitations-and-deferred-work/dev-note:
   en: e67f633dc6fe7773
   zh: 3bb0c20c93f16f98

package/README.md

@@ -46,7 +46,7 @@ A row opens the turn's `changes-review` tab, addressed by the viewed Session and
 
 ### Inline-code links
 
-The closing prose links produced or delivered paths: an inline-code token resolves by exact path, or by being exactly the basename of exactly one such path — a basename two paths share stays inert rather than guessing, so a mention can never open the wrong file. A resolved mention keeps its code chip and takes the markdown sheet's link language, with the full path as its title.
+The closing prose links produced or delivered paths: an inline-code token resolves by exact target, by an exact argument recorded for that target, or by a unique basename. Every matching fact must identify the same file; ambiguous arguments and basenames stay inert. No suffix or current-directory guess is used. A resolved mention keeps its code chip and takes the markdown sheet's link language, with the full path as its title.
 
 -----
 
@@ -56,7 +56,7 @@ The closing prose links produced or delivered paths: an inline-code token resolv
 <details>
 <summary>Implementation internals — click to expand</summary>
 
-The Node half registers the static `ui:deliverable-file-references` system-prompt section described under [Model Experience](#model-experience). Explicit Markdown links use the shared [Markdown renderer](../ui-primitives/README.md); inline-code matching remains limited to produced or delivered files. The browser half registers a wrapper around the changed-files card and explicit deliveries into the chat view's `conversation.chat.turnTail` list alongside other feature artifacts. `deliverablesDefinition` folds the sequence of each Turn's latest validated `workspace/changes` announcement into `DeliverablesTurnData.changes`, whose summary the card reads from the Host and caches until the connection is replaced, its `deliverables/presented` events into deliveries, and the successful first-party mutation calls of `write`, `edit`, and mutating `str_replace_editor` commands into produced paths from their validated raw arguments; the produced paths feed only the prose mention resolver. Reads, deletes, unsupported tools, malformed calls, malformed events, and failed results contribute nothing. Each row opens `qilin-resource://changes-review/session/<sessionId>/<seq>/<turn>` through `ctx.sidebarRight.openResource` with the file's index as the `changes-review` navigation parameter; the package registers the `changes-review` tab type at the `builtin` band for that pattern and its body under the keyed `sidebar.right.pane.tab` seat with an exclusive store of per-tab choices, and the body reads the summary and the comparisons through the authenticated routes into stores cleared on connection replacement. The package also provides the `chatFileMentions` service the chat view consults per closing message; composing the plugin out removes every surface and leaves the view's empty list at zero cost.
+The Node half registers the static `ui:deliverable-file-references` system-prompt section described under [Model Experience](#model-experience). Explicit Markdown links use the shared [Markdown renderer](../ui-primitives/README.md); inline-code matching remains limited to produced or delivered files. The browser half registers a wrapper around the changed-files card and explicit deliveries into the chat view's `conversation.chat.turnTail` list alongside other feature artifacts. `deliverablesDefinition` folds the sequence of each Turn's latest validated `workspace/changes` announcement into `DeliverablesTurnData.changes`, whose summary the card reads from the Host and caches until the connection is replaced, its `deliverables/presented` events into deliveries, and the successful first-party mutation calls of `write`, `edit`, and mutating `str_replace_editor` commands into produced paths from their recorded absolute targets, falling back to validated raw arguments for legacy results; the produced paths feed only the prose mention resolver. Reads, deletes, unsupported tools, malformed calls, malformed events, and failed results contribute nothing. Each row opens `qilin-resource://changes-review/session/<sessionId>/<seq>/<turn>` through `ctx.sidebarRight.openResource` with the file's index as the `changes-review` navigation parameter; the package registers the `changes-review` tab type at the `builtin` band for that pattern and its body under the keyed `sidebar.right.pane.tab` seat with an exclusive store of per-tab choices, and the body reads the summary and the comparisons through the authenticated routes into stores cleared on connection replacement. The package also provides the `chatFileMentions` service the chat view consults per closing message; composing the plugin out removes every surface and leaves the view's empty list at zero cost.
 
 Native opening uses an authenticated POST addressed by the viewed Session, event sequence, and original file index; the review tab's native open of a changed file uses the same coordinates. For a declaration the Host reads the viewed Session header with the event and passes its cwd, or the deployment workspace root when absent, to `workspaceFiles.stat`; for a changed file it passes the working directory the served summary carries. This uses the same composed filesystem as Sidebar previews and does not activate an Agent, including for child Sessions. Native actions require the canonical process path to map from a Host path back to that same process path. Providers without this mapping return 422, after which the review tab hides its native open; a same-named Host file is insufficient. The same configured desktop availability governs metadata and execution. Edits affect subsequent opens; deletion returns an error. No file-content copy or attachment is created. Plugin disposal cancels and awaits pending native-open requests.
 

package/README.zh.md

@@ -46,7 +46,7 @@ Web 的 `standard`、`ptc` 与 `cordis` preset 提供 `present` 用于声明交
 
 ### 行内代码链接
 
-收尾正文链接产出或已交付的路径：行内代码 token 按精确路径解析，或当它恰好等于其中某条路径的 basename 且该路径唯一时解析——两条路径共享同一 basename 时保持不可点击而不作猜测，因此提及绝不打开错误的文件。解析成功的提及保留代码标签，并采用 Markdown 样式表的链接样式，完整路径作为其 `title`。
+收尾正文链接产出或已交付的路径：行内代码 token 按精确目标、按为该目标记录的精确参数、或按唯一 basename 解析；所有命中的事实必须指向同一个文件，参数或 basename 有歧义时保持不可点击。不使用后缀猜测，也不使用当前目录猜测。解析成功的提及保留代码标签，并采用 Markdown 样式表的链接样式，完整路径作为其 `title`。
 
 -----
 
@@ -56,7 +56,7 @@ Web 的 `standard`、`ptc` 与 `cordis` preset 提供 `present` 用于声明交
 <details>
 <summary>实现细节——点击展开</summary>
 
-Node 半部注册[模型体验](#model-experience)所述的静态 `ui:deliverable-file-references` 系统提示词段。显式 Markdown 链接使用共享的 [Markdown 渲染器](../ui-primitives/README.zh.md)；行内代码匹配仍仅限产出或交付文件。浏览器半部把组合改动文件卡片与显式交付的包装组件注册进 chat 视图的 `conversation.chat.turnTail` 列表，与其他功能产物并列。`deliverablesDefinition` 把每个轮次最新且通过校验的 `workspace/changes` 宣告的序号折叠进 `DeliverablesTurnData.changes`，卡片按它向 Host 读取摘要并缓存到连接被替换为止，把 `deliverables/presented` 事件折叠为交付，并根据 `write`、`edit` 和有修改作用的 `str_replace_editor` 命令中经过校验的原始参数把成功的第一方修改调用折叠为产出路径；产出路径只供正文提及解析器使用。读取、删除、不受支持的工具、格式错误的调用、格式错误的事件和失败结果不贡献任何条目。每一行通过 `ctx.sidebarRight.openResource` 打开 `qilin-resource://changes-review/session/<sessionId>/<seq>/<turn>`，并以文件下标作为 `changes-review` 的导航参数；本包在 `builtin` 档为该模式注册 `changes-review` tab 类型，把其 body 连同一个按 tab 保存选择的独占 store 注册到按键的 `sidebar.right.pane.tab` 座位下，body 通过经过认证的路由把摘要和对比读进连接更换时清空的 store。本包还提供 chat 视图按收尾消息查询的 `chatFileMentions` 服务；把插件组合出去会移除全部表面，视图的空列表以零成本留下。
+Node 半部注册[模型体验](#model-experience)所述的静态 `ui:deliverable-file-references` 系统提示词段。显式 Markdown 链接使用共享的 [Markdown 渲染器](../ui-primitives/README.zh.md)；行内代码匹配仍仅限产出或交付文件。浏览器半部把组合改动文件卡片与显式交付的包装组件注册进 chat 视图的 `conversation.chat.turnTail` 列表，与其他功能产物并列。`deliverablesDefinition` 把每个轮次最新且通过校验的 `workspace/changes` 宣告的序号折叠进 `DeliverablesTurnData.changes`，卡片按它向 Host 读取摘要并缓存到连接被替换为止，把 `deliverables/presented` 事件折叠为交付，并根据 `write`、`edit` 和有修改作用的 `str_replace_editor` 命令记录的绝对目标（旧结果回落到经过校验的原始参数）把成功的第一方修改调用折叠为产出路径；产出路径只供正文提及解析器使用。读取、删除、不受支持的工具、格式错误的调用、格式错误的事件和失败结果不贡献任何条目。每一行通过 `ctx.sidebarRight.openResource` 打开 `qilin-resource://changes-review/session/<sessionId>/<seq>/<turn>`，并以文件下标作为 `changes-review` 的导航参数；本包在 `builtin` 档为该模式注册 `changes-review` tab 类型，把其 body 连同一个按 tab 保存选择的独占 store 注册到按键的 `sidebar.right.pane.tab` 座位下，body 通过经过认证的路由把摘要和对比读进连接更换时清空的 store。本包还提供 chat 视图按收尾消息查询的 `chatFileMentions` 服务；把插件组合出去会移除全部表面，视图的空列表以零成本留下。
 
 原生打开使用经过认证的 POST，通过当前查看的会话、事件序号和原始文件索引定位声明；review tab 对改动文件的原生打开使用同一组坐标。对声明，Host 读取事件及当前查看的会话 header，将其中的 cwd 传给 `workspaceFiles.stat`，未记录 cwd 时使用部署的工作目录；对改动文件，传的是所提供摘要携带的工作目录。它与侧栏预览使用同一组合文件系统，无需启动 Agent，子会话也适用。原生操作要求规范化的进程路径能从 Host 路径映射回同一进程路径。提供方没有这种映射时返回 422，之后 review tab 隐藏原生打开；Host 上存在同名文件并不足够。同一份桌面可用性配置同时约束信息查询和实际执行。编辑会影响后续打开的内容；删除后返回错误。不创建文件内容副本或附件。插件释放时取消并等待进行中的原生打开请求。
 

package/lib/client.js

@@ -800,9 +800,10 @@ window.__ModuleLoader__.load({
 		//#region lib/types/client/turn-deliverables.js
 		/**
 		* Turn-scoped produced-file Definition and readers. Client-only and
-		* model-free: produced paths come from successful first-party mutation calls,
-		* changed files from the Host's recorded git summary, and deliveries from
-		* `present`; never from presentation data or the closing prose.
+		* model-free: produced paths come from successful first-party mutation calls and
+		* their recorded file targets, changed files from the Host's recorded git
+		* summary, and deliveries from `present`; never from presentation data or
+		* the closing prose.
 		*/
 		/**
 		* Extract the path from a supported first-party mutation call. Session
@@ -846,6 +847,12 @@ window.__ModuleLoader__.load({
 		function pathValue(value) {
 			return typeof value === "string" && value.trim().length > 0 ? value : null;
 		}
+		/** Resolve a settled mutation from recorded metadata, retaining legacy argument paths. */
+		function mutationResultPath(argumentPath, meta) {
+			if (!isRecord(meta) || !Object.hasOwn(meta, "path")) return argumentPath;
+			if (typeof meta.path === "string" && isAbsoluteWorkspacePath(meta.path)) return meta.path;
+			return isAbsoluteWorkspacePath(argumentPath) ? argumentPath : null;
+		}
 		/** Narrow parsed JSON to an argument object. */
 		function isRecord(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -853,9 +860,10 @@ window.__ModuleLoader__.load({
 		/**
 		* Files produced by one Turn data value.
 		*
-		* The source is the arguments of successful `write`, `edit`, and mutating
-		* `str_replace_editor` calls, not the closing prose: a produced file must be
-		* listed whether or not the model remembered to name it. Reads, unsupported
+		* The source is successful `write`, `edit`, and mutating
+		* `str_replace_editor` calls and their recorded absolute targets; legacy
+		* results use arguments. A produced file must be listed whether or not the
+		* model remembered to name it. Reads, unsupported
 		* tools, malformed calls, and failed results contribute nothing. Paths keep
 		* first-seen order and appear once, so a file written and then edited in the
 		* same turn is one entry.
@@ -955,12 +963,15 @@ window.__ModuleLoader__.load({
 				if (match.event.type !== "tool/result") return context.state;
 				if (match.event.data.message.isError === true) return context.state;
 				const callId = String(match.event.data.message.source.callId);
-				const path = context.state.calls.get(callId);
-				return path === null || path === void 0 ? context.state : {
+				const argumentPath = context.state.calls.get(callId);
+				if (argumentPath === null || argumentPath === void 0) return context.state;
+				const path = mutationResultPath(argumentPath, match.event.data.meta);
+				return path === null ? context.state : {
 					...context.state,
 					produced: [...context.state.produced, {
 						seq: match.event.seq,
-						path
+						path,
+						...path === argumentPath ? {} : { argumentPath }
 					}]
 				};
 			},
@@ -999,17 +1010,20 @@ window.__ModuleLoader__.load({
 		}
 		/**
 		* Resolves inline-code references against one turn's produced or delivered
-		* paths. Exact paths resolve directly; a basename resolves only when exactly
-		* one supplied path has that basename. Ambiguous and unknown tokens stay inert.
+		* paths and explicit mutation arguments. A reference resolves only when every
+		* exact or basename match identifies one target. Ambiguous and unknown tokens stay inert.
 		* @param paths - The turn's produced or delivered paths, already deduplicated.
 		* @param openFile - The chat view's file opener.
 		* @param label - Localizes the accessible open-label for a resolved path.
+		* @param operations - successful mutations whose literal arguments may name the same canonical targets.
 		* @returns The resolver MarkdownText consumes; the full path rides `title`,
 		* the same disambiguator the row's chips carry.
 		*/
-		function producedFileMentions(paths, openFile, label) {
+		function producedFileMentions(paths, openFile, label, operations = []) {
 			return { resolve(value) {
-				const path = paths.includes(value) ? value : onlyPathWithBasename(paths, value);
+				const matches = new Set(paths.filter((path) => path === value || basename(path) === value));
+				for (const operation of operations) if (operation.argumentPath === value) matches.add(operation.path);
+				const path = matches.size === 1 ? matches.values().next().value : void 0;
 				if (path === void 0) return void 0;
 				return {
 					open: () => {
@@ -1020,11 +1034,6 @@ window.__ModuleLoader__.load({
 				};
 			} };
 		}
-		/** The single supplied path whose basename is exactly `value`, else undefined. */
-		function onlyPathWithBasename(paths, value) {
-			const matches = paths.filter((path) => basename(path) === value);
-			return matches.length === 1 ? matches[0] : void 0;
-		}
 		//#endregion
 		//#region \0qilin-css:/home/runner/work/QiLin/QiLin/packages/client/ui-deliverables/src/client/Deliverables.module.css.mjs
 		const css$1 = "._2Q7zSW_root{--deliverable-fill:var(--qilin-static-neutral-50);--deliverable-hover:var(--qilin-static-neutral-100);flex-direction:column;gap:16px;min-width:0;margin-top:4px;display:flex;container-type:inline-size}._2Q7zSW_root[data-after-changes=true]{margin-top:0}body[data-ds-dark-theme] ._2Q7zSW_root{--deliverable-fill:var(--qilin-static-neutral-850);--deliverable-hover:var(--qilin-static-neutral-800)}._2Q7zSW_hostStatus{color:var(--qilin-alias-label-secondary);align-items:center;gap:8px;font-size:12px;line-height:18px;display:flex}._2Q7zSW_presented{grid-template-columns:repeat(2,minmax(0,1fr));gap:10px;min-width:0;display:grid}._2Q7zSW_presented[data-single=true]{grid-template-columns:minmax(0,1fr)}._2Q7zSW_file{box-sizing:border-box;border:.5px solid var(--qilin-alias-border-l1);background:var(--deliverable-fill);min-width:0;height:60px;color:var(--qilin-alias-label-primary);border-radius:18px;align-items:center;gap:10px;padding:8px 10px;transition:background-color .12s;display:flex;position:relative;overflow:hidden}._2Q7zSW_file:hover{background:var(--deliverable-hover)}._2Q7zSW_cardPreview{z-index:1;border-radius:inherit;cursor:pointer;background:0 0;border:0;width:100%;padding:0;position:absolute;inset:0}._2Q7zSW_cardPreview:focus-visible{box-shadow:inset 0 0 0 2px var(--qilin-focus-ring-color,var(--qilin-alias-state-business-primary));outline:none}._2Q7zSW_fileIcon{z-index:2;box-sizing:border-box;pointer-events:none;border:.5px solid var(--qilin-alias-border-l1);background:var(--deliverable-fill);width:40px;height:40px;color:var(--qilin-alias-link);border-radius:10px;flex:none;place-items:center;display:grid;position:relative;overflow:hidden}._2Q7zSW_fileBody{z-index:2;pointer-events:none;flex:1;justify-content:space-between;align-items:center;gap:12px;min-width:0;display:flex;position:relative}._2Q7zSW_details{flex-direction:column;flex:1;justify-content:center;gap:2px;min-width:0;display:flex}._2Q7zSW_fileName{text-overflow:ellipsis;white-space:nowrap;font-size:13px;font-weight:500;line-height:20px;overflow:hidden}._2Q7zSW_description{color:var(--qilin-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;font-size:10px;font-weight:400;line-height:16px;overflow:hidden}._2Q7zSW_description[data-error=true]{color:var(--qilin-alias-state-error-primary)}._2Q7zSW_previewHint,._2Q7zSW_file:hover ._2Q7zSW_secondaryText{display:none}._2Q7zSW_file:hover ._2Q7zSW_previewHint{display:inline}._2Q7zSW_split{box-sizing:border-box;pointer-events:auto;border:.5px solid var(--qilin-alias-border-l3);background:var(--qilin-alias-button-floating-fill);border-radius:10px;flex:none;align-items:stretch;height:28px;display:inline-flex;overflow:hidden}._2Q7zSW_menuAnchor{align-self:stretch}._2Q7zSW_open,._2Q7zSW_chevron{color:var(--qilin-alias-label-primary);cursor:pointer;font-family:var(--qilin-font-family);background:0 0;border:0;justify-content:center;align-items:center;display:inline-flex}._2Q7zSW_open{padding:4px 8px;font-size:12px;line-height:18px}._2Q7zSW_chevron{border-left:.5px solid var(--qilin-alias-border-l3);color:var(--qilin-alias-label-secondary);padding:4px 5px}._2Q7zSW_open:hover,._2Q7zSW_open:focus-visible,._2Q7zSW_chevron:hover:not(:disabled),._2Q7zSW_chevron:focus-visible{background:var(--qilin-alias-interactive-bg-hover)}._2Q7zSW_chevron:disabled{color:var(--qilin-alias-label-dimmed);cursor:not-allowed}._2Q7zSW_menuActionIcon{width:16px;height:16px;display:block}._2Q7zSW_toggle{min-width:0;color:var(--qilin-alias-label-tertiary);cursor:pointer;font:inherit;background:0 0;border:0;border-radius:8px;align-self:center;align-items:center;gap:4px;padding:1px 11px;font-size:12px;line-height:18px;display:inline-flex}._2Q7zSW_toggle:hover{background:var(--qilin-alias-interactive-bg-hover)}._2Q7zSW_toggle svg{flex:none;width:14px;height:14px}@container (width<=620px){._2Q7zSW_presented{grid-template-columns:minmax(0,1fr)}}@media (pointer:coarse){._2Q7zSW_split{min-height:44px}._2Q7zSW_open,._2Q7zSW_chevron{min-width:44px}}";
@@ -2212,7 +2221,7 @@ window.__ModuleLoader__.load({
 				const paths = selectProducedFiles(owner);
 				const presented = presentedForClosing(owner);
 				if (paths === null && presented.length === 0) return void 0;
-				return producedFileMentions([...new Set([...paths ?? [], ...presented.map((file) => file.path)])], owner.openFile, (path) => t("presented.previewButton", { name: path }));
+				return producedFileMentions([...new Set([...paths ?? [], ...presented.map((file) => file.path)])], owner.openFile, (path) => t("presented.previewButton", { name: path }), owner.turn.data.get("deliverables")?.produced.filter((operation) => operation.seq <= owner.seq));
 			} });
 		}
 		//#endregion

package/lib/types/client/turn-deliverables.d.ts

@@ -10,6 +10,7 @@ export interface PresentedPath extends PresentedFile {
 interface ProducedPath {
     readonly seq: number;
     readonly path: string;
+    readonly argumentPath?: string;
 }
 /** The latest `workspace/changes` announcement of one Turn; the Host serves its summary by this sequence. */
 export interface ChangesTurnData {
@@ -34,9 +35,10 @@ interface DeliverablesState extends DeliverablesTurnData {
 /**
  * Files produced by one Turn data value.
  *
- * The source is the arguments of successful `write`, `edit`, and mutating
- * `str_replace_editor` calls, not the closing prose: a produced file must be
- * listed whether or not the model remembered to name it. Reads, unsupported
+ * The source is successful `write`, `edit`, and mutating
+ * `str_replace_editor` calls and their recorded absolute targets; legacy
+ * results use arguments. A produced file must be listed whether or not the
+ * model remembered to name it. Reads, unsupported
  * tools, malformed calls, and failed results contribute nothing. Paths keep
  * first-seen order and appear once, so a file written and then edited in the
  * same turn is one entry.
@@ -72,13 +74,14 @@ export declare function presentedForClosing(owner: TurnTailOwnerProps): Presente
 export { basename } from '../presented.ts';
 /**
  * Resolves inline-code references against one turn's produced or delivered
- * paths. Exact paths resolve directly; a basename resolves only when exactly
- * one supplied path has that basename. Ambiguous and unknown tokens stay inert.
+ * paths and explicit mutation arguments. A reference resolves only when every
+ * exact or basename match identifies one target. Ambiguous and unknown tokens stay inert.
  * @param paths - The turn's produced or delivered paths, already deduplicated.
  * @param openFile - The chat view's file opener.
  * @param label - Localizes the accessible open-label for a resolved path.
+ * @param operations - successful mutations whose literal arguments may name the same canonical targets.
  * @returns The resolver MarkdownText consumes; the full path rides `title`,
  * the same disambiguator the row's chips carry.
  */
-export declare function producedFileMentions(paths: readonly string[], openFile: (path: string) => void, label: (path: string) => string): MarkdownFileMentions;
+export declare function producedFileMentions(paths: readonly string[], openFile: (path: string) => void, label: (path: string) => string, operations?: readonly Pick<ProducedPath, 'path' | 'argumentPath'>[]): MarkdownFileMentions;
 //# sourceMappingURL=turn-deliverables.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-deliverables",
   "description": "Changed-files card with per-file comparison tabs, delivery cards, and clickable final-response file references for Web",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "publishConfig": {
     "access": "public"
   },
@@ -50,33 +50,33 @@
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@qilin-agent/api-remotes": "3.1.3",
-    "@qilin-agent/client-connection": "3.1.3",
-    "@qilin-agent/client-locale": "3.1.3",
-    "@qilin-agent/client-store": "3.1.3",
-    "@qilin-agent/client-test-runtime": "3.1.3",
-    "@qilin-agent/client-ui-chat": "3.1.3",
-    "@qilin-agent/client-ui-conversation": "3.1.3",
-    "@qilin-agent/client-ui-dockkit": "3.1.3",
-    "@qilin-agent/client-ui-renderer": "3.1.3",
-    "@qilin-agent/client-ui-slots": "3.1.3",
+    "@qilin-agent/api-remotes": "3.1.4",
+    "@qilin-agent/client-connection": "3.1.4",
+    "@qilin-agent/client-store": "3.1.4",
+    "@qilin-agent/client-test-runtime": "3.1.4",
+    "@qilin-agent/client-locale": "3.1.4",
+    "@qilin-agent/client-ui-dockkit": "3.1.4",
+    "@qilin-agent/client-ui-conversation": "3.1.4",
+    "@qilin-agent/client-ui-chat": "3.1.4",
+    "@qilin-agent/client-ui-renderer": "3.1.4",
+    "@qilin-agent/client-ui-sidebar-right": "3.1.4",
+    "@qilin-agent/client-ui-slots": "3.1.4",
+    "@qilin-agent/session": "3.1.4",
     "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/client-ui-primitives": "3.1.3",
-    "@qilin-agent/session": "3.1.3",
-    "@qilin-agent/client-ui-sidebar-right": "3.1.3",
-    "@qilin-agent/system-prompt": "3.1.3",
-    "@qilin-agent/session-query": "3.1.3",
-    "@qilin-agent/llm": "3.1.3",
-    "@qilin-agent/client-ui-tool": "3.1.3",
-    "@qilin-agent/tool-present": "3.1.3",
-    "@qilin-agent/workspace-changes": "3.1.3",
-    "@qilin-agent/api-session-controller": "3.1.3",
-    "@qilin-agent/util-workspace-path": "3.1.3",
-    "@qilin-agent/api-workspace-files": "3.1.3",
-    "@qilin-agent/fs": "3.1.3",
-    "@qilin-agent/sandbox-policy": "3.1.3",
-    "@qilin-agent/fs-local": "3.1.3",
-    "@qilin-agent/agent": "3.1.3"
+    "@qilin-agent/session-query": "3.1.4",
+    "@qilin-agent/llm": "3.1.4",
+    "@qilin-agent/client-ui-tool": "3.1.4",
+    "@qilin-agent/client-ui-primitives": "3.1.4",
+    "@qilin-agent/workspace-changes": "3.1.4",
+    "@qilin-agent/util-workspace-path": "3.1.4",
+    "@qilin-agent/tool-present": "3.1.4",
+    "@qilin-agent/system-prompt": "3.1.4",
+    "@qilin-agent/api-session-controller": "3.1.4",
+    "@qilin-agent/api-workspace-files": "3.1.4",
+    "@qilin-agent/fs": "3.1.4",
+    "@qilin-agent/fs-local": "3.1.4",
+    "@qilin-agent/agent": "3.1.4",
+    "@qilin-agent/sandbox-policy": "3.1.4"
   },
   "files": [
     "lib/index.js",
@@ -84,7 +84,7 @@
     "lib/types/**/*.d.ts"
   ],
   "dependencies": {
-    "@qilin-agent/typert-protocol": "3.1.3"
+    "@qilin-agent/typert-protocol": "3.1.4"
   },
   "scripts": {
     "bundle": "tsdown",