@qilin-agent/client-ui-settings-unarchive-sessions 0.0.0-stage → 3.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kkutysllb
+
+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,52 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/client/ui-settings-unarchive-sessions/README.md
+/:
+  en: cf17e23609461ff5
+  zh: d9bf8dec044aec4b
+/qilin-agent-client-ui-settings-unarchive-sessions:
+  en: 825d1923cf600d31
+  zh: b7279c8f3adb8d63
+/qilin-agent-client-ui-settings-unarchive-sessions/summary:
+  en: 8c95a9f635f0482e
+  zh: 93c557a88f421637
+/qilin-agent-client-ui-settings-unarchive-sessions/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 09388d293f9be9cb
+/qilin-agent-client-ui-settings-unarchive-sessions/use-this-package:
+  en: cc804295d917d25d
+  zh: 7080fa8e0bac79f5
+/qilin-agent-client-ui-settings-unarchive-sessions/use-this-package/reading-a-row:
+  en: 5445c5c721b8db17
+  zh: 167ccf94c562ec95
+/qilin-agent-client-ui-settings-unarchive-sessions/use-this-package/restoring-a-session:
+  en: 00960eb756b7e659
+  zh: edcd2d869ec61f49
+/qilin-agent-client-ui-settings-unarchive-sessions/understand-the-implementation:
+  en: 3f8be000388c56e3
+  zh: 30edbe6915f5198c
+/qilin-agent-client-ui-settings-unarchive-sessions/understand-the-implementation/registration-and-data-sources:
+  en: 797fe2512150ef8f
+  zh: 26c26ebebd288527
+/qilin-agent-client-ui-settings-unarchive-sessions/understand-the-implementation/row-derivation:
+  en: b1085dd5b11f6493
+  zh: 7ab004a94b29f34c
+/qilin-agent-client-ui-settings-unarchive-sessions/understand-the-implementation/source-map:
+  en: 282c196c6771ed5b
+  zh: 44c0795cfb20100d
+/qilin-agent-client-ui-settings-unarchive-sessions/further-exploration:
+  en: 912d4348dff075c6
+  zh: 31cd0904b3f2f07a
+/qilin-agent-client-ui-settings-unarchive-sessions/model-experience:
+  en: 3120df665299c634
+  zh: 1d9f365d091d0d2a
+/qilin-agent-client-ui-settings-unarchive-sessions/model-experience/kv-cache-effect:
+  en: ca75c51c89c2c9b0
+  zh: de54f3467ef3b9be
+/qilin-agent-client-ui-settings-unarchive-sessions/known-limitations-and-deferred-work:
+  en: a5e85bc8f04a6f95
+  zh: 096b2fb4c52e4e43
+/qilin-agent-client-ui-settings-unarchive-sessions/known-limitations-and-deferred-work/dev-note:
+  en: e67f633dc6fe7773
+  zh: 3bb0c20c93f16f98

package/README.md

