digital-tasks 2.1.3 → 2.4.0

package/dist/function-task.js

@@ -1,286 +0,0 @@
-/**
- * Function-Task Integration
- *
- * Connects the task system with ai-functions Function definitions.
- * Every task is essentially a function call with typed inputs/outputs.
- *
- * ## Function Types
- *
- * Tasks can execute different function types:
- * - **Code**: Generates executable code
- * - **Generative**: AI generates text/objects (no tools)
- * - **Agentic**: AI with tools in a loop
- * - **Human**: Requires human input/approval
- *
- * ## Data Flow
- *
- * Tasks form a typed DAG where outputs flow to dependent task inputs:
- *
- * ```ts
- * const workflow = defineWorkflow({
- *   name: 'Data Pipeline',
- *   tasks: {
- *     fetchData: generativeTask({
- *       prompt: 'Fetch user data from API',
- *       output: z.object({ users: z.array(z.object({ name: z.string() })) }),
- *     }),
- *     processData: codeTask({
- *       input: (ctx) => ctx.outputs.fetchData, // Type-safe reference
- *       language: 'typescript',
- *       description: 'Filter active users',
- *     }),
- *     reviewResults: humanTask({
- *       input: (ctx) => ctx.outputs.processData,
- *       channel: 'slack',
- *       instructions: 'Review the processed user list',
- *     }),
- *   },
- *   // Dependencies inferred from input references
- * })
- * ```
- *
- * @packageDocumentation
- */
-// ============================================================================
-// Task Factory Functions
-// ============================================================================
-let taskIdCounter = 0;
-function generateFunctionTaskId() {
-    return `ftask_${Date.now()}_${++taskIdCounter}`;
-}
-/**
- * Create a code task
- *
- * @example
- * ```ts
- * const task = codeTask({
- *   name: 'Generate API client',
- *   language: 'typescript',
- *   instructions: 'Generate a type-safe API client from OpenAPI spec',
- *   input: { spec: openApiSpec },
- * })
- * ```
- */
-export function codeTask(options) {
-    return {
-        id: generateFunctionTaskId(),
-        functionType: 'code',
-        ...options,
-    };
-}
-/**
- * Create a generative task
- *
- * @example
- * ```ts
- * const task = generativeTask({
- *   name: 'Summarize document',
- *   prompt: 'Summarize the following document: {{document}}',
- *   outputSchema: { summary: 'string', keyPoints: ['string'] },
- * })
- * ```
- */
-export function generativeTask(options) {
-    return {
-        id: generateFunctionTaskId(),
-        functionType: 'generative',
-        ...options,
-    };
-}
-/**
- * Create an agentic task
- *
- * @example
- * ```ts
- * const task = agenticTask({
- *   name: 'Research topic',
- *   instructions: 'Research the given topic and compile a report',
- *   tools: [searchTool, fetchTool, extractTool],
- *   maxIterations: 10,
- * })
- * ```
- */
-export function agenticTask(options) {
-    return {
-        id: generateFunctionTaskId(),
-        functionType: 'agentic',
-        ...options,
-    };
-}
-/**
- * Create a human task
- *
- * @example
- * ```ts
- * const task = humanTask({
- *   name: 'Review PR',
- *   channel: 'slack',
- *   instructions: 'Review the code changes and approve or request changes',
- *   responseSchema: { approved: 'boolean', feedback: 'string' },
- * })
- * ```
- */
-export function humanTask(options) {
-    return {
-        id: generateFunctionTaskId(),
-        functionType: 'human',
-        ...options,
-    };
-}
-/**
- * Create a typed workflow with automatic dependency inference
- *
- * @example
- * ```ts
- * const contentPipeline = Workflow({
- *   name: 'Content Pipeline',
- *   tasks: {
- *     research: agenticTask({
- *       name: 'Research topic',
- *       instructions: 'Research AI trends',
- *       tools: [searchTool],
- *     }),
- *     outline: generativeTask({
- *       name: 'Create outline',
- *       prompt: 'Create outline from research',
- *       input: (ctx) => ctx.getOutput('research'),
- *     }),
- *     draft: generativeTask({
- *       name: 'Write draft',
- *       prompt: 'Write article from outline',
- *       input: (ctx) => ctx.getOutput('outline'),
- *     }),
- *     review: humanTask({
- *       name: 'Review article',
- *       channel: 'web',
- *       instructions: 'Review and approve the article',
- *       input: (ctx) => ctx.getOutput('draft'),
- *     }),
- *   },
- * })
- * ```
- */
-export function Workflow(options) {
-    return {
-        id: `wf_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`,
-        name: options.name,
-        description: options.description,
-        tasks: options.tasks,
-        dependencies: options.dependencies,
-        defaultMode: options.defaultMode || 'sequential',
-        metadata: options.metadata,
-    };
-}
-/**
- * Convert function task type to base task type
- */
-function functionTypeToTaskType(functionType) {
-    switch (functionType) {
-        case 'code':
-            return 'generation';
-        case 'generative':
-            return 'generation';
-        case 'agentic':
-            return 'research';
-        case 'human':
-            return 'approval';
-        default:
-            return 'action';
-    }
-}
-/**
- * Convert a function task to a base Task
- */
-export function functionTaskToTask(functionTask) {
-    return {
-        title: functionTask.name,
-        description: functionTask.description,
-        type: functionTypeToTaskType(functionTask.functionType),
-        priority: functionTask.priority || 'normal',
-        tags: functionTask.tags,
-        allowedWorkers: functionTask.functionType === 'human'
-            ? ['human']
-            : functionTask.functionType === 'agentic'
-                ? ['agent']
-                : ['any'],
-        metadata: {
-            _functionTaskId: functionTask.id,
-            _functionType: functionTask.functionType,
-            _functionDefinition: functionTask.definition,
-        },
-    };
-}
-/**
- * Infer dependencies from input resolvers
- */
-export function inferDependencies(workflow) {
-    const dependencies = new Map();
-    const taskIds = Object.keys(workflow.tasks);
-    for (const [taskId, task] of Object.entries(workflow.tasks)) {
-        const deps = [];
-        // Check if input is a resolver function
-        if (typeof task.input === 'function') {
-            // Create a mock context to track which outputs are accessed
-            const accessedOutputs = [];
-            const mockContext = {
-                outputs: new Proxy({}, {
-                    get(_, prop) {
-                        if (typeof prop === 'string' && taskIds.includes(prop)) {
-                            accessedOutputs.push(prop);
-                        }
-                        return undefined;
-                    },
-                }),
-                getOutput: (id) => {
-                    if (taskIds.includes(id)) {
-                        accessedOutputs.push(id);
-                    }
-                    return undefined;
-                },
-                metadata: {},
-            };
-            try {
-                // Call the resolver to detect accessed outputs
-                ;
-                task.input(mockContext);
-            }
-            catch {
-                // Resolver may throw if outputs are not available, that's ok
-            }
-            deps.push(...accessedOutputs);
-        }
-        // Add explicit dependencies
-        const explicit = workflow.dependencies?.find(d => d.task === taskId);
-        if (explicit) {
-            const explicitDeps = Array.isArray(explicit.dependsOn)
-                ? explicit.dependsOn
-                : [explicit.dependsOn];
-            deps.push(...explicitDeps);
-        }
-        dependencies.set(taskId, [...new Set(deps)]);
-    }
-    return dependencies;
-}
-/**
- * Get execution order for a workflow (topological sort)
- */
-export function getExecutionOrder(workflow) {
-    const dependencies = inferDependencies(workflow);
-    const taskIds = Object.keys(workflow.tasks);
-    const result = [];
-    const completed = new Set();
-    while (completed.size < taskIds.length) {
-        // Find tasks whose dependencies are all completed
-        const ready = taskIds.filter(id => !completed.has(id) &&
-            (dependencies.get(id) || []).every(dep => completed.has(dep)));
-        if (ready.length === 0 && completed.size < taskIds.length) {
-            throw new Error('Circular dependency detected in workflow');
-        }
-        // Group ready tasks (can run in parallel)
-        result.push(ready);
-        // Mark as completed
-        ready.forEach(id => completed.add(id));
-    }
-    return result;
-}
-//# sourceMappingURL=function-task.js.map

