digital-tasks 2.3.0 → 2.4.0

package/dist/types.d.ts

@@ -0,0 +1,405 @@
+/**
+ * Types for digital-tasks
+ *
+ * Task = Action + issue-shaped metadata (title, body, comments, labels,
+ * dependencies, assignees, project). A Task is a specialization of an
+ * `Action` (`digital-objects.Action`) with project-management overlay,
+ * per the SVO co-design (`docs/plans/2026-05-05-svo-co-design.md`).
+ *
+ * Every task wraps a callable Verb — historically the `function` field
+ * (an `ai-functions.FunctionDefinition`). Per CONTEXT.md the canonical
+ * name for callable Verbs is **Tool**; `function` is being renamed to
+ * `tool` over time. See the `function` / `tool` fields below.
+ *
+ * The function (now Tool) can be:
+ * - Code: generates executable code
+ * - Generative: AI generates content (no tools)
+ * - Agentic: AI with tools in a loop
+ * - Human: requires human input
+ *
+ * @packageDocumentation
+ */
+import type { FunctionDefinition, CodeFunctionDefinition, GenerativeFunctionDefinition, AgenticFunctionDefinition, HumanFunctionDefinition } from 'ai-functions';
+import type { Action } from 'digital-objects';
+export type { FunctionDefinition, CodeFunctionDefinition, GenerativeFunctionDefinition, AgenticFunctionDefinition, HumanFunctionDefinition, };
+export type { Action };
+/**
+ * Task lifecycle status
+ */
+export type TaskStatus = 'pending' | 'queued' | 'assigned' | 'in_progress' | 'blocked' | 'review' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Task priority levels
+ */
+export type TaskPriority = 'low' | 'normal' | 'high' | 'urgent' | 'critical';
+/**
+ * Who can work on this task
+ */
+export type WorkerType = 'agent' | 'human' | 'team' | 'any';
+/**
+ * Worker reference
+ */
+export interface WorkerRef {
+    type: WorkerType;
+    id: string;
+    name?: string;
+    role?: string;
+}
+/**
+ * Task assignment
+ */
+export interface TaskAssignment {
+    worker: WorkerRef;
+    assignedAt: Date;
+    assignedBy?: string;
+    notes?: string;
+}
+/**
+ * Dependency type
+ */
+export type DependencyType = 'blocks' | 'blocked_by' | 'related_to' | 'parent' | 'child';
+/**
+ * Task dependency
+ */
+export interface TaskDependency {
+    type: DependencyType;
+    taskId: string;
+    satisfied?: boolean;
+}
+/**
+ * Task progress
+ */
+export interface TaskProgress {
+    percent: number;
+    step?: string;
+    totalSteps?: number;
+    currentStep?: number;
+    estimatedTimeRemaining?: number;
+    updatedAt: Date;
+}
+/**
+ * Task event for history
+ */
+export interface TaskEvent {
+    id: string;
+    type: 'created' | 'assigned' | 'started' | 'progress' | 'blocked' | 'unblocked' | 'completed' | 'failed' | 'cancelled' | 'comment';
+    timestamp: Date;
+    actor?: WorkerRef;
+    data?: unknown;
+    message?: string;
+}
+/**
+ * Comment - a thin wrapper around a comment posted on a Task.
+ *
+ * Per the SVO co-design, comments are child Actions of verb 'commented'
+ * whose `cause` role points back at the parent Task's Action id. This
+ * shape is the surfaced view of such an Action for issue-shaped UIs.
+ */
+export interface Comment {
+    /** Comment id (matches the underlying Action id when persisted) */
+    id: string;
+    /** Markdown body of the comment */
+    body: string;
+    /** Who posted the comment */
+    author?: WorkerRef;
+    /** When the comment was posted */
+    createdAt: Date;
+}
+/**
+ * Task = Action + issue-shaped metadata
+ *
+ * A Task is a specialization of `digital-objects.Action` carrying
+ * project-management overlay (title, body, comments, labels,
+ * dependencies, assignees, milestone/project). The Action supertype
+ * provides id/verb/subject/object/roles/data/createdAt/completedAt.
+ *
+ * Status: Action's status taxonomy is lifecycle-only
+ * (pending/active/completed/failed/cancelled). Task's status taxonomy
+ * is project-management shaped (queued/assigned/in_progress/blocked/
+ * review/...). We omit Action's `status` and replace it with the
+ * Task-specific `TaskStatus`. Both supersets share `pending`,
+ * `completed`, `failed`, `cancelled`.
+ *
+ * Verb: every Task is an Action of some Verb. For tasks created via
+ * the legacy `createTask({ function })` path, `verb` defaults to the
+ * function's name (e.g. `'summarize'`).
+ *
+ * Backward compatibility: all previously-valid Task shapes remain
+ * assignable. Newly added fields (title/body/labels/project/assignees/
+ * comments/$type/verb) are optional or have defaults populated by
+ * `createTask`.
+ */
+export type Task<TInput = unknown, TOutput = unknown> = Omit<Action<TInput>, 'status'> & {
+    /** MDXLD type discriminator */
+    $type?: 'Task';
+    /**
+     * The Tool (callable Verb) this task executes. This is the canonical
+     * field per CONTEXT.md. `createTask` always populates `tool`; the
+     * legacy `function` alias is also populated during the deprecation
+     * window so existing readers keep working.
+     *
+     * Optional on the type so that older literals constructed with only
+     * `function` still typecheck; in practice every Task has exactly one
+     * underlying callable Verb available via `task.tool ?? task.function`.
+     */
+    tool?: FunctionDefinition<TInput, TOutput>;
+    /**
+     * Legacy alias for `tool`.
+     *
+     * @deprecated Use `tool` instead. The canonical name for callable
+     * Verbs is **Tool** (see CONTEXT.md). `createTask` continues to
+     * populate this alongside `tool` for the duration of the deprecation
+     * window. Slated for removal in the next major version.
+     */
+    function?: FunctionDefinition<TInput, TOutput>;
+    /** Issue title (short, single-line) */
+    title?: string;
+    /** Rich markdown body / description */
+    body?: string;
+    /** GitHub-issue-shaped labels */
+    labels?: string[];
+    /** Milestone or project reference (string ref; cf. `projectId` for
+     *  the durable internal id when a `Project` exists in this package). */
+    project?: string;
+    /** Comments posted on this task (child Actions of verb 'commented') */
+    comments?: Comment[];
+    /** Workers assigned to this task */
+    assignees?: WorkerRef[];
+    /** Current task status (specialization — see jsdoc above) */
+    status: TaskStatus;
+    /** Priority level */
+    priority: TaskPriority;
+    /** Input value (resolved from function.args) */
+    input?: TInput;
+    /** Output value (when completed) */
+    output?: TOutput;
+    /** Error (when failed) */
+    error?: string;
+    /** Worker types permitted to claim this task */
+    allowedWorkers?: WorkerType[];
+    /** Current assignment (single primary worker) */
+    assignment?: TaskAssignment;
+    /** Task dependencies */
+    dependencies?: TaskDependency[];
+    /** Current progress */
+    progress?: TaskProgress;
+    /** Scheduled start time */
+    scheduledFor?: Date;
+    /** Deadline */
+    deadline?: Date;
+    /** When started */
+    startedAt?: Date;
+    /** Timeout in ms */
+    timeout?: number;
+    /** Parent task ID */
+    parentId?: string;
+    /** Project ID (internal `Project.id` when this Task belongs to a
+     *  Project in this package; distinct from `project` ref string) */
+    projectId?: string;
+    /** Tags */
+    tags?: string[];
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    /** Event history */
+    events?: TaskEvent[];
+};
+/**
+ * Task dependency tuple — minimal shape from the SVO design doc.
+ *
+ * `TaskDependency` (above) is the richer in-package shape with a
+ * full DependencyType set; `TaskDep` is the issue-shaped pair from
+ * the design doc, retained as a convenience export.
+ */
+export interface TaskDep {
+    taskId: string;
+    type: 'blocked_by' | 'related';
+}
+/**
+ * Any task (for collections)
+ */
+export type AnyTask = Task<any, any>;
+/**
+ * Create task from a Code function
+ */
+export interface CodeTaskOptions<TInput = unknown, TOutput = unknown> {
+    /** Tool (callable Verb) to run. Preferred over `function`. */
+    tool?: CodeFunctionDefinition<TInput, TOutput>;
+    /** @deprecated Use `tool` instead. */
+    function?: CodeFunctionDefinition<TInput, TOutput>;
+    input?: TInput;
+    priority?: TaskPriority;
+    assignTo?: WorkerRef;
+    dependencies?: string[];
+    deadline?: Date;
+    tags?: string[];
+    parentId?: string;
+    projectId?: string;
+}
+/**
+ * Create task from a Generative function
+ */
+export interface GenerativeTaskOptions<TInput = unknown, TOutput = unknown> {
+    /** Tool (callable Verb) to run. Preferred over `function`. */
+    tool?: GenerativeFunctionDefinition<TInput, TOutput>;
+    /** @deprecated Use `tool` instead. */
+    function?: GenerativeFunctionDefinition<TInput, TOutput>;
+    input?: TInput;
+    priority?: TaskPriority;
+    assignTo?: WorkerRef;
+    dependencies?: string[];
+    deadline?: Date;
+    tags?: string[];
+    parentId?: string;
+    projectId?: string;
+}
+/**
+ * Create task from an Agentic function
+ */
+export interface AgenticTaskOptions<TInput = unknown, TOutput = unknown> {
+    /** Tool (callable Verb) to run. Preferred over `function`. */
+    tool?: AgenticFunctionDefinition<TInput, TOutput>;
+    /** @deprecated Use `tool` instead. */
+    function?: AgenticFunctionDefinition<TInput, TOutput>;
+    input?: TInput;
+    priority?: TaskPriority;
+    assignTo?: WorkerRef;
+    dependencies?: string[];
+    deadline?: Date;
+    tags?: string[];
+    parentId?: string;
+    projectId?: string;
+}
+/**
+ * Create task from a Human function
+ */
+export interface HumanTaskOptions<TInput = unknown, TOutput = unknown> {
+    /** Tool (callable Verb) to run. Preferred over `function`. */
+    tool?: HumanFunctionDefinition<TInput, TOutput>;
+    /** @deprecated Use `tool` instead. */
+    function?: HumanFunctionDefinition<TInput, TOutput>;
+    input?: TInput;
+    priority?: TaskPriority;
+    assignTo?: WorkerRef;
+    dependencies?: string[];
+    deadline?: Date;
+    tags?: string[];
+    parentId?: string;
+    projectId?: string;
+}
+/**
+ * Generic task creation options
+ *
+ * Either `tool` (preferred) or the deprecated `function` alias must be
+ * provided. `createTask` normalizes to `tool` and also populates the
+ * legacy `function` alias on the resulting Task for backward compat.
+ */
+export interface CreateTaskOptions<TInput = unknown, TOutput = unknown> {
+    /** Tool (callable Verb) to run. Preferred over `function`. */
+    tool?: FunctionDefinition<TInput, TOutput>;
+    /** @deprecated Use `tool` instead. */
+    function?: FunctionDefinition<TInput, TOutput>;
+    input?: TInput;
+    priority?: TaskPriority;
+    allowedWorkers?: WorkerType[];
+    assignTo?: WorkerRef;
+    /** Multiple assignees (issue-shaped); first becomes the primary `assignment` */
+    assignees?: WorkerRef[];
+    dependencies?: string[];
+    scheduledFor?: Date;
+    deadline?: Date;
+    timeout?: number;
+    tags?: string[];
+    parentId?: string;
+    projectId?: string;
+    metadata?: Record<string, unknown>;
+    /** Issue title (short, single-line) */
+    title?: string;
+    /** Rich markdown body / description */
+    body?: string;
+    /** GitHub-issue-shaped labels */
+    labels?: string[];
+    /** Milestone or project ref string */
+    project?: string;
+}
+/**
+ * Task update options
+ */
+export interface UpdateTaskOptions {
+    status?: TaskStatus;
+    progress?: Partial<TaskProgress>;
+    assignment?: TaskAssignment;
+    priority?: TaskPriority;
+    event?: Omit<TaskEvent, 'id' | 'timestamp'>;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Task query options
+ */
+export interface TaskQuery {
+    status?: TaskStatus | TaskStatus[];
+    priority?: TaskPriority | TaskPriority[];
+    functionType?: 'code' | 'generative' | 'agentic' | 'human';
+    assignedTo?: string;
+    tags?: string[];
+    projectId?: string;
+    parentId?: string;
+    search?: string;
+    sortBy?: 'createdAt' | 'priority' | 'deadline' | 'status';
+    sortOrder?: 'asc' | 'desc';
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Task queue options
+ */
+export interface TaskQueueOptions {
+    name?: string;
+    concurrency?: number;
+    defaultTimeout?: number;
+    persistent?: boolean;
+}
+/**
+ * Task queue interface
+ */
+export interface TaskQueue {
+    add(task: AnyTask): Promise<void>;
+    get(id: string): Promise<AnyTask | undefined>;
+    update(id: string, options: UpdateTaskOptions): Promise<AnyTask | undefined>;
+    remove(id: string): Promise<boolean>;
+    query(options: TaskQuery): Promise<AnyTask[]>;
+    getNextForWorker(worker: WorkerRef): Promise<AnyTask | undefined>;
+    claim(taskId: string, worker: WorkerRef): Promise<boolean>;
+    complete(taskId: string, output: unknown): Promise<void>;
+    fail(taskId: string, error: string): Promise<void>;
+    stats(): Promise<TaskQueueStats>;
+}
+/**
+ * Task queue stats
+ */
+export interface TaskQueueStats {
+    total: number;
+    byStatus: Record<TaskStatus, number>;
+    byPriority: Record<TaskPriority, number>;
+    byFunctionType?: Record<string, number>;
+    avgWaitTime?: number;
+    avgCompletionTime?: number;
+}
+/**
+ * Task execution result
+ */
+export interface TaskResult<TOutput = unknown> {
+    taskId: string;
+    success: boolean;
+    output?: TOutput;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+    metadata?: {
+        duration: number;
+        startedAt: Date;
+        completedAt: Date;
+        worker?: WorkerRef;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,23 @@
+/**
+ * Types for digital-tasks
+ *
+ * Task = Action + issue-shaped metadata (title, body, comments, labels,
+ * dependencies, assignees, project). A Task is a specialization of an
+ * `Action` (`digital-objects.Action`) with project-management overlay,
+ * per the SVO co-design (`docs/plans/2026-05-05-svo-co-design.md`).
+ *
+ * Every task wraps a callable Verb — historically the `function` field
+ * (an `ai-functions.FunctionDefinition`). Per CONTEXT.md the canonical
+ * name for callable Verbs is **Tool**; `function` is being renamed to
+ * `tool` over time. See the `function` / `tool` fields below.
+ *
+ * The function (now Tool) can be:
+ * - Code: generates executable code
+ * - Generative: AI generates content (no tools)
+ * - Agentic: AI with tools in a loop
+ * - Human: requires human input
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}