@sparkelf/dsh-plugin-document-attachments 0.1.0-rc.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/plus/document-attachments/README.md
+README.md: 51f203b7094d3d5a55c3fb2a95a1923dd74e8498
+README.zh.md: e306fffb40200cf2996c99ed3b6e5a6be85a5899

package/README.md

@@ -0,0 +1,63 @@
+---
+description: "Durable document intake, MinerU parsing, bounded model projection, and composer, Chat, and Trajectory cards."
+kind: "package-reference"
+---
+
+# @sparkelf/dsh-plugin-document-attachments
+
+English | [中文](README.zh.md)
+
+## Summary
+
+This complete Host and Client plugin owns document wire admission, the provider-neutral parser Service and MinerU HTTP provider, browser transport and localized validation, deterministic model delimiters, and cards for the composer, Chat, and Trajectory. With its independently retireable official-source patch, Plus accepts PDF, DOCX, PPTX, and XLSX files, persists originals and parsed artifacts, records document blocks, and projects bounded Markdown.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## Use this package
+
+Set `DSH_MINERU_ENDPOINT` to an absolute synchronous MinerU `/file_parse` URL. The Plus profile mounts a 1 MiB direct-Markdown budget and the MinerU provider with a 120-second timeout and 64 MiB response limit; without the endpoint, both rows stay disabled and no incomplete capability is advertised.
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+### Durable document content
+
+#### What the model sees
+
+Each accepted document contributes only `parsed.modelText`, wrapped with the original name and media type in deterministic delimiters. Parser paths, raw Office archives, content-list JSON, and extracted images remain out of model context.
+
+#### Token effect
+
+The document adds the bounded UTF-8 model-text length plus fixed delimiter text to its user message. Aggregate rendered bytes are checked before admission.
+
+#### KV Cache effect
+
+One durable parser result produces deterministic model text. Later turns can reuse the unchanged user-message prefix containing that document.
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- **Temporary official integration patch**: the selected official revision exposes only image attachment integration; `@sparkelf/dsh-patch-document-attachments` supplies generic storage, durable content, model projection, mixed draft intake, Host limits, file selection, and presentation slots until official DSH publishes equivalent points.
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers, click to expand</summary>
+
+This Dev Note is working context for maintainers; shipped behavior, limits, and rationale live in the sections above, the package code, and the linked Agent Note.
+
+- `src/index.ts` and `src/mineru.ts` own admission and parsing; `src/client` owns intake and cards. The [distribution Agent Note](../../../.agents/notes/proposed/architecture/2026-08-29-ranged-plus-patchset-distribution.md) owns the patch retirement rule.
+
+</details>

package/README.zh.md

