digital-tasks 2.1.3 → 2.4.0

package/test/task.test.ts

@@ -35,13 +35,15 @@ describe('Task Management', () => {
       }
 
       const task = await createTask({
-        function: func,
+        tool: func,
         input: { text: 'Long article content...' },
         priority: 'high',
       })
 
       expect(task).toBeDefined()
       expect(task.id).toMatch(/^task_/)
+      expect(task.tool).toEqual(func)
+      // Legacy `function` alias still populated during deprecation window
       expect(task.function).toEqual(func)
       expect(task.priority).toBe('high')
       expect(task.status).toBe('queued')
@@ -60,11 +62,11 @@ describe('Task Management', () => {
       }
 
       const task = await createTask({
-        function: func,
+        tool: func,
         priority: 'normal',
       })
 
-      expect(task.function.type).toBe('code')
+      expect(task.tool?.type).toBe('code')
       expect(task.allowedWorkers).toEqual(['any'])
     })
 
@@ -79,7 +81,7 @@ describe('Task Management', () => {
       }
 
       const task = await createTask({
-        function: func,
+        tool: func,
       })
 
       expect(task.allowedWorkers).toEqual(['human'])
@@ -95,7 +97,7 @@ describe('Task Management', () => {
       }
 
       const task = await createTask({
-        function: func,
+        tool: func,
       })
 
       expect(task.allowedWorkers).toEqual(['agent'])
@@ -109,9 +111,9 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task1 = await createTask({ function: func })
+      const task1 = await createTask({ tool: func })
       const task2 = await createTask({
-        function: { ...func, name: 'task2' },
+        tool: { ...func, name: 'task2' },
         dependencies: [task1.id],
       })
 
@@ -137,7 +139,7 @@ describe('Task Management', () => {
       }
 
       const task = await createTask({
-        function: func,
+        tool: func,
         assignTo: worker,
       })
 
@@ -157,7 +159,7 @@ describe('Task Management', () => {
       const scheduledFor = new Date(Date.now() + 60000)
 
       const task = await createTask({
-        function: func,
+        tool: func,
         scheduledFor,
       })
 
@@ -174,7 +176,7 @@ describe('Task Management', () => {
       }
 
       const task = await createTask({
-        function: func,
+        tool: func,
         tags: ['urgent', 'frontend'],
         metadata: { source: 'api', version: '1.0' },
       })
@@ -182,6 +184,57 @@ describe('Task Management', () => {
       expect(task.tags).toEqual(['urgent', 'frontend'])
       expect(task.metadata).toEqual({ source: 'api', version: '1.0' })
     })
+
+    it('should set Action supertype fields ($type, verb, tool alias)', async () => {
+      const func: FunctionDefinition = {
+        type: 'generative',
+        name: 'summarize',
+        args: { text: 'text' },
+        output: 'string',
+      }
+
+      const task = await createTask({ tool: func })
+
+      // $type discriminator
+      expect(task.$type).toBe('Task')
+      // verb defaults to underlying function name
+      expect(task.verb).toBe('summarize')
+      // `tool` is canonical; legacy `function` alias mirrors it during
+      // the deprecation window (CONTEXT.md vocabulary migration).
+      expect(task.tool).toBe(task.function)
+    })
+
+    it('should accept GitHub-issue-shaped fields', async () => {
+      const func: FunctionDefinition = {
+        type: 'generative',
+        name: 'review-pr',
+        args: {},
+        output: 'string',
+      }
+
+      const assignees: WorkerRef[] = [
+        { type: 'human', id: 'user_1', name: 'Alice' },
+        { type: 'human', id: 'user_2', name: 'Bob' },
+      ]
+
+      const task = await createTask({
+        tool: func,
+        title: 'Review PR #42',
+        body: '## Summary\n\nReview the proposed change to the auth flow.',
+        labels: ['review', 'auth'],
+        project: 'sprint-12',
+        assignees,
+      })
+
+      expect(task.title).toBe('Review PR #42')
+      expect(task.body).toContain('Review the proposed change')
+      expect(task.labels).toEqual(['review', 'auth'])
+      expect(task.project).toBe('sprint-12')
+      expect(task.assignees).toEqual(assignees)
+      // First assignee becomes primary `assignment`
+      expect(task.assignment?.worker).toEqual(assignees[0])
+      expect(task.status).toBe('assigned')
+    })
   })
 
   describe('getTask()', () => {
@@ -193,7 +246,7 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const created = await createTask({ function: func })
+      const created = await createTask({ tool: func })
       const retrieved = await getTask(created.id)
 
       expect(retrieved).toBeDefined()
@@ -215,7 +268,7 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task = await createTask({ function: func })
+      const task = await createTask({ tool: func })
       const worker: WorkerRef = { type: 'agent', id: 'agent_1', name: 'Worker' }
 
       const started = await startTask(task.id, worker)
@@ -241,7 +294,7 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task = await createTask({ function: func })
+      const task = await createTask({ tool: func })
       const updated = await updateProgress(task.id, 50, 'Processing data')
 
       expect(updated).toBeDefined()
@@ -259,7 +312,7 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task = await createTask({ function: func })
+      const task = await createTask({ tool: func })
       const worker: WorkerRef = { type: 'agent', id: 'agent_1' }
       await startTask(task.id, worker)
 
@@ -287,7 +340,7 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task = await createTask({ function: func })
+      const task = await createTask({ tool: func })
       const result = await failTask(task.id, 'Something went wrong')
 
       expect(result.success).toBe(false)
@@ -303,7 +356,7 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task = await createTask({ function: func })
+      const task = await createTask({ tool: func })
       const error = new Error('Error object message')
       const result = await failTask(task.id, error)
 
@@ -321,7 +374,7 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task = await createTask({ function: func })
+      const task = await createTask({ tool: func })
       const cancelled = await cancelTask(task.id, 'No longer needed')
 
       expect(cancelled).toBe(true)
@@ -345,13 +398,13 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task = await createTask({ function: func })
+      const task = await createTask({ tool: func })
       const author: WorkerRef = { type: 'human', id: 'user_1', name: 'John' }
 
       const updated = await addComment(task.id, 'This is a comment', author)
 
       expect(updated).toBeDefined()
-      const commentEvent = updated!.events?.find(e => e.type === 'comment')
+      const commentEvent = updated!.events?.find((e) => e.type === 'comment')
       expect(commentEvent).toBeDefined()
       expect(commentEvent!.message).toBe('This is a comment')
       expect(commentEvent!.actor).toEqual(author)
@@ -367,10 +420,10 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const parent = await createTask({ function: func })
+      const parent = await createTask({ tool: func })
 
       const subtask = await createSubtask(parent.id, {
-        function: {
+        tool: {
           type: 'generative',
           name: 'subtask',
           args: {},
@@ -391,13 +444,13 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const parent = await createTask({ function: func })
+      const parent = await createTask({ tool: func })
 
       await createSubtask(parent.id, {
-        function: { type: 'generative', name: 'sub1', args: {}, output: 'string' },
+        tool: { type: 'generative', name: 'sub1', args: {}, output: 'string' },
       })
       await createSubtask(parent.id, {
-        function: { type: 'generative', name: 'sub2', args: {}, output: 'string' },
+        tool: { type: 'generative', name: 'sub2', args: {}, output: 'string' },
       })
 
       const subtasks = await getSubtasks(parent.id)
@@ -414,7 +467,7 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task = await createTask({ function: func })
+      const task = await createTask({ tool: func })
       await completeTask(task.id, 'done')
 
       const result = await waitForTask(task.id, { timeout: 1000 })
@@ -431,7 +484,7 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task = await createTask({ function: func })
+      const task = await createTask({ tool: func })
       await failTask(task.id, 'task failed')
 
       const result = await waitForTask(task.id, { timeout: 1000 })
@@ -447,7 +500,7 @@ describe('Task Management', () => {
         output: 'string',
       }
 
-      const task = await createTask({ function: func })
+      const task = await createTask({ tool: func })
       await cancelTask(task.id)
 
       const result = await waitForTask(task.id, { timeout: 1000 })