task

Module: vibex/task

Task - Individual work item within a Mission’s Plan

A Task is a discrete, actionable unit of work. Tasks have their own lifecycle and can be assigned to specific agents.

Hierarchy: Space (persistent container) └── Mission (user’s intent) └── Plan (strategy) └── Task[] (individual work items) ‹— This file

Note: This is different from AI SDK’s “steps” which refers to multi-turn tool execution loops. Our Task is a higher-level work item.

Classes

Task

View source

Properties:

Name	Type	Description
`id`	`string`
`title`	`string`
`description`	`string`
`status`	`TaskStatus`
`assignedTo`	`string`
`priority`	`"low" \| "medium" \| "high"`
`estimatedTime`	`string`
`actualTime`	`string`
`dependencies`	`TaskDependency[]`
`tags`	`string[]`
`metadata`	`Record<string, unknown>`
`result`	`unknown`
`error`	`string`
`createdAt`	`Date`
`updatedAt`	`Date`
`startedAt`	`Date`
`completedAt`	`Date`

Methods:

start

View source

Start the task


function start(): void

complete

View source

Complete the task with optional result


function complete(result?: unknown): void

Parameters:

Name	Type	Description
`result`	`unknown` (optional)

fail

View source

Mark task as failed


function fail(error: string): void

Parameters:

Name	Type	Description
`error`	`string`

block

View source

Block the task (waiting on something)


function block(reason: string): void

Parameters:

Name	Type	Description
`reason`	`string`

cancel

View source

Cancel the task


function cancel(): void

isActionable

View source

Check if task can be started


function isActionable(): boolean

isFinished

View source

Check if task is finished (completed, failed, or cancelled)


function isFinished(): boolean

hasBlockingDependencies

View source

Check for blocking dependencies Note: In real implementation, this would check against other tasks


function hasBlockingDependencies(): boolean

toJSON

View source

Serialize to JSON


function toJSON(): Record<string, unknown>

fromJSON

View source

Deserialize from JSON


function fromJSON(data: Record<string, unknown>): Task

Parameters:

Name	Type	Description
`data`	`Record<string, unknown>`

Interfaces

TaskDependency

View source

Properties:

Name	Type	Description
`taskId`	`string`
`type`	`"required" \| "optional"`

TaskConfig

View source

Properties:

Name	Type	Description
`id`	`string`
`title`	`string`
`description`	`string`	(optional)
`assignedTo`	`string`	(optional)
`priority`	`"low" \| "medium" \| "high"`	(optional)
`estimatedTime`	`string`	(optional)
`dependencies`	`TaskDependency[]`	(optional)
`tags`	`string[]`	(optional)
`metadata`	`Record<string, unknown>`	(optional)

Enums

TaskStatus

View source

Task - Individual work item within a Mission’s Plan

A Task is a discrete, actionable unit of work. Tasks have their own lifecycle and can be assigned to specific agents.

Hierarchy: Space (persistent container) └── Mission (user’s intent) └── Plan (strategy) └── Task[] (individual work items) ‹— This file

Note: This is different from AI SDK’s “steps” which refers to multi-turn tool execution loops. Our Task is a higher-level work item.

Values:

PENDING = "pending"
RUNNING = "running"
COMPLETED = "completed"
FAILED = "failed"
BLOCKED = "blocked"
CANCELLED = "cancelled"