digital-tasks 2.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+
+> digital-tasks@2.0.1 build /Users/nathanclevenger/projects/primitives.org.ai/packages/digital-tasks
+> tsc
+

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# digital-tasks
+
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies
+  - ai-functions@2.0.1
+  - digital-tools@2.0.1
+  - digital-workers@2.0.1

package/dist/function-task.d.ts

@@ -0,0 +1,319 @@
+/**
+ * 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
+ */
+import type { FunctionDefinition, AIFunctionDefinition, CodeLanguage, HumanChannel } from 'ai-functions';
+import type { AnyTask, TaskStatus, TaskPriority, WorkerRef } from './types.js';
+/**
+ * The type of function that executes this task
+ */
+export type FunctionTaskType = 'code' | 'generative' | 'agentic' | 'human';
+/**
+ * Base function task - a task that executes a function
+ */
+export interface FunctionTask<TInput = unknown, TOutput = unknown> {
+    /** Task ID */
+    id: string;
+    /** Task name */
+    name: string;
+    /** Task description */
+    description?: string;
+    /** Function type */
+    functionType: FunctionTaskType;
+    /** Function definition (if pre-defined) */
+    functionRef?: string;
+    /** Inline function definition */
+    definition?: FunctionDefinition<TInput, TOutput>;
+    /** Input value or resolver */
+    input?: TInput | InputResolver<TInput>;
+    /** Expected output type (for type inference) */
+    outputType?: TOutput;
+    /** Task priority */
+    priority?: TaskPriority;
+    /** Assigned worker */
+    assignTo?: WorkerRef;
+    /** Tags */
+    tags?: string[];
+}
+/**
+ * Input resolver - gets input from workflow context
+ */
+export type InputResolver<T> = (context: WorkflowContext) => T | Promise<T>;
+/**
+ * Workflow execution context
+ */
+export interface WorkflowContext {
+    /** Outputs from completed tasks */
+    outputs: Record<string, unknown>;
+    /** Get typed output from a specific task */
+    getOutput: <T>(taskId: string) => T | undefined;
+    /** Workflow metadata */
+    metadata: Record<string, unknown>;
+    /** Current user/worker */
+    worker?: WorkerRef;
+}
+/**
+ * Code task - generates executable code
+ */
+export interface CodeTask<TInput = unknown, TOutput = string> extends FunctionTask<TInput, TOutput> {
+    functionType: 'code';
+    /** Target programming language */
+    language?: CodeLanguage;
+    /** Code generation instructions */
+    instructions?: string;
+    /** Include tests */
+    includeTests?: boolean;
+    /** Include examples */
+    includeExamples?: boolean;
+}
+/**
+ * Generative task - AI generates content (no tools)
+ */
+export interface GenerativeTask<TInput = unknown, TOutput = unknown> extends FunctionTask<TInput, TOutput> {
+    functionType: 'generative';
+    /** Prompt template */
+    prompt: string;
+    /** System prompt */
+    system?: string;
+    /** Model to use */
+    model?: string;
+    /** Temperature */
+    temperature?: number;
+    /** Output schema (for structured output) */
+    outputSchema?: unknown;
+}
+/**
+ * Agentic task - AI with tools in a loop
+ */
+export interface AgenticTask<TInput = unknown, TOutput = unknown> extends FunctionTask<TInput, TOutput> {
+    functionType: 'agentic';
+    /** Agent instructions */
+    instructions: string;
+    /** Available tools */
+    tools?: AIFunctionDefinition[];
+    /** Tool names (if using registry) */
+    toolNames?: string[];
+    /** Maximum iterations */
+    maxIterations?: number;
+    /** Model to use */
+    model?: string;
+    /** Stream intermediate results */
+    stream?: boolean;
+}
+/**
+ * Human task - requires human input
+ */
+export interface HumanTask<TInput = unknown, TOutput = unknown> extends FunctionTask<TInput, TOutput> {
+    functionType: 'human';
+    /** Interaction channel */
+    channel: HumanChannel;
+    /** Instructions for the human */
+    instructions: string;
+    /** Timeout in ms */
+    timeout?: number;
+    /** Who should handle this */
+    assignee?: string;
+    /** Expected response schema */
+    responseSchema?: unknown;
+}
+/**
+ * Union of all function task types
+ */
+export type AnyFunctionTask = CodeTask | GenerativeTask | AgenticTask | HumanTask;
+/**
+ * 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 declare function codeTask<TInput = unknown, TOutput = string>(options: Omit<CodeTask<TInput, TOutput>, 'id' | 'functionType'>): CodeTask<TInput, TOutput>;
+/**
+ * Create a generative task
+ *
+ * @example
+ * ```ts
+ * const task = generativeTask({
+ *   name: 'Summarize document',
+ *   prompt: 'Summarize the following document: {{document}}',
+ *   outputSchema: { summary: 'string', keyPoints: ['string'] },
+ * })
+ * ```
+ */
+export declare function generativeTask<TInput = unknown, TOutput = unknown>(options: Omit<GenerativeTask<TInput, TOutput>, 'id' | 'functionType'>): GenerativeTask<TInput, TOutput>;
+/**
+ * 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 declare function agenticTask<TInput = unknown, TOutput = unknown>(options: Omit<AgenticTask<TInput, TOutput>, 'id' | 'functionType'>): AgenticTask<TInput, TOutput>;
+/**
+ * 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 declare function humanTask<TInput = unknown, TOutput = unknown>(options: Omit<HumanTask<TInput, TOutput>, 'id' | 'functionType'>): HumanTask<TInput, TOutput>;
+/**
+ * Workflow definition with typed task graph
+ */
+export interface TypedWorkflow<TTasks extends Record<string, AnyFunctionTask> = Record<string, AnyFunctionTask>> {
+    /** Workflow ID */
+    id: string;
+    /** Workflow name */
+    name: string;
+    /** Workflow description */
+    description?: string;
+    /** Tasks in the workflow */
+    tasks: TTasks;
+    /** Explicit dependencies (if not using input resolvers) */
+    dependencies?: Array<{
+        task: keyof TTasks;
+        dependsOn: keyof TTasks | Array<keyof TTasks>;
+    }>;
+    /** Execution mode for tasks without explicit dependencies */
+    defaultMode?: 'parallel' | 'sequential';
+    /** Workflow metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for defining a typed workflow
+ */
+export interface DefineWorkflowOptions<TTasks extends Record<string, AnyFunctionTask>> {
+    name: string;
+    description?: string;
+    tasks: TTasks;
+    dependencies?: TypedWorkflow<TTasks>['dependencies'];
+    defaultMode?: 'parallel' | 'sequential';
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 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 declare function Workflow<TTasks extends Record<string, AnyFunctionTask>>(options: DefineWorkflowOptions<TTasks>): TypedWorkflow<TTasks>;
+/**
+ * Workflow execution state
+ */
+export interface WorkflowExecutionState {
+    /** Workflow ID */
+    workflowId: string;
+    /** Current status */
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+    /** Task statuses */
+    taskStatuses: Record<string, TaskStatus>;
+    /** Task outputs */
+    outputs: Record<string, unknown>;
+    /** Execution context */
+    context: WorkflowContext;
+    /** Start time */
+    startedAt?: Date;
+    /** End time */
+    completedAt?: Date;
+    /** Current task being executed */
+    currentTask?: string;
+    /** Error if failed */
+    error?: string;
+}
+/**
+ * Convert a function task to a base Task
+ */
+export declare function functionTaskToTask(functionTask: AnyFunctionTask): Partial<AnyTask>;
+/**
+ * Infer dependencies from input resolvers
+ */
+export declare function inferDependencies<TTasks extends Record<string, AnyFunctionTask>>(workflow: TypedWorkflow<TTasks>): Map<string, string[]>;
+/**
+ * Get execution order for a workflow (topological sort)
+ */
+export declare function getExecutionOrder<TTasks extends Record<string, AnyFunctionTask>>(workflow: TypedWorkflow<TTasks>): string[][];
+//# sourceMappingURL=function-task.d.ts.map

package/dist/function-task.d.ts.map

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

package/dist/function-task.js

@@ -0,0 +1,286 @@
+/**
+ * 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

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