package/dist/function-task.js.map

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

package/src/index.js

@@ -1,73 +0,0 @@
-/**
- * digital-tasks - Task management primitives for digital workers
- *
- * Task = Function + metadata (status, progress, assignment, dependencies)
- *
- * Every task wraps a function (code, generative, agentic, or human)
- * with lifecycle management, worker assignment, and dependency tracking.
- *
- * ## Quick Start
- *
- * ```ts
- * import { Task, createTask, taskQueue } from 'digital-tasks'
- *
- * // Create a task from a function
- * const task = await createTask({
- *   function: {
- *     type: 'generative',
- *     name: 'summarize',
- *     args: { text: 'The text to summarize' },
- *     output: 'string',
- *     promptTemplate: 'Summarize: {{text}}',
- *   },
- *   input: { text: 'Long article...' },
- *   priority: 'high',
- * })
- *
- * // Start and complete
- * await startTask(task.id, { type: 'agent', id: 'agent_1' })
- * await completeTask(task.id, 'Summary of the article...')
- * ```
- *
- * ## Projects with Parallel/Sequential Tasks
- *
- * ```ts
- * import { createProject, task, parallel, sequential, toMarkdown } from 'digital-tasks'
- *
- * const project = createProject({
- *   name: 'Launch Feature',
- *   tasks: [
- *     parallel(
- *       task('Design mockups'),
- *       task('Write tech spec'),
- *     ),
- *     sequential(
- *       task('Implement backend'),
- *       task('Implement frontend'),
- *       task('Write tests'),
- *     ),
- *   ],
- * })
- *
- * // Convert to markdown
- * const md = toMarkdown(project)
- * // # Launch Feature
- * // - [ ] Design mockups
- * // - [ ] Write tech spec
- * // 1. [ ] Implement backend
- * // 2. [ ] Implement frontend
- * // 3. [ ] Write tests
- * ```
- *
- * @packageDocumentation
- */
-// ============================================================================
-// Task Queue
-// ============================================================================
-export { taskQueue, createTaskQueue } from './queue.js';
-// ============================================================================
-// Task Management
-// ============================================================================
-export { createTask, getTask, startTask, updateProgress, completeTask, failTask, cancelTask, addComment, createSubtask, getSubtasks, waitForTask, } from './task.js';
-export { task, parallel, sequential, createProject, workflow, materializeProject, getDependants, getDependencies, getReadyTasks, hasCycles, sortTasks, } from './project.js';
-export { parseMarkdown, toMarkdown, syncStatusFromMarkdown, } from './markdown.js';