@linxin666/dsh-client-ui-task-board 0.1.20 → 0.2.0

package/lib/types/protocol.d.ts

@@ -0,0 +1,72 @@
+import type { TaskUpdatePatch } from './core/use-cases/task-update.ts';
+import { type NewTaskInput, type TaskRecord, type TaskStatus } from './core/tasks.ts';
+export declare const TASK_BOARD_SCHEMA_VERSION: 2;
+export declare const TASK_BOARD_API_PREFIX = "/api/task-board";
+export type PowerPhase = 'disabled' | 'idle' | 'acquiring' | 'active' | 'error' | 'unsupported';
+export interface TaskBoardPowerSnapshot {
+    platform: string;
+    phase: PowerPhase;
+    enabled: boolean;
+    runningSessions: number;
+    armedSchedules: number;
+    sessionStateKnown: boolean;
+    lastError?: string;
+}
+export interface TaskBoardSchedulerSnapshot {
+    timeZone: string;
+    /** Opaque identity of the current Host ledger generation. */
+    ledgerId?: string;
+    lastTickAt?: number;
+    error?: string;
+}
+export interface TaskBoardSnapshot {
+    schemaVersion: typeof TASK_BOARD_SCHEMA_VERSION;
+    revision: number;
+    tasks: TaskRecord[];
+    scheduler: TaskBoardSchedulerSnapshot;
+    power: TaskBoardPowerSnapshot;
+}
+export type TaskBoardAction = {
+    kind: 'import';
+    sourceId: string;
+    tasks: TaskRecord[];
+} | {
+    kind: 'create';
+    id: string;
+    input: NewTaskInput;
+} | {
+    kind: 'update';
+    taskId: string;
+    patch: TaskUpdatePatch;
+} | {
+    kind: 'delete';
+    taskId: string;
+} | {
+    kind: 'move';
+    taskId: string;
+    status: TaskStatus;
+} | {
+    kind: 'archive';
+    taskId: string;
+} | {
+    kind: 'restore';
+    taskId: string;
+} | {
+    kind: 'set-schedule';
+    taskId: string;
+    patch: {
+        enabled?: boolean;
+        cron?: string;
+    };
+} | {
+    kind: 'run';
+    taskId: string;
+} | {
+    kind: 'rerun';
+    taskId: string;
+};
+export interface TaskBoardActionEnvelope {
+    requestId: string;
+    action: TaskBoardAction;
+}
+export declare function parseActionEnvelope(value: unknown): TaskBoardActionEnvelope | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-client-ui-task-board",
-  "description": "Task board for the dsh web GUI: a sidebar entry plus a multi-column kanban view with local persistence, task details, and real execution through dsh sessions (session.prompt). Hot-pluggable — mounted via ~/.dsh/cordis.patch.yml + a profile node_modules symlink, no dsh source changes.",
-  "version": "0.1.20",
+  "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.2.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -42,15 +42,18 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-host-apiproxy": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.7",
     "@types/react": "~18.3.1",
     "@types/react-dom": "^18.3.5",
+    "@types/node": "^22.20.0",
     "jsdom": "^25.0.0",
     "lightningcss": "1.32.0",
     "react": "^18.3.1",

package/src/client/PluginSettingsCard.tsx

@@ -56,6 +56,12 @@ export interface PluginSettingsCardProps<TKey extends string = string> {
    * already provides the selection.
    */
   alwaysOpen?: boolean
+  /**
+   * Hide the save/discard footer: cards whose body applies its own changes
+   * immediately (an embedded external settings section) have no staged
+   * edits, so the footer would sit there permanently disabled.
+   */
+  hideFooter?: boolean
   /** The plugin's controls. */
   children: ReactNode
 }
