digital-tasks 2.3.0 → 2.4.0

package/dist/queue.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Task Queue - In-memory task queue implementation
+ *
+ * Provides task queuing, assignment, and execution management.
+ *
+ * @packageDocumentation
+ */
+import type { TaskQueue, TaskQueueOptions } from './types.js';
+/**
+ * Global task queue instance
+ */
+export declare const taskQueue: TaskQueue;
+/**
+ * Create a new task queue instance
+ */
+export declare function createTaskQueue(options?: TaskQueueOptions): TaskQueue;
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAEV,SAAS,EACT,gBAAgB,EASjB,MAAM,YAAY,CAAA;AAgbnB;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,SAAmC,CAAA;AAE3D;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAErE"}

package/dist/queue.js

@@ -0,0 +1,386 @@
+/**
+ * Task Queue - In-memory task queue implementation
+ *
+ * Provides task queuing, assignment, and execution management.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Priority values for sorting
+ */
+const priorityOrder = {
+    critical: 5,
+    urgent: 4,
+    high: 3,
+    normal: 2,
+    low: 1,
+};
+/**
+ * In-memory task queue implementation
+ */
+class InMemoryTaskQueue {
+    tasks = new Map();
+    options;
+    constructor(options = {}) {
+        this.options = {
+            name: 'default',
+            concurrency: 10,
+            defaultTimeout: 5 * 60 * 1000, // 5 minutes
+            persistent: false,
+            ...options,
+        };
+    }
+    async add(task) {
+        // Read the underlying Tool, tolerating the legacy `function` alias.
+        const tool = task.tool ?? task.function;
+        // Add created event
+        const event = {
+            id: `evt_${Date.now()}`,
+            type: 'created',
+            timestamp: new Date(),
+            message: `Task created: ${tool?.name ?? task.id}`,
+        };
+        const taskWithEvent = {
+            ...task,
+            events: [...(task.events || []), event],
+        };
+        this.tasks.set(task.id, taskWithEvent);
+    }
+    async get(id) {
+        return this.tasks.get(id);
+    }
+    async update(id, options) {
+        const task = this.tasks.get(id);
+        if (!task)
+            return undefined;
+        const events = [...(task.events || [])];
+        // Add event if provided
+        if (options.event) {
+            events.push({
+                ...options.event,
+                id: `evt_${Date.now()}`,
+                timestamp: new Date(),
+            });
+        }
+        // Add status change event
+        if (options.status && options.status !== task.status) {
+            events.push({
+                id: `evt_${Date.now()}_status`,
+                type: options.status === 'completed'
+                    ? 'completed'
+                    : options.status === 'failed'
+                        ? 'failed'
+                        : options.status === 'in_progress'
+                            ? 'started'
+                            : options.status === 'blocked'
+                                ? 'blocked'
+                                : 'progress',
+                timestamp: new Date(),
+                message: `Status changed from ${task.status} to ${options.status}`,
+            });
+        }
+        // Build progress update if provided
+        let progressUpdate = task.progress;
+        if (options.progress) {
+            progressUpdate = {
+                percent: options.progress.percent ?? task.progress?.percent ?? 0,
+                updatedAt: new Date(),
+            };
+            const step = options.progress.step ?? task.progress?.step;
+            if (step !== undefined) {
+                progressUpdate.step = step;
+            }
+            const totalSteps = options.progress.totalSteps ?? task.progress?.totalSteps;
+            if (totalSteps !== undefined) {
+                progressUpdate.totalSteps = totalSteps;
+            }
+            const currentStep = options.progress.currentStep ?? task.progress?.currentStep;
+            if (currentStep !== undefined) {
+                progressUpdate.currentStep = currentStep;
+            }
+            const estTime = options.progress.estimatedTimeRemaining ?? task.progress?.estimatedTimeRemaining;
+            if (estTime !== undefined) {
+                progressUpdate.estimatedTimeRemaining = estTime;
+            }
+        }
+        const updated = {
+            ...task,
+            ...(options.status && { status: options.status }),
+            ...(options.priority && { priority: options.priority }),
+            ...(options.assignment && { assignment: options.assignment }),
+            ...(progressUpdate && { progress: progressUpdate }),
+            ...(options.metadata && {
+                metadata: { ...task.metadata, ...options.metadata },
+            }),
+            events,
+        };
+        this.tasks.set(id, updated);
+        return updated;
+    }
+    async remove(id) {
+        return this.tasks.delete(id);
+    }
+    async query(options) {
+        let results = Array.from(this.tasks.values());
+        // Filter by status
+        if (options.status) {
+            const statuses = Array.isArray(options.status) ? options.status : [options.status];
+            results = results.filter((t) => statuses.includes(t.status));
+        }
+        // Filter by priority
+        if (options.priority) {
+            const priorities = Array.isArray(options.priority) ? options.priority : [options.priority];
+            results = results.filter((t) => priorities.includes(t.priority));
+        }
+        // Filter by function type (reads `tool` with fallback to legacy `function`)
+        if (options.functionType) {
+            results = results.filter((t) => (t.tool ?? t.function)?.type === options.functionType);
+        }
+        // Filter by assigned worker
+        if (options.assignedTo) {
+            results = results.filter((t) => t.assignment?.worker.id === options.assignedTo);
+        }
+        // Filter by tags
+        if (options.tags && options.tags.length > 0) {
+            results = results.filter((t) => t.tags && options.tags.some((tag) => t.tags.includes(tag)));
+        }
+        // Filter by project
+        if (options.projectId) {
+            results = results.filter((t) => t.projectId === options.projectId);
+        }
+        // Filter by parent
+        if (options.parentId) {
+            results = results.filter((t) => t.parentId === options.parentId);
+        }
+        // Text search (reads `tool` with fallback to legacy `function`)
+        if (options.search) {
+            const search = options.search.toLowerCase();
+            results = results.filter((t) => {
+                const tool = t.tool ?? t.function;
+                if (!tool)
+                    return false;
+                return (tool.name.toLowerCase().includes(search) ||
+                    tool.description?.toLowerCase().includes(search));
+            });
+        }
+        // Sort
+        if (options.sortBy) {
+            results.sort((a, b) => {
+                let aVal;
+                let bVal;
+                switch (options.sortBy) {
+                    case 'createdAt':
+                        aVal = a.createdAt.getTime();
+                        bVal = b.createdAt.getTime();
+                        break;
+                    case 'priority':
+                        aVal = priorityOrder[a.priority];
+                        bVal = priorityOrder[b.priority];
+                        break;
+                    case 'deadline':
+                        aVal = a.deadline?.getTime() || Infinity;
+                        bVal = b.deadline?.getTime() || Infinity;
+                        break;
+                    case 'status':
+                        aVal = a.status.charCodeAt(0);
+                        bVal = b.status.charCodeAt(0);
+                        break;
+                    default:
+                        return 0;
+                }
+                return options.sortOrder === 'desc' ? bVal - aVal : aVal - bVal;
+            });
+        }
+        // Pagination
+        const offset = options.offset ?? 0;
+        const limit = options.limit ?? results.length;
+        results = results.slice(offset, offset + limit);
+        return results;
+    }
+    async getNextForWorker(worker) {
+        // Get queued tasks sorted by priority, then by deadline
+        const queuedTasks = await this.query({
+            status: ['pending', 'queued'],
+            sortBy: 'priority',
+            sortOrder: 'desc',
+        });
+        // Find first task the worker can handle
+        for (const task of queuedTasks) {
+            // Check if worker type is allowed
+            if (task.allowedWorkers &&
+                !task.allowedWorkers.includes(worker.type) &&
+                !task.allowedWorkers.includes('any')) {
+                continue;
+            }
+            // Note: Could check worker skills against task requirements in the future
+            // Check if task is scheduled for later
+            if (task.scheduledFor && task.scheduledFor > new Date()) {
+                continue;
+            }
+            // Check dependencies
+            if (task.dependencies && task.dependencies.length > 0) {
+                const unblockedDeps = task.dependencies.filter((d) => d.type === 'blocked_by' && !d.satisfied);
+                if (unblockedDeps.length > 0) {
+                    continue;
+                }
+            }
+            return task;
+        }
+        return undefined;
+    }
+    async claim(taskId, worker) {
+        const task = await this.get(taskId);
+        if (!task)
+            return false;
+        // Check if already assigned
+        if (task.assignment) {
+            return false;
+        }
+        // Update task with assignment
+        await this.update(taskId, {
+            status: 'assigned',
+            assignment: {
+                worker,
+                assignedAt: new Date(),
+            },
+            event: {
+                type: 'assigned',
+                actor: worker,
+                message: `Assigned to ${worker.name || worker.id}`,
+            },
+        });
+        return true;
+    }
+    async complete(taskId, output) {
+        const task = await this.get(taskId);
+        if (!task)
+            return;
+        const event = {
+            type: 'completed',
+            message: 'Task completed successfully',
+            data: { output },
+        };
+        if (task.assignment?.worker !== undefined) {
+            event.actor = task.assignment.worker;
+        }
+        await this.update(taskId, {
+            status: 'completed',
+            event,
+        });
+        // Update task output separately since it's not in UpdateTaskOptions
+        const updated = await this.get(taskId);
+        if (updated) {
+            this.tasks.set(taskId, {
+                ...updated,
+                output: {
+                    value: output,
+                    producedAt: new Date(),
+                },
+                completedAt: new Date(),
+            });
+        }
+        // Satisfy dependencies in other tasks
+        for (const [, otherTask] of this.tasks) {
+            if (otherTask.dependencies) {
+                const hasDep = otherTask.dependencies.find((d) => d.taskId === taskId && d.type === 'blocked_by');
+                if (hasDep) {
+                    const updatedDeps = otherTask.dependencies.map((d) => d.taskId === taskId ? { ...d, satisfied: true } : d);
+                    this.tasks.set(otherTask.id, {
+                        ...otherTask,
+                        dependencies: updatedDeps,
+                    });
+                    // Unblock if all dependencies satisfied
+                    const allSatisfied = updatedDeps
+                        .filter((d) => d.type === 'blocked_by')
+                        .every((d) => d.satisfied);
+                    if (allSatisfied && otherTask.status === 'blocked') {
+                        await this.update(otherTask.id, {
+                            status: 'queued',
+                            event: {
+                                type: 'unblocked',
+                                message: 'All dependencies satisfied',
+                            },
+                        });
+                    }
+                }
+            }
+        }
+    }
+    async fail(taskId, error) {
+        const task = await this.get(taskId);
+        if (!task)
+            return;
+        const event = {
+            type: 'failed',
+            message: `Task failed: ${error}`,
+            data: { error },
+        };
+        if (task.assignment?.worker !== undefined) {
+            event.actor = task.assignment.worker;
+        }
+        await this.update(taskId, {
+            status: 'failed',
+            event,
+        });
+    }
+    async stats() {
+        const tasks = Array.from(this.tasks.values());
+        const byStatus = {
+            pending: 0,
+            queued: 0,
+            assigned: 0,
+            in_progress: 0,
+            blocked: 0,
+            review: 0,
+            completed: 0,
+            failed: 0,
+            cancelled: 0,
+        };
+        const byPriority = {
+            low: 0,
+            normal: 0,
+            high: 0,
+            urgent: 0,
+            critical: 0,
+        };
+        let totalWaitTime = 0;
+        let waitTimeCount = 0;
+        let totalCompletionTime = 0;
+        let completionTimeCount = 0;
+        for (const task of tasks) {
+            byStatus[task.status]++;
+            byPriority[task.priority]++;
+            if (task.startedAt && task.createdAt) {
+                totalWaitTime += task.startedAt.getTime() - task.createdAt.getTime();
+                waitTimeCount++;
+            }
+            if (task.completedAt && task.startedAt) {
+                totalCompletionTime += task.completedAt.getTime() - task.startedAt.getTime();
+                completionTimeCount++;
+            }
+        }
+        const stats = {
+            total: tasks.length,
+            byStatus,
+            byPriority,
+        };
+        if (waitTimeCount > 0) {
+            stats.avgWaitTime = totalWaitTime / waitTimeCount;
+        }
+        if (completionTimeCount > 0) {
+            stats.avgCompletionTime = totalCompletionTime / completionTimeCount;
+        }
+        return stats;
+    }
+}
+/**
+ * Global task queue instance
+ */
+export const taskQueue = new InMemoryTaskQueue();
+/**
+ * Create a new task queue instance
+ */
+export function createTaskQueue(options) {
+    return new InMemoryTaskQueue(options);
+}
+//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

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

