dsh-plugin-shop 0.8.7 → 0.9.0-beta.2

package/lib/index.js

@@ -3983,6 +3983,30 @@ async function appBootFacts(dshDir) {
 		peerCheck: peerCheckOf(exported, appBootDir)
 	};
 }
+/** `value` when it is a non-null object, else null. */
+const objectOrNull = (value) => typeof value === "object" && value !== null ? value : null;
+/**
+* The list a refusal names, read off one answer of dsh's compatibility check
+* or of its plugin manager, under whichever name the dsh that gave the answer
+* uses: `requirements` from 0.2.1, `peers` from 0.1.7 to 0.2.0. app-boot's
+* `evaluatePluginCompatibility` and dsh-plugin-manager's `IncompatiblePlugin`
+* were renamed together (design 2026-10-19-dsh-021-readiness, section 4, read
+* off 0.2.1-rc.2's own types and code on 2026-10-19). A key is a dsh peer's
+* package name or the literal `engines.dsh`; a value is the range the package
+* declared.
+*
+* `requirements` is read first, and only when it holds an object: an answer
+* whose `requirements` is anything else is not in the newer shape, so its
+* `peers` is tried. Only the entries whose range is a string are kept, as
+* `incompatibleList` always kept them, so one malformed range costs its own
+* entry and not the rest of the list. An answer naming neither reads as an
+* empty list, never as a throw.
+*/
+function refusedRequirements(answer) {
+	const list = objectOrNull(answer.requirements) ?? objectOrNull(answer.peers);
+	if (list === null) return {};
+	return Object.fromEntries(Object.entries(list).filter((pair) => typeof pair[1] === "string"));
+}
 /**
 * The peer check an app-boot exports, bound to its own version (see
 * `PeerCheck.evaluate`), or null when it exports only part of one — a rule
@@ -3990,6 +4014,10 @@ async function appBootFacts(dshDir) {
 * or when its manifest carries no version, which is the one `evaluate`
 * judges by. Never throws, so a check that cannot be formed costs the
 * templates and the patch-list answer nothing.
+*
+* What `evaluate` hands back is app-boot's answer with the shop's own `peers`
+* filled from whichever name the list came under (`refusedRequirements`), so
+* a dsh that renames it again costs this function and nothing past it.
 */
 function peerCheckOf(exported, appBootDir) {
 	const { evaluatePluginCompatibility: evaluate, readProfileVersionExemptions: exemptions } = exported;
@@ -4004,7 +4032,14 @@ function peerCheckOf(exported, appBootDir) {
 	const runtime = version;
 	const judge = evaluate;
 	return {
-		evaluate: (manifest, profileExemptions) => judge(manifest, profileExemptions, runtime),
+		evaluate: (manifest, profileExemptions) => {
+			const answer = judge(manifest, profileExemptions, runtime);
+			if (answer === void 0 || answer === null) return void 0;
+			return {
+				...answer,
+				peers: refusedRequirements(answer)
+			};
+		},
 		exemptions
 	};
 }
@@ -4092,7 +4127,7 @@ function incompatibleList(value) {
 			name,
 			version,
 			runtimeVersion,
-			peers: Object.fromEntries(Object.entries(record(entry.peers)).filter((pair) => typeof pair[1] === "string"))
+			peers: refusedRequirements(entry)
 		}];
 	});
 }
@@ -4228,7 +4263,8 @@ const CODE_SENTENCE = {
 	"stale-approval": "a build approval names a package pnpm no longer holds",
 	"management-required": "the plugin belongs to dsh itself",
 	unaddressable: "the plugin is not a row of the profile's own patch, so dsh cannot address it",
-	"operation-error": "dsh hit an unexpected error"
+	"operation-error": "dsh hit an unexpected error",
+	"already-installed": "this dsh updates no installed package in place: uninstall it, then install it again"
 };
 /** What each classified pnpm failure was, as dsh classifies it. */
 const KIND_SENTENCE = {
@@ -4568,6 +4604,90 @@ function startManagerOperation(options) {
 		finished
 	};
 }
