@deepseek-ai/dsh-client-ui-jobs 0.0.1-rc.3

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, DeepSeek
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

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/client/ui-jobs/README.md
+README.md: d9720329ee537fdc303b8191b714c315b7535f9c
+README.zh.md: 7e7bc05eefc21e62fc3751d1c069305398759268

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-client-ui-jobs
+
+English | [中文](README.zh.md)
+
+Web background-job feature owner: contributes one entry to `conversation.session.header.actions` listing the `ctx.jobs` records this session can see. The data arrives entirely through the `jobsBySession` list mirror that [`dsh-client-runtime`](../runtime/README.md) folds from `session/jobs` frames, so this package issues no RPC and holds no state beyond popover visibility.
+
+The trigger renders only when the session has at least one job, so an ordinary conversation never grows a control for a capability it is not using. Its badge counts `running` plus `stopping` and is omitted at zero, leaving a session that holds only finished jobs a quiet entry point into its history rather than one advertising a count of nothing. The popover is a flat list: live rows first by `startedAt` ascending, then settled rows by `finishedAt` descending, with a same-millisecond tie broken on start order so the host's map iteration never decides it. A row shows the producer kind, the label, a status marker, the producer's `detail` in place of the generic status word once it has one, and an elapsed duration. That duration advances once per second while the row is live and freezes at `finishedAt`; the clock runs only while an open list holds something that moves. A settled row missing `finishedAt` reads as zero rather than as a negative figure, and a duration past an hour stays in hours rather than growing a day vocabulary no producer currently reaches.
+
+Settled rows stay visible and de-emphasized until the registry drops them at owner disposal. They are in the snapshot, a failed job's `detail` is the only place its failure is legible, and filtering them out here is work the output and cancellation phases would undo. A running one-shot background subagent therefore appears both here and in the [subagent catalog](../ui-subagent/README.md): the catalog navigates into the child's transcript, while this list is the only handle a future cancellation can attach to.
+
+Escape closes the list and returns focus to the trigger, as does a pointer press outside it. The last job disappearing closes the list before the control unmounts, so focus never vanishes from a removed node. Styling uses tokens only; copy goes through the package's own `job` locale namespace. The behavior is specified by the [Web background-job display Agent Note](../../../.agents/notes/implemented/feature/2026-08-08-web-background-job-display.md).
+
+## Model Experience
+
+None, as this package renders host-computed registry state for a human and touches no prompt, message, schema, stream, or tool result. The model's own view of the same jobs stays with [`dsh-tool-jobs`](../../jobs/tool-jobs/README.md).
+
+#### KV Cache effect
+
+None; the package never assembles or sends provider requests.
+
+## Known Limitations and Deferred Work
+
+- **Rows are read-only** — a job's streamed output and a human-initiated cancellation are separate phases. Cancellation additionally owes a model-facing decision the seam does not answer today: `kill()` marks terminal delivery reported, so an interrupt written against the current contract would leave the model believing its job is still running.
+- **The list is not the registry's own set** — it shows what one session can see through the wire view, so a job owned by another session never appears here, and a process restart empties the list while the transcript keeps the `run_in_background` cards that started those jobs. An unowned job (one started without a live `Agent`) is the opposite case: it reaches every session's list, matching what `list(caller)` reports to every caller.