package/dist/task.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Task - Core task creation and management functions
+ *
+ * @packageDocumentation
+ */
+import type { Task, AnyTask, CreateTaskOptions, WorkerRef, TaskResult } from './types.js';
+/**
+ * Create a new task from a function definition
+ *
+ * @example
+ * ```ts
+ * const task = await createTask({
+ *   tool: {
+ *     type: 'generative',
+ *     name: 'summarize',
+ *     args: { text: 'The text to summarize' },
+ *     output: 'string',
+ *     promptTemplate: 'Summarize: {{text}}',
+ *   },
+ *   input: { text: 'Long article content...' },
+ *   priority: 'high',
+ * })
+ * ```
+ */
+export declare function createTask<TInput = unknown, TOutput = unknown>(options: CreateTaskOptions<TInput, TOutput>): Promise<Task<TInput, TOutput>>;
+/**
+ * Get a task by ID
+ */
+export declare function getTask(id: string): Promise<AnyTask | undefined>;
+/**
+ * Start working on a task
+ */
+export declare function startTask(taskId: string, worker: WorkerRef): Promise<AnyTask | undefined>;
+/**
+ * Update task progress
+ */
+export declare function updateProgress(taskId: string, percent: number, step?: string): Promise<AnyTask | undefined>;
+/**
+ * Complete a task with output
+ */
+export declare function completeTask<TOutput>(taskId: string, output: TOutput): Promise<TaskResult<TOutput>>;
+/**
+ * Fail a task with error
+ */
+export declare function failTask(taskId: string, error: string | Error): Promise<TaskResult>;
+/**
+ * Cancel a task
+ */
+export declare function cancelTask(taskId: string, reason?: string): Promise<boolean>;
+/**
+ * Add a comment to a task
+ */
+export declare function addComment(taskId: string, comment: string, author?: WorkerRef): Promise<AnyTask | undefined>;
+/**
+ * Create a subtask
+ */
+export declare function createSubtask<TInput = unknown, TOutput = unknown>(parentTaskId: string, options: Omit<CreateTaskOptions<TInput, TOutput>, 'parentId'>): Promise<Task<TInput, TOutput>>;
+/**
+ * Get subtasks of a task
+ */
+export declare function getSubtasks(parentTaskId: string): Promise<AnyTask[]>;
+/**
+ * Wait for a task to complete
+ */
+export declare function waitForTask(taskId: string, options?: {
+    timeout?: number;
+    pollInterval?: number;
+}): Promise<TaskResult>;
+//# sourceMappingURL=task.d.ts.map

package/dist/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,IAAI,EACJ,OAAO,EACP,iBAAiB,EACjB,SAAS,EACT,UAAU,EAGX,MAAM,YAAY,CAAA;AAUnB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAClE,OAAO,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqHhC;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAmB/F;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAgB9B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CA8B9B;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAoCzF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAalF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAS9B;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACrE,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,GAC5D,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKhC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAE1E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,UAAU,CAAC,CAqFrB"}