@monotykamary/dsh-session-log-export 0.1.0-rc.5

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/session-query/session-log-export/README.md
+README.md: 051dcb9d1bd77bd743980b533394f016489aa4fd
+README.zh.md: 8e40eaf7e2fc0aaf54dffd4f44b5502f82defa35

package/README.md

@@ -0,0 +1,49 @@
+# @monotykamary/dsh-session-log-export
+
+English | [中文](README.zh.md)
+
+Web Session-log download control over the host-streamed ZIP endpoint owned by `dsh-host-apiproxy`. The Host half registers `/export`; the browser half owns a 111×32 `Session log` action in the Session Header, one download controller, and one modal shared by that button and the slash command. ZIP generation, raw JSONL/zstd reads, descendants, attachments, backpressure, and HTTP error semantics remain owned by the [ApiProxy download implementation](../../host/apiproxy/README.md).
+
+## Command contract
+
+| Input | Result |
+|---|---|
+| `/export` | Record a human-command lifecycle; the submitting browser receives the local execution acknowledgment and downloads `GET /api/session.export?sessionId=<id>&includeDescendants=true`. |
+| `/export <path>` | Return an error. Browser downloads choose their destination through the browser's ordinary download behavior. |
+
+The command is mounted only by the Web bundle. The local `command/executed` acknowledgment triggers the slash download only after a successful `/export` result in the browser that submitted it; other tabs still render the durable command row without repeating the browser side effect. The Header button calls the same controller directly. Both entry paths issue a `HEAD` preflight, then hand the GET URL to the browser download manager without buffering the ZIP in JavaScript; they share in-flight collapsing, cancellation of the preflight on plugin disposal, preparation-error handling, browser save behavior, and the same Modal.
+
+The Host download endpoint flushes a live root Session before `readRaw`, so a slash-triggered ZIP includes the `command/run` and `command/done` pair whose acknowledgment started the download. Cold persisted Sessions require no flush.
+
+The modal reports preparation, download start, or failure. Closing it does not cancel an in-flight download and does not reopen it when that operation later settles. One Session admits one active download at a time; repeated gestures share that operation.
+
+## Composition
+
+```yaml
+- id: session-log-download
+  name: '@monotykamary/dsh-session-log-export'
+```
+
+The Web bundle mounts the package beside `dsh-host-apiproxy`, `dsh-commands`, `dsh-client-ui-commands`, and `dsh-client-ui-conversation`. The package contributes its button and modal to the right-aligned `conversation.session.header.utilities` list, independently of the title-adjacent mode, Subagent, and Task entries in `conversation.session.header.actions`; Trajectory carries no export control.
+
+## Model Experience
+
+### Human `/export` control
+
+#### What the model sees
+
+Nothing. `/export` stays on the human-command plane, and the ZIP download does not enter model history.
+
+#### Token effect
+
+Zero. The command creates no model turn.
+
+#### KV Cache effect
+
+None. The log-only command lifecycle and browser download do not change the derived request prefix.
+
+## Known Limitations and Deferred Work
+
+- The download endpoint requires a persistence backend with a per-Session raw artifact. The shipped JSONL backend supports plaintext and zstd artifacts; SQLite export is not included in this change.
+- This is a browser download, not a Host-path writer. The browser chooses the local destination; no Host path or native folder action is returned.
+- The preflight reports failures found before ZIP streaming starts. A descendant or attachment failure after the browser accepts the GET is reported by the browser download manager, not by the modal.

package/README.zh.md