package/README.zh.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-client-ui-jobs
+
+[English](README.md) | 中文
+
+Web 后台任务特性的归属方：向 `conversation.session.header.actions` 贡献一个条目，列出当前会话可见的 `ctx.jobs` 记录。数据完全来自 [`dsh-client-runtime`](../runtime/README.md) 从 `session/jobs` 帧折叠出的 `jobsBySession` 列表镜像，因此本包不发任何 RPC，除弹层开合外不持有任何状态。
+
+只有当会话至少有一个任务时才渲染触发器，普通对话不会因为一项未被使用的能力而长出控件。角标计数为 `running` 加 `stopping`，为零时省略，这样只剩已完成任务的会话保留一个安静的历史入口，而不是宣告一个「零」。弹层是一个扁平列表：活跃行在前按 `startedAt` 升序，随后终态行按 `finishedAt` 降序；毫秒相同的并列按启动顺序打破，宿主的 map 迭代顺序永远不参与决定。一行显示生产者 kind、label、状态标记、生产者一旦给出 `detail` 就取代通用状态词的那段文字，以及已耗时。该耗时在活跃时每秒推进，并在 `finishedAt` 冻结；只有当打开的列表里确实有会动的东西时时钟才运行。缺少 `finishedAt` 的终态行读作零而不是负数，超过一小时的耗时停留在小时单位，不会长出任何生产者目前都到不了的「天」词汇。
+
+终态行保持可见并弱化，直到注册表在 owner 销毁时把它们丢掉。它们本就在快照里，失败任务的 `detail` 是其失败唯一可读之处，在这里过滤掉它们是输出与中断两期要推翻的工作。因此一个运行中的一次性后台 subagent 会同时出现在这里和 [subagent 目录](../ui-subagent/README.md)里：目录负责进入子会话的 transcript，而这个列表是将来中断能力唯一可能附着的句柄。
+
+Escape 关闭列表并把焦点交还触发器，在其外部按下指针同理。最后一个任务消失时先关闭列表再卸载控件，焦点因此不会从一个被移除的节点上凭空消失。样式只用 token；文案走本包自己的 `job` locale 命名空间。行为由 [Web 后台任务展示 Agent Note](../../../.agents/notes/implemented/feature/2026-08-08-web-background-job-display.md) 规定。
+
+## 模型体验
+
+无，因为本包为人类渲染宿主计算出的注册表状态，不触及 prompt、消息、schema、流或工具结果。模型对同一批任务的视角仍属于 [`dsh-tool-jobs`](../../jobs/tool-jobs/README.md)。
+
+#### KV Cache effect
+
+无；本包从不组装或发送 provider 请求。
+
+## 已知限制与暂缓事项
+
+- **行是只读的** —— 任务的流式输出与人类发起的中断是各自独立的阶段。中断还额外欠一个 seam 目前没有回答的、面向模型的决策：`kill()` 会把终态投递标为已上报，所以照当前契约写出来的中断会让模型一直以为它的任务还在跑。
+- **列表不等于注册表自己的集合** —— 它展示的是「一个会话通过线路视图能看到什么」，所以别的会话拥有的任务在这里永远不出现；而进程重启会清空列表，transcript 里启动这些任务的 `run_in_background` 卡片却还在。无主任务（在没有活体 `Agent` 时启动的）是反过来的情形：它会进入每一个会话的列表，与 `list(caller)` 对每个调用方的报告一致。

package/lib/client.js

