digital-workers 0.1.1 → 2.0.2

package/dist/decide.js

@@ -0,0 +1,245 @@
+/**
+ * Decision-making functionality for digital workers
+ */
+import { generateObject } from 'ai-functions';
+/**
+ * Make a decision from a set of options
+ *
+ * Uses AI to evaluate options and make a reasoned decision,
+ * or can route to human decision-makers for critical choices.
+ *
+ * @param options - Decision options with configuration
+ * @returns Promise resolving to decision result
+ *
+ * @example
+ * ```ts
+ * const decision = await decide({
+ *   options: ['Option A', 'Option B', 'Option C'],
+ *   context: 'We need to choose a technology stack for our new project',
+ *   criteria: [
+ *     'Developer experience',
+ *     'Performance',
+ *     'Community support',
+ *     'Long-term viability',
+ *   ],
+ * })
+ *
+ * console.log(`Decision: ${decision.choice}`)
+ * console.log(`Reasoning: ${decision.reasoning}`)
+ * console.log(`Confidence: ${decision.confidence}`)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Complex decision with structured options
+ * const decision = await decide({
+ *   options: [
+ *     { id: 'migrate', label: 'Migrate to new platform' },
+ *     { id: 'refactor', label: 'Refactor existing system' },
+ *     { id: 'rebuild', label: 'Rebuild from scratch' },
+ *   ],
+ *   context: {
+ *     budget: '$500k',
+ *     timeline: '6 months',
+ *     teamSize: 5,
+ *     currentSystem: 'Legacy monolith',
+ *   },
+ *   criteria: ['Cost', 'Time to market', 'Risk', 'Scalability'],
+ * })
+ * ```
+ */
+export async function decide(options) {
+    const { options: choices, context, criteria = [], includeReasoning = true, } = options;
+    // Format context for the prompt
+    const contextStr = typeof context === 'string'
+        ? context
+        : context
+            ? JSON.stringify(context, null, 2)
+            : 'No additional context provided';
+    // Format choices for the prompt
+    const choicesStr = choices
+        .map((choice, i) => {
+        if (typeof choice === 'object' && choice !== null) {
+            return `${i + 1}. ${JSON.stringify(choice)}`;
+        }
+        return `${i + 1}. ${choice}`;
+    })
+        .join('\n');
+    const result = await generateObject({
+        model: 'sonnet',
+        schema: {
+            choice: 'The chosen option (must be one of the provided options)',
+            reasoning: includeReasoning
+                ? 'Detailed reasoning explaining why this choice is best'
+                : 'Brief explanation of the choice',
+            confidence: 'Confidence level in this decision as a decimal (number)',
+            alternatives: [
+                {
+                    option: 'An alternative option that was considered',
+                    score: 'Score for this alternative from 0-100 (number)',
+                },
+            ],
+            criteriaScores: criteria.length > 0
+                ? 'Scores for each criterion as object mapping criterion name to score (0-100)'
+                : undefined,
+        },
+        system: `You are a decision-making expert. Analyze the options carefully and make the best choice based on the context and criteria provided.
+
+${criteria.length > 0 ? `Evaluation Criteria:\n${criteria.map((c, i) => `${i + 1}. ${c}`).join('\n')}` : ''}`,
+        prompt: `Make a decision based on the following:
+
+Context:
+${contextStr}
+
+Options:
+${choicesStr}
+
+${criteria.length > 0 ? `\nEvaluate each option against these criteria:\n${criteria.join(', ')}` : ''}
+
+Provide your decision with clear reasoning.`,
+    });
+    const response = result.object;
+    return {
+        choice: response.choice,
+        reasoning: response.reasoning,
+        confidence: Math.min(1, Math.max(0, response.confidence)),
+        alternatives: response.alternatives,
+    };
+}
+/**
+ * Make a binary (yes/no) decision
+ *
+ * @param question - The yes/no question
+ * @param context - Context for the decision
+ * @returns Promise resolving to decision
+ *
+ * @example
+ * ```ts
+ * const decision = await decide.yesNo(
+ *   'Should we proceed with the deployment?',
+ *   {
+ *     tests: 'All passing',
+ *     codeReview: 'Approved',
+ *     loadTests: 'Within acceptable range',
+ *   }
+ * )
+ *
+ * if (decision.choice === 'yes') {
+ *   // Proceed with deployment
+ * }
+ * ```
+ */
+decide.yesNo = async (question, context) => {
+    return decide({
+        options: ['yes', 'no'],
+        context: typeof context === 'string'
+            ? `${question}\n\n${context}`
+            : `${question}\n\n${context ? JSON.stringify(context, null, 2) : ''}`,
+    });
+};
+/**
+ * Make a prioritization decision
+ *
+ * Ranks options by priority instead of choosing one.
+ *
+ * @param items - Items to prioritize
+ * @param context - Context for prioritization
+ * @param criteria - Criteria for prioritization
+ * @returns Promise resolving to prioritized list
+ *
+ * @example
+ * ```ts
+ * const prioritized = await decide.prioritize(
+ *   ['Feature A', 'Bug fix B', 'Tech debt C', 'Feature D'],
+ *   'Sprint planning for next 2 weeks',
+ *   ['User impact', 'Urgency', 'Effort required']
+ * )
+ *
+ * console.log('Priority order:', prioritized.map(p => p.choice))
+ * ```
+ */
+decide.prioritize = async (items, context, criteria = []) => {
+    const contextStr = typeof context === 'string'
+        ? context
+        : context
+            ? JSON.stringify(context, null, 2)
+            : 'No additional context provided';
+    const itemsStr = items
+        .map((item, i) => `${i + 1}. ${typeof item === 'object' ? JSON.stringify(item) : item}`)
+        .join('\n');
+    const result = await generateObject({
+        model: 'sonnet',
+        schema: {
+            prioritized: [
+                {
+                    item: 'The item',
+                    rank: 'Priority rank (1 = highest) (number)',
+                    reasoning: 'Why this priority',
+                    confidence: 'Confidence in this ranking (number)',
+                },
+            ],
+        },
+        system: `You are a prioritization expert. Rank items by priority based on the context and criteria.
+
+${criteria.length > 0 ? `Prioritization Criteria:\n${criteria.map((c, i) => `${i + 1}. ${c}`).join('\n')}` : ''}`,
+        prompt: `Prioritize the following items:
+
+Context:
+${contextStr}
+
+Items:
+${itemsStr}
+
+${criteria.length > 0 ? `\nConsider these criteria when prioritizing:\n${criteria.join(', ')}` : ''}
+
+Rank all items from highest to lowest priority.`,
+    });
+    const response = result.object;
+    return response.prioritized.map((p) => ({
+        choice: p.item,
+        rank: p.rank,
+        reasoning: p.reasoning,
+        confidence: Math.min(1, Math.max(0, p.confidence)),
+    }));
+};
+/**
+ * Make a decision with approval required
+ *
+ * Makes a recommendation but requires human approval before finalizing.
+ *
+ * @param options - Decision options
+ * @param approver - Who should approve the decision
+ * @returns Promise resolving to approved decision
+ *
+ * @example
+ * ```ts
+ * const decision = await decide.withApproval(
+ *   {
+ *     options: ['Rollback', 'Fix forward', 'Wait'],
+ *     context: 'Production incident - 500 errors on checkout',
+ *     criteria: ['User impact', 'Recovery time', 'Risk'],
+ *   },
+ *   'oncall-engineer@company.com'
+ * )
+ * ```
+ */
+decide.withApproval = async (options, approver) => {
+    // First, make the decision
+    const decision = await decide(options);
+    // Then request approval
+    const { approve } = await import('./approve.js');
+    const approval = await approve(`Approve decision: ${decision.choice}`, { id: approver }, {
+        via: 'slack',
+        context: {
+            decision,
+            options: options.options,
+            context: options.context,
+        },
+    });
+    return {
+        ...decision,
+        approved: approval.approved,
+        approvedBy: approval.approvedBy?.id ?? approval.approvedBy?.name,
+    };
+};
+//# sourceMappingURL=decide.js.map