+/**
+* `first`, continued by the record `next` starts when `first` ends refused,
+* as one record under `first`'s id: design 2026-10-19-dsh-021-readiness,
+* section 2. dsh-plugin-manager 0.2.1-rc.2 refuses an update in place as
+* `already-installed`, and the gateway continues such an update through
+* dsh's CLI. One record, so the client keeps polling the id it was given,
+* and the restart gate and eviction, which read every tracked record, see
+* the command that runs.
+*
+* While `first` runs, this is `first`. Whether it continues is decided once,
+* when `first` ends: the first `status()` read or `first.finished` settling
+* that sees `first` terminal asks `refused`, and that answer is kept. So a
+* caller may set its flag while reading the answer that ends `first`, and a
+* flag flipped after that changes neither `status()` nor `finished`, which
+* answer from that one decision. Not refused, this stays `first`. Refused,
+* `next` runs, exactly once, at that same read or finish, so no read between
+* the refusal and the next command reports the refusal. From then on the
+* record is `next`'s, its state, detail and activation, with `first`'s log,
+* then `bridge`, then `next`'s log. That log joins two bounded logs and the
+* bridge, so a continued record can carry about twice `MAX_LOG_LINES` and
+* `MAX_LOG_BYTES`, where one record of `startManagerOperation` carries at most
+* one line over them.
+*/
+function continueAfter(first, refused, next, bridge) {
+	let begun = false;
+	/** Whether `first` ended refused: `refused`'s answer, asked once, by the
+	* first read or finish that sees `first` terminal. */
+	let refusal;
+	/** The log `first` ended on, and the record carrying on from it: what
+	* `next` returned, or the failure it threw. */
+	let continued;
+	const behind = (head, tail) => ({
+		...tail,
+		log: [
+			...head,
+			bridge,
+			...tail.log
+		]
+	});
+	const status = () => {
+		if (continued !== void 0) return behind(continued.head, continued.running.status());
+		if (begun) return {
+			state: "running",
+			log: [...first.status().log, bridge]
+		};
+		const own = first.status();
+		if (!isTerminalInstallState(own.state)) return own;
+		refusal ??= refused();
+		if (!refusal) return own;
+		begun = true;
+		let running;
+		try {
+			running = next();
+		} catch (error) {
+			const failed = {
+				state: "failed",
+				log: [],
+				detail: `dsh-plugin-shop: ${messageOf(error)}`
+			};
+			running = {
+				installId: first.installId,
+				status: () => failed,
+				finished: Promise.resolve(failed)
+			};
+		}
+		continued = {
+			head: own.log,
+			running
+		};
+		return behind(own.log, running.status());
+	};
+	const finished = first.finished.then(async (own) => {
+		status();
+		const now = continued;
+		if (now === void 0) return own;
+		return behind(now.head, await now.running.finished);
+	});
+	finished.catch(() => {});
+	return {
+		installId: first.installId,
+		status,
+		finished
+	};
+}
 //#endregion
 //#region src/host/index.ts
 /** ShopGateway: the Host half of dsh-plugin-shop (§5.1). */
