@fonlan/dsh-task-kanban 0.2.6 → 0.2.8

package/lib/index.js

@@ -10,48 +10,67 @@ import { isSkillName, isUserInvocable, renderSkillContent } from "@deepseek-ai/d
 import { defineTool } from "@deepseek-ai/dsh-tools";
 //#region src/server/settings.ts
 const KANBAN_SETTINGS_NS = "task-kanban";
+/**
+* The entry config schema. Deliberately UNANNOTATED: schemastery >= 3.18.3
+* added a third `Mode` type parameter, so `.default().volatile()` fields have
+* output type `Volatile<T>` and an explicit `z<KanbanSettingsShape>` no longer
+* compiles (the schema's `meta.default` then carries `Volatile<number>`, which
+* is not a `number`). The plain `KanbanSettingsShape` interface stays the
+* plugin-facing shape: `registerSettings` unwraps the live cells below.
+*/
 const KanbanSettingsSchema = z.object({
-	maxParallelWorkers: z.natural().min(1).default(1),
-	refinementModel: z.string().default(""),
-	refinementProvider: z.string().default(""),
-	refinementReasoningEffort: z.string().default(""),
-	refinementPreset: z.string().default(""),
-	phaseModel: z.string().default(""),
-	phaseProvider: z.string().default(""),
-	phaseReasoningEffort: z.string().default(""),
-	phasePreset: z.string().default("")
+	maxParallelWorkers: z.natural().min(1).default(1).volatile(),
+	refinementModel: z.string().default("").volatile(),
+	refinementProvider: z.string().default("").volatile(),
+	refinementReasoningEffort: z.string().default("").volatile(),
+	refinementPreset: z.string().default("").volatile(),
+	phaseModel: z.string().default("").volatile(),
+	phaseProvider: z.string().default("").volatile(),
+	phaseReasoningEffort: z.string().default("").volatile(),
+	phasePreset: z.string().default("").volatile()
 });
+/**
+* Dereference one config field. `Config` fields marked `.volatile()` are handed
+* to the plugin as references (`{ get() }`) instead of plain values, so reading
+* them raw yields the reference object — which serializes to `{}` and makes
+* every setting look empty. Non-volatile (plain) configs keep working as-is.
+*/
+function fieldValue(value, fallback) {
+	if (value !== null && typeof value === "object" && typeof value.get === "function") return value.get() ?? fallback;
+	return value ?? fallback;
+}
 const EMPTY_DEFAULTS = {
 	model: "",
 	provider: "",
 	reasoningEffort: "",
 	preset: ""
 };
-function registerSettings(ctx) {
-	let current = {
-		maxParallelWorkers: 1,
-		refinementModel: "",
-		refinementProvider: "",
-		refinementReasoningEffort: "",
-		refinementPreset: "",
-		phaseModel: "",
-		phaseProvider: "",
-		phaseReasoningEffort: "",
-		phasePreset: ""
-	};
+function registerSettings(ctx, config) {
+	const fields = config ?? {};
+	const snapshot = () => ({
+		maxParallelWorkers: fieldValue(fields.maxParallelWorkers, 1),
+		refinementModel: fieldValue(fields.refinementModel, ""),
+		refinementProvider: fieldValue(fields.refinementProvider, ""),
+		refinementReasoningEffort: fieldValue(fields.refinementReasoningEffort, ""),
+		refinementPreset: fieldValue(fields.refinementPreset, ""),
+		phaseModel: fieldValue(fields.phaseModel, ""),
+		phaseProvider: fieldValue(fields.phaseProvider, ""),
+		phaseReasoningEffort: fieldValue(fields.phaseReasoningEffort, ""),
+		phasePreset: fieldValue(fields.phasePreset, "")
+	});
+	let pending = {};
+	const current = () => ({
+		...snapshot(),
+		...pending
+	});
 	let service;
 	ctx.inject(["settings"], (sctx) => {
 		service = sctx.settings;
-		const scope = service.register(KANBAN_SETTINGS_NS, KanbanSettingsSchema);
-		current = scope.get();
-		scope.watch((next) => {
-			current = next;
-		});
 	});
 	return {
-		get: () => current,
+		get: () => current(),
 		sessionDefaults: (kind) => {
-			const s = current;
+			const s = current();
 			switch (kind) {
 				case "refine": return {
 					model: s.refinementModel,
@@ -85,6 +104,10 @@ function registerSettings(ctx) {
 		update: async (patch) => {
 			if (service === void 0) throw new Error("@fonlan/dsh-task-kanban: settings service is not available in this profile");
 			await service.update(KANBAN_SETTINGS_NS, patch);
+			pending = {
+				...pending,
+				...patch
+			};
 		}
 	};
 }
@@ -653,7 +676,7 @@ var KanbanRunner = class {
 	recovered = false;
 	/** Agents that already got their scoped kanban tools (event idempotency). */
 	toolScopedAgents = /* @__PURE__ */ new WeakSet();
-	agentStartOff;
+	agentCreatedOff;
 	constructor(ctx, store, settings) {
 		this.ctx = ctx;
 		this.store = store;
@@ -666,16 +689,16 @@ var KanbanRunner = class {
 		this.pumpTimer = setInterval(() => {
 			this.pump();
 		}, 2500);
-		this.agentStartOff = this.ctx.on("agent/session-start", (payload) => {
-			this.onAgentSessionStart(payload.agent);
+		this.agentCreatedOff = this.ctx.on("agent/created", (payload) => {
+			this.onAgentCreated(payload.agent);
 		});
 	}
 	stop() {
 		if (this.pumpTimer !== void 0) clearInterval(this.pumpTimer);
 		this.pumpTimer = void 0;
-		if (this.agentStartOff !== void 0) {
-			this.agentStartOff();
-			this.agentStartOff = void 0;
+		if (this.agentCreatedOff !== void 0) {
+			this.agentCreatedOff();
+			this.agentCreatedOff = void 0;
 		}
 	}
 	newSessionId() {
@@ -781,12 +804,13 @@ var KanbanRunner = class {
 		}
 	}
 	/**
-	* The single place kanban tools get registered. `agent/session-start` fires
-	* for BOTH `agents.create` (startup) and `agents.resume` (host re-open after
-	* a restart), so a resumed refinement/phase/merge session keeps its scoped
+	* The single place kanban tools get registered. Subscribed to
+	* `agent/created`, which fires for BOTH `agents.create` (startup) and
+	* `agents.resume` (host re-open after a restart) and carries the path in its
+	* `source`, so a resumed refinement/phase/merge session keeps its scoped
 	* tools. Idempotent per agent object; non-kanban sessions are skipped.
 	*/
-	async onAgentSessionStart(agent) {
+	async onAgentCreated(agent) {
 		if (agent === void 0 || agent.id === void 0 || agent.ctx === void 0) return;
 		if (this.toolScopedAgents.has(agent)) return;
 		let cardId = this.sessionCards.get(agent.id);
@@ -1901,9 +1925,9 @@ const inject = [
 	"agents",
 	"skills"
 ];
-const Config = z.object({});
-function apply(ctx, _config) {
-	const settings = registerSettings(ctx);
+const Config = KanbanSettingsSchema;
+function apply(ctx, config) {
+	const settings = registerSettings(ctx, config);
 	const runner = new KanbanRunner(ctx, new TaskStore(), settings);
 	ctx.effect(() => {
 		runner.recoverInterrupted();

package/lib/types/index.d.ts

@@ -7,8 +7,28 @@
  * serves the fenced JSON API the board UI calls.
  */
 import type { Context } from '@deepseek-ai/cordis';
-import z from '@deepseek-ai/schemastery';
+import type { KanbanSettingsShape } from './shared/card.js';
 export declare const name = "@fonlan/dsh-task-kanban";
 export declare const inject: string[];
-export declare const Config: z<Schemastery.ObjectS<{}>, Schemastery.ObjectT<{}>>;
-export declare function apply(ctx: Context, _config: unknown): void;
+export declare const Config: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+    maxParallelWorkers: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+    refinementModel: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    refinementProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    refinementReasoningEffort: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    refinementPreset: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    phaseModel: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    phaseProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    phaseReasoningEffort: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    phasePreset: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    maxParallelWorkers: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+    refinementModel: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    refinementProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    refinementReasoningEffort: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    refinementPreset: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    phaseModel: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    phaseProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    phaseReasoningEffort: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+    phasePreset: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+}>>, "plain">;
+export declare function apply(ctx: Context, config: KanbanSettingsShape): void;

package/lib/types/server/runner.d.ts

@@ -21,7 +21,7 @@ export declare class KanbanRunner implements KanbanToolResolver {
     private recovered;
     /** Agents that already got their scoped kanban tools (event idempotency). */
     private toolScopedAgents;
-    private agentStartOff;
+    private agentCreatedOff;
     constructor(ctx: Context, store: TaskStore, settings: KanbanSettingsFace);
     register(ctx: Context): void;
     start(): void;
@@ -45,12 +45,13 @@ export declare class KanbanRunner implements KanbanToolResolver {
     /** Fallback lookup when a session starts before indexSessions ran. */
     private lookupCardOfSession;
     /**
-     * The single place kanban tools get registered. `agent/session-start` fires
-     * for BOTH `agents.create` (startup) and `agents.resume` (host re-open after
-     * a restart), so a resumed refinement/phase/merge session keeps its scoped
+     * The single place kanban tools get registered. Subscribed to
+     * `agent/created`, which fires for BOTH `agents.create` (startup) and
+     * `agents.resume` (host re-open after a restart) and carries the path in its
+     * `source`, so a resumed refinement/phase/merge session keeps its scoped
      * tools. Idempotent per agent object; non-kanban sessions are skipped.
      */
-    private onAgentSessionStart;
+    private onAgentCreated;
     listCards(workspacePath: string): Promise<KanbanCard[]>;
     createTask(input: {
         workspacePath: string;

package/lib/types/server/settings.d.ts

@@ -1,35 +1,43 @@
 /**
  * User-facing plugin settings (global parallel worker count, per-session-type
- * model/effort/preset defaults), persisted through the settings service
- * namespace `task-kanban`. The DSH settings service requires a lowercase
- * kebab-case namespace (/^[a-z][a-z0-9-]*$/), so the scoped package name
- * cannot be used here.
+ * model/effort/preset defaults), carried by this bundle's entry config: dsh
+ * >= 0.1.7 owns plugin settings as entry config (the plugin's `Config`
+ * schema), so the face reads the config it was applied with and persists
+ * updates through `settings.update`.
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { KanbanSessionKind, KanbanSettingsShape } from '../shared/card.js';
 export declare const KANBAN_SETTINGS_NS = "task-kanban";
-export declare const KanbanSettingsSchema: z<Schemastery.ObjectS<{
-    maxParallelWorkers: z<number, number>;
-    refinementModel: z<string, string>;
-    refinementProvider: z<string, string>;
-    refinementReasoningEffort: z<string, string>;
-    refinementPreset: z<string, string>;
-    phaseModel: z<string, string>;
-    phaseProvider: z<string, string>;
-    phaseReasoningEffort: z<string, string>;
-    phasePreset: z<string, string>;
-}>, Schemastery.ObjectT<{
-    maxParallelWorkers: z<number, number>;
-    refinementModel: z<string, string>;
-    refinementProvider: z<string, string>;
-    refinementReasoningEffort: z<string, string>;
-    refinementPreset: z<string, string>;
-    phaseModel: z<string, string>;
-    phaseProvider: z<string, string>;
-    phaseReasoningEffort: z<string, string>;
-    phasePreset: z<string, string>;
-}>>;
+/**
+ * The entry config schema. Deliberately UNANNOTATED: schemastery >= 3.18.3
+ * added a third `Mode` type parameter, so `.default().volatile()` fields have
+ * output type `Volatile<T>` and an explicit `z<KanbanSettingsShape>` no longer
+ * compiles (the schema's `meta.default` then carries `Volatile<number>`, which
+ * is not a `number`). The plain `KanbanSettingsShape` interface stays the
+ * plugin-facing shape: `registerSettings` unwraps the live cells below.
+ */
+export declare const KanbanSettingsSchema: z<Schemastery.ObjectS<NoInfer<{
+    maxParallelWorkers: z<number, number, "volatile-defined">;
+    refinementModel: z<string, string, "volatile-defined">;
+    refinementProvider: z<string, string, "volatile-defined">;
+    refinementReasoningEffort: z<string, string, "volatile-defined">;
+    refinementPreset: z<string, string, "volatile-defined">;
+    phaseModel: z<string, string, "volatile-defined">;
+    phaseProvider: z<string, string, "volatile-defined">;
+    phaseReasoningEffort: z<string, string, "volatile-defined">;
+    phasePreset: z<string, string, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    maxParallelWorkers: z<number, number, "volatile-defined">;
+    refinementModel: z<string, string, "volatile-defined">;
+    refinementProvider: z<string, string, "volatile-defined">;
+    refinementReasoningEffort: z<string, string, "volatile-defined">;
+    refinementPreset: z<string, string, "volatile-defined">;
+    phaseModel: z<string, string, "volatile-defined">;
+    phaseProvider: z<string, string, "volatile-defined">;
+    phaseReasoningEffort: z<string, string, "volatile-defined">;
+    phasePreset: z<string, string, "volatile-defined">;
+}>>, "plain">;
 /** The per-session-type default slice a session kind resolves. */
 export interface KanbanSessionDefaults {
     model: string;
@@ -52,4 +60,4 @@ export interface KanbanSettingsFace {
      */
     sessionDefaults(kind: KanbanSessionKind): KanbanSessionDefaults;
 }
-export declare function registerSettings(ctx: Context): KanbanSettingsFace;
+export declare function registerSettings(ctx: Context, config: KanbanSettingsShape): KanbanSettingsFace;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonlan/dsh-task-kanban",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "DSH web plugin: a task kanban that refines requirements into phased plans, auto-executes them in git worktrees (one session per phase), and auto-merges into the main branch on completion.",
   "license": "MIT",
   "repository": {
@@ -78,54 +78,54 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-agent-preset-registry": "^0.1.7-rc.1 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-workspace": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2 || ^0.2.0-rc.1",
     "@deepseek-ai/schemastery": "^3.18.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-layout": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-workspace": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-agent-preset": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-skill": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4",
     "@types/node": "^22.0.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",
     "tsdown": "^0.22.14",
     "typescript": "^5.9.0",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-layout": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-workspace": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.2",
     "vitest": "^3.2.0"
   },
   "packageManager": "pnpm@11.21.0"

package/src/client/board.css

@@ -386,110 +386,3 @@
   font-size: 13px;
   line-height: 1.5;
 }
-.kb-footer-action {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  gap: 6px;
-  width: 32px;
-  height: 32px;
-  border-radius: 6px;
-  border: none;
-  background: transparent;
-  /* same foreground as the settings trigger (its trigger css uses this var) */
-  color: var(--dsw-alias-label-primary, inherit);
-  cursor: pointer;
-}
-.kb-footer-action:hover { background: rgba(128, 128, 128, 0.18); }
-.kb-footer-action-active { background: rgba(59, 130, 246, 0.25); }
-/* Wide mode borrows the settings trigger's metrics (34px tall, 14px label,
-   18px icon) so both controls read as siblings on the same line. */
-.kb-footer-action-wide {
-  width: auto;
-  height: 34px;
-  padding: 0 8px;
-  border-radius: 12px;
-  font-size: 14px;
-}
-.kb-footer-action-wide .kb-footer-label {
-  font-size: 14px;
-  line-height: 22px;
-}
-/* Theme following is handled by the --dsw-alias-* tokens above: they change
-   value with the shell's selected light/dark appearance, so no OS-level
-   prefers-color-scheme override is needed (and one would fight the app
-   theme when the two disagree). */
-/* Same-line placement WITHOUT moving any DOM: the sidebar foot area becomes
-   a reversed flex row, so its LAST child (the settings area) renders on the
-   LEFT and the FIRST child (footer actions = the kanban button) on the RIGHT
-   — exactly "settings, then kanban". The settings trigger flexes to fill the
-   remaining width; the button keeps its content width. */
-.kb-foot-row {
-  display: flex;
-  flex-direction: row-reverse;
-  align-items: stretch;
-  gap: 4px;
-}
-.kb-foot-row > div:first-child {
-  flex: none;
-  width: auto;
-  min-width: 0;
-  display: flex;
-  align-items: center;
-}
-.kb-foot-row > div:last-child {
-  flex: 1;
-  min-width: 0;
-}
-/* Rail (collapsed sidebar): column-reverse stacks the settings circle on top
-   and the kanban icon below it, both centered; the kanban button borrows the
-   settings trigger's rail chrome (36px circle) so the two match. */
-.kb-foot-rail {
-  flex-direction: column-reverse;
-  align-items: center;
-}
-.kb-foot-rail .kb-footer-action {
-  width: 36px;
-  height: 36px;
-  border-radius: 50%;
-  margin: 8px 0 10px;
-}
-.kb-footer-label {
-  max-width: 110px;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-/* Narrow screens (mobile drawer / auto-collapse breakpoint): the drawer's
-   foot area is ~256-280px but the footer actions row carries the kanban
-   button PLUS mobile-nav's drawer actions (Files / session log), which
-   together exceed the row and squeeze the settings trigger to zero width
-   (row-reverse overflows left, clipping the button). Below the shell's
-   auto-collapse breakpoint, stack the settings row above the actions and
-   let the actions wrap so nothing is squeezed or clipped. */
-@media (max-width: 1023px) {
-  .kb-foot-row {
-    flex-direction: column-reverse;
-    align-items: stretch;
-  }
-  .kb-foot-row > div:first-child {
-    flex: none;
-    width: 100%;
-    display: flex;
-    flex-wrap: wrap;
-    justify-content: flex-start;
-    gap: 4px;
-    padding-top: 4px;
-  }
-  .kb-foot-row > div:last-child {
-    flex: none;
-    width: 100%;
-  }
-  /* The footer-actions entries are display:contents wrappers, so the kanban
-     button itself is a flex item of the wrapping actions row; pull it to the
-     first wrap position so it sits directly below the settings row (the
-     mobile-nav drawer actions follow on their own wrapped line). */
-  .kb-foot-row .kb-footer-action {
-    order: -1;
-  }
-}

package/src/client/board.tsx

@@ -2,7 +2,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
 import type { KanbanCard, Lane, PhaseAttempt, PlanPhase } from '../shared/card'
 import { DROP_RULES, laneOf } from '../shared/lanes'
 import { api, gatewaySkillList, type SkillOption } from './api'
-import { exitBoard, getClient } from './kanban-state'
+import { openSessionView } from './kanban-state'
 import { en, zh } from './locales'
 import './board.css'
 
@@ -157,14 +157,10 @@ export function BoardRoot(props: BoardProps): JSX.Element {
   }, [cards, refresh, showToast, t])
 
   const openSession = useCallback((sessionId: string) => {
-    const ctx = getClient()
-    exitBoard()
-    if (ctx === null) return
-    try {
-      ;(ctx.sessions as { open(id: string): void }).open(sessionId)
-    } catch {
-      showToast(t('sessionNotListed'))
-    }
+    // The shell's view owner retains the session and reveals the Conversation
+    // in one action, so the board itself needs no panel teardown; a runtime
+    // without that face cannot show the session at all.
+    if (!openSessionView(sessionId)) showToast(t('sessionNotListed'))
   }, [showToast, t])
 
   if (items.length === 0) {

package/src/client/icons.tsx

@@ -0,0 +1,74 @@
+import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+
+/** Props every shell icon accepts: square edge in px, color rides currentColor. */
+export interface IconProps {
+  size?: number
+  className?: string
+}
+
+/** One shell icon component. */
+export type IconComponent = (props: IconProps) => JSX.Element
+
+/** The runtime export table, read by capability instead of by one hard-coded name. */
+const table = primitives as unknown as Record<string, IconComponent | undefined>
+
+/** First name the runtime actually provides (a missing export is `undefined`). */
+function firstDefined(...names: string[]): IconComponent | undefined {
+  for (const name of names) {
+    let candidate: IconComponent | undefined
+    try {
+      candidate = table[name]
+    } catch {
+      // Some module namespaces reject unknown names instead of yielding
+      // `undefined`; a rename must never throw on its way to the fallback.
+      continue
+    }
+    if (typeof candidate === 'function') return candidate
+  }
+  return undefined
+}
+
+/**
+ * Self-contained 16×16 checklist glyph (the 0.1.7 artwork) used when the shell
+ * primitives expose none of the names above: the footer entry must render
+ * something even on a runtime whose icon exports we do not know.
+ */
+function ChecklistFallback({ size = 14, className }: IconProps): JSX.Element {
+  return (
+    <svg
+      width={size}
+      height={size}
+      className={className}
+      viewBox="0 0 16 16"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      aria-hidden="true"
+      strokeWidth={1}
+    >
+      <path d="M3.75 6.25C4.7165 6.25 5.5 5.4665 5.5 4.5C5.5 3.5335 4.7165 2.75 3.75 2.75C2.7835 2.75 2 3.5335 2 4.5C2 5.4665 2.7835 6.25 3.75 6.25Z" stroke="currentColor" />
+      <path d="M7.5 4.5H13.5" stroke="currentColor" />
+      <path d="M3.75 13.25C4.7165 13.25 5.5 12.4665 5.5 11.5C5.5 10.5335 4.7165 9.75 3.75 9.75C2.7835 9.75 2 10.5335 2 11.5C2 12.4665 2.7835 13.25 3.75 13.25Z" stroke="currentColor" />
+      <path d="M7.5 11.5H13.5" stroke="currentColor" />
+    </svg>
+  )
+}
+
+/**
+ * The checklist icon used by the sidebar panel row entry.
+ *
+ * DSH 0.1.7 renamed every size-suffixed shell icon (`IconChecklistOutline14`)
+ * into stroke-weight variants (`…Regular` 1px / `…Medium` 1.3px) inside
+ * `@deepseek-ai/dsh-client-ui-primitives`. A stale named import resolves to
+ * `undefined` and React then throws "Element type is invalid" while rendering
+ * the slot entry — the entry is dropped and the button silently disappears
+ * (exactly what upgrading to 0.1.7 did to this plugin). Resolve the name at
+ * runtime, newest first, so the next rename degrades to another shipped
+ * variant instead of taking the button down with it.
+ */
+export const ChecklistIcon: IconComponent =
+  firstDefined(
+    'IconChecklistOutlineRegular',
+    'IconChecklistOutlineMedium',
+    'IconChecklistOutline',
+    'IconChecklistOutline14',
+  ) ?? ChecklistFallback