package/dist/decide.js.map

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

package/dist/do.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Task execution functionality for digital workers
+ */
+import type { TaskResult, DoOptions } from './types.js';
+/**
+ * Execute a task
+ *
+ * Routes tasks to appropriate workers (AI or human) based on complexity
+ * and requirements. Handles retries, timeouts, and background execution.
+ *
+ * @param task - Description of the task to execute
+ * @param options - Execution options (retries, timeout, background, etc.)
+ * @returns Promise resolving to task result
+ *
+ * @example
+ * ```ts
+ * // Execute a simple task
+ * const result = await do('Generate monthly sales report', {
+ *   timeout: 60000, // 1 minute
+ *   context: {
+ *     month: 'January',
+ *     year: 2024,
+ *   },
+ * })
+ *
+ * if (result.success) {
+ *   console.log('Report:', result.result)
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Execute with retries
+ * const result = await do('Sync data to backup server', {
+ *   maxRetries: 3,
+ *   timeout: 30000,
+ *   context: {
+ *     source: 'primary-db',
+ *     destination: 'backup-db',
+ *   },
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Execute in background
+ * const result = await do('Process large dataset', {
+ *   background: true,
+ *   context: {
+ *     dataset: 'customer_transactions.csv',
+ *     outputFormat: 'parquet',
+ *   },
+ * })
+ * ```
+ */
+export declare function doTask<T = unknown>(task: string, options?: DoOptions): Promise<TaskResult<T>>;
+export declare namespace doTask {
+    var parallel: <T = unknown>(tasks: string[], options?: DoOptions) => Promise<Array<TaskResult<T>>>;
+    var sequence: <T = unknown>(tasks: string[], options?: DoOptions) => Promise<Array<TaskResult<T>>>;
+    var withDependencies: <T = unknown>(task: string, dependencies: string[], options?: DoOptions) => Promise<TaskResult<T>>;
+}
+export { doTask as do };
+//# sourceMappingURL=do.d.ts.map

