@swarmclawai/swarmclaw 1.8.13 → 1.9.2

package/src/lib/server/tasks/task-service.ts

@@ -20,6 +20,28 @@ const TASK_STATUS_VALUES = new Set([
   'archived',
 ])
 
+const ASSIGNMENT_START_WORKFLOW_STATES = new Set(['triage', 'backlog', 'todo'])
+
+function hasOwn(record: Record<string, unknown>, key: string): boolean {
+  return Object.prototype.hasOwnProperty.call(record, key)
+}
+
+export function resolveAssignmentWorkflowStateTransition(params: {
+  previousAgentId?: string | null
+  nextAgentId?: string | null
+  previousWorkflowStateId?: string | null
+  explicitWorkflowState?: boolean
+}): string | null {
+  if (params.explicitWorkflowState) return null
+  const previousAgentId = typeof params.previousAgentId === 'string' ? params.previousAgentId.trim() : ''
+  const nextAgentId = typeof params.nextAgentId === 'string' ? params.nextAgentId.trim() : ''
+  if (!nextAgentId || nextAgentId === previousAgentId) return null
+  const currentWorkflow = typeof params.previousWorkflowStateId === 'string' && params.previousWorkflowStateId.trim()
+    ? params.previousWorkflowStateId.trim()
+    : 'backlog'
+  return ASSIGNMENT_START_WORKFLOW_STATES.has(currentWorkflow) ? 'in_progress' : null
+}
+
 export function deriveTaskTitle(input: { title?: unknown; description?: unknown }): string {
   const explicit = typeof input.title === 'string' ? input.title.replace(/\s+/g, ' ').trim() : ''
   if (explicit && !/^untitled task$/i.test(explicit)) return explicit.slice(0, 120)
@@ -157,6 +179,7 @@ export type PrepareTaskCreationResult =
 
 export function prepareTaskCreation(options: PrepareTaskCreationOptions): PrepareTaskCreationResult {
   const seed = options.seed ? { ...options.seed } : {}
+  delete seed.workType
   const explicitTitle = typeof options.input.title === 'string' ? options.input.title.trim() : ''
   const derivedTitle = deriveTaskTitle(options.input)
   const nextTitle = options.deriveTitleFromDescription
@@ -194,6 +217,9 @@ export function prepareTaskCreation(options: PrepareTaskCreationOptions): Prepar
       qualityGate,
     },
   })
+  if (!task.workflowStateId && task.agentId) {
+    task.workflowStateId = 'in_progress'
+  }
   task.fingerprint = computeTaskFingerprint(task.title || 'Untitled Task', task.agentId || '')
 
   const duplicate = task.fingerprint