@@ -4618,10 +4738,11 @@ var __esDecorate = function(ctor, descriptorIn, decorators, contextIn, initializ
 * WHY a restart is impossible. They did: `version()` reported a boolean that
 * covered two of the refusals, the client had one string for that boolean, and
 * that string named systemd — so a Windows user was told to restart a systemd
-* service and to set an override that the platform check, being the first gate
-* of the three, could never reach. */
+* service and to set an override that the platform check, being checked ahead
+* of the systemd one, could never reach. */
 const RESTART_BLOCKED_DETAIL = {
 	desktop: "dsh-plugin-shop: the desktop profile is managed by the DeepSeek Harness desktop app, and dsh refuses to restart it from here; restart the app to apply the change",
+	"from-default-profile": "dsh-plugin-shop: restart is not supported when dsh was launched with --from-default-profile; from dsh 0.2.1 a restart would recreate the profile from its template and delete every plugin installed in it, this shop included. Restart dsh manually without that flag to apply the change",
 	windows: "dsh-plugin-shop: restart is not supported on Windows yet; restart dsh manually to apply the change",
 	systemd: "dsh-plugin-shop: restart is disabled because this process is a systemd service — a restart would kill the takeover helper along with the unit, and the service would not come back. Set allowRestart: true in the shop row config to override.",
 	"port-zero": "dsh-plugin-shop: restart is not supported when dsh was launched with --port 0; restart dsh manually"
@@ -4640,6 +4761,14 @@ const DESKTOP_PROFILE_DETAIL = "dsh-plugin-shop: the desktop profile is managed
 * CLI path's switch, and switching a deselected package off) is not
 * refused. */
 const switchWhileBusyDetail = (name) => `dsh-plugin-shop: an install, update or uninstall is still running in this profile, and dsh holds the profile until it ends; switch ${name} after it finishes.`;
+/** The line a record gains when dsh's plugin manager refuses an update in
+* place and the shop continues it through dsh's CLI (design
+* 2026-10-19-dsh-021-readiness §2): what dsh refused, and the command that
+* runs instead. It names a `dsh plugin` command, so it never reaches a
+* desktop reader: the continuation does not run in that profile. */
+function cliFallbackLine(profile, spec) {
+	return `dsh-plugin-shop: dsh's plugin manager updates no installed package in place (already-installed); running \`dsh plugin --profile ${profile} add ${spec}\` instead`;
+}
 /** How many bytes a release tarball may be at the integrity check. The
 * registry already refuses to publish a tarball over 32 MiB, so 64 MiB is
 * headroom, not a gate of its own. */
@@ -5531,14 +5660,32 @@ let ShopGateway = (() => {
 		*
 		* The order is load-bearing for the copy a reader sees. The desktop
 		* profile first: dsh itself refuses to launch it, so no platform,
-		* supervisor or port could make a restart possible there. Then Windows,
-		* because the platform check has no override and reporting the systemd one
-		* there sends a Windows user to set `allowRestart: true`, which this gate
-		* would still refuse.
+		* supervisor or port could make a restart possible there, and the remedy
+		* is the app. Then `from-default-profile` and Windows, both ahead of
+		* systemd, because neither has an override and reporting the systemd one
+		* there sends the reader to set `allowRestart: true`, which this gate would
+		* still refuse. And `from-default-profile` ahead of Windows, because every
+		* remedy after `desktop` is "restart dsh manually", which a reader launched
+		* with the flag would do with the flag, and on 0.2.1 that recreates the
+		* profile: its copy is the one that says "without that flag", and a
+		* Windows, systemd or `--port 0` reader needs it as much as any other.
 		*
 		* - `desktop`: dsh's CLI refuses `--profile desktop` ("managed exclusively
 		*   by the Electron application"), so the relaunch would exit at once and
 		*   leave nothing on the port; the app restarts it.
+		* - `from-default-profile`: from dsh 0.2.1, `--from-default-profile <name>`
+		*   replaces an existing custom profile with a fresh copy of the shipped
+		*   template on every launch, and the relaunch re-runs this argv verbatim,
+		*   so it would delete every plugin in the profile, this shop included.
+		*   Measured 2026-10-19 in throwaway homes: 0.2.1-rc.2 booted a relaunched
+		*   profile that had held the shop with no dependencies, while 0.2.0-rc.2
+		*   refused to boot an existing profile at all, so there the restarted dsh
+		*   failed to come back. Both spellings are the flag:
+		*   `--from-default-profile <name>` and `--from-default-profile=<name>`. It
+		*   is left in the argv rather than stripped: the restarted process would no
+		*   longer run the command the reader chose, and their next launch with the
+		*   flag recreates the profile anyway. No override (design
+		*   2026-10-19-dsh-021-readiness §3).
 		* - `windows`: the handoff helper is a POSIX shell one-liner (restart.ts)
 		*   and there is no `sh` on Windows. That spawn fails ASYNCHRONOUSLY, so
 		*   committing would answer `ok: true`, exit this process, and leave nothing
@@ -5546,11 +5693,12 @@ let ShopGateway = (() => {
 		* - `systemd`: under a unit the two-phase handoff kills itself, because the
 		*   main process exiting also kills the unit's cgroup and takes the detached
 		*   helper with it; the service never comes back. Overridable, and the only
-		*   one of the three that is.
+		*   one that is.
 		* - `port-zero`: the OS hands the NEW process a fresh port the browser
 		*   cannot know, so a restart would strand the client on a dead origin. */
 		staticRestartBlock() {
 			if (isDesktopProfile(this.profile)) return "desktop";
+			if (this.restartArgv.some((arg) => arg === "--from-default-profile" || arg.startsWith("--from-default-profile="))) return "from-default-profile";
 			if (!this.restartPlatformSupported()) return "windows";
 			if (detectSupervisor(this.env, { ppid: this.ppid }) === "systemd" && !this.allowRestartConfigured()) return "systemd";
 			const portIndex = this.restartArgv.indexOf("--port");
@@ -5678,10 +5826,14 @@ let ShopGateway = (() => {
 			const alreadyImported = isUpdate || this.imported.has(args.name);
 			const harness = await this.runningHarness();
 			if (manager !== null) {
-				const running = this.startManagerInstall(manager, spec, `install ${spec}`, (raw) => {
-					if (!isUpdate && readChange(raw).stage === "enable") this.imported.add(args.name);
+				const continues = isUpdate && !isDesktopProfile(this.profile);
+				let refusedInPlace = false;
+				const running = continueAfter(this.startManagerInstall(manager, spec, `install ${spec}`, (raw) => {
+					const change = readChange(raw);
+					if (!isUpdate && change.stage === "enable") this.imported.add(args.name);
+					if (continues && change.errorCode === "already-installed") refusedInPlace = true;
 					return managerOutcome(raw, this.outcomeContext(args.name, isUpdate ? "update" : "install", alreadyImported, this.packageHasClientHalf(args.name)));
-				}, () => this.postInstallHazard(args.name, harness, " It is on disk: uninstall it from the shop to undo this install."));
+				}, () => this.postInstallHazard(args.name, harness, " It is on disk: uninstall it from the shop to undo this install.")), () => refusedInPlace, () => this.startCliInstall(args.name, spec, harness, true), cliFallbackLine(this.profile, spec));
 				this.track(running);
 				this.recordGithubPin(entry);
 				return {
@@ -5690,13 +5842,31 @@ let ShopGateway = (() => {
 					state: running.status().state
 				};
 			}
-			const running = startInstall({
+			const running = this.startCliInstall(args.name, spec, harness, alreadyImported);
+			this.recordGithubPin(entry);
+			this.track(running);
+			return {
+				ok: true,
+				installId: running.installId,
+				state: running.status().state
+			};
+		}
+		/**
+		* One install of `name` through dsh's CLI, `dsh plugin --profile <p> add
+		* <spec>` (§7.2): the path every install takes when dsh offers no plugin
+		* manager, and the one that continues an update the manager refuses in
+		* place (design 2026-10-19-dsh-021-readiness §2). `alreadyImported` is
+		* whether this process may already hold the package's module, which rules
+		* out a hot mount. The caller tracks the record and records any pin, once.
+		*/
+		startCliInstall(name, spec, harness, alreadyImported) {
+			return startInstall({
 				profile: this.profile,
 				spec,
 				dshBin: this.dshBin,
-				expectedName: args.name,
+				expectedName: name,
 				prefetcher: this.prefetcher,
-				alsoConfirm: () => this.postInstallHazard(args.name, harness, ` It is on disk: run \`dsh plugin --profile ${this.profile} remove ${args.name}\` to undo this install.`),
+				alsoConfirm: () => this.postInstallHazard(name, harness, ` It is on disk: run \`dsh plugin --profile ${this.profile} remove ${name}\` to undo this install.`),
 				afterDone: async () => {
 					if (alreadyImported) return {
 						activation: "restart",
@@ -5706,8 +5876,8 @@ let ShopGateway = (() => {
 						mount: hotMount,
 						unmount: hotUnmount
 					};
-					this.imported.add(args.name);
-					const result = await hot.mount({ plugin: (plugin, config) => this.home.plugin(plugin, config) }, this.profileDirResolved(), args.name);
+					this.imported.add(name);
+					const result = await hot.mount({ plugin: (plugin, config) => this.home.plugin(plugin, config) }, this.profileDirResolved(), name);
 					if (!result.ok) return {
 						activation: "restart",
 						...result.reason !== null ? { restartReason: result.reason } : {}
@@ -5715,17 +5885,10 @@ let ShopGateway = (() => {
 					return { activation: activationOf({
 						hostLive: true,
 						clientLive: true,
-						hasClientHalf: this.packageHasClientHalf(args.name)
+						hasClientHalf: this.packageHasClientHalf(name)
 					}) };
 				}
 			});
-			this.recordGithubPin(entry);
-			this.track(running);
-			return {
-				ok: true,
-				installId: running.installId,
-				state: running.status().state
-			};
 		}
 		/**
 		* What would stop the profile from starting now that `name`'s files are on
@@ -6157,7 +6320,12 @@ let ShopGateway = (() => {
 			};
 			const spec = `dsh-plugin-shop@${args.version}`;
 			if (manager !== null) {
-				const running = this.startManagerInstall(manager, spec, `update ${spec}`, (raw) => managerOutcome(raw, this.outcomeContext("dsh-plugin-shop", "update", true, true)));
+				const continues = !isDesktopProfile(this.profile);
+				let refusedInPlace = false;
+				const running = continueAfter(this.startManagerInstall(manager, spec, `update ${spec}`, (raw) => {
+					if (continues && readChange(raw).errorCode === "already-installed") refusedInPlace = true;
+					return managerOutcome(raw, this.outcomeContext("dsh-plugin-shop", "update", true, true));
+				}), () => refusedInPlace, () => this.startCliSelfUpdate(spec), cliFallbackLine(this.profile, spec));
 				this.track(running);
 				return {
 					ok: true,
@@ -6165,13 +6333,7 @@ let ShopGateway = (() => {
 					state: running.status().state
 				};
 			}
-			const running = startInstall({
-				profile: this.profile,
-				spec,
-				dshBin: this.dshBin,
-				expectedName: "dsh-plugin-shop",
-				prefetcher: this.prefetcher
-			});
+			const running = this.startCliSelfUpdate(spec);
 			this.track(running);
 			return {
 				ok: true,
@@ -6179,6 +6341,20 @@ let ShopGateway = (() => {
 				state: running.status().state
 			};
 		}
+		/** The shop's own update through dsh's CLI: the path when dsh offers no
+		* plugin manager, and the one that continues a self-update the manager
+		* refuses in place (design 2026-10-19-dsh-021-readiness §2). It passes no
+		* `afterDone`, so it reports a restart: a host half cannot swap itself live
+		* (§8). The caller tracks the record. */
+		startCliSelfUpdate(spec) {
+			return startInstall({
+				profile: this.profile,
+				spec,
+				dshBin: this.dshBin,
+				expectedName: "dsh-plugin-shop",
+				prefetcher: this.prefetcher
+			});
+		}
 	};
 })();
 //#endregion

package/lib/typert.host.js

@@ -165,7 +165,7 @@ const dsh_plugin_shop_shop_version_result$schema = z.object({
   'installed': z.string(),
   'latest': z.union([z.literal(null), z.string()]),
   'outdated': z.boolean(),
-  'restartBlocked': z.union([z.literal(null), z.literal("desktop"), z.literal("windows"), z.literal("systemd"), z.literal("port-zero")]),
+  'restartBlocked': z.union([z.literal(null), z.literal("desktop"), z.literal("from-default-profile"), z.literal("windows"), z.literal("systemd"), z.literal("port-zero")]),
   'pendingVersion': z.union([z.undefined(), z.literal(null), z.string()]).optional(),
   'bootId': z.union([z.undefined(), z.string()]).optional(),
 })
@@ -202,7 +202,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_catalog_result$schema,
         create: () => dsh_plugin_shop_shop_catalog_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1272,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1301,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installed',
@@ -218,7 +218,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_installed_result$schema,
         create: () => dsh_plugin_shop_shop_installed_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1739,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1804,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installedSpecs',
@@ -234,7 +234,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_installedSpecs_result$schema,
         create: () => dsh_plugin_shop_shop_installedSpecs_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1730,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1795,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installStart',
@@ -262,7 +262,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_installStart_result$schema,
         create: () => dsh_plugin_shop_shop_installStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1398,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1427,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installStatus',
@@ -289,7 +289,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_installStatus_result$schema,
         create: () => dsh_plugin_shop_shop_installStatus_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1706,"column":3},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1771,"column":3},
     },
     {
       id: 'dsh-plugin-shop#shop/restart',
@@ -305,7 +305,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_restart_result$schema,
         create: () => dsh_plugin_shop_shop_restart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1990,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2055,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/setEnabled',
@@ -332,7 +332,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_setEnabled_result$schema,
         create: () => dsh_plugin_shop_shop_setEnabled_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":943,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":953,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/uninstallStart',
@@ -360,7 +360,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_uninstallStart_result$schema,
         create: () => dsh_plugin_shop_shop_uninstallStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1884,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1949,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/updateStart',
@@ -387,7 +387,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_updateStart_result$schema,
         create: () => dsh_plugin_shop_shop_updateStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2097,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2162,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/version',
@@ -403,7 +403,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_version_result$schema,
         create: () => dsh_plugin_shop_shop_version_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2054,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2119,"column":9},
     },
   ],
   model: {
@@ -544,7 +544,7 @@ export const TYPERT = {
           },
           {
             "name": "RestartBlockedReason",
-            "declaration": "export type RestartBlockedReason = 'desktop' | 'windows' | 'systemd' | 'port-zero';"
+            "declaration": "export type RestartBlockedReason = 'desktop' | 'from-default-profile' | 'windows' | 'systemd' | 'port-zero';"
           },
           {
             "name": "RestartOutcome",

package/lib/typert.remote-client.js

@@ -165,7 +165,7 @@ const dsh_plugin_shop_shop_version_result$schema = z.object({
   'installed': z.string(),
   'latest': z.union([z.literal(null), z.string()]),
   'outdated': z.boolean(),
-  'restartBlocked': z.union([z.literal(null), z.literal("desktop"), z.literal("windows"), z.literal("systemd"), z.literal("port-zero")]),
+  'restartBlocked': z.union([z.literal(null), z.literal("desktop"), z.literal("from-default-profile"), z.literal("windows"), z.literal("systemd"), z.literal("port-zero")]),
   'pendingVersion': z.union([z.undefined(), z.literal(null), z.string()]).optional(),
   'bootId': z.union([z.undefined(), z.string()]).optional(),
 })
@@ -199,7 +199,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_catalog_result$schema,
         create: () => dsh_plugin_shop_shop_catalog_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1272,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1301,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installed',
@@ -215,7 +215,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_installed_result$schema,
         create: () => dsh_plugin_shop_shop_installed_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1739,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1804,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installedSpecs',
@@ -231,7 +231,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_installedSpecs_result$schema,
         create: () => dsh_plugin_shop_shop_installedSpecs_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1730,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1795,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installStart',
@@ -259,7 +259,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_installStart_result$schema,
         create: () => dsh_plugin_shop_shop_installStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1398,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1427,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installStatus',
@@ -286,7 +286,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_installStatus_result$schema,
         create: () => dsh_plugin_shop_shop_installStatus_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1706,"column":3},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1771,"column":3},
     },
     {
       id: 'dsh-plugin-shop#shop/restart',
@@ -302,7 +302,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_restart_result$schema,
         create: () => dsh_plugin_shop_shop_restart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1990,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2055,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/setEnabled',
@@ -329,7 +329,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_setEnabled_result$schema,
         create: () => dsh_plugin_shop_shop_setEnabled_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":943,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":953,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/uninstallStart',
@@ -357,7 +357,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_uninstallStart_result$schema,
         create: () => dsh_plugin_shop_shop_uninstallStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1884,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1949,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/updateStart',
@@ -384,7 +384,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_updateStart_result$schema,
         create: () => dsh_plugin_shop_shop_updateStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2097,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2162,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/version',
@@ -400,7 +400,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_version_result$schema,
         create: () => dsh_plugin_shop_shop_version_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2054,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2119,"column":9},
     },
   ],
 }

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

@@ -0,0 +1,46 @@
+/**
+ * The shop's two buttons on dsh's Plugins page (design
+ * 2026-10-16-shop-sidebar-page §7), in the head of a detail page, before the
+ * page's own switch and uninstall (`plugins.detail.actions`, dsh 0.1.7-rc.2
+ * and later): "Open Plugin shop" on the shop's own bundle page, and "View in
+ * Plugin shop" on the page of any bundle the shelf lists. Any other subject
+ * renders nothing, as the slot's contract asks of an entry.
+ *
+ * It renders inside dsh's page, so it carries its own error boundary: a
+ * throw here costs the reader a button, never dsh's page.
+ */
+import { type ReactNode } from 'react';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ShopCatalogResult } from '../host/index.ts';
+import type { ShopPageStore } from './page-store.ts';
+/** One bundle as a detail contribution sees it: the field this reads of the
+ * Plugins page's `PluginPackageRef` (`dsh-client-ui-plugin-manager`'s slot
+ * contract, identical in 0.1.7-rc.2 and 0.2.0-rc.2). */
+export interface PluginPackageRef {
+    readonly name: string;
+}
+/** What a detail page is about, as the Plugins page hands it over. */
+export type PluginsSubject = {
+    readonly kind: 'bundle';
+    readonly pkg: PluginPackageRef;
+} | {
+    readonly kind: 'row';
+    readonly pkg: PluginPackageRef;
+} | {
+    readonly kind: 'item';
+    readonly id: string;
+};
+/** The face index.ts hands the buttons. */
+export interface ShopDetailActionInjected {
+    /** The catalog a listing question is asked of (index.ts `listing`). */
+    listing: () => Promise<ShopCatalogResult>;
+    /** Whether the page can be opened at all: false without a layout service
+     * that can select a panel. */
+    canOpen: () => boolean;
+    openShop: () => void;
+    page: ShopPageStore;
+}
+export type ShopDetailActionProps = {
+    subject: PluginsSubject;
+} & PropsLocale<'settings.shop'> & InjectFace<ShopDetailActionInjected>;
+export declare function ShopDetailAction(props: ShopDetailActionProps): ReactNode;

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

@@ -0,0 +1,12 @@
+/**
+ * The shop's glyph in dsh's sidebar (design 2026-10-16-shop-sidebar-page
+ * §4.3): a bag with a whale tail, drawn the way dsh draws its own panel
+ * glyphs — a 16×16 view box, one-pixel `currentColor` strokes, no fill — so
+ * the row's colour and its selection treatment reach it unchanged. `active`
+ * is ignored, as dsh's own glyphs ignore it: the row draws the selection.
+ */
+import type { ReactNode } from 'react';
+export declare function ShopGlyph({ size }: {
+    size: number;
+    active: boolean;
+}): ReactNode;