digital-workers 0.1.1 → 2.0.1

package/dist/actions.js

@@ -0,0 +1,437 @@
+/**
+ * Worker Actions - Workflow Integration
+ *
+ * Worker actions (notify, ask, approve, decide, do) are durable workflow actions
+ * that integrate with ai-workflows. They can be invoked via:
+ *
+ * 1. `$.do('Worker.notify', data)` - Durable action
+ * 2. `$.send('Worker.notify', data)` - Fire and forget
+ * 3. `$.notify(target, message)` - Convenience method (when using withWorkers)
+ *
+ * @packageDocumentation
+ */
+// ============================================================================
+// Action Handlers
+// ============================================================================
+/**
+ * Handle Worker.notify action
+ */
+export async function handleNotify(data, $) {
+    const { object: target, message, via, priority = 'normal' } = data;
+    // Resolve target to get contacts
+    const { contacts, recipients } = resolveTarget(target);
+    // Determine which channels to use
+    const channels = resolveChannels(via, contacts, priority);
+    if (channels.length === 0) {
+        return {
+            sent: false,
+            via: [],
+            sentAt: new Date(),
+            messageId: generateId('msg'),
+        };
+    }
+    // Send to each channel
+    const delivery = await Promise.all(channels.map(async (channel) => {
+        try {
+            await sendToChannel(channel, message, contacts, { priority });
+            return { channel, status: 'sent' };
+        }
+        catch (error) {
+            return {
+                channel,
+                status: 'failed',
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }));
+    const sent = delivery.some((d) => d.status === 'sent');
+    const result = {
+        sent,
+        via: channels,
+        recipients,
+        sentAt: new Date(),
+        messageId: generateId('msg'),
+        delivery,
+    };
+    // Emit result event
+    if (sent) {
+        await $.send('Worker.notified', { ...data, result });
+    }
+    return result;
+}
+/**
+ * Handle Worker.ask action
+ */
+export async function handleAsk(data, $) {
+    const { object: target, question, via, schema, timeout } = data;
+    // Resolve target
+    const { contacts, recipients } = resolveTarget(target);
+    const recipient = recipients[0];
+    // Determine channel
+    const channel = resolveChannel(via, contacts);
+    if (!channel) {
+        throw new Error('No valid channel available for ask action');
+    }
+    // Send question and wait for response
+    const answer = await sendQuestion(channel, question, contacts, { schema, timeout });
+    const result = {
+        answer,
+        answeredBy: recipient,
+        answeredAt: new Date(),
+        via: channel,
+    };
+    // Emit result event
+    await $.send('Worker.answered', { ...data, result });
+    return result;
+}
+/**
+ * Handle Worker.approve action
+ */
+export async function handleApprove(data, $) {
+    const { object: target, request, via, context, timeout, escalate } = data;
+    // Resolve target
+    const { contacts, recipients } = resolveTarget(target);
+    const approver = recipients[0];
+    // Determine channel
+    const channel = resolveChannel(via, contacts);
+    if (!channel) {
+        throw new Error('No valid channel available for approve action');
+    }
+    // Send approval request and wait for response
+    const response = await sendApprovalRequest(channel, request, contacts, {
+        context,
+        timeout,
+        escalate,
+    });
+    const result = {
+        approved: response.approved,
+        approvedBy: approver,
+        approvedAt: new Date(),
+        notes: response.notes,
+        via: channel,
+    };
+    // Emit result event
+    await $.send(result.approved ? 'Worker.approved' : 'Worker.rejected', { ...data, result });
+    return result;
+}
+/**
+ * Handle Worker.decide action
+ */
+export async function handleDecide(data, $) {
+    const { options, context, criteria } = data;
+    // Use AI to make decision
+    const result = await makeDecision(options, context, criteria);
+    // Emit result event
+    await $.send('Worker.decided', { ...data, result });
+    return result;
+}
+/**
+ * Handle Worker.do action
+ */
+export async function handleDo(data, $) {
+    const { object: target, instruction, timeout, maxRetries = 3 } = data;
+    const startTime = Date.now();
+    const steps = [];
+    let lastError;
+    let result;
+    // Retry loop
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            steps.push({
+                action: attempt === 0 ? 'start' : `retry_${attempt}`,
+                result: { instruction },
+                timestamp: new Date(),
+            });
+            // Execute the task (this would integrate with agent execution)
+            result = await executeTask(target, instruction, { timeout });
+            steps.push({
+                action: 'complete',
+                result,
+                timestamp: new Date(),
+            });
+            const doResult = {
+                result: result,
+                success: true,
+                duration: Date.now() - startTime,
+                steps,
+            };
+            await $.send('Worker.done', { ...data, result: doResult });
+            return doResult;
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            steps.push({
+                action: 'error',
+                result: { error: lastError.message, attempt },
+                timestamp: new Date(),
+            });
+        }
+    }
+    // All retries failed
+    const failResult = {
+        result: undefined,
+        success: false,
+        error: lastError?.message,
+        duration: Date.now() - startTime,
+        steps,
+    };
+    await $.send('Worker.failed', { ...data, result: failResult });
+    return failResult;
+}
+// ============================================================================
+// Workflow Extension
+// ============================================================================
+/**
+ * Register Worker action handlers with a workflow
+ *
+ * @example
+ * ```ts
+ * import { Workflow } from 'ai-workflows'
+ * import { registerWorkerActions } from 'digital-workers'
+ *
+ * const workflow = Workflow($ => {
+ *   registerWorkerActions($)
+ *
+ *   $.on.Expense.submitted(async (expense, $) => {
+ *     const approval = await $.do('Worker.approve', {
+ *       actor: 'system',
+ *       object: manager,
+ *       request: `Expense: $${expense.amount}`,
+ *       via: 'slack',
+ *     })
+ *   })
+ * })
+ * ```
+ */
+export function registerWorkerActions($) {
+    // Register action handlers using the proxy pattern
+    // The $ context provides event registration via $.on[Namespace][event]
+    const on = $.on;
+    if (on.Worker) {
+        on.Worker.notify?.(handleNotify);
+        on.Worker.ask?.(handleAsk);
+        on.Worker.approve?.(handleApprove);
+        on.Worker.decide?.(handleDecide);
+        on.Worker.do?.(handleDo);
+    }
+}
+/**
+ * Extend WorkflowContext with convenience methods for worker actions
+ *
+ * @example
+ * ```ts
+ * const workflow = Workflow($ => {
+ *   const worker$ = withWorkers($)
+ *
+ *   $.on.Expense.submitted(async (expense) => {
+ *     await worker$.notify(finance, `New expense: ${expense.amount}`)
+ *
+ *     const approval = await worker$.approve(
+ *       `Expense: $${expense.amount}`,
+ *       manager,
+ *       { via: 'slack' }
+ *     )
+ *   })
+ * })
+ * ```
+ */
+export function withWorkers($) {
+    const workerContext = {
+        async notify(target, message, options = {}) {
+            return $.do('Worker.notify', {
+                actor: 'system',
+                object: target,
+                action: 'notify',
+                message,
+                ...options,
+            });
+        },
+        async ask(target, question, options = {}) {
+            return $.do('Worker.ask', {
+                actor: 'system',
+                object: target,
+                action: 'ask',
+                question,
+                ...options,
+            });
+        },
+        async approve(request, target, options = {}) {
+            // Convert ActionTarget to a suitable actor reference
+            const actor = typeof target === 'string'
+                ? target
+                : 'id' in target
+                    ? { id: target.id, type: 'type' in target ? target.type : undefined, name: 'name' in target ? target.name : undefined }
+                    : 'system';
+            return $.do('Worker.approve', {
+                actor,
+                object: target,
+                action: 'approve',
+                request,
+                ...options,
+            });
+        },
+        async decide(options) {
+            return $.do('Worker.decide', {
+                actor: 'ai',
+                object: 'decision',
+                action: 'decide',
+                ...options,
+            });
+        },
+    };
+    return { ...$, ...workerContext };
+}
+// ============================================================================
+// Standalone Functions (for use outside workflows)
+// ============================================================================
+/**
+ * Send a notification (standalone, non-durable)
+ */
+export async function notify(target, message, options = {}) {
+    const { contacts, recipients } = resolveTarget(target);
+    const channels = resolveChannels(options.via, contacts, options.priority || 'normal');
+    if (channels.length === 0) {
+        return { sent: false, via: [], messageId: generateId('msg') };
+    }
+    const delivery = await Promise.all(channels.map(async (channel) => {
+        try {
+            await sendToChannel(channel, message, contacts, { priority: options.priority });
+            return { channel, status: 'sent' };
+        }
+        catch (error) {
+            return { channel, status: 'failed', error: String(error) };
+        }
+    }));
+    return {
+        sent: delivery.some((d) => d.status === 'sent'),
+        via: channels,
+        recipients,
+        sentAt: new Date(),
+        messageId: generateId('msg'),
+        delivery,
+    };
+}
+/**
+ * Ask a question (standalone, non-durable)
+ */
+export async function ask(target, question, options = {}) {
+    const { contacts, recipients } = resolveTarget(target);
+    const channel = resolveChannel(options.via, contacts);
+    if (!channel) {
+        throw new Error('No valid channel available');
+    }
+    const answer = await sendQuestion(channel, question, contacts, options);
+    return {
+        answer,
+        answeredBy: recipients[0],
+        answeredAt: new Date(),
+        via: channel,
+    };
+}
+/**
+ * Request approval (standalone, non-durable)
+ */
+export async function approve(request, target, options = {}) {
+    const { contacts, recipients } = resolveTarget(target);
+    const channel = resolveChannel(options.via, contacts);
+    if (!channel) {
+        throw new Error('No valid channel available');
+    }
+    const response = await sendApprovalRequest(channel, request, contacts, options);
+    return {
+        approved: response.approved,
+        approvedBy: recipients[0],
+        approvedAt: new Date(),
+        notes: response.notes,
+        via: channel,
+    };
+}
+/**
+ * Make a decision (standalone, non-durable)
+ */
+export async function decide(options) {
+    return makeDecision(options.options, options.context, options.criteria);
+}
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+function resolveTarget(target) {
+    if (typeof target === 'string') {
+        return { contacts: {}, recipients: [{ id: target }] };
+    }
+    if ('contacts' in target) {
+        const recipients = 'members' in target
+            ? target.members
+            : [{ id: target.id, type: target.type, name: target.name }];
+        return { contacts: target.contacts, recipients };
+    }
+    return { contacts: {}, recipients: [target] };
+}
+function resolveChannels(via, contacts, priority) {
+    if (via) {
+        const requested = Array.isArray(via) ? via : [via];
+        return requested.filter((c) => contacts[c] !== undefined);
+    }
+    const available = Object.keys(contacts);
+    if (available.length === 0)
+        return [];
+    const firstChannel = available[0];
+    if (!firstChannel)
+        return [];
+    if (priority === 'urgent') {
+        const urgentChannels = ['slack', 'sms', 'phone'];
+        const urgent = available.filter((c) => urgentChannels.includes(c));
+        return urgent.length > 0 ? urgent : [firstChannel];
+    }
+    return [firstChannel];
+}
+function resolveChannel(via, contacts) {
+    if (via) {
+        const channel = Array.isArray(via) ? via[0] : via;
+        if (channel && contacts[channel] !== undefined)
+            return channel;
+    }
+    const available = Object.keys(contacts);
+    const first = available[0];
+    return first ?? null;
+}
+async function sendToChannel(channel, message, contacts, options) {
+    // In a real implementation, this would send via Slack API, SendGrid, Twilio, etc.
+    await new Promise((resolve) => setTimeout(resolve, 10));
+}
+async function sendQuestion(channel, question, contacts, options) {
+    // In a real implementation, this would send the question and wait for response
+    await new Promise((resolve) => setTimeout(resolve, 10));
+    return 'Pending response...';
+}
+async function sendApprovalRequest(channel, request, contacts, options) {
+    // In a real implementation, this would send approval request and wait
+    await new Promise((resolve) => setTimeout(resolve, 10));
+    return { approved: false, notes: 'Pending approval...' };
+}
+async function makeDecision(options, context, criteria) {
+    if (options.length === 0) {
+        throw new Error('At least one option is required for a decision');
+    }
+    // In a real implementation, this would use AI to make a decision
+    // For now, return first option with mock data
+    const choice = options[0];
+    return {
+        choice,
+        reasoning: 'Decision pending...',
+        confidence: 0.5,
+        alternatives: options.slice(1).map((opt, i) => ({
+            option: opt,
+            score: 50 - i * 10,
+        })),
+    };
+}
+async function executeTask(target, instruction, options) {
+    // In a real implementation, this would execute the task via the target worker
+    await new Promise((resolve) => setTimeout(resolve, 10));
+    return { completed: true, instruction };
+}
+function generateId(prefix) {
+    return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

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

package/dist/approve.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Approval request functionality for digital workers
+ */
+import type { ActionTarget, ApprovalResult, ApprovalOptions } from './types.js';
+/**
+ * Request approval from a worker or team
+ *
+ * Routes approval requests through the specified channel and waits for a response.
+ *
+ * @param request - What is being requested for approval
+ * @param target - The worker or team to request approval from
+ * @param options - Approval options
+ * @returns Promise resolving to approval result
+ *
+ * @example
+ * ```ts
+ * // Request approval from a worker
+ * const result = await approve('Expense: $500 for AWS', manager, {
+ *   via: 'slack',
+ *   context: { amount: 500, category: 'Infrastructure' },
+ * })
+ *
+ * if (result.approved) {
+ *   console.log(`Approved by ${result.approvedBy?.name}`)
+ * }
+ *
+ * // Request approval from a team
+ * const result = await approve('Deploy v2.1.0 to production', opsTeam, {
+ *   via: 'slack',
+ * })
+ * ```
+ */
+export declare function approve(request: string, target: ActionTarget, options?: ApprovalOptions): Promise<ApprovalResult>;
+export declare namespace approve {
+    var withContext: (request: string, target: ActionTarget, decision: {
+        pros?: string[];
+        cons?: string[];
+        risks?: string[];
+        mitigations?: string[];
+        alternatives?: string[];
+    }, options?: ApprovalOptions) => Promise<ApprovalResult>;
+    var batch: (requests: string[], target: ActionTarget, options?: ApprovalOptions) => Promise<ApprovalResult[]>;
+    var withDeadline: (request: string, target: ActionTarget, deadline: Date, options?: ApprovalOptions) => Promise<ApprovalResult>;
+    var any: (request: string, targets: ActionTarget[], options?: ApprovalOptions) => Promise<ApprovalResult>;
+    var all: (request: string, targets: ActionTarget[], options?: ApprovalOptions) => Promise<ApprovalResult & {
+        approvals: ApprovalResult[];
+    }>;
+}
+//# sourceMappingURL=approve.d.ts.map

package/dist/approve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../src/approve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAIV,YAAY,EAEZ,cAAc,EACd,eAAe,EAEhB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA4BzB;yBAhCqB,OAAO;+BAqDlB,MAAM,UACP,YAAY,YACV;QACR,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;QACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KACxB,YACQ,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC;0BAyBd,MAAM,EAAE,UACV,YAAY,YACX,eAAe,KACvB,OAAO,CAAC,cAAc,EAAE,CAAC;gCAkBjB,MAAM,UACP,YAAY,YACV,IAAI,YACL,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC;uBAyBf,MAAM,WACN,YAAY,EAAE,YACd,eAAe,KACvB,OAAO,CAAC,cAAc,CAAC;uBAkBf,MAAM,WACN,YAAY,EAAE,YACd,eAAe,KACvB,OAAO,CAAC,cAAc,GAAG;QAAE,SAAS,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC"}