package/dist/do.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do.d.ts","sourceRoot":"","sources":["../src/do.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,OAAO,EACtC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,SAAc,GACtB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAiGxB;yBApGqB,MAAM;mBA8HH,CAAC,mBACjB,MAAM,EAAE,YACN,SAAS,KACjB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;mBAsBP,CAAC,mBACjB,MAAM,EAAE,YACN,SAAS,KACjB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;2BAiCC,CAAC,kBAC1B,MAAM,gBACE,MAAM,EAAE,YACb,SAAS,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;;AAxFzB,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,CAAA"}

package/dist/do.js

@@ -0,0 +1,228 @@
+/**
+ * Task execution functionality for digital workers
+ */
+import { define } from 'ai-functions';
+/**
+ * Execute a task
+ *
+ * Routes tasks to appropriate workers (AI or human) based on complexity
+ * and requirements. Handles retries, timeouts, and background execution.
+ *
+ * @param task - Description of the task to execute
+ * @param options - Execution options (retries, timeout, background, etc.)
+ * @returns Promise resolving to task result
+ *
+ * @example
+ * ```ts
+ * // Execute a simple task
+ * const result = await do('Generate monthly sales report', {
+ *   timeout: 60000, // 1 minute
+ *   context: {
+ *     month: 'January',
+ *     year: 2024,
+ *   },
+ * })
+ *
+ * if (result.success) {
+ *   console.log('Report:', result.result)
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Execute with retries
+ * const result = await do('Sync data to backup server', {
+ *   maxRetries: 3,
+ *   timeout: 30000,
+ *   context: {
+ *     source: 'primary-db',
+ *     destination: 'backup-db',
+ *   },
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Execute in background
+ * const result = await do('Process large dataset', {
+ *   background: true,
+ *   context: {
+ *     dataset: 'customer_transactions.csv',
+ *     outputFormat: 'parquet',
+ *   },
+ * })
+ * ```
+ */
+export async function doTask(task, options = {}) {
+    const { maxRetries = 0, timeout, background = false, context, } = options;
+    const startTime = Date.now();
+    const steps = [];
+    // Use agentic function for complex tasks
+    const taskFn = define.agentic({
+        name: 'executeTask',
+        description: 'Execute a task using available tools and capabilities',
+        args: {
+            task: 'Description of the task to execute',
+            contextInfo: 'Additional context and parameters for the task',
+        },
+        returnType: {
+            result: 'The result of executing the task',
+            steps: ['List of steps taken to complete the task'],
+        },
+        instructions: `Execute the following task:
+
+${task}
+
+${context ? `Context: ${JSON.stringify(context, null, 2)}` : ''}
+
+Work step-by-step to complete the task. Use available tools as needed.
+Document each step you take for transparency.`,
+        maxIterations: 10,
+        tools: [], // Tools would be provided by the execution environment
+    });
+    let retries = 0;
+    let lastError;
+    while (retries <= maxRetries) {
+        try {
+            const response = await Promise.race([
+                taskFn.call({ task, contextInfo: context ? JSON.stringify(context) : '' }),
+                timeout
+                    ? new Promise((_, reject) => setTimeout(() => reject(new Error('Task timeout')), timeout))
+                    : new Promise(() => { }), // Never resolves if no timeout
+            ]);
+            const typedResponse = response;
+            // Track steps if provided
+            if (typedResponse.steps) {
+                steps.push(...typedResponse.steps.map((step) => ({
+                    ...step,
+                    timestamp: new Date(),
+                })));
+            }
+            const duration = Date.now() - startTime;
+            return {
+                result: typedResponse.result,
+                success: true,
+                duration,
+                steps,
+            };
+        }
+        catch (error) {
+            lastError = error;
+            retries++;
+            if (retries <= maxRetries) {
+                steps.push({
+                    action: `Retry attempt ${retries}`,
+                    result: { error: lastError.message },
+                    timestamp: new Date(),
+                });
+                // Exponential backoff
+                await new Promise((resolve) => setTimeout(resolve, Math.pow(2, retries) * 1000));
+            }
+        }
+    }
+    const duration = Date.now() - startTime;
+    return {
+        result: undefined,
+        success: false,
+        error: lastError?.message || 'Task failed',
+        duration,
+        steps,
+    };
+}
+// Export as 'do' with proper typing
+export { doTask as do };
+/**
+ * Execute multiple tasks in parallel
+ *
+ * @param tasks - Array of tasks to execute
+ * @param options - Execution options
+ * @returns Promise resolving to array of task results
+ *
+ * @example
+ * ```ts
+ * const results = await do.parallel([
+ *   'Generate sales report',
+ *   'Generate marketing report',
+ *   'Generate finance report',
+ * ], {
+ *   timeout: 60000,
+ * })
+ *
+ * const successful = results.filter(r => r.success)
+ * console.log(`Completed ${successful.length} of ${results.length} tasks`)
+ * ```
+ */
+doTask.parallel = async (tasks, options = {}) => {
+    return Promise.all(tasks.map((task) => doTask(task, options)));
+};
+/**
+ * Execute tasks in sequence
+ *
+ * @param tasks - Array of tasks to execute sequentially
+ * @param options - Execution options
+ * @returns Promise resolving to array of task results
+ *
+ * @example
+ * ```ts
+ * const results = await do.sequence([
+ *   'Backup database',
+ *   'Run migrations',
+ *   'Restart application',
+ * ], {
+ *   maxRetries: 1,
+ * })
+ * ```
+ */
+doTask.sequence = async (tasks, options = {}) => {
+    const results = [];
+    for (const task of tasks) {
+        const result = await doTask(task, options);
+        results.push(result);
+        // Stop if a task fails (unless we're continuing on error)
+        if (!result.success && !options.context?.continueOnError) {
+            break;
+        }
+    }
+    return results;
+};
+/**
+ * Execute a task with specific dependencies
+ *
+ * @param task - The task to execute
+ * @param dependencies - Tasks that must complete first
+ * @param options - Execution options
+ * @returns Promise resolving to task result
+ *
+ * @example
+ * ```ts
+ * const result = await do.withDependencies(
+ *   'Deploy application',
+ *   ['Run tests', 'Build artifacts', 'Get approval'],
+ *   { maxRetries: 1 }
+ * )
+ * ```
+ */
+doTask.withDependencies = async (task, dependencies, options = {}) => {
+    // Execute dependencies in sequence
+    const depResults = await doTask.sequence(dependencies, options);
+    // Check if all dependencies succeeded
+    const allSuccessful = depResults.every((r) => r.success);
+    if (!allSuccessful) {
+        const failed = depResults.filter((r) => !r.success);
+        return {
+            result: undefined,
+            success: false,
+            error: `Dependencies failed: ${failed.map((r) => r.error).join(', ')}`,
+            duration: 0,
+        };
+    }
+    // Execute main task with dependency results as context
+    return doTask(task, {
+        ...options,
+        context: {
+            ...options.context,
+            dependencies: depResults.map((r) => r.result),
+        },
+    });
+};
+//# sourceMappingURL=do.js.map