@@ -0,0 +1,63 @@
+---
+description: "durable document intake、MinerU parsing、bounded model projection以及composer、Chat、Trajectory cards。"
+kind: "package-reference"
+---
+
+# @sparkelf/dsh-plugin-document-attachments
+
+[English](README.md) | 中文
+
+## 概述
+
+该完整Host及Client plugin持有document wire admission、provider-neutral parser Service及MinerU HTTP provider、browser transport及localized validation、deterministic model delimiters，以及composer、Chat和Trajectory cards。配合independently retireable official-source patch，Plus接受PDF、DOCX、PPTX及XLSX files，persist original及parsed artifacts，记录document blocks并project bounded Markdown。
+
+## 目录
+
+- [使用此软件包](#use-this-package)
+- [模型体验](#model-experience)
+- [已知限制和延期工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用此软件包
+
+把`DSH_MINERU_ENDPOINT`设为absolute synchronous MinerU `/file_parse` URL。Plus profile会mount 1 MiB direct-Markdown budget及带120-second timeout和64 MiB response limit的MinerU provider；缺少endpoint时两行保持disabled，且不会advertise incomplete capability。
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+### Durable document content
+
+#### 模型看到什么
+
+每个accepted document只贡献`parsed.modelText`，并用deterministic delimiters包裹original name及media type。Parser paths、raw Office archives、content-list JSON及extracted images不会进入model context。
+
+#### Token 影响
+
+Document向其user message加入bounded UTF-8 model-text length及fixed delimiter text。Aggregate rendered bytes会在admission前检查。
+
+#### KV Cache 影响
+
+一个durable parser result产生deterministic model text。Later turns可复用包含该document的unchanged user-message prefix。
+
+## 已知限制和延期工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- **Temporary official integration patch**：selected official revision只暴露image attachment integration；`@sparkelf/dsh-patch-document-attachments`会提供generic storage、durable content、model projection、mixed draft intake、Host limits、file selection及presentation slots，直到official DSH发布equivalent points。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者工作上下文，点击展开</summary>
+
+该开发备注是maintainer working context；shipped behavior、limits及rationale以以上sections、package code及linked Agent Note为准。
+
+- `src/index.ts`和`src/mineru.ts`持有admission及parsing；`src/client`持有intake及cards。[Distribution Agent Note](../../../.agents/notes/proposed/architecture/2026-08-29-ranged-plus-patchset-distribution.zh.md)持有patch retirement rule。
+
+</details>

package/lib/client.js

@@ -0,0 +1,319 @@
+window.__ModuleLoader__.load({
+	id: "@sparkelf/dsh-plugin-document-attachments",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		//#region \0dsh-css:/home/runner/work/deepseek-harness-plus/deepseek-harness-plus/packages/plus/document-attachments/src/client/Documents.module.css.mjs
+		const css = ".WD_fRa_list,.WD_fRa_history{scrollbar-width:none;gap:8px;padding:2px 0;display:flex;overflow-x:auto}.WD_fRa_list::-webkit-scrollbar,.WD_fRa_history::-webkit-scrollbar{display:none}.WD_fRa_card,.WD_fRa_historyCard{border:1px solid var(--dsw-alias-border-l2-darkmode-thin);background:var(--dsw-specific-input-major);border-radius:6px;grid-template-columns:42px minmax(96px,220px) auto 24px;align-items:center;gap:8px;min-height:48px;padding:6px 8px;display:grid}.WD_fRa_historyCard{grid-template-columns:42px minmax(96px,220px) auto}.WD_fRa_kind{background:var(--dsw-alias-interactive-bg-hover-solid);width:42px;height:28px;color:var(--dsw-alias-label-secondary);letter-spacing:0;border-radius:4px;justify-content:center;align-items:center;font-size:10px;font-weight:600;display:inline-flex}.WD_fRa_name{color:var(--dsw-alias-label-primary);text-overflow:ellipsis;white-space:nowrap;font-size:13px;overflow:hidden}.WD_fRa_size{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-size:11px}.WD_fRa_remove{width:24px;height:24px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:0;border-radius:4px;justify-content:center;align-items:center;padding:0;display:inline-flex}.WD_fRa_remove:hover,.WD_fRa_remove:focus-visible{background:var(--dsw-alias-interactive-bg-hover-solid);color:var(--dsw-alias-label-primary)}";
+		const tagId = "@sparkelf/dsh-plugin-document-attachments/Documents.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@sparkelf/dsh-plugin-document-attachments";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var Documents_module_css_default = {
+			"card": "WD_fRa_card",
+			"history": "WD_fRa_history",
+			"historyCard": "WD_fRa_historyCard",
+			"kind": "WD_fRa_kind",
+			"list": "WD_fRa_list",
+			"name": "WD_fRa_name",
+			"remove": "WD_fRa_remove",
+			"size": "WD_fRa_size"
+		};
+		//#endregion
+		//#region lib/types/client/DraftDocuments.js
+		function fileKind$1(mediaType, t) {
+			if (mediaType === "application/pdf") return t("format.pdf");
+			if (mediaType.includes("wordprocessingml")) return t("format.docx");
+			if (mediaType.includes("presentationml")) return t("format.pptx");
+			return t("format.xlsx");
+		}
+		function formatBytes$2(bytes, t) {
+			if (bytes >= 1024 * 1024) return t("format.mib", { value: (bytes / (1024 * 1024)).toFixed(1) });
+			return t("format.kib", { value: Math.max(1, Math.ceil(bytes / 1024)) });
+		}
+		/**
+		* Render browser-owned Document drafts with remove controls.
+		* @param props - nested composer slot owner data and locale translator.
+		* @returns the draft rail, or null when empty.
+		*/
+		function DraftDocuments({ documents, onRemoveDocument, t }) {
+			if (documents.length === 0) return null;
+			return (0, react_jsx_runtime.jsx)("div", {
+				className: Documents_module_css_default.list,
+				"aria-label": t("draft.group"),
+				children: documents.map((document) => (0, react_jsx_runtime.jsxs)("div", {
+					className: Documents_module_css_default.card,
+					children: [
+						(0, react_jsx_runtime.jsx)("span", {
+							className: Documents_module_css_default.kind,
+							children: fileKind$1(document.file.type, t)
+						}),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: Documents_module_css_default.name,
+							title: document.file.name,
+							children: document.file.name
+						}),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: Documents_module_css_default.size,
+							children: formatBytes$2(document.file.size, t)
+						}),
+						(0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							className: Documents_module_css_default.remove,
+							"aria-label": t("draft.remove", { name: document.file.name }),
+							title: t("draft.remove", { name: document.file.name }),
+							onClick: () => {
+								onRemoveDocument(document.id);
+							},
+							children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseFill14, { "aria-hidden": true })
+						})
+					]
+				}, document.id))
+			});
+		}
+		//#endregion
+		//#region lib/types/client/MessageDocuments.js
+		function fileKind(mediaType, t) {
+			if (mediaType === "application/pdf") return t("format.pdf");
+			if (mediaType.includes("wordprocessingml")) return t("format.docx");
+			if (mediaType.includes("presentationml")) return t("format.pptx");
+			return t("format.xlsx");
+		}
+		function formatBytes$1(bytes, t) {
+			if (bytes >= 1024 * 1024) return t("format.mib", { value: (bytes / (1024 * 1024)).toFixed(1) });
+			return t("format.kib", { value: Math.max(1, Math.ceil(bytes / 1024)) });
+		}
+		/**
+		* Render durable Document cards in Chat history.
+		* @param props - nested Chat attachment owner data and locale translator.
+		* @returns the history card row, or null when empty.
+		*/
+		function MessageDocuments({ documents, t }) {
+			return (0, react_jsx_runtime.jsx)(DocumentCards, {
+				documents,
+				label: t("history.group"),
+				t
+			});
+		}
+		/**
+		* Render durable Document cards in Trajectory history.
+		* @param props - nested Trajectory attachment owner data and locale translator.
+		* @returns the history card row, or null when empty.
+		*/
+		function TrajectoryDocuments({ documents, t }) {
+			return (0, react_jsx_runtime.jsx)(DocumentCards, {
+				documents,
+				label: t("history.group"),
+				t
+			});
+		}
+		function DocumentCards({ documents, label, t }) {
+			if (documents.length === 0) return null;
+			return (0, react_jsx_runtime.jsx)("div", {
+				className: Documents_module_css_default.history,
+				"aria-label": label,
+				children: documents.map((document, index) => (0, react_jsx_runtime.jsxs)("div", {
+					className: Documents_module_css_default.historyCard,
+					children: [
+						(0, react_jsx_runtime.jsx)("span", {
+							className: Documents_module_css_default.kind,
+							children: fileKind(document.mediaType, t)
+						}),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: Documents_module_css_default.name,
+							title: document.name,
+							children: document.name
+						}),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: Documents_module_css_default.size,
+							children: formatBytes$1(document.bytes, t)
+						})
+					]
+				}, `${document.name}:${index}`))
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		const en = {
+			"intake.count": "Attach up to {count} documents per message.",
+			"intake.type": "Choose a PDF, DOCX, PPTX, or XLSX file whose extension matches its type.",
+			"intake.fileSize": "Each document must be {size} or smaller.",
+			"intake.totalSize": "Documents in one message must total {size} or less.",
+			"submit.failed": "Unable to submit the document prompt.",
+			"command.unsupported": "Slash commands do not accept document attachments.",
+			"drop.title": "Drop images or documents here",
+			"drop.desc": "PDF, DOCX, PPTX, or XLSX; up to {count} documents, {size} each.",
+			"draft.group": "Draft documents",
+			"draft.remove": "Remove {name}",
+			"history.group": "Attached documents",
+			"format.pdf": "PDF",
+			"format.docx": "DOCX",
+			"format.pptx": "PPTX",
+			"format.xlsx": "XLSX",
+			"format.mib": "{value} MiB",
+			"format.kib": "{value} KiB"
+		};
+		const zh = {
+			"intake.count": "每条消息最多可附加 {count} 个文档。",
+			"intake.type": "请选择扩展名与类型一致的 PDF、DOCX、PPTX 或 XLSX 文件。",
+			"intake.fileSize": "每个文档不得超过 {size}。",
+			"intake.totalSize": "单条消息中的文档总大小不得超过 {size}。",
+			"submit.failed": "无法提交文档消息。",
+			"command.unsupported": "斜杠命令不接受文档附件。",
+			"drop.title": "将图片或文档拖放到此处",
+			"drop.desc": "支持 PDF、DOCX、PPTX 或 XLSX；最多 {count} 个文档，每个不超过 {size}。",
+			"draft.group": "待发送文档",
+			"draft.remove": "移除 {name}",
+			"history.group": "已附加文档",
+			"format.pdf": "PDF",
+			"format.docx": "DOCX",
+			"format.pptx": "PPTX",
+			"format.xlsx": "XLSX",
+			"format.mib": "{value} MiB",
+			"format.kib": "{value} KiB"
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Browser Document prompt transport, localized intake validation, and nested card registrations. */
+		const name = "document-attachments-client";
+		const inject = ["locale", "slots"];
+		const NS = "documentAttachments";
+		const PATH = "/api/document.prompt";
+		function browserHostUrl(path) {
+			return new URL(path.replace(/^[/]/u, ""), document.baseURI).toString();
+		}
+		function extension(mediaType) {
+			switch (mediaType) {
+				case "application/pdf": return ".pdf";
+				case "application/vnd.openxmlformats-officedocument.wordprocessingml.document": return ".docx";
+				case "application/vnd.openxmlformats-officedocument.presentationml.presentation": return ".pptx";
+				case "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": return ".xlsx";
+				default: return "";
+			}
+		}
+		function isRecord(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value);
+		}
+		function parsePromptResponse(value) {
+			if (!isRecord(value) || typeof value.ok !== "boolean") throw new Error("Document prompt response is invalid.");
+			if (value.ok) {
+				if (!isRecord(value.value) || value.value.accepted !== true) throw new Error("Document prompt success response is invalid.");
+				return {
+					ok: true,
+					value: { accepted: true }
+				};
+			}
+			if (!isRecord(value.error) || typeof value.error.code !== "string" || typeof value.error.message !== "string" || !isRecord(value.error.details)) throw new Error("Document prompt failure response is invalid.");
+			return {
+				ok: false,
+				error: {
+					code: value.error.code,
+					message: value.error.message,
+					details: value.error.details
+				}
+			};
+		}
+		function formatBytes(bytes) {
+			if (bytes >= 1024 * 1024) return `${Math.floor(bytes / (1024 * 1024))} MiB`;
+			return `${Math.floor(bytes / 1024)} KiB`;
+		}
+		var DocumentPromptClientService = class extends _deepseek_ai_cordis.Service {
+			constructor(ctx) {
+				super(ctx, "documentPrompt");
+			}
+			commandUnsupported() {
+				return this.ctx.locale.bind(NS)("command.unsupported");
+			}
+			dropLabels(limits) {
+				const t = this.ctx.locale.bind(NS);
+				return {
+					title: t("drop.title"),
+					desc: t("drop.desc", {
+						count: limits.maxDocumentsPerMessage,
+						size: formatBytes(limits.maxDocumentBytes)
+					})
+				};
+			}
+			validateIntake(files, existing, limits) {
+				const t = this.ctx.locale.bind(NS);
+				if (existing.length + files.length > limits.maxDocumentsPerMessage) return t("intake.count", { count: limits.maxDocumentsPerMessage });
+				let total = existing.reduce((sum, document) => sum + document.file.size, 0);
+				for (const file of files) {
+					const expectedExtension = extension(file.type);
+					if (!limits.mediaTypes.includes(file.type) || expectedExtension === "" || !file.name.toLowerCase().endsWith(expectedExtension)) return t("intake.type");
+					if (file.size > limits.maxDocumentBytes) return t("intake.fileSize", { size: formatBytes(limits.maxDocumentBytes) });
+					total += file.size;
+				}
+				if (total > limits.maxMessageDocumentBytes) return t("intake.totalSize", { size: formatBytes(limits.maxMessageDocumentBytes) });
+				return null;
+			}
+			async submit(request) {
+				try {
+					const response = await fetch(browserHostUrl(PATH), {
+						method: "POST",
+						headers: { "content-type": "application/json" },
+						body: JSON.stringify({
+							sessionId: request.sessionId,
+							requestId: request.requestId,
+							mode: request.mode === "steer" ? "steer" : "followup",
+							content: request.content,
+							clientTimeZone: Intl.DateTimeFormat().resolvedOptions().timeZone
+						}),
+						...request.signal === void 0 ? {} : { signal: request.signal }
+					});
+					const value = parsePromptResponse(await response.json());
+					if (!response.ok || !value.ok) return value.ok ? {
+						ok: false,
+						error: {
+							code: "DOCUMENT_PROMPT_FAILED",
+							message: this.ctx.locale.bind(NS)("submit.failed"),
+							details: {}
+						}
+					} : value;
+					return {
+						ok: true,
+						value: { accepted: true }
+					};
+				} catch (error) {
+					console.error("document-attachments: client prompt failed", error);
+					throw error;
+				}
+			}
+		};
+		/** Install browser transport, localized validation, and Document card contributions. */
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "document-attachments: client dictionaries");
+			new DocumentPromptClientService(ctx);
+			ctx.slots.inject("conversation.input.attachments.documents", () => ctx.slots.register({
+				name: "conversation.input.attachments.documents",
+				locale: NS
+			}, DraftDocuments));
+			ctx.slots.inject("conversation.message.images.documents", () => ctx.slots.register({
+				name: "conversation.message.images.documents",
+				locale: NS
+			}, MessageDocuments));
+			ctx.slots.inject("conversation.trajectory.images.documents", () => ctx.slots.register({
+				name: "conversation.trajectory.images.documents",
+				locale: NS
+			}, TrajectoryDocuments));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		exports.name = name;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,2 @@
+import { n as DocumentParserRuntime, r as DocumentParserError, t as Config } from "./types-gD1pbaLm.js";
+export { Config, DocumentParserError, DocumentParserRuntime, DocumentParserRuntime as default };

package/lib/invariant.js

@@ -0,0 +1,16 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@sparkelf/dsh-plugin-document-attachments`.
+* @module @sparkelf/dsh-plugin-document-attachments/invariant
+*/
+const PACKAGE_NAME = "@sparkelf/dsh-plugin-document-attachments";
+/** Cordis companion plugin name. */
+const name = "document-parser-mineru-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/** No runtime invariant: parse transport has no independent durable state beyond attachment refs validated by its consumers. */
+const install = () => {};
+/** Register this package's invariant companion. */
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };