@linxin666/dsh-client-ui-task-board 0.3.9 → 0.3.11

package/lib/index.js

@@ -369,7 +369,7 @@ function settleExecution(task, executionId, outcome, now, error) {
 	};
 	const executions = [...task.executions];
 	executions[index] = settled;
-	const status = outcome === "succeeded" ? "done" : outcome === "failed" ? "failed" : task.status === "running" ? "todo" : task.status;
+	const status = outcome === "succeeded" ? task.schedule?.enabled ? "todo" : "done" : outcome === "failed" ? "failed" : task.status === "running" ? "todo" : task.status;
 	return {
 		...task,
 		status,
@@ -2013,6 +2013,10 @@ function isServiceUnavailable(error) {
 	const code = error.code;
 	return code === "service-unavailable" || code === "gateway/service-unavailable";
 }
+function isInvocationUnavailable(error) {
+	const code = error.code;
+	return code === "invocation-unavailable" || code === "gateway/invocation-unavailable";
+}
 const SERVICE_UNAVAILABLE_ATTEMPTS = 5;
 const SERVICE_UNAVAILABLE_BACKOFF_MS = 2e3;
 function delay(ms) {
@@ -2093,6 +2097,7 @@ var HostExecutionRunner = class {
 	scanMemos = /* @__PURE__ */ new Map();
 	unavailableAttempts;
 	unavailableBackoffMs;
+	unsupportedSessionListWarned = false;
 	constructor(gateway, commands, workspaceRegistry, unavailableRetry) {
 		this.gateway = gateway;
 		this.commands = commands;
@@ -2167,6 +2172,13 @@ var HostExecutionRunner = class {
 				items: response.items
 			};
 		} catch (error) {
+			if (isInvocationUnavailable(error)) {
+				if (!this.unsupportedSessionListWarned) {
+					this.unsupportedSessionListWarned = true;
+					console.warn("[dsh-task-board] DSH runtime session endpoint unavailable (requires DSH >= 0.1.2-alpha.2); task board roster auto-discovery is disabled", error);
+				}
+				return { known: false };
+			}
 			if (!isServiceUnavailable(error) || attempt >= this.unavailableAttempts) {
 				console.error("[dsh-task-board] session/list failed; treating the host session roster as unknown", error);
 				return { known: false };
@@ -2183,6 +2195,13 @@ var HostExecutionRunner = class {
 			try {
 				response = await this.invoke("session", "list", {});
 			} catch (error) {
+				if (isInvocationUnavailable(error)) {
+					if (!this.unsupportedSessionListWarned) {
+						this.unsupportedSessionListWarned = true;
+						console.warn("[dsh-task-board] DSH runtime session endpoint unavailable (requires DSH >= 0.1.2-alpha.2); task board roster auto-discovery is disabled", error);
+					}
+					return { outcome: "pending" };
+				}
 				console.warn("[dsh-task-board] session/list failed during execution inspection; keeping the outcome pending", error);
 				return { outcome: "pending" };
 			}

package/lib/types/client/board-mount.d.ts

@@ -1,10 +1,13 @@
 import type { BoardController } from '../core/controller.ts';
+import type { LocaleRefreshSource } from './sidebar-entry.ts';
 /** The injected board container (kept in the DOM, hidden when inactive). */
 export declare const BOARD_VIEW_SELECTOR = "[data-dsh-taskboard-view]";
 /**
  * Mount the board React tree into the center column and bind its visibility
  * to the controller's boardOpen state.
  * @param controller - the board controller driving the view.
+ * @param locale - locale-change source; when given, re-renders a mounted board
+ *   on a Language switch.
  * @returns disposer unmounting the tree and restoring the column.
  */
-export declare function mountBoard(controller: BoardController): () => void;
+export declare function mountBoard(controller: BoardController, locale?: LocaleRefreshSource): () => void;

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

@@ -155,5 +155,7 @@ export type TaskBoardKey = keyof typeof zh;
 export type SettingsCardKey = TaskBoardKey;
 /** Active dictionary, picked by the document language at call time. */
 export declare function dictionary(): Record<TaskBoardKey, string>;
+/** Wire the SDK translate seat; pass undefined to restore the document-language pick. */
+export declare function setRuntimeTranslate(t: ((key: TaskBoardKey, params?: Record<string, string>) => string) | undefined): void;
 /** Translate a key with optional {name} template params. */
 export declare function t(key: TaskBoardKey, params?: Record<string, string>): string;

package/lib/types/client/sidebar-entry-core.d.ts

@@ -34,6 +34,16 @@ export interface SidebarEntryOptions {
     label(): string;
     /** Optional localized tooltip (title attribute). */
     tooltip?(): string;
+    /**
+     * Optional locale-change subscription: re-applies label / aria-label /
+     * tooltip whenever the active locale changes. Plain-DOM rows would
+     * otherwise keep the label captured at mount; pass the SDK locale runtime
+     * subscription (ctx.locale.subscribe) so the row follows the language
+     * switch without a reload.
+     */
+    refresh?: {
+        subscribe(listener: () => void): () => void;
+    };
     /** Click action (open/toggle the owning panel). */
     onToggle(): void;
     /** Family-block position: 'before' inserts ahead of sibling plugin rows, 'after' behind them. */

package/lib/types/client/sidebar-entry.d.ts

@@ -14,10 +14,16 @@
 import type { BoardController } from '../core/controller.ts';
 /** Stable data attribute identifying the injected entry row. */
 export declare const ENTRY_SELECTOR = "[data-dsh-taskboard-entry]";
+/** Locale-change subscription the shared core asks for (ctx.locale.subscribe shape). */
+export interface LocaleRefreshSource {
+    subscribe(listener: () => void): () => void;
+}
 /**
  * Mount the sidebar entry, waiting for the shell to render and self-healing
  * on later React re-renders.
  * @param controller - the board controller the entry toggles.
+ * @param locale - locale-change source; when given, re-applies the label on
+ *   a Language switch (the plain-DOM row otherwise keeps the mount-time copy).
  * @returns disposer removing the entry and its observers.
  */
-export declare function mountSidebarEntry(controller: BoardController): () => void;
+export declare function mountSidebarEntry(controller: BoardController, locale?: LocaleRefreshSource): () => void;

package/lib/types/host/run-guarded.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Async-boundary guard shared by the plugin family's Host halves: every
+ * fire-and-forget promise chain and callback the host runtime does not own
+ * (route handlers, timers, event listeners, spawned work) funnels through
+ * these helpers. The dsh host installs a process-level fail-loud guard that
+ * turns ANY unhandled promise rejection into a whole-process exit — one
+ * plugin's stray rejection would otherwise take every plugin down. These
+ * helpers exist so that failure mode is structurally impossible in family
+ * code: the rejection becomes a logged error at the plugin boundary instead.
+ *
+ * Complements the aggregate's shell isolation (packages/dsh-web-all): the
+ * shell contains import/activation failures at boot; runGuarded contains
+ * run-time failures after activation.
+ * @module dsh-web-shared/host/run-guarded
+ */
+/**
+ * Run one async operation, logging (never propagating) a rejection. Use for
+ * promises whose lifecycle the caller does not await: spawned work, retry
+ * loops, background flushes. Returns the original promise so callers can
+ * still chain when they want to.
+ * @param promise - the work to shield; any thenable.
+ * @param label - log prefix naming the work site.
+ * @param log - error sink; defaults to console.error.
+ * @returns the input promise (rejection already consumed).
+ */
+export declare function runGuarded<T>(promise: PromiseLike<T>, label: string, log?: (error: unknown) => void): PromiseLike<T>;
+/**
+ * Wrap one callback so every invocation is individually guarded: a rejection
+ * inside one call is logged and swallowed instead of escaping into whatever
+ * infrastructure invoked the callback (HTTP server, EventEmitter, interval).
+ * Sync throws are caught identically; a returned promise is replaced by
+ * `undefined` after guarding (callers that need the original rejection should
+ * await inside their own try/catch instead).
+ * @param label - log prefix naming the callback site.
+ * @param handler - the work to guard.
+ * @param log - error sink; defaults to console.error.
+ * @returns a wrapped callback with the same parameter list.
+ */
+export declare function guardedHandler<A extends unknown[]>(label: string, handler: (...args: A) => unknown, log?: (error: unknown) => void): (...args: A) => unknown;

package/lib/types/host-runner.d.ts

@@ -58,6 +58,7 @@ export declare class HostExecutionRunner {
     private readonly scanMemos;
     private readonly unavailableAttempts;
     private readonly unavailableBackoffMs;
+    private unsupportedSessionListWarned;
     constructor(gateway: SessionGateway | TypertGateway, commands?: SessionCommandDispatcher | undefined, workspaceRegistry?: TaskBoardWorkspaceRegistry | undefined, unavailableRetry?: {
         attempts?: number;
         backoffMs?: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-client-ui-task-board",
   "description": "Host-authoritative task board for the DSH Web GUI with real session execution, Host cron scheduling, and optional cross-platform idle-sleep protection; mounted without DSH source changes.",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -23,7 +23,7 @@
   },
   "dsh": {
     "engines": {
-      "dsh": ">=0.1.2-alpha.1"
+      "dsh": ">=0.1.2-alpha.3"
     },
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -48,23 +48,23 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-commands": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-workspace": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-commands": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.3",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "^18.3.5",

package/src/client/board-mount.tsx

@@ -15,6 +15,7 @@
 import { createRoot, type Root } from 'react-dom/client'
 import type { BoardController } from '../core/controller.ts'
 import { TaskBoard } from './board/TaskBoard.tsx'
+import type { LocaleRefreshSource } from './sidebar-entry.ts'
 import css from './board.module.css'
 
 /** The injected board container (kept in the DOM, hidden when inactive). */
@@ -37,11 +38,19 @@ function conversationColumn(): HTMLElement | undefined {
  * Mount the board React tree into the center column and bind its visibility
  * to the controller's boardOpen state.
  * @param controller - the board controller driving the view.
+ * @param locale - locale-change source; when given, re-renders a mounted board
+ *   on a Language switch.
  * @returns disposer unmounting the tree and restoring the column.
  */
-export function mountBoard(controller: BoardController): () => void {
+export function mountBoard(controller: BoardController, locale?: LocaleRefreshSource): () => void {
   let root: Root | undefined
   let container: HTMLDivElement | undefined
+  let unsubscribeLocale: (() => void) | undefined
+  try {
+    unsubscribeLocale = locale?.subscribe(() => {
+      if (root !== undefined) root.render(<TaskBoard controller={controller} />)
+    })
+  } catch { /* locale service absent: the board follows its next natural re-render */ }
 
   const ensure = (): void => {
     if (container !== undefined) {
@@ -106,6 +115,7 @@ export function mountBoard(controller: BoardController): () => void {
     document.removeEventListener(ACTIVATE_EVENT, onOtherActivate)
     waitObserver.disconnect()
     unsubscribe()
+    unsubscribeLocale?.()
     document.documentElement.removeAttribute(ACTIVE_ATTR)
     root?.unmount()
     root = undefined

package/src/client/board.module.css

@@ -99,7 +99,8 @@ html[data-dsh-taskboard-active]:not([data-dsh-ssh-active]) [class*='centerCol']
 }
 
 /* Collapsed rail: icon-only, centered, matching the shell's 56px rail. */
-[data-dsh-frame][data-sidebar-collapsed] .entry {
+:global([data-dsh-frame][data-sidebar-collapsed]) .entry,
+:global([data-sidebar-collapsed]) .entry {
   justify-content: center;
   padding: 0;
   width: 36px;
@@ -108,7 +109,8 @@ html[data-dsh-taskboard-active]:not([data-dsh-ssh-active]) [class*='centerCol']
   border-radius: 50%;
 }
 
-[data-dsh-frame][data-sidebar-collapsed] .entryLabel {
+:global([data-dsh-frame][data-sidebar-collapsed]) .entryLabel,
+:global([data-sidebar-collapsed]) .entryLabel {
   display: none;
 }
 

package/src/client/index.ts

@@ -27,7 +27,7 @@ import { claimTaskboardApply, releaseTaskboardApply } from './apply-guard.ts'
 import { mountBoard } from './board-mount.tsx'
 import { mountSidebarEntry } from './sidebar-entry.ts'
 import { TaskBoardSettingsCard, TaskBoardSettingsCardController, type TaskBoardSettings } from './TaskBoardSettingsCard.tsx'
-import { en, zh, type TaskBoardKey } from './locales.ts'
+import { en, zh, setRuntimeTranslate, type TaskBoardKey } from './locales.ts'
 import { HttpTaskBoardHostTransport } from './host-api.ts'
 import { reportDailyHeartbeat } from './telemetry.ts'
 
@@ -157,6 +157,12 @@ export function apply(ctx: ClientContext): void {
     }
   }, 'task-board: dictionaries')
 
+  // Wire the SDK translate seat into the module-level t (sidebar row and
+  // other plain-DOM callers): reads the active locale at call time, so they
+  // follow the Language setting without a reload. The register effect above
+  // guarantees the dictionaries exist before the first read.
+  try { setRuntimeTranslate(ctx.locale.bind(NS)) } catch { /* locale missing: document-language fallback stays */ }
+
   // Plugin configuration card: one staged form over the `task-board` settings
   // namespace, contributed to the Web UI plugin group.
   const binder = ctx.get('webUiSettings') ?? ctx.settingsScope
@@ -201,7 +207,7 @@ export function apply(ctx: ClientContext): void {
       transport: new HttpTaskBoardHostTransport(),
       sessions: {
         list: sessions.list,
-        open: id => sessions.open(id as SessionId),
+        open: id => sessions.open(id as never),
       },
     })
     controller.start()
@@ -246,8 +252,8 @@ export function apply(ctx: ClientContext): void {
     void pushPresetOptions()
     disposers.push(ctx.on('connection/reset', () => { void pushPresetOptions() }))
     try {
-      disposers.push(mountSidebarEntry(controller))
-      disposers.push(mountBoard(controller))
+      disposers.push(mountSidebarEntry(controller, ctx.locale))
+      disposers.push(mountBoard(controller, ctx.locale))
     } catch (error) {
       // DOM failures degrade the board, never the GUI.
       console.error('[dsh-task-board] mount failed:', error)

package/src/client/locales.ts

@@ -307,8 +307,23 @@ export function dictionary(): Record<TaskBoardKey, string> {
   return lang.toLowerCase().startsWith('en') ? en : zh
 }
 
+/**
+ * SDK translate seat wired by the browser apply() once ctx.locale is bound
+ * (setRuntimeTranslate). When present it reads the ACTIVE locale at call
+ * time, so plain-DOM surfaces (sidebar row, toggles) follow a runtime
+ * language switch; the document-language pick above stays only as the
+ * unwired fallback (locale service absent, module-scope early callers).
+ */
+let runtimeT: ((key: TaskBoardKey, params?: Record<string, string>) => string) | undefined
+
+/** Wire the SDK translate seat; pass undefined to restore the document-language pick. */
+export function setRuntimeTranslate(t: ((key: TaskBoardKey, params?: Record<string, string>) => string) | undefined): void {
+  runtimeT = t
+}
+
 /** Translate a key with optional {name} template params. */
 export function t(key: TaskBoardKey, params?: Record<string, string>): string {
+  if (runtimeT !== undefined) return runtimeT(key, params)
   let text: string = dictionary()[key]
   if (params !== undefined) {
     for (const [name, value] of Object.entries(params)) {

package/src/client/sidebar-entry-core.ts

@@ -36,6 +36,14 @@ export interface SidebarEntryOptions {
   label(): string
   /** Optional localized tooltip (title attribute). */
   tooltip?(): string
+  /**
+   * Optional locale-change subscription: re-applies label / aria-label /
+   * tooltip whenever the active locale changes. Plain-DOM rows would
+   * otherwise keep the label captured at mount; pass the SDK locale runtime
+   * subscription (ctx.locale.subscribe) so the row follows the language
+   * switch without a reload.
+   */
+  refresh?: { subscribe(listener: () => void): () => void }
   /** Click action (open/toggle the owning panel). */
   onToggle(): void
   /** Family-block position: 'before' inserts ahead of sibling plugin rows, 'after' behind them. */
@@ -76,7 +84,7 @@ function newSessionButton(root: HTMLElement): HTMLButtonElement | undefined {
 }
 
 /** Build the entry row (a detached button; insert once the shell is up). */
-function createEntry(options: SidebarEntryOptions): HTMLButtonElement {
+function createEntry(options: SidebarEntryOptions): { entry: HTMLButtonElement; applyLabel: () => void } {
   const entry = document.createElement('button')
   entry.type = 'button'
   entry.setAttribute(options.rowAttribute, '')
@@ -85,12 +93,20 @@ function createEntry(options: SidebarEntryOptions): HTMLButtonElement {
     entry.setAttribute('data-dsh-part', 'sidebar-entry')
   }
   entry.className = options.css['entry'] ?? ''
-  entry.setAttribute('aria-label', options.label())
-  if (options.tooltip !== undefined) entry.setAttribute('title', options.tooltip())
-  entry.innerHTML = '<span class="' + (options.css['entryIcon'] ?? '') + '">' + options.icon
-    + '</span><span class="' + (options.css['entryLabel'] ?? '') + '">' + options.label() + '</span>'
+  const labelSpan = document.createElement('span')
+  labelSpan.className = options.css['entryLabel'] ?? ''
+  const iconSpan = document.createElement('span')
+  iconSpan.className = options.css['entryIcon'] ?? ''
+  iconSpan.innerHTML = options.icon
+  entry.append(iconSpan, labelSpan)
+  const applyLabel = (): void => {
+    entry.setAttribute('aria-label', options.label())
+    if (options.tooltip !== undefined) entry.setAttribute('title', options.tooltip())
+    labelSpan.textContent = options.label()
+  }
+  applyLabel()
   entry.addEventListener('click', options.onToggle)
-  return entry
+  return { entry, applyLabel }
 }
 
 /** Re-insert the entry after the New Session row (before the browser region). */
@@ -132,9 +148,18 @@ export function mountSidebarEntry(options: SidebarEntryOptions): () => void {
   if (typeof document !== 'undefined' && document.querySelector(options.rowSelector) !== null) {
     return () => {}
   }
-  const entry = createEntry(options)
+  const { entry, applyLabel } = createEntry(options)
   let root: HTMLElement | undefined
   let placed = false
+  let unsubscribeRefresh: (() => void) | undefined
+  if (options.refresh !== undefined) {
+    try {
+      unsubscribeRefresh = options.refresh.subscribe(applyLabel)
+    } catch {
+      // A throwing subscription must not break the mount; the label stays at
+      // its initial value and the next reload resolves it again.
+    }
+  }
 
   const tryPlace = (): void => {
     if (root !== undefined && !root.isConnected) {
@@ -202,6 +227,7 @@ export function mountSidebarEntry(options: SidebarEntryOptions): () => void {
   return () => {
     waitObserver.disconnect()
     rootObserver.disconnect()
+    unsubscribeRefresh?.()
     unsubscribeActive?.()
     entry.remove()
   }

package/src/client/sidebar-entry.ts

@@ -22,13 +22,18 @@ export const ENTRY_SELECTOR = '[data-dsh-taskboard-entry]'
 /** Inline icon normalized to the shell's 18px navigation glyph size. */
 const ICON = '<svg viewBox="0 0 16 16" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="2" y="2.5" width="12" height="11" rx="1.5"/><path d="M2 6.5h12M6.5 6.5v7"/></svg>'
 
+/** Locale-change subscription the shared core asks for (ctx.locale.subscribe shape). */
+export interface LocaleRefreshSource { subscribe(listener: () => void): () => void }
+
 /**
  * Mount the sidebar entry, waiting for the shell to render and self-healing
  * on later React re-renders.
  * @param controller - the board controller the entry toggles.
+ * @param locale - locale-change source; when given, re-applies the label on
+ *   a Language switch (the plain-DOM row otherwise keeps the mount-time copy).
  * @returns disposer removing the entry and its observers.
  */
-export function mountSidebarEntry(controller: BoardController): () => void {
+export function mountSidebarEntry(controller: BoardController, locale?: LocaleRefreshSource): () => void {
   return mountSharedSidebarEntry({
     rowAttribute: 'data-dsh-taskboard-entry',
     rowSelector: ENTRY_SELECTOR,
@@ -36,6 +41,7 @@ export function mountSidebarEntry(controller: BoardController): () => void {
     icon: ICON,
     css,
     label: () => t('entry.label'),
+    refresh: locale === undefined ? undefined : { subscribe: (listener) => locale.subscribe(listener) },
     onToggle: () => { controller.toggleBoard() },
     position: 'before',
     familySelectors: ['[data-dsh-taskboard-entry]', '[data-dsh-ssh-entry]'],

package/src/core/tasks.ts

@@ -361,7 +361,8 @@ export function settleExecution(
   const settled: ExecutionRecord = { ...execution, endedAt: now, result: outcome, error }
   const executions = [...task.executions]
   executions[index] = settled
-  const status: TaskStatus = outcome === 'succeeded' ? 'done'
+  const status: TaskStatus = outcome === 'succeeded'
+    ? (task.schedule?.enabled ? 'todo' : 'done')
     : outcome === 'failed' ? 'failed'
       : task.status === 'running' ? 'todo' : task.status
   return { ...task, status, updatedAt: now, executions }

package/src/host/run-guarded.ts

@@ -0,0 +1,76 @@
+// Generated by scripts/sync-shared.mjs from shared/host/run-guarded.ts. Do not edit this copy; edit the shared source and run "node scripts/sync-shared.mjs".
+/**
+ * Async-boundary guard shared by the plugin family's Host halves: every
+ * fire-and-forget promise chain and callback the host runtime does not own
+ * (route handlers, timers, event listeners, spawned work) funnels through
+ * these helpers. The dsh host installs a process-level fail-loud guard that
+ * turns ANY unhandled promise rejection into a whole-process exit — one
+ * plugin's stray rejection would otherwise take every plugin down. These
+ * helpers exist so that failure mode is structurally impossible in family
+ * code: the rejection becomes a logged error at the plugin boundary instead.
+ *
+ * Complements the aggregate's shell isolation (packages/dsh-web-all): the
+ * shell contains import/activation failures at boot; runGuarded contains
+ * run-time failures after activation.
+ * @module dsh-web-shared/host/run-guarded
+ */
+
+/** Format one failure line for logging. */
+function formatFailure(label: string, error: unknown): Error {
+  return new Error(`[${label}] unhandled async failure: ${error instanceof Error ? error.stack ?? error.message : String(error)}`)
+}
+
+/**
+ * Run one async operation, logging (never propagating) a rejection. Use for
+ * promises whose lifecycle the caller does not await: spawned work, retry
+ * loops, background flushes. Returns the original promise so callers can
+ * still chain when they want to.
+ * @param promise - the work to shield; any thenable.
+ * @param label - log prefix naming the work site.
+ * @param log - error sink; defaults to console.error.
+ * @returns the input promise (rejection already consumed).
+ */
+export function runGuarded<T>(promise: PromiseLike<T>, label: string, log: (error: unknown) => void = console.error): PromiseLike<T> {
+  void Promise.resolve(promise).catch(error => {
+    log(formatFailure(label, error))
+  })
+  return promise
+}
+
+/**
+ * Wrap one callback so every invocation is individually guarded: a rejection
+ * inside one call is logged and swallowed instead of escaping into whatever
+ * infrastructure invoked the callback (HTTP server, EventEmitter, interval).
+ * Sync throws are caught identically; a returned promise is replaced by
+ * `undefined` after guarding (callers that need the original rejection should
+ * await inside their own try/catch instead).
+ * @param label - log prefix naming the callback site.
+ * @param handler - the work to guard.
+ * @param log - error sink; defaults to console.error.
+ * @returns a wrapped callback with the same parameter list.
+ */
+export function guardedHandler<A extends unknown[]>(
+  label: string,
+  handler: (...args: A) => unknown,
+  log: (error: unknown) => void = console.error,
+): (...args: A) => unknown {
+  return (...args: A) => {
+    try {
+      const result = handler(...args)
+      if (isPromiseLike(result)) {
+        void Promise.resolve(result).catch(error => {
+          log(formatFailure(label, error))
+        })
+        return undefined
+      }
+      return result
+    } catch (error) {
+      log(formatFailure(label, error))
+      return undefined
+    }
+  }
+}
+
+function isPromiseLike(value: unknown): value is PromiseLike<unknown> {
+  return typeof value === 'object' && value !== null && typeof (value as PromiseLike<unknown>).then === 'function'
+}

package/src/host-runner.ts

@@ -40,6 +40,11 @@ function isServiceUnavailable(error: unknown): boolean {
   return code === 'service-unavailable' || code === 'gateway/service-unavailable'
 }
 
+function isInvocationUnavailable(error: unknown): boolean {
+  const code = (error as { code?: unknown }).code
+  return code === 'invocation-unavailable' || code === 'gateway/invocation-unavailable'
+}
+
 const SERVICE_UNAVAILABLE_ATTEMPTS = 5
 const SERVICE_UNAVAILABLE_BACKOFF_MS = 2_000
 
@@ -145,6 +150,7 @@ export class HostExecutionRunner {
   private readonly scanMemos = new Map<string, number>()
   private readonly unavailableAttempts: number
   private readonly unavailableBackoffMs: number
+  private unsupportedSessionListWarned = false
 
   constructor(
     private readonly gateway: SessionGateway | TypertGateway,
@@ -214,6 +220,13 @@ export class HostExecutionRunner {
         const response = await this.invoke('session', 'list', {}) as SessionListValue
         return { known: true, count: response.items.filter(item => item.running).length, items: response.items as SessionSummary[] }
       } catch (error) {
+        if (isInvocationUnavailable(error)) {
+          if (!this.unsupportedSessionListWarned) {
+            this.unsupportedSessionListWarned = true
+            console.warn('[dsh-task-board] DSH runtime session endpoint unavailable (requires DSH >= 0.1.2-alpha.2); task board roster auto-discovery is disabled', error)
+          }
+          return { known: false }
+        }
         if (!isServiceUnavailable(error) || attempt >= this.unavailableAttempts) {
           console.error('[dsh-task-board] session/list failed; treating the host session roster as unknown', error)
           return { known: false }
@@ -233,6 +246,13 @@ export class HostExecutionRunner {
       try {
         response = await this.invoke('session', 'list', {}) as SessionListValue
       } catch (error) {
+        if (isInvocationUnavailable(error)) {
+          if (!this.unsupportedSessionListWarned) {
+            this.unsupportedSessionListWarned = true
+            console.warn('[dsh-task-board] DSH runtime session endpoint unavailable (requires DSH >= 0.1.2-alpha.2); task board roster auto-discovery is disabled', error)
+          }
+          return { outcome: 'pending' }
+        }
         console.warn('[dsh-task-board] session/list failed during execution inspection; keeping the outcome pending', error)
         return { outcome: 'pending' }
       }