@@ -227,6 +253,8 @@ export interface ApplyTaskPatchOptions {
 
 export function applyTaskPatch(options: ApplyTaskPatchOptions): BoardTask {
   const nextPatch = { ...options.patch }
+  const previousAgentId = options.task.agentId
+  const previousWorkflowStateId = options.task.workflowStateId || null
   if (Object.prototype.hasOwnProperty.call(nextPatch, 'status')) {
     const normalized = normalizeTaskStatusInput(nextPatch.status, options.task.status)
     if (normalized) nextPatch.status = normalized
@@ -240,6 +268,13 @@ export function applyTaskPatch(options: ApplyTaskPatchOptions): BoardTask {
 
   Object.assign(options.task, nextPatch, { updatedAt: options.now })
   if (options.clearProjectIdWhenNull && nextPatch.projectId === null) delete options.task.projectId
+  const workflowTransition = resolveAssignmentWorkflowStateTransition({
+    previousAgentId,
+    nextAgentId: options.task.agentId,
+    previousWorkflowStateId,
+    explicitWorkflowState: hasOwn(nextPatch, 'workflowStateId'),
+  })
+  if (workflowTransition) options.task.workflowStateId = workflowTransition
 
   if (options.task.status === 'completed') {
     const { validation } = refreshTaskCompletionValidation(options.task, options.settings)

package/src/lib/tasks.ts

@@ -1,5 +1,5 @@
 import { api } from './app/api-client'
-import type { BoardTask } from '../types'
+import type { BoardTask, TaskComment, TaskPreviewLink, TaskRuntimeService } from '../types'
 
 export const fetchTasks = (includeArchived = false) =>
   api<Record<string, BoardTask>>('GET', `/tasks${includeArchived ? '?includeArchived=true' : ''}`)
@@ -29,16 +29,24 @@ export interface GitHubIssueImportResult {
   skipped: GitHubIssueImportItem[]
 }
 
-export const createTask = (data: {
+export type TaskWriteInput = Partial<BoardTask> & {
+  title?: string
+  description?: string
+  agentId?: string
+  provisionWorkspace?: boolean
+  previewLinks?: Array<Partial<TaskPreviewLink> & { url: string }>
+  runtimeServices?: Array<Partial<TaskRuntimeService>>
+  appendComment?: TaskComment
+}
+
+export const createTask = (data: TaskWriteInput & {
   title: string
   description: string
   agentId: string
-  status?: string
-  qualityGate?: BoardTask['qualityGate']
 }) =>
   api<BoardTask>('POST', '/tasks', data)
 
-export const updateTask = (id: string, data: Partial<BoardTask>) =>
+export const updateTask = (id: string, data: TaskWriteInput) =>
   api<BoardTask>('PUT', `/tasks/${id}`, data)
 
 export const deleteTask = (id: string) =>

package/src/lib/validation/schemas.ts

@@ -200,6 +200,25 @@ export const TaskCreateSchema = z.object({
   retryBackoffSec: z.number().optional(),
   priority: z.enum(['low', 'medium', 'high', 'critical']).optional(),
   dueAt: z.number().nullable().optional(),
+  workflowStateId: z.string().nullable().optional(),
+  requiredCapabilities: z.array(z.string()).optional(),
+  provisionWorkspace: z.boolean().optional(),
+  previewLinks: z.array(z.object({
+    id: z.string().optional(),
+    label: z.string().optional(),
+    url: z.string().min(1),
+    kind: z.enum(['web', 'api', 'docs', 'custom']).optional(),
+    port: z.number().nullable().optional(),
+  })).optional(),
+  runtimeServices: z.array(z.object({
+    id: z.string().optional(),
+    name: z.string().optional(),
+    status: z.enum(['planned', 'running', 'stopped', 'failed', 'unknown']).optional(),
+    command: z.string().nullable().optional(),
+    url: z.string().nullable().optional(),
+    port: z.number().nullable().optional(),
+    startedAt: z.number().nullable().optional(),
+  })).optional(),
   qualityGate: z.object({
     enabled: z.boolean().optional(),
     minResultChars: z.number().optional(),

package/src/types/misc.ts

@@ -486,7 +486,7 @@ export interface MemoryEntry {
 
 export type KnowledgeSourceKind = 'manual' | 'file' | 'url'
 export type KnowledgeSyncStatus = 'ready' | 'syncing' | 'error'
-export type KnowledgeHygieneActionKind = 'sync' | 'reindex' | 'archive' | 'restore' | 'supersede'
+export type KnowledgeHygieneActionKind = 'sync' | 'reindex' | 'archive' | 'restore' | 'supersede' | 'prune'
 export type KnowledgeHygieneFindingKind = 'stale' | 'duplicate' | 'overlap' | 'broken' | 'archived' | 'superseded'
 
 export interface KnowledgeCitation {

package/src/types/task.ts

@@ -21,6 +21,64 @@ export interface TaskQualityGateConfig {
   requireReport?: boolean
 }
 
+export type TaskExecutionWorkspaceMode = 'task' | 'project' | 'custom'
+
+export interface TaskPreviewLink {
+  id: string
+  label: string
+  url: string
+  kind: 'web' | 'api' | 'docs' | 'custom'
+  port?: number | null
+  addedAt: number
+}
+
+export interface TaskRuntimeService {
+  id: string
+  name: string
+  status: 'planned' | 'running' | 'stopped' | 'failed' | 'unknown'
+  command?: string | null
+  url?: string | null
+  port?: number | null
+  startedAt?: number | null
+  updatedAt: number
+}
+
+export interface TaskExecutionWorkspace {
+  path: string
+  mode: TaskExecutionWorkspaceMode
+  sourceCwd?: string | null
+  projectId?: string | null
+  preparedAt: number
+  preparedBy?: string | null
+  readmePath?: string | null
+  previewLinks: TaskPreviewLink[]
+  runtimeServices: TaskRuntimeService[]
+}
+
+export type TaskLivenessState =
+  | 'not_started'
+  | 'ready'
+  | 'queued'
+  | 'blocked'
+  | 'running'
+  | 'stale'
+  | 'retrying'
+  | 'dead_lettered'
+  | 'completed'
+  | 'failed'
+  | 'cancelled'
+  | 'archived'
+
+export interface TaskLivenessSnapshot {
+  state: TaskLivenessState
+  reason: string
+  checkedAt: number
+  lastActivityAt?: number | null
+  nextWakeAt?: number | null
+  blockerTaskIds?: string[]
+  staleMs?: number | null
+}
+
 export interface BoardTask {
   id: string
   title: string
@@ -49,6 +107,10 @@ export interface BoardTask {
     type: 'image' | 'video' | 'pdf' | 'file'
     filename: string
   }>
+  executionWorkspace?: TaskExecutionWorkspace | null
+  previewLinks?: TaskPreviewLink[]
+  runtimeServices?: TaskRuntimeService[]
+  liveness?: TaskLivenessSnapshot | null
   comments?: TaskComment[]
   images?: string[]
   createdByAgentId?: string | null