@@ -0,0 +1,289 @@
+window.__ModuleLoader__.load({
+	id: "@deepseek-ai/dsh-client-ui-jobs",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-jobs/src/client/JobListAction.module.css.mjs
+		const css = ".QsffPG_root{position:relative}.QsffPG_trigger{min-height:28px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;align-items:center;gap:3px;padding:3px 2px;font-size:12px;line-height:18px;display:inline-flex}.QsffPG_trigger:hover,.QsffPG_trigger:focus-visible{color:var(--dsw-alias-label-secondary)}.QsffPG_trigger svg{transition:transform .12s}.QsffPG_triggerOpen{transform:rotate(180deg)}.QsffPG_triggerDot{flex:none}.QsffPG_count{margin:0 5px}.QsffPG_menu{z-index:100;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-specific-menu);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);width:336px;max-width:min(400px,100vw - 32px);max-height:min(420px,100vh - 140px);box-shadow:var(--dsw-shadow-lv3);border-radius:12px;flex-direction:column;gap:1px;margin:0;padding:4px;list-style:none;display:flex;position:absolute;top:calc(100% + 5px);left:0;overflow:auto}.QsffPG_row{box-sizing:border-box;width:100%;min-height:32px;color:var(--dsw-alias-label-primary);border-radius:8px;align-items:center;gap:8px;padding:6px 8px;font-size:13px;line-height:18px;display:flex}.QsffPG_rowSettled{color:var(--dsw-alias-label-tertiary)}.QsffPG_rowDot{flex:none}.QsffPG_kind{background:var(--dsw-alias-fill-l2);color:var(--dsw-alias-label-secondary);border-radius:5px;flex:none;padding:0 6px;font-size:11px;line-height:18px}.QsffPG_label{min-width:0;font-family:var(--dsw-font-mono);white-space:nowrap;text-overflow:ellipsis;flex:1;overflow:hidden}.QsffPG_status,.QsffPG_duration{color:var(--dsw-alias-label-tertiary);flex:none;font-size:11px;line-height:18px}.QsffPG_status{white-space:nowrap;text-overflow:ellipsis;max-width:40%;overflow:hidden}.QsffPG_duration{font-variant-numeric:tabular-nums}";
+		const tagId = "@deepseek-ai/dsh-client-ui-jobs/JobListAction.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-jobs";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var JobListAction_module_css_default = {
+			"kind": "QsffPG_kind",
+			"root": "QsffPG_root",
+			"triggerDot": "QsffPG_triggerDot",
+			"count": "QsffPG_count",
+			"row": "QsffPG_row",
+			"rowSettled": "QsffPG_rowSettled",
+			"rowDot": "QsffPG_rowDot",
+			"label": "QsffPG_label",
+			"status": "QsffPG_status",
+			"menu": "QsffPG_menu",
+			"duration": "QsffPG_duration",
+			"trigger": "QsffPG_trigger",
+			"triggerOpen": "QsffPG_triggerOpen"
+		};
+		//#endregion
+		//#region lib/types/client/JobListAction.js
+		/** Stable empty list so a session with no jobs keeps one array identity. */
+		const NO_TASKS = [];
+		/** A job the registry still holds open, and whose duration therefore ticks. */
+		function isLive(job) {
+			return job.status === "running" || job.status === "stopping";
+		}
+		/** Closed-union exhaustiveness fence for the wire status set. */
+		/* v8 ignore next 3 -- closed-union backstop; only reached if a status is forged */
+		function assertNever(value) {
+			throw new Error(`unhandled job status: ${JSON.stringify(value)}`);
+		}
+		/**
+		* Status marker semantics. `stopping` and `killed` share the attention color:
+		* both mean the work ended (or is ending) on request rather than on its own.
+		*/
+		function dotState(status) {
+			switch (status) {
+				case "running": return "ongoing";
+				case "stopping": return "warning";
+				case "completed": return "done";
+				case "killed": return "warning";
+				case "failed": return "error";
+				/* v8 ignore next -- closed wire status union */
+				default: return assertNever(status);
+			}
+		}
+		/** Human status word for the row and its accessible name. */
+		function statusLabel(status, t) {
+			switch (status) {
+				case "running": return t("status.running");
+				case "stopping": return t("status.stopping");
+				case "completed": return t("status.completed");
+				case "killed": return t("status.killed");
+				case "failed": return t("status.failed");
+				/* v8 ignore next -- closed wire status union */
+				default: return assertNever(status);
+			}
+		}
+		/**
+		* Elapsed time in at most two adjacent units. A background job that outlives
+		* an hour is already exceptional, so hours is the widest unit — beyond that the
+		* figure stays in hours rather than growing a day/month vocabulary no producer
+		* currently reaches.
+		*/
+		function formatDuration(elapsedMs, t) {
+			const total = Math.max(0, Math.floor(elapsedMs / 1e3));
+			const seconds = total % 60;
+			const minutes = Math.floor(total / 60) % 60;
+			const hours = Math.floor(total / 3600);
+			if (hours > 0) return t("duration.hours", {
+				hours,
+				minutes
+			});
+			if (minutes > 0) return t("duration.minutes", {
+				minutes,
+				seconds
+			});
+			return t("duration.seconds", { seconds });
+		}
+		/**
+		* Live rows first in start order, then settled rows newest-first. Two jobs
+		* that settled in the same millisecond fall back to start order, so the sort
+		* never depends on the host's map iteration.
+		*/
+		function ordered(jobs) {
+			return [...jobs].sort((left, right) => {
+				const liveLeft = isLive(left);
+				if (liveLeft !== isLive(right)) return liveLeft ? -1 : 1;
+				if (liveLeft) return left.startedAt - right.startedAt;
+				const finished = (right.finishedAt ?? right.startedAt) - (left.finishedAt ?? left.startedAt);
+				return finished !== 0 ? finished : left.startedAt - right.startedAt;
+			});
+		}
+		/**
+		* Session-header entry point for this session's background jobs. It renders
+		* nothing at all until the session has at least one job, so an ordinary
+		* conversation never grows a control for a capability it is not using.
+		* @param props - runtime slot currency plus the namespace translator.
+		* @returns the trigger and its popover list, or null when there is nothing to show.
+		*/
+		function JobListAction({ sessionId, useSessions, t }) {
+			const jobs = useSessions((state) => state.jobsBySession[sessionId]) ?? NO_TASKS;
+			const [open, setOpen] = (0, react.useState)(false);
+			const [now, setNow] = (0, react.useState)(() => Date.now());
+			const rootRef = (0, react.useRef)(null);
+			const triggerRef = (0, react.useRef)(null);
+			const rows = (0, react.useMemo)(() => ordered(jobs), [jobs]);
+			const liveCount = (0, react.useMemo)(() => jobs.filter(isLive).length, [jobs]);
+			(0, react.useEffect)(() => {
+				if (!open) return;
+				const closeOutside = (event) => {
+					if (event.target instanceof Node && !rootRef.current?.contains(event.target)) setOpen(false);
+				};
+				document.addEventListener("pointerdown", closeOutside);
+				return () => {
+					document.removeEventListener("pointerdown", closeOutside);
+				};
+			}, [open]);
+			(0, react.useEffect)(() => {
+				if (!open || liveCount === 0) return;
+				setNow(Date.now());
+				const timer = setInterval(() => {
+					setNow(Date.now());
+				}, 1e3);
+				return () => {
+					clearInterval(timer);
+				};
+			}, [open, liveCount]);
+			(0, react.useEffect)(() => {
+				if (jobs.length === 0 && open) setOpen(false);
+			}, [jobs.length, open]);
+			if (jobs.length === 0) return null;
+			const countLabel = t(liveCount > 0 ? liveCount === 1 ? "count.live.one" : "count.live.other" : jobs.length === 1 ? "count.idle.one" : "count.idle.other", { count: liveCount > 0 ? liveCount : jobs.length });
+			const onKeyDown = (event) => {
+				if (event.key !== "Escape" || !open) return;
+				event.preventDefault();
+				setOpen(false);
+				triggerRef.current?.focus();
+			};
+			return (0, react_jsx_runtime.jsxs)("div", {
+				ref: rootRef,
+				className: JobListAction_module_css_default.root,
+				onKeyDown,
+				children: [(0, react_jsx_runtime.jsxs)("button", {
+					ref: triggerRef,
+					type: "button",
+					className: JobListAction_module_css_default.trigger,
+					"aria-expanded": open,
+					"aria-label": countLabel,
+					onClick: () => {
+						setNow(Date.now());
+						setOpen((current) => !current);
+					},
+					children: [
+						liveCount > 0 ? (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, {
+							state: "ongoing",
+							className: JobListAction_module_css_default.triggerDot
+						}) : null,
+						(0, react_jsx_runtime.jsx)("span", {
+							className: JobListAction_module_css_default.count,
+							children: countLabel
+						}),
+						(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { className: open ? JobListAction_module_css_default.triggerOpen : void 0 })
+					]
+				}), open ? (0, react_jsx_runtime.jsx)("ul", {
+					className: JobListAction_module_css_default.menu,
+					"aria-label": t("list.aria"),
+					children: rows.map((job) => {
+						const live = isLive(job);
+						const duration = formatDuration(live ? now - job.startedAt : (job.finishedAt ?? job.startedAt) - job.startedAt, t);
+						const status = statusLabel(job.status, t);
+						return (0, react_jsx_runtime.jsxs)("li", {
+							className: live ? JobListAction_module_css_default.row : `${JobListAction_module_css_default.row} ${JobListAction_module_css_default.rowSettled}`,
+							children: [
+								(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, {
+									state: dotState(job.status),
+									className: JobListAction_module_css_default.rowDot
+								}),
+								(0, react_jsx_runtime.jsx)("span", {
+									className: JobListAction_module_css_default.kind,
+									children: job.kind
+								}),
+								(0, react_jsx_runtime.jsx)("span", {
+									className: JobListAction_module_css_default.label,
+									title: job.label,
+									children: job.label
+								}),
+								(0, react_jsx_runtime.jsx)("span", {
+									className: JobListAction_module_css_default.status,
+									title: job.detail ?? status,
+									children: job.detail ?? status
+								}),
+								(0, react_jsx_runtime.jsx)("span", {
+									className: JobListAction_module_css_default.duration,
+									title: t(live ? "duration.title.live" : "duration.title.done", { duration }),
+									children: duration
+								})
+							]
+						}, job.id);
+					})
+				}) : null]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"count.live.one": "{count} 个后台任务运行中",
+			"count.live.other": "{count} 个后台任务运行中",
+			"count.idle.one": "{count} 个后台任务",
+			"count.idle.other": "{count} 个后台任务",
+			"list.aria": "后台任务",
+			"status.running": "运行中",
+			"status.stopping": "正在停止",
+			"status.completed": "已完成",
+			"status.killed": "已取消",
+			"status.failed": "已失败",
+			"duration.seconds": "{seconds}秒",
+			"duration.minutes": "{minutes}分{seconds}秒",
+			"duration.hours": "{hours}小时{minutes}分",
+			"duration.title.live": "已运行 {duration}",
+			"duration.title.done": "耗时 {duration}"
+		};
+		/** English dictionary, key-identical to the Chinese source of truth. */
+		const en = {
+			"count.live.one": "{count} background job running",
+			"count.live.other": "{count} background jobs running",
+			"count.idle.one": "{count} background job",
+			"count.idle.other": "{count} background jobs",
+			"list.aria": "Background jobs",
+			"status.running": "running",
+			"status.stopping": "stopping",
+			"status.completed": "completed",
+			"status.killed": "cancelled",
+			"status.failed": "failed",
+			"duration.seconds": "{seconds}s",
+			"duration.minutes": "{minutes}m {seconds}s",
+			"duration.hours": "{hours}h {minutes}m",
+			"duration.title.live": "Running for {duration}",
+			"duration.title.done": "Took {duration}"
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Required services for locale registration and header-slot contribution. */
+		const inject = [
+			"sessions",
+			"slots",
+			"locale"
+		];
+		/**
+		* Client plugin body: register the dictionaries and the header action.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register("job", {
+				zh,
+				en
+			}), "ui-job: dictionaries");
+			ctx.slots.inject("conversation.session.header.actions", () => ctx.slots.register({
+				name: "conversation.session.header.actions",
+				id: "job-list",
+				order: 20,
+				locale: "job"
+			}, JobListAction));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* Background-job list plugin, node half. Pure UI plugin: the empty apply
+* exists so the plugin appears in the host cordis.yml / Loader; the browser
+* half ships via exports["./client"], discovered through the package.json
+* dshClient declaration.
+*/
+/** Host plugin body — no host-side behavior for this source plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,25 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-jobs`.
+* @module @deepseek-ai/dsh-client-ui-jobs/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-jobs";
+/** Cordis companion plugin name. */
+const name = "client-ui-jobs-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: this package is a read-only projection of the
+* `jobsBySession` mirror onto one header slot entry. It emits no cordis
+* events, owns no cross-plugin mutable state, and its single slot registration
+* proves disposal through the HMR-safety spec.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,13 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { NS } from './locales.ts';
+/** Full props for the session-header background-job action. */
+export type JobListActionProps = PropsRuntime<'conversation.session.header.actions'> & PropsLocale<typeof NS>;
+/**
+ * Session-header entry point for this session's background jobs. It renders
+ * nothing at all until the session has at least one job, so an ordinary
+ * conversation never grows a control for a capability it is not using.
+ * @param props - runtime slot currency plus the namespace translator.
+ * @returns the trigger and its popover list, or null when there is nothing to show.
+ */
+export declare function JobListAction({ sessionId, useSessions, t }: JobListActionProps): import("react").JSX.Element | null;
+//# sourceMappingURL=JobListAction.d.ts.map

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

@@ -0,0 +1,23 @@
+/**
+ * Background-job plugin, browser half: contributes one session-header action
+ * that renders this session's `ctx.jobs` records. The data arrives entirely
+ * through the `jobsBySession` list mirror, so the plugin issues no RPC and
+ * holds no state of its own beyond popover visibility.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type JobKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Background-job list copy. */
+        'job': JobKey;
+    }
+}
+export type { JobListActionProps } from './JobListAction.tsx';
+/** Required services for locale registration and header-slot contribution. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the dictionaries and the header action.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,26 @@
+/** `job` namespace dictionaries. */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "job";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    readonly 'count.live.one': "{count} 个后台任务运行中";
+    readonly 'count.live.other': "{count} 个后台任务运行中";
+    readonly 'count.idle.one': "{count} 个后台任务";
+    readonly 'count.idle.other': "{count} 个后台任务";
+    readonly 'list.aria': "后台任务";
+    readonly 'status.running': "运行中";
+    readonly 'status.stopping': "正在停止";
+    readonly 'status.completed': "已完成";
+    readonly 'status.killed': "已取消";
+    readonly 'status.failed': "已失败";
+    readonly 'duration.seconds': "{seconds}秒";
+    readonly 'duration.minutes': "{minutes}分{seconds}秒";
+    readonly 'duration.hours': "{hours}小时{minutes}分";
+    readonly 'duration.title.live': "已运行 {duration}";
+    readonly 'duration.title.done': "耗时 {duration}";
+};
+/** English dictionary, key-identical to the Chinese source of truth. */
+export declare const en: Record<JobKey, string>;
+/** Key domain of the `job` namespace (zh is the source of truth). */
+export type JobKey = keyof typeof zh;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Background-job list plugin, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * dshClient declaration.
+ */
+/** Host plugin body — no host-side behavior for this source plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-jobs`.
+ * @module @deepseek-ai/dsh-client-ui-jobs/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-jobs-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@deepseek-ai/dsh-client-ui-jobs",
+  "description": "Session-header background-job list: live registry state mirrored from session/jobs frames",
+  "version": "0.0.1-rc.3",
+  "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"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "BSD-3-Clause",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-jobs"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "dependencies": {
+    "react": "^18.2.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.3",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}