@@ -0,0 +1,49 @@
+# @monotykamary/dsh-session-log-export
+
+[English](README.md) | 中文
+
+Web Session 日志下载控制，使用 `dsh-host-apiproxy` 拥有的 Host 流式 ZIP 端点。Host 半包注册 `/export`；浏览器半包在 Session Header 中提供 111×32 的 `Session log` 操作，以及一个供该按钮与斜杠命令共用的下载控制器和弹窗。ZIP 生成、原始 JSONL/zstd 读取、子 Session、附件、背压和 HTTP 错误语义仍由 [ApiProxy 下载实现](../../host/apiproxy/README.md)负责。
+
+## 命令约定
+
+| 输入 | 结果 |
+|---|---|
+| `/export` | 记录一组用户命令生命周期；提交命令的浏览器收到本地执行确认后，下载 `GET /api/session.export?sessionId=<id>&includeDescendants=true`。 |
+| `/export <path>` | 返回错误。浏览器下载通过浏览器的普通下载行为选择目标位置。 |
+
+该命令只由 Web bundle 挂载。只有 `/export` 返回成功时，本地 `command/executed` 确认才会在提交命令的浏览器中触发斜杠下载；其他标签页仍会渲染持久命令行，但不会重复执行浏览器副作用。Header 按钮直接调用同一个控制器。两种入口都会先发出 `HEAD` 预检，再把 GET URL 交给浏览器下载管理器，JavaScript 不会缓冲 ZIP；它们共用并发折叠、插件释放时取消预检、准备阶段错误处理、浏览器保存行为和同一个 Modal。
+
+Host 下载端点会在 `readRaw` 前 flush 活动的根 Session，因此斜杠命令触发的 ZIP 会包含启动下载的 `command/run` 与 `command/done` 事件对。冷持久化 Session 不需要 flush。
+
+弹窗报告准备中、开始下载或失败。关闭弹窗不会取消正在进行的下载；该操作随后完成时也不会重新打开弹窗。每个 Session 同时只允许一项下载，重复操作会共用该任务。
+
+## 组合
+
+```yaml
+- id: session-log-download
+  name: '@monotykamary/dsh-session-log-export'
+```
+
+Web bundle 将本包与 `dsh-host-apiproxy`、`dsh-commands`、`dsh-client-ui-commands` 和 `dsh-client-ui-conversation` 一起挂载。本包把按钮和弹窗贡献到最右侧的 `conversation.session.header.utilities` 列表，与标题旁 `conversation.session.header.actions` 中的模式、Subagent 和 Task 配置项相互独立；Trajectory 不包含导出入口。
+
+## 模型体验
+
+### 用户 `/export` 控制
+
+#### 模型看到什么
+
+无。`/export` 留在用户命令平面，ZIP 下载不会进入模型历史。
+
+#### Token 影响
+
+为零。该命令不创建模型轮次。
+
+#### KV Cache 影响
+
+无。仅日志命令生命周期和浏览器下载不会改变派生请求前缀。
+
+## 已知限制与暂缓事项
+
+- 下载端点要求持久化后端具有逐 Session 原始工件。随附 JSONL 后端支持明文和 zstd 工件；本次改动不包含 SQLite 导出。
+- 这是浏览器下载，不是 Host 路径写入。目标位置由浏览器选择，不会返回 Host 路径或原生文件夹操作。
+- 预检只报告 ZIP 开始流式传输前发现的失败。浏览器接受 GET 后发生的子 Session 或附件读取失败由浏览器下载管理器报告，不通过弹窗报告。

package/lib/client.js

