digital-tasks 2.1.3 → 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.turbo/turbo-build.log +1 -1
- package/CHANGELOG.md +18 -0
- package/README.md +560 -0
- package/dist/client.d.ts +202 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +85 -0
- package/dist/client.js.map +1 -0
- package/dist/index.d.ts +9 -7
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -6
- package/dist/index.js.map +1 -1
- package/dist/markdown.d.ts.map +1 -1
- package/dist/markdown.js +48 -27
- package/dist/markdown.js.map +1 -1
- package/dist/project.d.ts.map +1 -1
- package/dist/project.js +48 -30
- package/dist/project.js.map +1 -1
- package/dist/queue.d.ts.map +1 -1
- package/dist/queue.js +70 -31
- package/dist/queue.js.map +1 -1
- package/dist/task.d.ts +1 -1
- package/dist/task.d.ts.map +1 -1
- package/dist/task.js +122 -60
- package/dist/task.js.map +1 -1
- package/dist/types.d.ts +135 -22
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +10 -2
- package/dist/types.js.map +1 -1
- package/dist/worker.d.ts +264 -0
- package/dist/worker.d.ts.map +1 -0
- package/dist/worker.js +656 -0
- package/dist/worker.js.map +1 -0
- package/package.json +29 -14
- package/src/client.ts +268 -0
- package/src/index.ts +12 -10
- package/src/markdown.ts +63 -48
- package/src/project.ts +57 -42
- package/src/queue.ts +76 -37
- package/src/task.ts +132 -75
- package/src/types.ts +177 -40
- package/src/worker.ts +959 -0
- package/test/project.test.ts +28 -84
- package/test/queue.test.ts +51 -24
- package/test/task.test.ts +80 -27
- package/test/worker.test.ts +1158 -0
- package/tsconfig.json +2 -13
- package/vitest.config.ts +48 -0
- package/wrangler.jsonc +44 -0
- package/LICENSE +0 -21
- package/dist/function-task.d.ts +0 -319
- package/dist/function-task.d.ts.map +0 -1
- package/dist/function-task.js +0 -286
- package/dist/function-task.js.map +0 -1
- package/src/index.js +0 -73
- package/src/markdown.js +0 -509
- package/src/project.js +0 -396
- package/src/queue.js +0 -346
- package/src/task.js +0 -320
- package/src/types.js +0 -14
package/dist/task.js
CHANGED
|
@@ -16,7 +16,7 @@ function generateTaskId() {
|
|
|
16
16
|
* @example
|
|
17
17
|
* ```ts
|
|
18
18
|
* const task = await createTask({
|
|
19
|
-
*
|
|
19
|
+
* tool: {
|
|
20
20
|
* type: 'generative',
|
|
21
21
|
* name: 'summarize',
|
|
22
22
|
* args: { text: 'The text to summarize' },
|
|
@@ -30,6 +30,13 @@ function generateTaskId() {
|
|
|
30
30
|
*/
|
|
31
31
|
export async function createTask(options) {
|
|
32
32
|
const now = new Date();
|
|
33
|
+
// Resolve the underlying Tool from either `tool` (preferred) or
|
|
34
|
+
// the legacy `function` alias. Exactly one path is required; throw
|
|
35
|
+
// a clear error if neither is set so callers see this at runtime.
|
|
36
|
+
const tool = options.tool ?? options.function;
|
|
37
|
+
if (!tool) {
|
|
38
|
+
throw new Error("createTask requires a 'tool' (preferred) or legacy 'function' option");
|
|
39
|
+
}
|
|
33
40
|
// Convert string dependencies to TaskDependency array
|
|
34
41
|
let dependencies;
|
|
35
42
|
if (options.dependencies && options.dependencies.length > 0) {
|
|
@@ -39,10 +46,10 @@ export async function createTask(options) {
|
|
|
39
46
|
satisfied: false,
|
|
40
47
|
}));
|
|
41
48
|
}
|
|
42
|
-
// Determine allowed workers from function type
|
|
49
|
+
// Determine allowed workers from the Tool's function type
|
|
43
50
|
let allowedWorkers = options.allowedWorkers;
|
|
44
51
|
if (!allowedWorkers) {
|
|
45
|
-
const funcType =
|
|
52
|
+
const funcType = tool.type;
|
|
46
53
|
if (funcType === 'human') {
|
|
47
54
|
allowedWorkers = ['human'];
|
|
48
55
|
}
|
|
@@ -55,26 +62,69 @@ export async function createTask(options) {
|
|
|
55
62
|
}
|
|
56
63
|
const task = {
|
|
57
64
|
id: generateTaskId(),
|
|
58
|
-
|
|
65
|
+
$type: 'Task',
|
|
66
|
+
// Action supertype: every Task is an Action of some Verb. Default
|
|
67
|
+
// the verb to the underlying Tool's name when not supplied.
|
|
68
|
+
verb: tool.name,
|
|
69
|
+
// Tool is the canonical field (CONTEXT.md). The legacy `function`
|
|
70
|
+
// alias is populated alongside for the duration of the deprecation
|
|
71
|
+
// window so older readers continue to work.
|
|
72
|
+
tool,
|
|
73
|
+
function: tool,
|
|
59
74
|
status: options.scheduledFor ? 'pending' : 'queued',
|
|
60
75
|
priority: options.priority || 'normal',
|
|
61
|
-
input: options.input,
|
|
62
76
|
allowedWorkers,
|
|
63
|
-
dependencies,
|
|
64
|
-
scheduledFor: options.scheduledFor,
|
|
65
|
-
deadline: options.deadline,
|
|
66
|
-
timeout: options.timeout,
|
|
67
|
-
tags: options.tags,
|
|
68
|
-
parentId: options.parentId,
|
|
69
|
-
projectId: options.projectId,
|
|
70
|
-
metadata: options.metadata,
|
|
71
77
|
createdAt: now,
|
|
72
78
|
events: [],
|
|
73
79
|
};
|
|
74
|
-
|
|
75
|
-
|
|
80
|
+
if (options.input !== undefined) {
|
|
81
|
+
task.input = options.input;
|
|
82
|
+
}
|
|
83
|
+
if (dependencies !== undefined) {
|
|
84
|
+
task.dependencies = dependencies;
|
|
85
|
+
}
|
|
86
|
+
if (options.scheduledFor !== undefined) {
|
|
87
|
+
task.scheduledFor = options.scheduledFor;
|
|
88
|
+
}
|
|
89
|
+
if (options.deadline !== undefined) {
|
|
90
|
+
task.deadline = options.deadline;
|
|
91
|
+
}
|
|
92
|
+
if (options.timeout !== undefined) {
|
|
93
|
+
task.timeout = options.timeout;
|
|
94
|
+
}
|
|
95
|
+
if (options.tags !== undefined) {
|
|
96
|
+
task.tags = options.tags;
|
|
97
|
+
}
|
|
98
|
+
if (options.parentId !== undefined) {
|
|
99
|
+
task.parentId = options.parentId;
|
|
100
|
+
}
|
|
101
|
+
if (options.projectId !== undefined) {
|
|
102
|
+
task.projectId = options.projectId;
|
|
103
|
+
}
|
|
104
|
+
if (options.metadata !== undefined) {
|
|
105
|
+
task.metadata = options.metadata;
|
|
106
|
+
}
|
|
107
|
+
// Issue-shaped fields (SVO co-design)
|
|
108
|
+
if (options.title !== undefined) {
|
|
109
|
+
task.title = options.title;
|
|
110
|
+
}
|
|
111
|
+
if (options.body !== undefined) {
|
|
112
|
+
task.body = options.body;
|
|
113
|
+
}
|
|
114
|
+
if (options.labels !== undefined) {
|
|
115
|
+
task.labels = options.labels;
|
|
116
|
+
}
|
|
117
|
+
if (options.project !== undefined) {
|
|
118
|
+
task.project = options.project;
|
|
119
|
+
}
|
|
120
|
+
if (options.assignees !== undefined) {
|
|
121
|
+
task.assignees = options.assignees;
|
|
122
|
+
}
|
|
123
|
+
// Auto-assign if specified (single primary worker takes precedence)
|
|
124
|
+
const primaryAssignee = options.assignTo ?? options.assignees?.[0];
|
|
125
|
+
if (primaryAssignee) {
|
|
76
126
|
task.assignment = {
|
|
77
|
-
worker:
|
|
127
|
+
worker: primaryAssignee,
|
|
78
128
|
assignedAt: now,
|
|
79
129
|
};
|
|
80
130
|
task.status = 'assigned';
|
|
@@ -123,12 +173,15 @@ export async function startTask(taskId, worker) {
|
|
|
123
173
|
* Update task progress
|
|
124
174
|
*/
|
|
125
175
|
export async function updateProgress(taskId, percent, step) {
|
|
176
|
+
const progressUpdate = {
|
|
177
|
+
percent,
|
|
178
|
+
updatedAt: new Date(),
|
|
179
|
+
};
|
|
180
|
+
if (step !== undefined) {
|
|
181
|
+
progressUpdate.step = step;
|
|
182
|
+
}
|
|
126
183
|
return taskQueue.update(taskId, {
|
|
127
|
-
progress:
|
|
128
|
-
percent,
|
|
129
|
-
step,
|
|
130
|
-
updatedAt: new Date(),
|
|
131
|
-
},
|
|
184
|
+
progress: progressUpdate,
|
|
132
185
|
event: {
|
|
133
186
|
type: 'progress',
|
|
134
187
|
message: step || `Progress: ${percent}%`,
|
|
@@ -152,18 +205,19 @@ export async function completeTask(taskId, output) {
|
|
|
152
205
|
};
|
|
153
206
|
}
|
|
154
207
|
await taskQueue.complete(taskId, output);
|
|
208
|
+
const metadata = {
|
|
209
|
+
duration: task.startedAt ? Date.now() - task.startedAt.getTime() : 0,
|
|
210
|
+
startedAt: task.startedAt || new Date(),
|
|
211
|
+
completedAt: new Date(),
|
|
212
|
+
};
|
|
213
|
+
if (task.assignment?.worker !== undefined) {
|
|
214
|
+
metadata.worker = task.assignment.worker;
|
|
215
|
+
}
|
|
155
216
|
return {
|
|
156
217
|
taskId,
|
|
157
218
|
success: true,
|
|
158
219
|
output,
|
|
159
|
-
metadata
|
|
160
|
-
duration: task.startedAt
|
|
161
|
-
? Date.now() - task.startedAt.getTime()
|
|
162
|
-
: 0,
|
|
163
|
-
startedAt: task.startedAt || new Date(),
|
|
164
|
-
completedAt: new Date(),
|
|
165
|
-
worker: task.assignment?.worker,
|
|
166
|
-
},
|
|
220
|
+
metadata,
|
|
167
221
|
};
|
|
168
222
|
}
|
|
169
223
|
/**
|
|
@@ -183,6 +237,14 @@ export async function failTask(taskId, error) {
|
|
|
183
237
|
}
|
|
184
238
|
const errorMessage = error instanceof Error ? error.message : error;
|
|
185
239
|
await taskQueue.fail(taskId, errorMessage);
|
|
240
|
+
const failMetadata = {
|
|
241
|
+
duration: task.startedAt ? Date.now() - task.startedAt.getTime() : 0,
|
|
242
|
+
startedAt: task.startedAt || new Date(),
|
|
243
|
+
completedAt: new Date(),
|
|
244
|
+
};
|
|
245
|
+
if (task.assignment?.worker !== undefined) {
|
|
246
|
+
failMetadata.worker = task.assignment.worker;
|
|
247
|
+
}
|
|
186
248
|
return {
|
|
187
249
|
taskId,
|
|
188
250
|
success: false,
|
|
@@ -191,14 +253,7 @@ export async function failTask(taskId, error) {
|
|
|
191
253
|
message: errorMessage,
|
|
192
254
|
details: error instanceof Error ? { stack: error.stack } : undefined,
|
|
193
255
|
},
|
|
194
|
-
metadata:
|
|
195
|
-
duration: task.startedAt
|
|
196
|
-
? Date.now() - task.startedAt.getTime()
|
|
197
|
-
: 0,
|
|
198
|
-
startedAt: task.startedAt || new Date(),
|
|
199
|
-
completedAt: new Date(),
|
|
200
|
-
worker: task.assignment?.worker,
|
|
201
|
-
},
|
|
256
|
+
metadata: failMetadata,
|
|
202
257
|
};
|
|
203
258
|
}
|
|
204
259
|
/**
|
|
@@ -221,13 +276,14 @@ export async function cancelTask(taskId, reason) {
|
|
|
221
276
|
* Add a comment to a task
|
|
222
277
|
*/
|
|
223
278
|
export async function addComment(taskId, comment, author) {
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
}
|
|
279
|
+
const event = {
|
|
280
|
+
type: 'comment',
|
|
281
|
+
message: comment,
|
|
282
|
+
};
|
|
283
|
+
if (author !== undefined) {
|
|
284
|
+
event.actor = author;
|
|
285
|
+
}
|
|
286
|
+
return taskQueue.update(taskId, { event });
|
|
231
287
|
}
|
|
232
288
|
/**
|
|
233
289
|
* Create a subtask
|
|
@@ -264,21 +320,34 @@ export async function waitForTask(taskId, options) {
|
|
|
264
320
|
};
|
|
265
321
|
}
|
|
266
322
|
if (task.status === 'completed') {
|
|
323
|
+
const completedMeta = {
|
|
324
|
+
duration: task.completedAt && task.startedAt
|
|
325
|
+
? task.completedAt.getTime() - task.startedAt.getTime()
|
|
326
|
+
: 0,
|
|
327
|
+
startedAt: task.startedAt || task.createdAt,
|
|
328
|
+
completedAt: task.completedAt || new Date(),
|
|
329
|
+
};
|
|
330
|
+
if (task.assignment?.worker !== undefined) {
|
|
331
|
+
completedMeta.worker = task.assignment.worker;
|
|
332
|
+
}
|
|
267
333
|
return {
|
|
268
334
|
taskId,
|
|
269
335
|
success: true,
|
|
270
336
|
output: task.output,
|
|
271
|
-
metadata:
|
|
272
|
-
duration: task.completedAt && task.startedAt
|
|
273
|
-
? task.completedAt.getTime() - task.startedAt.getTime()
|
|
274
|
-
: 0,
|
|
275
|
-
startedAt: task.startedAt || task.createdAt,
|
|
276
|
-
completedAt: task.completedAt || new Date(),
|
|
277
|
-
worker: task.assignment?.worker,
|
|
278
|
-
},
|
|
337
|
+
metadata: completedMeta,
|
|
279
338
|
};
|
|
280
339
|
}
|
|
281
340
|
if (task.status === 'failed') {
|
|
341
|
+
const failedMeta = {
|
|
342
|
+
duration: task.completedAt && task.startedAt
|
|
343
|
+
? task.completedAt.getTime() - task.startedAt.getTime()
|
|
344
|
+
: 0,
|
|
345
|
+
startedAt: task.startedAt || task.createdAt,
|
|
346
|
+
completedAt: task.completedAt || new Date(),
|
|
347
|
+
};
|
|
348
|
+
if (task.assignment?.worker !== undefined) {
|
|
349
|
+
failedMeta.worker = task.assignment.worker;
|
|
350
|
+
}
|
|
282
351
|
return {
|
|
283
352
|
taskId,
|
|
284
353
|
success: false,
|
|
@@ -286,14 +355,7 @@ export async function waitForTask(taskId, options) {
|
|
|
286
355
|
code: 'TASK_FAILED',
|
|
287
356
|
message: task.error || 'Task failed',
|
|
288
357
|
},
|
|
289
|
-
metadata:
|
|
290
|
-
duration: task.completedAt && task.startedAt
|
|
291
|
-
? task.completedAt.getTime() - task.startedAt.getTime()
|
|
292
|
-
: 0,
|
|
293
|
-
startedAt: task.startedAt || task.createdAt,
|
|
294
|
-
completedAt: task.completedAt || new Date(),
|
|
295
|
-
worker: task.assignment?.worker,
|
|
296
|
-
},
|
|
358
|
+
metadata: failedMeta,
|
|
297
359
|
};
|
|
298
360
|
}
|
|
299
361
|
if (task.status === 'cancelled') {
|
package/dist/task.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;
|
|
1
|
+
{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -1,9 +1,17 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Types for digital-tasks
|
|
3
3
|
*
|
|
4
|
-
* Task =
|
|
4
|
+
* Task = Action + issue-shaped metadata (title, body, comments, labels,
|
|
5
|
+
* dependencies, assignees, project). A Task is a specialization of an
|
|
6
|
+
* `Action` (`digital-objects.Action`) with project-management overlay,
|
|
7
|
+
* per the SVO co-design (`docs/plans/2026-05-05-svo-co-design.md`).
|
|
5
8
|
*
|
|
6
|
-
* Every task
|
|
9
|
+
* Every task wraps a callable Verb — historically the `function` field
|
|
10
|
+
* (an `ai-functions.FunctionDefinition`). Per CONTEXT.md the canonical
|
|
11
|
+
* name for callable Verbs is **Tool**; `function` is being renamed to
|
|
12
|
+
* `tool` over time. See the `function` / `tool` fields below.
|
|
13
|
+
*
|
|
14
|
+
* The function (now Tool) can be:
|
|
7
15
|
* - Code: generates executable code
|
|
8
16
|
* - Generative: AI generates content (no tools)
|
|
9
17
|
* - Agentic: AI with tools in a loop
|
|
@@ -12,7 +20,9 @@
|
|
|
12
20
|
* @packageDocumentation
|
|
13
21
|
*/
|
|
14
22
|
import type { FunctionDefinition, CodeFunctionDefinition, GenerativeFunctionDefinition, AgenticFunctionDefinition, HumanFunctionDefinition } from 'ai-functions';
|
|
23
|
+
import type { Action } from 'digital-objects';
|
|
15
24
|
export type { FunctionDefinition, CodeFunctionDefinition, GenerativeFunctionDefinition, AgenticFunctionDefinition, HumanFunctionDefinition, };
|
|
25
|
+
export type { Action };
|
|
16
26
|
/**
|
|
17
27
|
* Task lifecycle status
|
|
18
28
|
*/
|
|
@@ -78,17 +88,83 @@ export interface TaskEvent {
|
|
|
78
88
|
message?: string;
|
|
79
89
|
}
|
|
80
90
|
/**
|
|
81
|
-
*
|
|
91
|
+
* Comment - a thin wrapper around a comment posted on a Task.
|
|
82
92
|
*
|
|
83
|
-
*
|
|
84
|
-
*
|
|
93
|
+
* Per the SVO co-design, comments are child Actions of verb 'commented'
|
|
94
|
+
* whose `cause` role points back at the parent Task's Action id. This
|
|
95
|
+
* shape is the surfaced view of such an Action for issue-shaped UIs.
|
|
85
96
|
*/
|
|
86
|
-
export interface
|
|
87
|
-
/**
|
|
97
|
+
export interface Comment {
|
|
98
|
+
/** Comment id (matches the underlying Action id when persisted) */
|
|
88
99
|
id: string;
|
|
89
|
-
/**
|
|
90
|
-
|
|
91
|
-
/**
|
|
100
|
+
/** Markdown body of the comment */
|
|
101
|
+
body: string;
|
|
102
|
+
/** Who posted the comment */
|
|
103
|
+
author?: WorkerRef;
|
|
104
|
+
/** When the comment was posted */
|
|
105
|
+
createdAt: Date;
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* Task = Action + issue-shaped metadata
|
|
109
|
+
*
|
|
110
|
+
* A Task is a specialization of `digital-objects.Action` carrying
|
|
111
|
+
* project-management overlay (title, body, comments, labels,
|
|
112
|
+
* dependencies, assignees, milestone/project). The Action supertype
|
|
113
|
+
* provides id/verb/subject/object/roles/data/createdAt/completedAt.
|
|
114
|
+
*
|
|
115
|
+
* Status: Action's status taxonomy is lifecycle-only
|
|
116
|
+
* (pending/active/completed/failed/cancelled). Task's status taxonomy
|
|
117
|
+
* is project-management shaped (queued/assigned/in_progress/blocked/
|
|
118
|
+
* review/...). We omit Action's `status` and replace it with the
|
|
119
|
+
* Task-specific `TaskStatus`. Both supersets share `pending`,
|
|
120
|
+
* `completed`, `failed`, `cancelled`.
|
|
121
|
+
*
|
|
122
|
+
* Verb: every Task is an Action of some Verb. For tasks created via
|
|
123
|
+
* the legacy `createTask({ function })` path, `verb` defaults to the
|
|
124
|
+
* function's name (e.g. `'summarize'`).
|
|
125
|
+
*
|
|
126
|
+
* Backward compatibility: all previously-valid Task shapes remain
|
|
127
|
+
* assignable. Newly added fields (title/body/labels/project/assignees/
|
|
128
|
+
* comments/$type/verb) are optional or have defaults populated by
|
|
129
|
+
* `createTask`.
|
|
130
|
+
*/
|
|
131
|
+
export type Task<TInput = unknown, TOutput = unknown> = Omit<Action<TInput>, 'status'> & {
|
|
132
|
+
/** MDXLD type discriminator */
|
|
133
|
+
$type?: 'Task';
|
|
134
|
+
/**
|
|
135
|
+
* The Tool (callable Verb) this task executes. This is the canonical
|
|
136
|
+
* field per CONTEXT.md. `createTask` always populates `tool`; the
|
|
137
|
+
* legacy `function` alias is also populated during the deprecation
|
|
138
|
+
* window so existing readers keep working.
|
|
139
|
+
*
|
|
140
|
+
* Optional on the type so that older literals constructed with only
|
|
141
|
+
* `function` still typecheck; in practice every Task has exactly one
|
|
142
|
+
* underlying callable Verb available via `task.tool ?? task.function`.
|
|
143
|
+
*/
|
|
144
|
+
tool?: FunctionDefinition<TInput, TOutput>;
|
|
145
|
+
/**
|
|
146
|
+
* Legacy alias for `tool`.
|
|
147
|
+
*
|
|
148
|
+
* @deprecated Use `tool` instead. The canonical name for callable
|
|
149
|
+
* Verbs is **Tool** (see CONTEXT.md). `createTask` continues to
|
|
150
|
+
* populate this alongside `tool` for the duration of the deprecation
|
|
151
|
+
* window. Slated for removal in the next major version.
|
|
152
|
+
*/
|
|
153
|
+
function?: FunctionDefinition<TInput, TOutput>;
|
|
154
|
+
/** Issue title (short, single-line) */
|
|
155
|
+
title?: string;
|
|
156
|
+
/** Rich markdown body / description */
|
|
157
|
+
body?: string;
|
|
158
|
+
/** GitHub-issue-shaped labels */
|
|
159
|
+
labels?: string[];
|
|
160
|
+
/** Milestone or project reference (string ref; cf. `projectId` for
|
|
161
|
+
* the durable internal id when a `Project` exists in this package). */
|
|
162
|
+
project?: string;
|
|
163
|
+
/** Comments posted on this task (child Actions of verb 'commented') */
|
|
164
|
+
comments?: Comment[];
|
|
165
|
+
/** Workers assigned to this task */
|
|
166
|
+
assignees?: WorkerRef[];
|
|
167
|
+
/** Current task status (specialization — see jsdoc above) */
|
|
92
168
|
status: TaskStatus;
|
|
93
169
|
/** Priority level */
|
|
94
170
|
priority: TaskPriority;
|
|
@@ -98,29 +174,26 @@ export interface Task<TInput = unknown, TOutput = unknown> {
|
|
|
98
174
|
output?: TOutput;
|
|
99
175
|
/** Error (when failed) */
|
|
100
176
|
error?: string;
|
|
101
|
-
/**
|
|
177
|
+
/** Worker types permitted to claim this task */
|
|
102
178
|
allowedWorkers?: WorkerType[];
|
|
103
|
-
/** Current assignment */
|
|
179
|
+
/** Current assignment (single primary worker) */
|
|
104
180
|
assignment?: TaskAssignment;
|
|
105
181
|
/** Task dependencies */
|
|
106
182
|
dependencies?: TaskDependency[];
|
|
107
183
|
/** Current progress */
|
|
108
184
|
progress?: TaskProgress;
|
|
109
|
-
/** When created */
|
|
110
|
-
createdAt: Date;
|
|
111
185
|
/** Scheduled start time */
|
|
112
186
|
scheduledFor?: Date;
|
|
113
187
|
/** Deadline */
|
|
114
188
|
deadline?: Date;
|
|
115
189
|
/** When started */
|
|
116
190
|
startedAt?: Date;
|
|
117
|
-
/** When completed */
|
|
118
|
-
completedAt?: Date;
|
|
119
191
|
/** Timeout in ms */
|
|
120
192
|
timeout?: number;
|
|
121
193
|
/** Parent task ID */
|
|
122
194
|
parentId?: string;
|
|
123
|
-
/** Project ID
|
|
195
|
+
/** Project ID (internal `Project.id` when this Task belongs to a
|
|
196
|
+
* Project in this package; distinct from `project` ref string) */
|
|
124
197
|
projectId?: string;
|
|
125
198
|
/** Tags */
|
|
126
199
|
tags?: string[];
|
|
@@ -128,6 +201,17 @@ export interface Task<TInput = unknown, TOutput = unknown> {
|
|
|
128
201
|
metadata?: Record<string, unknown>;
|
|
129
202
|
/** Event history */
|
|
130
203
|
events?: TaskEvent[];
|
|
204
|
+
};
|
|
205
|
+
/**
|
|
206
|
+
* Task dependency tuple — minimal shape from the SVO design doc.
|
|
207
|
+
*
|
|
208
|
+
* `TaskDependency` (above) is the richer in-package shape with a
|
|
209
|
+
* full DependencyType set; `TaskDep` is the issue-shaped pair from
|
|
210
|
+
* the design doc, retained as a convenience export.
|
|
211
|
+
*/
|
|
212
|
+
export interface TaskDep {
|
|
213
|
+
taskId: string;
|
|
214
|
+
type: 'blocked_by' | 'related';
|
|
131
215
|
}
|
|
132
216
|
/**
|
|
133
217
|
* Any task (for collections)
|
|
@@ -137,7 +221,10 @@ export type AnyTask = Task<any, any>;
|
|
|
137
221
|
* Create task from a Code function
|
|
138
222
|
*/
|
|
139
223
|
export interface CodeTaskOptions<TInput = unknown, TOutput = unknown> {
|
|
140
|
-
function
|
|
224
|
+
/** Tool (callable Verb) to run. Preferred over `function`. */
|
|
225
|
+
tool?: CodeFunctionDefinition<TInput, TOutput>;
|
|
226
|
+
/** @deprecated Use `tool` instead. */
|
|
227
|
+
function?: CodeFunctionDefinition<TInput, TOutput>;
|
|
141
228
|
input?: TInput;
|
|
142
229
|
priority?: TaskPriority;
|
|
143
230
|
assignTo?: WorkerRef;
|
|
@@ -151,7 +238,10 @@ export interface CodeTaskOptions<TInput = unknown, TOutput = unknown> {
|
|
|
151
238
|
* Create task from a Generative function
|
|
152
239
|
*/
|
|
153
240
|
export interface GenerativeTaskOptions<TInput = unknown, TOutput = unknown> {
|
|
154
|
-
function
|
|
241
|
+
/** Tool (callable Verb) to run. Preferred over `function`. */
|
|
242
|
+
tool?: GenerativeFunctionDefinition<TInput, TOutput>;
|
|
243
|
+
/** @deprecated Use `tool` instead. */
|
|
244
|
+
function?: GenerativeFunctionDefinition<TInput, TOutput>;
|
|
155
245
|
input?: TInput;
|
|
156
246
|
priority?: TaskPriority;
|
|
157
247
|
assignTo?: WorkerRef;
|
|
@@ -165,7 +255,10 @@ export interface GenerativeTaskOptions<TInput = unknown, TOutput = unknown> {
|
|
|
165
255
|
* Create task from an Agentic function
|
|
166
256
|
*/
|
|
167
257
|
export interface AgenticTaskOptions<TInput = unknown, TOutput = unknown> {
|
|
168
|
-
function
|
|
258
|
+
/** Tool (callable Verb) to run. Preferred over `function`. */
|
|
259
|
+
tool?: AgenticFunctionDefinition<TInput, TOutput>;
|
|
260
|
+
/** @deprecated Use `tool` instead. */
|
|
261
|
+
function?: AgenticFunctionDefinition<TInput, TOutput>;
|
|
169
262
|
input?: TInput;
|
|
170
263
|
priority?: TaskPriority;
|
|
171
264
|
assignTo?: WorkerRef;
|
|
@@ -179,7 +272,10 @@ export interface AgenticTaskOptions<TInput = unknown, TOutput = unknown> {
|
|
|
179
272
|
* Create task from a Human function
|
|
180
273
|
*/
|
|
181
274
|
export interface HumanTaskOptions<TInput = unknown, TOutput = unknown> {
|
|
182
|
-
function
|
|
275
|
+
/** Tool (callable Verb) to run. Preferred over `function`. */
|
|
276
|
+
tool?: HumanFunctionDefinition<TInput, TOutput>;
|
|
277
|
+
/** @deprecated Use `tool` instead. */
|
|
278
|
+
function?: HumanFunctionDefinition<TInput, TOutput>;
|
|
183
279
|
input?: TInput;
|
|
184
280
|
priority?: TaskPriority;
|
|
185
281
|
assignTo?: WorkerRef;
|
|
@@ -191,13 +287,22 @@ export interface HumanTaskOptions<TInput = unknown, TOutput = unknown> {
|
|
|
191
287
|
}
|
|
192
288
|
/**
|
|
193
289
|
* Generic task creation options
|
|
290
|
+
*
|
|
291
|
+
* Either `tool` (preferred) or the deprecated `function` alias must be
|
|
292
|
+
* provided. `createTask` normalizes to `tool` and also populates the
|
|
293
|
+
* legacy `function` alias on the resulting Task for backward compat.
|
|
194
294
|
*/
|
|
195
295
|
export interface CreateTaskOptions<TInput = unknown, TOutput = unknown> {
|
|
196
|
-
function
|
|
296
|
+
/** Tool (callable Verb) to run. Preferred over `function`. */
|
|
297
|
+
tool?: FunctionDefinition<TInput, TOutput>;
|
|
298
|
+
/** @deprecated Use `tool` instead. */
|
|
299
|
+
function?: FunctionDefinition<TInput, TOutput>;
|
|
197
300
|
input?: TInput;
|
|
198
301
|
priority?: TaskPriority;
|
|
199
302
|
allowedWorkers?: WorkerType[];
|
|
200
303
|
assignTo?: WorkerRef;
|
|
304
|
+
/** Multiple assignees (issue-shaped); first becomes the primary `assignment` */
|
|
305
|
+
assignees?: WorkerRef[];
|
|
201
306
|
dependencies?: string[];
|
|
202
307
|
scheduledFor?: Date;
|
|
203
308
|
deadline?: Date;
|
|
@@ -206,6 +311,14 @@ export interface CreateTaskOptions<TInput = unknown, TOutput = unknown> {
|
|
|
206
311
|
parentId?: string;
|
|
207
312
|
projectId?: string;
|
|
208
313
|
metadata?: Record<string, unknown>;
|
|
314
|
+
/** Issue title (short, single-line) */
|
|
315
|
+
title?: string;
|
|
316
|
+
/** Rich markdown body / description */
|
|
317
|
+
body?: string;
|
|
318
|
+
/** GitHub-issue-shaped labels */
|
|
319
|
+
labels?: string[];
|
|
320
|
+
/** Milestone or project ref string */
|
|
321
|
+
project?: string;
|
|
209
322
|
}
|
|
210
323
|
/**
|
|
211
324
|
* Task update options
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/dist/types.js
CHANGED
|
@@ -1,9 +1,17 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Types for digital-tasks
|
|
3
3
|
*
|
|
4
|
-
* Task =
|
|
4
|
+
* Task = Action + issue-shaped metadata (title, body, comments, labels,
|
|
5
|
+
* dependencies, assignees, project). A Task is a specialization of an
|
|
6
|
+
* `Action` (`digital-objects.Action`) with project-management overlay,
|
|
7
|
+
* per the SVO co-design (`docs/plans/2026-05-05-svo-co-design.md`).
|
|
5
8
|
*
|
|
6
|
-
* Every task
|
|
9
|
+
* Every task wraps a callable Verb — historically the `function` field
|
|
10
|
+
* (an `ai-functions.FunctionDefinition`). Per CONTEXT.md the canonical
|
|
11
|
+
* name for callable Verbs is **Tool**; `function` is being renamed to
|
|
12
|
+
* `tool` over time. See the `function` / `tool` fields below.
|
|
13
|
+
*
|
|
14
|
+
* The function (now Tool) can be:
|
|
7
15
|
* - Code: generates executable code
|
|
8
16
|
* - Generative: AI generates content (no tools)
|
|
9
17
|
* - Agentic: AI with tools in a loop
|
package/dist/types.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}
|