@@ -1,3 +1,110 @@
-# Temporary Holding Version
+---
+description: "Archived-session Settings page for the qilin web client: the registry-global archive set as a searchable list with one Unarchive action per row."
+kind: "package-reference"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @qilin-agent/client-ui-settings-unarchive-sessions
+
+English | [中文](README.zh.md)
+
+## Summary
+
+The **Archived sessions** Settings page is the restore point for sessions hidden from Workspace navigation. It lists each archived session with the Workspace that owns it and its last activity, newest archive first, and offers one Unarchive action per row. A search box filters the list by session title or Workspace name. Rows come from the archive set joined with the loaded Session summaries, so an archive entry whose session record is gone has no row and no action. Every restore goes through the shared Workspace command.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Further Exploration](#further-exploration)
+- [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
+
+Open Settings and select **Archived sessions** to see the sessions currently hidden from every grouping surface. Mount `@qilin-agent/client-ui-settings-unarchive-sessions` in a Web composition that already provides the settings shell, the Workspace service, and the Session list; the page registers its own navigation entry and needs no configuration.
+
+### Reading a row
+
+Each row shows the session's display title, the title of the Workspace that accounts for it or the ungrouped label, and its last activity as a compact relative time. The page lists the most recently archived session first, the reverse of the durable archive order. The page waits for the Session list before rendering rows; while that list loads it shows a reading status instead of an empty archive. An empty archive, an archive whose entries have no loaded Session to restore, and a query matching no row report three different messages, so neither a search nor an unaddressable entry ever looks like an empty archive.
+
+### Restoring a session
+
+Unarchive restores the session to its recorded position under its Workspace, or to the ungrouped sessions when it belongs to none, and the row disappears from the page. The action calls `ctx.uiWorkspace.unarchiveSession`, whose echoed archive set updates every surface that filters on it, so the session reappears in the sidebar and search as well. A rejected call is logged as a console diagnostic and leaves the row in place for another attempt.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Implementation internals — click to expand</summary>
+
+The page is one localized `settings.section` contribution with id `archived-sessions`; the Settings shell owns the navigation entry, the modal, and the mounted section, so none of that chrome lives here.
+
+### Registration and data sources
+
+`apply()` registers the locale namespace, binds it, and uses `ctx.slots.inject()` to contribute the section, so a late or restored slot declaration still reaches it. The page reads `state.archivedSessionIds` and `state.items` from `useWorkspaces` and the Session summaries from `useSessions`; it owns no store and no transport, and its only write is the injected `unarchive` callback that the registration closes over `ctx.uiWorkspace.unarchiveSession`.
+
+### Row derivation
+
+Rows are derived from the archive set joined with the loaded summaries: a member with no summary produces no row, which is why a session deleted outside the Workspace registry leaves no unarchive action behind. Workspace ownership is read from each Workspace's `sessionIds`; a member outside every Workspace renders with the ungrouped label. Search normalizes the query once and matches it against the row title and Workspace label.
+
+### Source map
+
+| File | Role |
+|---|---|
+| [`src/index.ts`](src/index.ts) | Host loader entry: the page is browser-only, so the plugin body is empty |
+| [`src/client/index.ts`](src/client/index.ts) | Browser plugin: locale namespace, section registration, injected Unarchive operation |
+| [`src/client/ArchivedSessionsSection.tsx`](src/client/ArchivedSessionsSection.tsx) | The page component: row derivation, search, per-row Unarchive |
+| [`src/client/locales.ts`](src/client/locales.ts) | Chinese and English dictionaries for every visible and accessible string |
+| [`src/client/ArchivedSessionsSection.module.css`](src/client/ArchivedSessionsSection.module.css) | Page styles |
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+These pages cover the settings surface that hosts the page, the archive write behind it, and the state it renders.
+
+- [ui-settings](../ui-settings/README.md) — the domain base declaring `settings.section` and the namespace scope service.
+- [ui-settings-general](../ui-settings-general/README.md) — the Settings shell that renders the navigation and mounts the section.
+- [ui-workspace](../ui-workspace/README.md) — the sidebar browser whose Session rows archive, and the `ctx.uiWorkspace` service this page restores through.
+- [Workspace Controller](../../api/workspace-controller/README.md) — the `workspace.unarchiveSession` Remote and the Client model that owns the archive set.
+- [Workspace subsystem](../../../docs/subsystems/workspace.md) — the durable archive set, its domain field, and the registry operation behind a restore.
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+None, as the package is a browser-side UI plugin layer that registers nothing model-facing.
+
+#### KV Cache effect
+
+None; this package neither assembles nor sends a provider request.
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+
+These limits define which archived sessions this page can restore; they are current package constraints.
+
+- **Archived sessions without a loaded summary are unaddressable** — the page derives its rows by joining the archive set with the Session list, so a member the list does not carry has no row and no Unarchive action even though the archive set still holds it; a set whose members are all in that state reports itself as unrestorable rather than empty.
+- **The page lists sessions only; it offers no session deletion** — archives are reversible through this page, while deleting a session record remains a separate capability.
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,110 @@
+---
+description: "qilin Web 客户端的已归档会话设置页：把注册表全局归档集合呈现为可搜索列表，每行提供一个取消归档操作。"
+kind: "package-reference"
+---
+
+# @qilin-agent/client-ui-settings-unarchive-sessions
+
+[English](README.md) | 中文
+
+## 概述
+
+**已归档会话**设置页是从 Workspace 导航中隐藏的会话的恢复入口。它按归档时间由新到旧列出每个已归档会话，并显示其所属 Workspace 与最近活动时间，每行提供一个取消归档操作。搜索框按会话标题或 Workspace 名称过滤列表。行由归档集合与已加载的 Session 摘要合并而来，因此会话记录已不存在的归档条目既没有行也没有操作。每次恢复都经由共享的 Workspace 命令。
+
+## 目录
+
+- [使用本包](#use-this-package)
+- [理解实现](#understand-the-implementation)
+- [进一步探索](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制与延期工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用本包
+
+打开设置并选择**已归档会话**，即可看到当前从所有分组视图中隐藏的会话。在已提供设置外壳、Workspace 服务与 Session 列表的 Web 组合中挂载 `@qilin-agent/client-ui-settings-unarchive-sessions`；该页面注册自己的导航条目，无需配置。
+
+### 阅读一行
+
+每行显示会话的显示标题、为其记账的 Workspace 标题或未分组标签，以及以紧凑相对时间表示的最近活动。页面把最近归档的会话排在前面，与持久归档顺序相反。页面会先等待 Session 列表再渲染行；列表加载期间显示读取状态，而不是空归档。空归档、归档条目均无已加载 Session 可恢复、以及查询无匹配分别给出三种提示，因此搜索和不可寻址的条目都不会被误认为归档为空。
+
+### 恢复会话
+
+取消归档会把会话恢复到其 Workspace 下记录的位置；会话不属于任何 Workspace 时则恢复到未分组会话中，该行随即从页面消失。该操作调用 `ctx.uiWorkspace.unarchiveSession`，其回传的完整归档集合会更新所有依据它过滤的界面，因此会话也会重新出现在侧边栏与搜索中。调用被拒绝时会记录一条 console 诊断，并保留该行以便再次尝试。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 理解实现
+
+<details>
+<summary>实现细节——点击展开</summary>
+
+页面是 id 为 `archived-sessions` 的一个本地化 `settings.section` 贡献；导航条目、模态框与挂载的分区都归设置外壳所有，不在此包内。
+
+### 注册与数据来源
+
+`apply()` 注册并绑定 locale namespace，再用 `ctx.slots.inject()` 贡献该分区，因此延迟声明或恢复声明的 slot 依然能触达它。页面从 `useWorkspaces` 读取 `state.archivedSessionIds` 与 `state.items`，从 `useSessions` 读取 Session 摘要；它不持有 store 也不持有 transport，唯一的写入是注册处以 `ctx.uiWorkspace.unarchiveSession` 闭包注入的 `unarchive` 回调。
+
+### 行的派生
+
+行由归档集合与已加载摘要合并派生：没有摘要的成员不产生行，因此在 Workspace 注册表之外被删除的会话不会留下取消归档操作。Workspace 归属从各 Workspace 的 `sessionIds` 读取；不属于任何 Workspace 的成员以未分组标签渲染。搜索只规范化一次查询，并与行标题和 Workspace 标签匹配。
+
+### 源码地图
+
+| 文件 | 职责 |
+|---|---|
+| [`src/index.ts`](src/index.ts) | 宿主 loader 入口：该页面仅供浏览器使用，因此插件体为空 |
+| [`src/client/index.ts`](src/client/index.ts) | 浏览器插件：locale namespace、分区注册、注入的取消归档操作 |
+| [`src/client/ArchivedSessionsSection.tsx`](src/client/ArchivedSessionsSection.tsx) | 页面组件：行的派生、搜索、每行的取消归档 |
+| [`src/client/locales.ts`](src/client/locales.ts) | 全部可见与无障碍字符串的中英文字典 |
+| [`src/client/ArchivedSessionsSection.module.css`](src/client/ArchivedSessionsSection.module.css) | 页面样式 |
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 进一步探索
+
+以下页面覆盖承载该页面的设置界面、其背后的归档写入，以及它所渲染的状态。
+
+- [ui-settings](../ui-settings/README.zh.md)——声明 `settings.section` 与 namespace scope 服务的领域底座。
+- [ui-settings-general](../ui-settings-general/README.zh.md)——渲染导航并挂载该分区的设置外壳。
+- [ui-workspace](../ui-workspace/README.zh.md)——其 Session 行负责归档的侧边栏浏览器，以及本页面借以恢复的 `ctx.uiWorkspace` 服务。
+- [Workspace Controller](../../api/workspace-controller/README.zh.md)——`workspace.unarchiveSession` Remote 与持有归档集合的 Client model。
+- [Workspace 子系统](../../../docs/subsystems/workspace.zh.md)——持久归档集合、其领域字段，以及恢复背后的注册表操作。
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+无。该包是浏览器端 UI 插件层，不注册任何面向模型的内容。
+
+#### KV Cache 影响
+
+无；该包既不组装也不发送提供方请求。
+
+## 已知限制与延期工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+
+这些限制界定本页面能够恢复哪些已归档会话；它们是当前包约束。
+
+- **已加载摘要缺失的已归档会话无法寻址**：页面通过与 Session 列表合并来派生行，因此列表未携带的成员没有行也没有取消归档操作，尽管归档集合仍持有它；当集合中的成员全部处于该状态时，页面报告无法恢复，而不是报告归档为空。
+- **页面只列出会话，不提供会话删除**：归档可通过本页面恢复，而删除会话记录仍是彼此独立的能力。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者的工作上下文——点击展开</summary>
+
+无。
+
+</details>

package/lib/client.js

@@ -0,0 +1,216 @@
+window.__ModuleLoader__.load({
+	id: "@qilin-agent/client-ui-settings-unarchive-sessions",
+	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 _qilin_agent_client_ui_primitives = require("@qilin-agent/client-ui-primitives");
+		//#region \0qilin-css:/home/runner/work/QiLin/QiLin/packages/client/ui-settings-unarchive-sessions/src/client/ArchivedSessionsSection.module.css.mjs
+		const css = ".qzV--q_section{width:100%;max-width:760px;color:var(--qilin-alias-label-primary);flex-direction:column;gap:12px;display:flex}.qzV--q_status{color:var(--qilin-alias-label-tertiary);margin:0;font-size:13px;line-height:20px}.qzV--q_search{width:100%;color:var(--qilin-alias-label-tertiary);align-items:center;display:flex;position:relative}.qzV--q_search>svg{pointer-events:none;position:absolute;left:12px}.qzV--q_search input{border:.5px solid var(--qilin-alias-border-l2);background:var(--qilin-alias-bg-base);width:100%;height:32px;color:var(--qilin-alias-label-primary);font:inherit;border-radius:8px;padding:0 12px 0 36px}.qzV--q_list{flex-direction:column;gap:2px;margin:0;padding:0;list-style:none;display:flex}.qzV--q_row{border-radius:8px;align-items:center;gap:12px;padding:8px 10px;display:flex}.qzV--q_row:hover{background:var(--qilin-alias-bg-layer-1)}.qzV--q_identity{flex-direction:column;flex:1;gap:2px;min-width:0;display:flex}.qzV--q_title{text-overflow:ellipsis;white-space:nowrap;font-size:13px;line-height:20px;overflow:hidden}.qzV--q_meta{color:var(--qilin-alias-label-tertiary);font-size:12px;line-height:18px}";
+		const tagId = "@qilin-agent/client-ui-settings-unarchive-sessions/ArchivedSessionsSection.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@qilin-agent/client-ui-settings-unarchive-sessions";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var ArchivedSessionsSection_module_css_default = {
+			"identity": "qzV--q_identity",
+			"list": "qzV--q_list",
+			"meta": "qzV--q_meta",
+			"row": "qzV--q_row",
+			"search": "qzV--q_search",
+			"section": "qzV--q_section",
+			"status": "qzV--q_status",
+			"title": "qzV--q_title"
+		};
+		//#endregion
+		//#region lib/types/client/ArchivedSessionsSection.js
+		/**
+		* Archived-session Settings page: the registry-global archive set joined with
+		* the loaded Session summaries, newest archive first, filtered by one search
+		* box, with one Unarchive action per row. An archive entry whose Session is
+		* gone has no row and no action; the set itself stays host-owned.
+		*/
+		/** Localized compact relative time of one row's last activity. */
+		function timeLabel(updatedAt, now, t) {
+			const { unit, n } = (0, _qilin_agent_client_ui_primitives.relativeTime)(updatedAt, now);
+			return unit === "now" ? t("time.now") : t(`time.${unit}`, { n });
+		}
+		/** Whether one row matches the normalized query in its title or Workspace label. */
+		function matches(row, normalizedQuery) {
+			return normalizedQuery.length === 0 || row.title.toLowerCase().includes(normalizedQuery) || row.workspace.toLowerCase().includes(normalizedQuery);
+		}
+		/**
+		* Render the archived-session page.
+		* @param props - composed slot props (see {@link ArchivedSessionsSectionProps}).
+		* @returns the settings page element tree.
+		*/
+		function ArchivedSessionsSection(props) {
+			const { t, unarchive, useSessions, useWorkspaces } = props;
+			const sessions = useSessions((state) => state);
+			const workspaces = useWorkspaces((state) => state.items);
+			const archivedSessionIds = useWorkspaces((state) => state.archivedSessionIds);
+			const [query, setQuery] = (0, react.useState)("");
+			const ungrouped = t("ungrouped");
+			const summaries = sessions.byId;
+			const rows = (0, react.useMemo)(() => {
+				const owners = /* @__PURE__ */ new Map();
+				for (const workspace of workspaces) for (const id of workspace.sessionIds) owners.set(id, workspace.title);
+				return [...archivedSessionIds].reverse().flatMap((id) => {
+					const summary = summaries[id];
+					if (summary === void 0) return [];
+					return [{
+						id,
+						title: summary.displayTitle,
+						workspace: owners.get(id) ?? ungrouped,
+						updatedAt: summary.updatedAt
+					}];
+				});
+			}, [
+				archivedSessionIds,
+				workspaces,
+				summaries,
+				ungrouped
+			]);
+			if (sessions.phase !== "ready") return (0, react_jsx_runtime.jsx)("p", {
+				className: ArchivedSessionsSection_module_css_default.status,
+				children: t("loading")
+			});
+			const now = Date.now();
+			const visible = rows.filter((row) => matches(row, query.trim().toLowerCase()));
+			const archived = archivedSessionIds.length > 0;
+			return (0, react_jsx_runtime.jsxs)("div", {
+				className: ArchivedSessionsSection_module_css_default.section,
+				children: [
+					(0, react_jsx_runtime.jsxs)("div", {
+						className: ArchivedSessionsSection_module_css_default.search,
+						children: [(0, react_jsx_runtime.jsx)(_qilin_agent_client_ui_primitives.IconSearchOutline16, { "aria-hidden": "true" }), (0, react_jsx_runtime.jsx)("input", {
+							type: "search",
+							value: query,
+							placeholder: t("search"),
+							"aria-label": t("search"),
+							onChange: (event) => {
+								setQuery(event.currentTarget.value);
+							}
+						})]
+					}),
+					!archived ? (0, react_jsx_runtime.jsx)("p", {
+						className: ArchivedSessionsSection_module_css_default.status,
+						children: t("empty")
+					}) : null,
+					archived && rows.length === 0 ? (0, react_jsx_runtime.jsx)("p", {
+						className: ArchivedSessionsSection_module_css_default.status,
+						children: t("unavailable")
+					}) : null,
+					rows.length > 0 && visible.length === 0 ? (0, react_jsx_runtime.jsx)("p", {
+						className: ArchivedSessionsSection_module_css_default.status,
+						children: t("emptySearch")
+					}) : null,
+					visible.length > 0 ? (0, react_jsx_runtime.jsx)("ul", {
+						className: ArchivedSessionsSection_module_css_default.list,
+						children: visible.map((row) => (0, react_jsx_runtime.jsxs)("li", {
+							className: ArchivedSessionsSection_module_css_default.row,
+							children: [(0, react_jsx_runtime.jsxs)("span", {
+								className: ArchivedSessionsSection_module_css_default.identity,
+								children: [(0, react_jsx_runtime.jsx)("span", {
+									className: ArchivedSessionsSection_module_css_default.title,
+									children: row.title
+								}), (0, react_jsx_runtime.jsx)("span", {
+									className: ArchivedSessionsSection_module_css_default.meta,
+									children: [row.workspace, timeLabel(row.updatedAt, now, t)].join(" · ")
+								})]
+							}), (0, react_jsx_runtime.jsx)(_qilin_agent_client_ui_primitives.Button, {
+								variant: "outline",
+								size: "sm",
+								"aria-label": t("unarchiveNamed", { title: row.title }),
+								onClick: () => {
+									unarchive(row.id).catch((reason) => {
+										console.warn("session unarchive rejected:", reason);
+									});
+								},
+								children: t("unarchive")
+							})]
+						}, row.id))
+					}) : null
+				]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** Copy dictionaries for the archived-session Settings page. */
+		/** Simplified Chinese dictionary and key source of truth. */
+		const zh = {
+			nav: "已归档会话",
+			search: "搜索已归档会话",
+			loading: "正在读取会话…",
+			empty: "暂无已归档会话。",
+			unavailable: "这里没有可恢复的已归档会话。",
+			emptySearch: "没有匹配的会话。",
+			unarchive: "取消归档",
+			unarchiveNamed: "取消归档 {title}",
+			ungrouped: "未分组",
+			"time.now": "刚刚",
+			"time.minutes": "{n}分钟",
+			"time.hours": "{n}小时",
+			"time.days": "{n}天",
+			"time.months": "{n}个月",
+			"time.years": "{n}年"
+		};
+		/** English dictionary checked against the Chinese key set. */
+		const en = {
+			nav: "Archived sessions",
+			search: "Search archived sessions",
+			loading: "Reading sessions…",
+			empty: "No archived sessions.",
+			unavailable: "No archived session here can be restored.",
+			emptySearch: "No matching sessions.",
+			unarchive: "Unarchive",
+			unarchiveNamed: "Unarchive {title}",
+			ungrouped: "Ungrouped",
+			"time.now": "now",
+			"time.minutes": "{n}min",
+			"time.hours": "{n}h",
+			"time.days": "{n}d",
+			"time.months": "{n}mo",
+			"time.years": "{n}y"
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Archived-session Settings page, browser half. */
+		/** Dictionary namespace owned by this plugin. */
+		const NS = "settings.archivedSessions";
+		/** Services required by the Settings registration and the archive write. */
+		const inject = [
+			"slots",
+			"locale",
+			"uiWorkspace"
+		];
+		/** Contribute the archived-session page to Settings. */
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-settings-unarchive-sessions: dictionaries");
+			const t = ctx.locale.bind(NS);
+			const injected = () => ({ unarchive: (sessionId) => ctx.uiWorkspace.unarchiveSession(sessionId) });
+			ctx.slots.inject("settings.section", () => ctx.slots.register({
+				name: "settings.section",
+				id: "archived-sessions",
+				order: 25,
+				label: () => t("nav"),
+				locale: NS,
+				inject: injected
+			}, ArchivedSessionsSection));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,6 @@
+//#region lib/types/index.js
+/** Host loader entry for the archived-session page exported from `./client`. */
+/** Host plugin body — the archived-session page is browser-only. */
+function apply() {}
+//#endregion
+export { apply };

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

@@ -0,0 +1,26 @@
+/**
+ * Archived-session Settings page: the registry-global archive set joined with
+ * the loaded Session summaries, newest archive first, filtered by one search
+ * box, with one Unarchive action per row. An archive entry whose Session is
+ * gone has no row and no action; the set itself stays host-owned.
+ */
+import { type ReactNode } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import type { SessionId } from '@qilin-agent/session/types';
+/** Registration-side face used by the page. */
+export interface ArchivedSessionsSectionInjected {
+    /**
+     * Restore one archived Session.
+     * @param sessionId - Session to unarchive.
+     */
+    unarchive: (sessionId: SessionId) => Promise<void>;
+}
+/** Full component props assembled by the Settings slot renderer. */
+export type ArchivedSessionsSectionProps = PropsRuntime<'settings.section'> & PropsLocale<'settings.archivedSessions'> & InjectFace<ArchivedSessionsSectionInjected>;
+/**
+ * Render the archived-session page.
+ * @param props - composed slot props (see {@link ArchivedSessionsSectionProps}).
+ * @returns the settings page element tree.
+ */
+export declare function ArchivedSessionsSection(props: ArchivedSessionsSectionProps): ReactNode;
+//# sourceMappingURL=ArchivedSessionsSection.d.ts.map

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

@@ -0,0 +1,16 @@
+/** Archived-session Settings page, browser half. */
+import type { Context as ClientContext } from '@qilin-agent/kylin';
+import { type ArchivedSessionsLocaleKey } from './locales.ts';
+export type { ArchivedSessionsSectionInjected, ArchivedSessionsSectionProps } from './ArchivedSessionsSection.tsx';
+export type { ArchivedSessionsLocaleKey } from './locales.ts';
+declare module '@qilin-agent/client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Archived-session page copy. */
+        'settings.archivedSessions': ArchivedSessionsLocaleKey;
+    }
+}
+/** Services required by the Settings registration and the archive write. */
+export declare const inject: string[];
+/** Contribute the archived-session page to Settings. */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,40 @@
+/** Copy dictionaries for the archived-session Settings page. */
+/** Simplified Chinese dictionary and key source of truth. */
+export declare const zh: {
+    nav: string;
+    search: string;
+    loading: string;
+    empty: string;
+    unavailable: string;
+    emptySearch: string;
+    unarchive: string;
+    unarchiveNamed: string;
+    ungrouped: string;
+    'time.now': string;
+    'time.minutes': string;
+    'time.hours': string;
+    'time.days': string;
+    'time.months': string;
+    'time.years': string;
+};
+/** Archived-session page locale key union. */
+export type ArchivedSessionsLocaleKey = keyof typeof zh;
+/** English dictionary checked against the Chinese key set. */
+export declare const en: {
+    nav: string;
+    search: string;
+    loading: string;
+    empty: string;
+    unavailable: string;
+    emptySearch: string;
+    unarchive: string;
+    unarchiveNamed: string;
+    ungrouped: string;
+    'time.now': string;
+    'time.minutes': string;
+    'time.hours': string;
+    'time.days': string;
+    'time.months': string;
+    'time.years': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,4 @@
+/** Host loader entry for the archived-session page exported from `./client`. */
+/** Host plugin body — the archived-session page is browser-only. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,74 @@
 {
   "name": "@qilin-agent/client-ui-settings-unarchive-sessions",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Archived-session settings page: the registry-global archive set with one Unarchive action per row",
+  "version": "3.1.4",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkutysllb/QiLin.git",
+    "directory": "packages/client/ui-settings-unarchive-sessions"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "qilin": {
+    "client": {
+      "inject": [
+        "@qilin-agent/client-locale",
+        "@qilin-agent/client-ui-renderer",
+        "@qilin-agent/client-ui-session",
+        "@qilin-agent/client-ui-settings",
+        "@qilin-agent/client-ui-workspace"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@qilin-agent/kylin": "~4.0.3"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@qilin-agent/kylin": "~4.0.3",
+    "@qilin-agent/api-session-controller": "3.1.4",
+    "@qilin-agent/client-locale": "3.1.4",
+    "@qilin-agent/client-ui-primitives": "3.1.4",
+    "@qilin-agent/client-test-runtime": "3.1.4",
+    "@qilin-agent/api-workspace-controller": "3.1.4",
+    "@qilin-agent/client-ui-settings": "3.1.4",
+    "@qilin-agent/client-ui-session": "3.1.4",
+    "@qilin-agent/client-ui-slots": "3.1.4",
+    "@qilin-agent/client-ui-workspace": "3.1.4",
+    "@qilin-agent/session": "3.1.4",
+    "@qilin-agent/client-ui-renderer": "3.1.4"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
 }