@linxin666/dsh-client-ui-task-board 0.1.15 → 0.1.17

package/src/core/store.ts

@@ -14,8 +14,7 @@
  * localStorage backend.
  */
 import { isValidCron } from './schedule.ts'
-import type { ScheduleRule, TaskRecord, TaskStatus } from './tasks.ts'
-import { isTaskStatus } from './tasks.ts'
+import { isTaskPermission, isTaskStatus, type ScheduleRule, type TaskRecord, type TaskPermission, type TaskStatus } from './tasks.ts'
 
 /** Persistence seam for the task ledger. */
 export interface TaskStore {
@@ -64,6 +63,9 @@ function isTaskRecordShape(value: unknown): value is Omit<TaskRecord, 'status'>
   if (typeof record.prompt !== 'string') return false
   if (typeof record.createdAt !== 'number') return false
   if (typeof record.updatedAt !== 'number') return false
+  if (record.workspaceId !== undefined && typeof record.workspaceId !== 'string') return false
+  if (record.mode !== undefined && typeof record.mode !== 'string') return false
+  if (record.permission !== undefined && typeof record.permission !== 'string') return false
   if (!Array.isArray(record.executions)) return false
   for (const execution of record.executions) {
     if (typeof execution !== 'object' || execution === null) return false
@@ -78,6 +80,11 @@ function isTaskRecordShape(value: unknown): value is Omit<TaskRecord, 'status'>
   return true
 }
 
+/** Collapse a blank persisted target string to undefined (clears the pin). */
+function normalizeTargetId(value: string | undefined): string | undefined {
+  return value !== undefined && value.trim() === '' ? undefined : value
+}
+
 /** A task record is structurally valid if it round-trips through the UI. */
 export function isTaskRecord(value: unknown): value is TaskRecord {
   return isTaskRecordShape(value) && isTaskStatus(value.status)
@@ -136,6 +143,12 @@ export function parseLedger(raw: string | null): TaskRecord[] {
     // clear a malformed persisted rule rather than leave it in the row.
     const task: TaskRecord = { ...row, status: normalizeStatus(row.status) }
     task.schedule = normalizeSchedule(row.schedule)
+    // Execution targets are normalized like the schedule: blank strings
+    // clear the pin and unknown permission strings from a future version
+    // fall back to the session default instead of dropping the row.
+    task.workspaceId = normalizeTargetId(row.workspaceId)
+    task.mode = normalizeTargetId(row.mode)
+    task.permission = isTaskPermission(row.permission) ? row.permission as TaskPermission : undefined
     tasks.push(task)
   }
   return tasks

package/src/core/tasks.ts

@@ -64,6 +64,32 @@ export interface TaskRecord {
   executions: ExecutionRecord[]
   /** Optional scheduled-run rule (absent on tasks without a schedule). */
   schedule?: ScheduleRule
+  /**
+   * Workspace the execution must run in (a workspace-list id); absent means
+   * the recent-workspace fallback at execution time.
+   */
+  workspaceId?: string
+  /**
+   * Agent preset the execution session must be composed from (an
+   * `agentPreset.list` id); absent means the deployment default.
+   */
+  mode?: string
+  /**
+   * Permission preset applied to the execution session through the
+   * `/permission <id>` slash command; absent leaves the session default.
+   */
+  permission?: TaskPermission
+}
+
+/** Permission presets a task may pin on its execution session (the `/permission <id>` ids). */
+export const TASK_PERMISSIONS = ['read-only', 'workspace-write', 'danger-full-access'] as const
+
+/** One permission preset id. */
+export type TaskPermission = typeof TASK_PERMISSIONS[number]
+
+/** Whether an unknown value is a known permission preset id. */
+export function isTaskPermission(value: unknown): value is TaskPermission {
+  return typeof value === 'string' && (TASK_PERMISSIONS as readonly string[]).includes(value)
 }
 
 /** Input for creating a task. */
@@ -71,6 +97,12 @@ export interface NewTaskInput {
   title: string
   description: string
   prompt: string
+  /** Workspace the execution must run in; empty/absent = the recent workspace. */
+  workspaceId?: string
+  /** Agent preset the execution session must be composed from; empty/absent = deployment default. */
+  mode?: string
+  /** Permission preset applied to the execution session; absent = session default. */
+  permission?: TaskPermission
 }
 
 /** The five kanban columns, in display order. */
@@ -103,6 +135,12 @@ export function canMoveManually(_from: TaskStatus, to: TaskStatus): boolean {
   return (MANUAL_STATUSES as readonly TaskStatus[]).includes(to)
 }
 
+/** Normalize one optional execution-target string: trim; blank collapses to undefined. */
+function normalizeTargetId(value: string | undefined): string | undefined {
+  const trimmed = value?.trim()
+  return trimmed === undefined || trimmed === '' ? undefined : trimmed
+}
+
 /** Create a task from user input. */
 export function createTask(input: NewTaskInput, now: number, id: string): TaskRecord {
   return {
@@ -114,6 +152,9 @@ export function createTask(input: NewTaskInput, now: number, id: string): TaskRe
     createdAt: now,
     updatedAt: now,
     executions: [],
+    workspaceId: normalizeTargetId(input.workspaceId),
+    mode: normalizeTargetId(input.mode),
+    permission: isTaskPermission(input.permission) ? input.permission : undefined,
   }
 }
 

package/src/core/use-cases/task-update.ts

@@ -1,12 +1,31 @@
 /**
  * Update-task use case: apply an editable-field patch (title/description/
- * prompt) with a fresh updatedAt. Pure ledger transition (no persistence or
- * notify — the controller orchestrates those).
+ * prompt plus the execution targets workspaceId/mode/permission) with a
+ * fresh updatedAt. Pure ledger transition (no persistence or notify — the
+ * controller orchestrates those).
+ *
+ * An explicit `undefined` in the patch clears the field (the task falls
+ * back to the runtime default); an unknown permission string is ignored so
+ * stale UI can never persist a value the execution service rejects.
  */
-import type { TaskRecord } from '../tasks.ts'
+import { isTaskPermission, type TaskRecord, type TaskPermission } from '../tasks.ts'
 
 /** Editable fields on a task (the update patch surface). */
-export type TaskUpdatePatch = Partial<Pick<TaskRecord, 'title' | 'description' | 'prompt'>>
+export type TaskUpdatePatch = Partial<Pick<TaskRecord, 'title' | 'description' | 'prompt' | 'workspaceId' | 'mode' | 'permission'>>
+
+/** Collapse a blank target string to undefined (clears the pin). */
+function normalizeTargetId(value: string | undefined): string | undefined {
+  return value !== undefined && value.trim() === '' ? undefined : value
+}
+
+/** Keep an unknown permission string from entering the ledger. */
+function normalizePermission(
+  current: TaskPermission | undefined,
+  value: TaskPermission | undefined,
+): TaskPermission | undefined {
+  if (value === undefined) return undefined
+  return isTaskPermission(value) ? value : current
+}
 
 /**
  * Apply an update across the ledger. Tasks that do not match the id are left
@@ -22,5 +41,15 @@ export function applyUpdateTask(
   patch: TaskUpdatePatch,
   now: number,
 ): readonly TaskRecord[] {
-  return tasks.map(task => task.id === id ? { ...task, ...patch, updatedAt: now } : task)
+  return tasks.map(task => {
+    if (task.id !== id) return task
+    const workspaceId = 'workspaceId' in patch ? normalizeTargetId(patch.workspaceId) : undefined
+    const mode = 'mode' in patch ? normalizeTargetId(patch.mode) : undefined
+    const permission = 'permission' in patch ? normalizePermission(task.permission, patch.permission) : undefined
+    const next: TaskRecord = { ...task, ...patch, updatedAt: now }
+    if (workspaceId !== undefined || 'workspaceId' in patch) next.workspaceId = workspaceId
+    if (mode !== undefined || 'mode' in patch) next.mode = mode
+    if (permission !== undefined || 'permission' in patch) next.permission = permission
+    return next
+  })
 }

package/src/index.ts

@@ -22,7 +22,7 @@ const SECTION_ORDER = 200
 export const inject = ['systemPrompt']
 
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-export const TASK_BOARD_GUIDANCE = '本机已安装 dsh-task-board 插件（DSH Web GUI 的任务看板）：侧边栏「任务看板」入口；在 dsh-web-ui 插件全家桶仓库（packages/dsh-task-board）统一维护，经聚合包 web-ui-all 一键安装。能力：多列看板管理任务；任务可真实执行（驱动 agent 会话）；任务支持 5 段 cron 定时执行（如 0 23 * * *）；数据存浏览器 localStorage（键 dsh.taskBoard.v1）。限制：定时调度在浏览器端，需 GUI 标签页打开，错过即跳过；执行消耗 API 额度。用户提到「任务看板 / 看板 / 定时任务」时即指本插件，请据此协作。'
+export const TASK_BOARD_GUIDANCE = '本机已安装 dsh-task-board 插件（DSH Web GUI 的任务看板）：侧边栏「任务看板」入口；在 dsh-web-ui 插件全家桶仓库（packages/dsh-task-board）统一维护，经聚合包 web-ui-all 一键安装。能力：多列看板管理任务；任务可真实执行（驱动 agent 会话）；任务可钉住执行目标——工作区 / 模式（agent 预设）/ 权限（read-only / workspace-write / danger-full-access），缺省用运行时默认；任务支持 5 段 cron 定时执行（如 0 23 * * *）；数据存浏览器 localStorage（键 dsh.taskBoard.v1）。限制：定时调度在浏览器端，需 GUI 标签页打开，错过即跳过；执行消耗 API 额度。用户提到「任务看板 / 看板 / 定时任务」时即指本插件，请据此协作。'
 
 /**
  * Settings namespace of the board's announcement capability — the section the