@@ -140,6 +146,9 @@ export function PluginSettingsCard<TKey extends string = string>(props: PluginSe
           <div className={css.body}>
             {!state.writable ? <p className={css.readOnly} role="status">{props.t('settings.readOnly')}</p> : null}
             {props.children}
+            {props.hideFooter === true
+              ? null
+              : (
             <div className={css.footer}>
               {state.failed
                 ? (
@@ -165,6 +174,7 @@ export function PluginSettingsCard<TKey extends string = string>(props: PluginSe
                 {props.t(!state.saving ? 'settings.save' : 'settings.saving')}
               </button>
             </div>
+              )}
           </div>
         )
         : null}

package/src/client/TaskBoardSettingsCard.tsx

@@ -1,12 +1,13 @@
 /**
- * The task-board settings card: whether the board announces itself in every
- * agent's system prompt. Registers into the `settings.plugin.item` slot the
- * plugin-configuration section renders, bound to the `task-board` settings
- * namespace.
+ * Task-board settings for availability, agent announcement, and optional Host
+ * idle-sleep protection. Registers into the `settings.plugin.item` slot the
+ * plugin-configuration section renders, bound to the `task-board` namespace.
  */
 
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'
 import type { SettingsScope, SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client'
+import { useEffect, useState } from 'react'
+import type { TaskBoardPowerSnapshot } from '../protocol.ts'
 import { PluginSettingsCard, BooleanField } from './PluginSettingsCard.tsx'
 import { CardForm, booleanField, type CardActions, type CardShell, type FieldState as CardFieldState } from './settings-form.ts'
 
@@ -16,6 +17,8 @@ export interface TaskBoardSettings {
   enabled?: boolean
   /** Whether the board announces itself in every agent's system prompt. */
   announceToAgent?: boolean
+  /** Prevent host idle sleep while sessions run or schedules are armed. */
+  preventIdleSleep?: boolean
 }
 
 /** What the task-board card renders. */
@@ -24,6 +27,8 @@ export interface TaskBoardSettingsCardState extends CardShell {
   enabled: CardFieldState
   /** System-prompt announcement flag. */
   announceToAgent: CardFieldState
+  /** Idle-system-sleep protection flag. */
+  preventIdleSleep: CardFieldState
 }
 
 /** The registration-side face the card's slot entry injects. */
@@ -44,6 +49,7 @@ export class TaskBoardSettingsCardController {
     this.form = new CardForm(scope, [
       booleanField('enabled'),
       booleanField('announceToAgent'),
+      booleanField('preventIdleSleep'),
     ])
     this.store = this.form.bind(() => this.projection())
   }
@@ -53,6 +59,7 @@ export class TaskBoardSettingsCardController {
       ...this.form.shell(),
       enabled: this.form.field('enabled'),
       announceToAgent: this.form.field('announceToAgent'),
+      preventIdleSleep: this.form.field('preventIdleSleep'),
     }
   }
 
@@ -88,6 +95,23 @@ export function TaskBoardSettingsCard(props: TaskBoardSettingsCardProps) {
   const { t } = props
   const state = props.useTaskBoardSettingsCard(snapshot => snapshot)
   const disabled = !state.writable
+  const [power, setPower] = useState<TaskBoardPowerSnapshot | undefined>()
+  useEffect(() => {
+    let live = true
+    const refresh = async (): Promise<void> => {
+      try {
+        const response = await fetch('/api/task-board/state', { cache: 'no-store', credentials: 'same-origin' })
+        if (!response.ok) return
+        const snapshot = await response.json() as { power?: TaskBoardPowerSnapshot }
+        if (live) setPower(snapshot.power)
+      } catch {
+        // The settings form remains usable while the host status is reconnecting.
+      }
+    }
+    void refresh()
+    const timer = setInterval(() => { void refresh() }, 5_000)
+    return () => { live = false; clearInterval(timer) }
+  }, [])
   const fieldProps = {
     overriddenLabel: t('settings.overridden'),
     resetLabel: t('settings.reset'),
@@ -99,6 +123,7 @@ export function TaskBoardSettingsCard(props: TaskBoardSettingsCardProps) {
       t={t}
       titleKey="settings.title"
       descriptionKey="settings.description"
+      defaultOpen={false}
       state={state}
       onSave={props.save}
       onDiscard={props.discard}
@@ -127,6 +152,28 @@ export function TaskBoardSettingsCard(props: TaskBoardSettingsCardProps) {
         onEdit={(text) => { props.edit('announceToAgent', text) }}
         onReset={() => { props.resetField('announceToAgent') }}
       />
+      <BooleanField
+        id="settings-task-board-prevent-idle-sleep"
+        label={t('settings.preventIdleSleep')}
+        hint={t('settings.preventIdleSleepHint')}
+        inheritLabel={t('settings.inherit')}
+        onLabel={t('settings.on')}
+        offLabel={t('settings.off')}
+        {...fieldProps}
+        {...state.preventIdleSleep}
+        onEdit={(text) => { props.edit('preventIdleSleep', text) }}
+        onReset={() => { props.resetField('preventIdleSleep') }}
+      />
+      <p>
+        {t('settings.powerStatus', {
+          platform: power?.platform ?? t('settings.powerUnknown'),
+          phase: power?.phase ?? t('settings.powerUnknown'),
+          running: String(power?.runningSessions ?? 0),
+          schedules: String(power?.armedSchedules ?? 0),
+        })}
+      </p>
+      <p>{t('settings.powerBoundary')}</p>
+      {power?.lastError !== undefined && <p>{t('settings.powerError', { error: power.lastError })}</p>}
     </PluginSettingsCard>
   )
 }

package/src/client/board/NewTaskModal.tsx

@@ -1,6 +1,6 @@
 /**
  * New-task modal: title + description + the prompt that execution will send.
- * Creates through the controller (which persists immediately).
+ * Creates through the Host and closes only after the Host confirms it.
  */
 import { useEffect, useState } from 'react'
 import type { BoardController } from '../../core/controller.ts'
@@ -22,6 +22,7 @@ export function NewTaskModal({ controller, onClose }: { controller: BoardControl
   const [scheduleCron, setScheduleCron] = useState('')
   const [scheduleError, setScheduleError] = useState<string | undefined>(undefined)
   const [error, setError] = useState<string | undefined>(undefined)
+  const [pending, setPending] = useState(false)
   const [options, setOptions] = useState(controller.getSnapshot().executionOptions)
 
   // The workspace list and preset roster arrive from the runtime after mount;
@@ -31,7 +32,7 @@ export function NewTaskModal({ controller, onClose }: { controller: BoardControl
     [controller],
   )
 
-  const submit = (): void => {
+  const submit = async (): Promise<void> => {
     if (scheduleEnabled) {
       const cron = scheduleCron.trim()
       if (cron === '' || !isValidCron(cron)) {
@@ -39,7 +40,8 @@ export function NewTaskModal({ controller, onClose }: { controller: BoardControl
         return
       }
     }
-    const task = controller.createTask({
+    setPending(true)
+    const task = await controller.createTaskConfirmed({
       title,
       description,
       prompt,
@@ -49,7 +51,8 @@ export function NewTaskModal({ controller, onClose }: { controller: BoardControl
       schedule: scheduleEnabled ? { enabled: true, cron: scheduleCron.trim() } : undefined,
     })
     if (task === undefined) {
-      setError(t('new.required'))
+      setPending(false)
+      setError(controller.getSnapshot().transportError ?? t('new.required'))
       return
     }
     onClose()
@@ -66,7 +69,7 @@ export function NewTaskModal({ controller, onClose }: { controller: BoardControl
         className={css.modal}
         role="dialog"
         aria-label={t('board.new')}
-        onSubmit={event => { event.preventDefault(); submit() }}
+        onSubmit={event => { event.preventDefault(); void submit() }}
       >
         <h2 className={css.modalTitle}>{t('board.new')}</h2>
 
@@ -205,7 +208,7 @@ export function NewTaskModal({ controller, onClose }: { controller: BoardControl
           <button type="button" className={css.ghostButton} onClick={onClose}>
             {t('new.cancel')}
           </button>
-          <button type="submit" className={css.primaryButton}>
+          <button type="submit" className={css.primaryButton} disabled={pending}>
             {t('new.submit')}
           </button>
         </footer>

package/src/client/board/TaskBoard.tsx

@@ -26,9 +26,9 @@ function matchesFilter(task: TaskRecord, filter: string): boolean {
  * re-renders only when its own task changes — not when a sibling card status,
  * the filter, or the selection moves.
  */
-const MemoTaskCard = memo(function MemoTaskCard({ task, onOpen }: { task: TaskRecord; onOpen: (id: string) => void }) {
+const MemoTaskCard = memo(function MemoTaskCard({ task, pending, timeZone, onOpen }: { task: TaskRecord; pending: boolean; timeZone?: string; onOpen: (id: string) => void }) {
   const onClick = useCallback(() => { onOpen(task.id) }, [task.id, onOpen])
-  return <TaskCard task={task} onClick={onClick} />
+  return <TaskCard task={task} pending={pending} timeZone={timeZone} onClick={onClick} />
 })
 
 /** Board component; subscribes to the controller snapshot. */
@@ -62,6 +62,14 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
           <span>{t('board.close')}</span>
         </button>
         <h2 className={css.boardTitle}>{t('board.title')}</h2>
+        {snapshot.host !== undefined && (
+          <span className={css.detailMeta}>
+            {t('board.hostMeta', {
+              revision: String(snapshot.host.revision),
+              timeZone: snapshot.host.scheduler.timeZone,
+            })}
+          </span>
+        )}
         <input
           className={css.search}
           type="search"
@@ -88,6 +96,15 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
         </button>
       </header>
 
+      {snapshot.transportError !== undefined && (
+        <div className={css.formError}>
+          {t('board.hostError', { error: snapshot.transportError })}{' '}
+          <button type="button" className={css.linkButton} onClick={() => { void controller.retryHostSync() }}>
+            {t('board.retryHost')}
+          </button>
+        </div>
+      )}
+
       <div className={css.columns}>
         {archiveView ? (
           <section className={css.column} data-status="archived">
@@ -97,7 +114,7 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
             </header>
             <div className={css.cards}>
               {visible.map(task => (
-                <MemoTaskCard key={task.id} task={task} onOpen={openTask} />
+                <MemoTaskCard key={task.id} task={task} pending={snapshot.pendingTaskIds.includes(task.id)} timeZone={snapshot.host?.scheduler.timeZone} onOpen={openTask} />
               ))}
               {visible.length === 0 && <div className={css.columnEmpty}>{t('archive.empty')}</div>}
             </div>
@@ -114,7 +131,7 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
                 </header>
                 <div className={css.cards}>
                   {tasks.map(task => (
-                    <MemoTaskCard key={task.id} task={task} onOpen={openTask} />
+                    <MemoTaskCard key={task.id} task={task} pending={snapshot.pendingTaskIds.includes(task.id)} timeZone={snapshot.host?.scheduler.timeZone} onOpen={openTask} />
                   ))}
                   {tasks.length === 0 && <div className={css.columnEmpty}>{t('board.empty')}</div>}
                 </div>

package/src/client/board/TaskCard.tsx

@@ -14,25 +14,40 @@ import { t } from '../locales.ts'
 import css from '../board.module.css'
 
 /** Compact relative/absolute time label. */
-export function formatTime(ms: number): string {
+export function formatHostTimestamp(ms: number, timeZone?: string): string {
+  try {
+    return new Intl.DateTimeFormat(undefined, {
+      dateStyle: 'medium',
+      timeStyle: 'medium',
+      ...(timeZone === undefined ? {} : { timeZone }),
+    }).format(new Date(ms))
+  } catch {
+    return new Date(ms).toISOString()
+  }
+}
+
+export function formatTime(ms: number, timeZone?: string): string {
   const date = new Date(ms)
   const now = Date.now()
   const minutes = Math.floor((now - ms) / 60000)
   if (minutes < 1) return t('time.justNow')
   if (minutes < 60) return `${minutes}m`
   if (minutes < 60 * 24) return `${Math.floor(minutes / 60)}h`
+  if (timeZone !== undefined) return formatHostTimestamp(ms, timeZone)
   return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`
 }
 
 /** One card in a column. */
-function TaskCardInner({ task, onClick }: { task: TaskRecord; onClick: () => void }) {
+function TaskCardInner({ task, pending, timeZone, onClick }: { task: TaskRecord; pending: boolean; timeZone?: string; onClick: () => void }) {
   const latest = task.executions[task.executions.length - 1]
   const runs = task.executions.length
+  const archived = task.archivedAt !== undefined
   return (
     <button
       type="button"
       className={css.card}
-      data-status={task.status}
+      data-status={archived ? 'archived' : task.status}
+      data-pending={pending || undefined}
       onClick={onClick}
       title={task.description !== '' ? task.description : task.title}
     >
@@ -40,27 +55,28 @@ function TaskCardInner({ task, onClick }: { task: TaskRecord; onClick: () => voi
       {task.description !== '' && <span className={css.cardExcerpt}>{task.description}</span>}
       <span className={css.cardMeta}>
         <span className={css.cardTime}>{t('board.updated')} {formatTime(task.updatedAt)}</span>
-        {task.schedule?.enabled === true && (
+        {!archived && task.schedule?.enabled === true && (
           <span
             className={css.cardSchedule}
             title={task.schedule.nextRunAt !== undefined
-              ? `${t('card.scheduled')} · ${new Date(task.schedule.nextRunAt).toLocaleString()}`
+              ? `${t('card.scheduled')} · ${formatHostTimestamp(task.schedule.nextRunAt, timeZone)}`
               : t('card.scheduled')}
           >
             {t('card.scheduled')}
           </span>
         )}
         {latest !== undefined && (
-          <span className={css.cardRun} data-result={latest.result}>
+          <span className={css.cardRun} data-result={archived ? undefined : latest.result}>
             {runs} {t('board.runs')}
           </span>
         )}
         {latest?.sessionId !== undefined && (
           <span className={css.cardSession} title={latest.sessionId}>⌁</span>
         )}
-        {task.status === 'running' && <span className={css.cardSpinner} aria-hidden="true" />}
+        {!archived && (task.status === 'running' || pending) && <span className={css.cardSpinner} aria-hidden="true" />}
       </span>
-      {latest !== undefined && executionLabel(latest) === 'running' && (
+      {!archived && pending && <span className={css.cardRunningLabel}>{t('board.pending')}…</span>}
+      {!archived && latest !== undefined && executionLabel(latest) === 'running' && (
         <span className={css.cardRunningLabel}>{t('detail.result.running')}…</span>
       )}
     </button>