package/dist/do.js.map

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

package/dist/generate.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Content generation functionality for digital workers
+ */
+import type { GenerateResult, GenerateOptions } from './types.js';
+/**
+ * Generate content
+ *
+ * Uses AI to generate various types of content including text,
+ * code, structured data, images, video, and audio.
+ *
+ * @param prompt - What to generate
+ * @param options - Generation options
+ * @returns Promise resolving to generated content
+ *
+ * @example
+ * ```ts
+ * // Generate text content
+ * const result = await generate('Write a product description for wireless earbuds', {
+ *   type: 'text',
+ *   instructions: 'Focus on sound quality and battery life. Keep it under 100 words.',
+ * })
+ * console.log(result.content)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Generate structured data
+ * const result = await generate('Create a user profile', {
+ *   type: 'structured',
+ *   schema: {
+ *     name: 'User full name',
+ *     email: 'Email address',
+ *     role: 'admin | user | guest',
+ *     preferences: {
+ *       theme: 'light | dark',
+ *       notifications: 'Whether to receive notifications (boolean)',
+ *     },
+ *   },
+ * })
+ * console.log(result.content) // { name: '...', email: '...', ... }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Generate code
+ * const result = await generate('Create a React component for a todo list', {
+ *   type: 'code',
+ *   instructions: 'Use TypeScript and hooks. Include prop types.',
+ * })
+ * console.log(result.content) // TypeScript React component code
+ * ```
+ */
+export declare function generate<T = string>(prompt: string, options?: GenerateOptions): Promise<GenerateResult<T>>;
+export declare namespace generate {
+    var variations: <T = string>(prompt: string, count: number, options?: GenerateOptions) => Promise<Array<GenerateResult<T>>>;
+    var withTone: <T = string>(prompt: string, tone: "professional" | "casual" | "friendly" | "formal" | "humorous" | "empathetic", options?: GenerateOptions) => Promise<GenerateResult<T>>;
+    var forAudience: <T = string>(prompt: string, audience: string, options?: GenerateOptions) => Promise<GenerateResult<T>>;
+    var withLength: <T = string>(prompt: string, length: "brief" | "short" | "medium" | "long" | "detailed", options?: GenerateOptions) => Promise<GenerateResult<T>>;
+    var refine: <T = string>(prompt: string, refinements: string[], options?: GenerateOptions) => Promise<GenerateResult<T>>;
+}
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,MAAM,EACvC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAkH5B;yBArHqB,QAAQ;qBA4ID,CAAC,mBACpB,MAAM,SACP,MAAM,YACJ,eAAe,KACvB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;mBA6BT,CAAC,mBAClB,MAAM,QACR,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,YAC1E,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;sBAuCC,CAAC,mBACrB,MAAM,YACJ,MAAM,YACP,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;qBA8BA,CAAC,mBACpB,MAAM,UACN,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,YACjD,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;iBAoCJ,CAAC,mBAChB,MAAM,eACD,MAAM,EAAE,YACZ,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC"}