@@ -0,0 +1,268 @@
+window.__ModuleLoader__.load({
+	id: "@monotykamary/dsh-session-log-export",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let _monotykamary_dsh_client_runtime_client = require("@monotykamary/dsh-client-runtime/client");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let _monotykamary_dsh_client_ui_primitives = require("@monotykamary/dsh-client-ui-primitives");
+		//#region lib/types/client/controller.js
+		/** Browser download state shared by the Session Header button and `/export`. */
+		const INITIAL = { bySession: {} };
+		/**
+		* Collapse an untrusted Session id into the filename convention owned by the host endpoint.
+		* @param sessionId - Session whose archive is downloaded.
+		* @returns one safe browser download filename.
+		*/
+		function sessionLogZipFilename(sessionId) {
+			return `dsh-session-${String(sessionId).replace(/[^A-Za-z0-9_-]/g, "_")}.zip`;
+		}
+		/**
+		* Hand a Host download URL to the browser download manager.
+		* @param url - same-origin Host download URL.
+		* @param filename - browser download filename.
+		*/
+		function downloadUrl(url, filename) {
+			const anchor = document.createElement("a");
+			anchor.href = url;
+			anchor.download = filename;
+			anchor.click();
+		}
+		/** Resolve the browser's Host base with the connection carrier's null-origin fallback. */
+		function hostBase() {
+			const origin = globalThis.location?.origin;
+			return origin !== void 0 && origin !== "null" ? origin : "http://dsh.internal";
+		}
+		function messageOf(error) {
+			return error instanceof Error ? error.message : String(error);
+		}
+		/** Owns one in-flight browser download per Session and publishes modal state. */
+		var SessionLogDownloadController = class {
+			fetcher;
+			save;
+			/** uSES-safe state source shared by every Session-scoped modal contribution. */
+			store = (0, _monotykamary_dsh_client_runtime_client.createSnapshotStore)(INITIAL);
+			active = /* @__PURE__ */ new Map();
+			disposed = false;
+			/**
+			* @param fetcher - HTTP carrier used to read the host-streamed ZIP.
+			* @param save - browser save operation.
+			*/
+			constructor(fetcher = (input, init) => fetch(input, init), save = downloadUrl) {
+				this.fetcher = fetcher;
+				this.save = save;
+			}
+			/**
+			* Download one Session tree; concurrent gestures for the same Session share one operation.
+			* @param sessionId - root Session whose ZIP includes descendants and attachments.
+			* @returns after the browser save starts, an error state is published, or a late post-disposal request is ignored.
+			*/
+			download(sessionId) {
+				const existing = this.active.get(sessionId);
+				if (existing !== void 0) return existing.done;
+				if (this.disposed) return Promise.resolve();
+				const abort = new AbortController();
+				const done = this.run(sessionId, abort.signal).finally(() => {
+					this.active.delete(sessionId);
+				});
+				this.active.set(sessionId, {
+					abort,
+					done
+				});
+				return done;
+			}
+			/**
+			* Close one Session's dialog without cancelling an in-flight browser download.
+			* @param sessionId - Session whose modal closes.
+			*/
+			dismiss(sessionId) {
+				const current = this.store.getSnapshot().bySession[String(sessionId)];
+				if (current === void 0 || !current.open) return;
+				this.publish(sessionId, {
+					...current,
+					open: false
+				});
+			}
+			/**
+			* Abort active fetches and reach quiescence.
+			* @returns after every active operation settles.
+			*/
+			async dispose() {
+				this.disposed = true;
+				const active = [...this.active.values()];
+				for (const operation of active) operation.abort.abort();
+				await Promise.allSettled(active.map((operation) => operation.done));
+			}
+			async run(sessionId, signal) {
+				this.publish(sessionId, {
+					open: true,
+					status: "downloading",
+					error: null
+				});
+				try {
+					const url = new URL("/api/session.export", hostBase());
+					url.searchParams.set("sessionId", sessionId);
+					url.searchParams.set("includeDescendants", "true");
+					const response = await this.fetcher(url, {
+						method: "HEAD",
+						signal
+					});
+					if (!response.ok) {
+						const detail = await response.text().catch(() => "");
+						throw new Error(`Export failed: HTTP ${response.status}${detail === "" ? "" : ` ${detail}`}`);
+					}
+					this.save(url.toString(), sessionLogZipFilename(sessionId));
+					const open = this.store.getSnapshot().bySession[String(sessionId)]?.open ?? true;
+					this.publish(sessionId, {
+						open,
+						status: "success",
+						error: null
+					});
+				} catch (error) {
+					if (signal.aborted) return;
+					const open = this.store.getSnapshot().bySession[String(sessionId)]?.open ?? true;
+					this.publish(sessionId, {
+						open,
+						status: "error",
+						error: messageOf(error)
+					});
+				}
+			}
+			publish(sessionId, entry) {
+				this.store.update((state) => {
+					state.bySession = {
+						...state.bySession,
+						[String(sessionId)]: entry
+					};
+				});
+			}
+		};
+		//#endregion
+		//#region lib/types/client/Dialog.js
+		/**
+		* Modal shared by the Session Header button and this browser's `/export` command.
+		* @param props - Session runtime, bound controller state, actions, and localized copy.
+		* @returns the modal portal contribution.
+		*/
+		function SessionLogDownloadDialog({ sessionId, useSessionLogDownload, dismiss, t }) {
+			const entry = useSessionLogDownload((state) => state.bySession[String(sessionId)]);
+			const status = entry?.status;
+			const open = entry?.open === true;
+			const error = status === "error" ? entry?.error || t("dialog.commandFailed") : null;
+			return (0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.Modal, {
+				open,
+				onClose: () => {
+					dismiss(sessionId);
+				},
+				title: status === "downloading" ? t("dialog.preparingTitle") : status === "success" ? t("dialog.successTitle") : t("dialog.errorTitle"),
+				description: status === "downloading" ? t("dialog.preparingDescription") : status === "success" ? t("dialog.successDescription") : error ?? t("dialog.commandFailed"),
+				closeLabel: t("dialog.close"),
+				footer: (0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.Button, {
+					variant: "primary",
+					onClick: () => {
+						dismiss(sessionId);
+					},
+					children: t("dialog.close")
+				})
+			});
+		}
+		//#endregion
+		//#region \0dsh-css:/Users/monotykamary/VCS/working-remote/open-source/deepseek-harness/packages/session-query/session-log-export/src/client/HeaderAction.module.css.mjs
+		const css = ".TBrRZG_sessionLogButton{border:1px solid var(--dsw-alias-border-l2);min-width:111px;height:32px;color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family);cursor:pointer;background:0 0;border-radius:18px;justify-content:center;align-items:center;gap:4px;padding:6px 12px;font-size:13px;font-weight:400;line-height:20px;display:inline-flex}.TBrRZG_sessionLogButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.TBrRZG_sessionLogButton:disabled{color:var(--dsw-alias-label-dimmed);cursor:wait}.TBrRZG_sessionLogButton span,.TBrRZG_sessionLogButton svg{flex:none}.TBrRZG_sessionLogButton span{white-space:nowrap}";
+		const tagId = "@monotykamary/dsh-session-log-export/HeaderAction.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@monotykamary/dsh-session-log-export";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var HeaderAction_module_css_default = { "sessionLogButton": "TBrRZG_sessionLogButton" };
+		//#endregion
+		//#region lib/types/client/HeaderAction.js
+		/**
+		* Render the Session Header export capsule and its shared result dialog.
+		* @param props - Session runtime, download controller, and localized dialog copy.
+		* @returns the persistent Header action and Session-scoped dialog.
+		*/
+		function SessionLogDownloadHeaderAction(props) {
+			const { sessionId, useSessionLogDownload, request } = props;
+			const busy = useSessionLogDownload((state) => state.bySession[String(sessionId)])?.status === "downloading";
+			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsxs)("button", {
+				type: "button",
+				className: HeaderAction_module_css_default.sessionLogButton,
+				disabled: busy,
+				"aria-busy": busy,
+				onClick: () => {
+					request(sessionId);
+				},
+				children: [(0, react_jsx_runtime.jsx)("span", { children: "Session log" }), (0, react_jsx_runtime.jsx)(_monotykamary_dsh_client_ui_primitives.IconDownloadOutline16, { size: 12 })]
+			}), (0, react_jsx_runtime.jsx)(SessionLogDownloadDialog, { ...props })] });
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** Locale namespace owned by Session export browser feedback. */
+		const NS = "session-log-download";
+		/** Simplified-Chinese Session export strings. */
+		const zh = {
+			"dialog.preparingTitle": "正在导出 Session",
+			"dialog.preparingDescription": "正在准备包含当前 Session、子 Session 和附件的 ZIP 文件。",
+			"dialog.successTitle": "Session 导出已开始下载",
+			"dialog.successDescription": "浏览器正在下载 Session ZIP 文件。",
+			"dialog.errorTitle": "Session 导出失败",
+			"dialog.close": "关闭",
+			"dialog.commandFailed": "无法启动 Session 导出。"
+		};
+		/** English Session export strings. */
+		const en = {
+			"dialog.preparingTitle": "Exporting Session",
+			"dialog.preparingDescription": "Preparing a ZIP containing this Session, its sub-Sessions, and attachments.",
+			"dialog.successTitle": "Session download started",
+			"dialog.successDescription": "The browser is downloading the Session ZIP.",
+			"dialog.errorTitle": "Session export failed",
+			"dialog.close": "Close",
+			"dialog.commandFailed": "Could not start the Session export."
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Browser plugin owning Session export download state and its shared modal. */
+		const inject = ["slots", "locale"];
+		/**
+		* Provide the download controller and mount its modal into the Session Header.
+		* @param ctx - browser context carrying slots and locale services.
+		*/
+		function apply(ctx) {
+			const controller = new SessionLogDownloadController();
+			ctx.provide("sessionLogDownload", controller);
+			ctx.effect(() => async () => {
+				await controller.dispose();
+			}, "session-log-download: browser download lifecycle");
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "session-log-download: browser dictionaries");
+			ctx.on("command/executed", (sessionId, commandName, result) => {
+				if (commandName === "export" && result.kind === "success") controller.download(sessionId);
+			});
+			ctx.slots.inject("conversation.session.header.utilities", () => ctx.slots.register({
+				name: "conversation.session.header.utilities",
+				id: "session-log-download",
+				locale: NS,
+				inject: () => ({
+					hooks: { sessionLogDownload: controller.store },
+					request: (sessionId) => controller.download(sessionId),
+					dismiss: (sessionId) => {
+						controller.dismiss(sessionId);
+					}
+				})
+			}, SessionLogDownloadHeaderAction));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,24 @@
+//#region lib/types/index.js
+/** Web Session-log download command over the host endpoint owned by ApiProxy. */
+const name = "session-log-download";
+const inject = ["commands"];
+const REQUESTED = {
+	kind: "success",
+	text: "Session log download requested."
+};
+/**
+* Register the Web-only `/export` command that the browser download plugin observes.
+* @param ctx - Host context carrying the human-command registry.
+*/
+function apply(ctx) {
+	ctx.effect(() => ctx.commands.register({
+		name: "export",
+		description: "Download this Session log as a ZIP archive",
+		handler: (invocation) => Promise.resolve(invocation.rawInput.trim() === "" ? REQUESTED : {
+			kind: "error",
+			text: "The Web /export command does not accept a path."
+		})
+	}), "session-log-download: command");
+}
+//#endregion
+export { apply, inject, name };

package/lib/invariant.js

@@ -0,0 +1,15 @@
+//#region lib/types/invariant.js
+/** Package invariant companion for `@monotykamary/dsh-session-log-export`. */
+const PACKAGE_NAME = "@monotykamary/dsh-session-log-export";
+const name = "session-export-invariant";
+const inject = ["invariants"];
+/** No runtime invariant: the command registry owns lifecycle pairing and ApiProxy owns ZIP integrity. */
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Host context carrying the invariant registry.
+* @returns the registration disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,20 @@
+import type { ObservableSnapshot, SessionId } from '@monotykamary/dsh-client-runtime/client';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@monotykamary/dsh-client-ui-slots';
+import type { SessionLogDownloadState } from './controller.ts';
+import { NS } from './locales.ts';
+/** Browser operations and state injected into the Session Header contribution. */
+export interface SessionLogDownloadDialogInjected {
+    hooks: {
+        sessionLogDownload: ObservableSnapshot<SessionLogDownloadState>;
+    };
+    request: (sessionId: SessionId) => Promise<void>;
+    dismiss: (sessionId: SessionId) => void;
+}
+export type SessionLogDownloadDialogProps = PropsRuntime<'conversation.session.header.utilities'> & PropsLocale<typeof NS> & InjectFace<SessionLogDownloadDialogInjected>;
+/**
+ * Modal shared by the Session Header button and this browser's `/export` command.
+ * @param props - Session runtime, bound controller state, actions, and localized copy.
+ * @returns the modal portal contribution.
+ */
+export declare function SessionLogDownloadDialog({ sessionId, useSessionLogDownload, dismiss, t, }: SessionLogDownloadDialogProps): import("react").JSX.Element;
+//# sourceMappingURL=Dialog.d.ts.map

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

@@ -0,0 +1,9 @@
+import type { ReactNode } from 'react';
+import { type SessionLogDownloadDialogProps } from './Dialog.tsx';
+/**
+ * Render the Session Header export capsule and its shared result dialog.
+ * @param props - Session runtime, download controller, and localized dialog copy.
+ * @returns the persistent Header action and Session-scoped dialog.
+ */
+export declare function SessionLogDownloadHeaderAction(props: SessionLogDownloadDialogProps): ReactNode;
+//# sourceMappingURL=HeaderAction.d.ts.map

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

@@ -0,0 +1,62 @@
+/** Browser download state shared by the Session Header button and `/export`. */
+import { type SessionId, type SnapshotStore } from '@monotykamary/dsh-client-runtime/client';
+/** Download phases presented by the shared modal. */
+export type SessionLogDownloadStatus = 'downloading' | 'success' | 'error';
+/** One Session's current download-dialog state. */
+export interface SessionLogDownloadEntry {
+    readonly open: boolean;
+    readonly status: SessionLogDownloadStatus;
+    readonly error: string | null;
+}
+/** Download states keyed by the Session whose Header owns the dialog. */
+export interface SessionLogDownloadState {
+    bySession: Record<string, SessionLogDownloadEntry | undefined>;
+}
+type Fetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
+type Save = (url: string, filename: string) => void;
+/**
+ * Collapse an untrusted Session id into the filename convention owned by the host endpoint.
+ * @param sessionId - Session whose archive is downloaded.
+ * @returns one safe browser download filename.
+ */
+export declare function sessionLogZipFilename(sessionId: SessionId): string;
+/**
+ * Hand a Host download URL to the browser download manager.
+ * @param url - same-origin Host download URL.
+ * @param filename - browser download filename.
+ */
+export declare function downloadUrl(url: string, filename: string): void;
+/** Owns one in-flight browser download per Session and publishes modal state. */
+export declare class SessionLogDownloadController {
+    private readonly fetcher;
+    private readonly save;
+    /** uSES-safe state source shared by every Session-scoped modal contribution. */
+    readonly store: SnapshotStore<SessionLogDownloadState>;
+    private readonly active;
+    private disposed;
+    /**
+     * @param fetcher - HTTP carrier used to read the host-streamed ZIP.
+     * @param save - browser save operation.
+     */
+    constructor(fetcher?: Fetch, save?: Save);
+    /**
+     * Download one Session tree; concurrent gestures for the same Session share one operation.
+     * @param sessionId - root Session whose ZIP includes descendants and attachments.
+     * @returns after the browser save starts, an error state is published, or a late post-disposal request is ignored.
+     */
+    download(sessionId: SessionId): Promise<void>;
+    /**
+     * Close one Session's dialog without cancelling an in-flight browser download.
+     * @param sessionId - Session whose modal closes.
+     */
+    dismiss(sessionId: SessionId): void;
+    /**
+     * Abort active fetches and reach quiescence.
+     * @returns after every active operation settles.
+     */
+    dispose(): Promise<void>;
+    private run;
+    private publish;
+}
+export {};
+//# sourceMappingURL=controller.d.ts.map

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

@@ -0,0 +1,23 @@
+/** Browser plugin owning Session export download state and its shared modal. */
+import type { ClientContext } from '@monotykamary/dsh-client-runtime/client';
+import { SessionLogDownloadController } from './controller.ts';
+import { type SessionLogDownloadKey } from './locales.ts';
+declare module '@monotykamary/cordis' {
+    interface Context {
+        sessionLogDownload: SessionLogDownloadController;
+    }
+}
+declare module '@monotykamary/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        'session-log-download': SessionLogDownloadKey;
+    }
+}
+export type { SessionLogDownloadEntry, SessionLogDownloadState } from './controller.ts';
+export declare const inject: string[];
+/**
+ * Provide the download controller and mount its modal into the Session Header.
+ * @param ctx - browser context carrying slots and locale services.
+ */
+export declare function apply(ctx: ClientContext): void;
+export type { SessionLogDownloadDialogInjected, SessionLogDownloadDialogProps } from './Dialog.tsx';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,17 @@
+/** Locale namespace owned by Session export browser feedback. */
+export declare const NS = "session-log-download";
+/** Simplified-Chinese Session export strings. */
+export declare const zh: {
+    readonly 'dialog.preparingTitle': "正在导出 Session";
+    readonly 'dialog.preparingDescription': "正在准备包含当前 Session、子 Session 和附件的 ZIP 文件。";
+    readonly 'dialog.successTitle': "Session 导出已开始下载";
+    readonly 'dialog.successDescription': "浏览器正在下载 Session ZIP 文件。";
+    readonly 'dialog.errorTitle': "Session 导出失败";
+    readonly 'dialog.close': "关闭";
+    readonly 'dialog.commandFailed': "无法启动 Session 导出。";
+};
+/** English Session export strings. */
+export declare const en: Record<keyof typeof zh, string>;
+/** Stable locale keys consumed by the shared modal. */
+export type SessionLogDownloadKey = keyof typeof zh;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,10 @@
+/** Web Session-log download command over the host endpoint owned by ApiProxy. */
+import type { Context } from '@monotykamary/cordis';
+export declare const name = "session-log-download";
+export declare const inject: string[];
+/**
+ * Register the Web-only `/export` command that the browser download plugin observes.
+ * @param ctx - Host context carrying the human-command registry.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,11 @@
+/** Package invariant companion for `@monotykamary/dsh-session-log-export`. */
+import type { Context } from '@monotykamary/cordis';
+export declare const name = "session-export-invariant";
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Host context carrying the invariant registry.
+ * @returns the registration disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@monotykamary/dsh-session-log-export",
+  "description": "Web Session-log export command and shared download dialog",
+  "version": "0.1.0-rc.5",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/session-query/session-log-export"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@monotykamary/dsh-client-locale": "^0.1.0-rc.5",
+    "@monotykamary/cordis": "^4.0.1",
+    "@monotykamary/dsh-client-ui-commands": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-slots": "^0.1.0-rc.5",
+    "@monotykamary/dsh-commands": "^0.1.0-rc.5",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-conversation": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-primitives": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-runtime": "^0.1.0-rc.5"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@monotykamary/cordis": "^4.0.1",
+    "@monotykamary/dsh-client-locale": "^0.1.0-rc.5",
+    "@monotykamary/dsh-agent": "^0.1.0-rc.5",
+    "@monotykamary/cordis-plugin-loader": "^1.0.2",
+    "@monotykamary/dsh-client-runtime": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-conversation": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-primitives": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-slots": "^0.1.0-rc.5",
+    "@monotykamary/dsh-session": "^0.1.0-rc.5",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.5",
+    "@monotykamary/dsh-client-ui-commands": "^0.1.0-rc.5",
+    "@monotykamary/dsh-commands": "^0.1.0-rc.5"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@monotykamary/dsh-client-locale",
+        "@monotykamary/dsh-client-runtime",
+        "@monotykamary/dsh-client-ui-commands",
+        "@monotykamary/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}