digital-workers 2.1.1 → 2.3.0

package/dist/runtime.js

@@ -0,0 +1,510 @@
+/**
+ * Runtime Integration for Human Request Processing
+ *
+ * Connects transport adapters (Slack, Email, etc.) to a request store and
+ * provides orchestration for approval workflows, questions, and notifications.
+ *
+ * The HumanRequestProcessor is the central coordinator that:
+ * - Sends requests via configured transports
+ * - Tracks request state in a store
+ * - Handles webhook callbacks from transports
+ * - Notifies when requests complete or timeout
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// In-Memory Request Store
+// =============================================================================
+/**
+ * In-memory implementation of HumanRequestStore
+ *
+ * Suitable for development and testing. For production, implement
+ * a store backed by Durable Objects, KV, or a database.
+ */
+export class InMemoryRequestStore {
+    requests = new Map();
+    externalIdIndex = new Map();
+    counter = 0;
+    generateId() {
+        this.counter++;
+        return `req_${Date.now()}_${this.counter.toString().padStart(4, '0')}`;
+    }
+    async create(data) {
+        const id = this.generateId();
+        const request = {
+            id,
+            type: data.type,
+            target: data.target,
+            content: data.content,
+            status: 'pending',
+            transport: data.transport,
+            createdAt: new Date(),
+        };
+        if (data.requestedBy !== undefined) {
+            request.requestedBy = data.requestedBy;
+        }
+        if (data.context !== undefined) {
+            request.context = data.context;
+        }
+        if (data.notifyChannel !== undefined) {
+            request.notifyChannel = data.notifyChannel;
+        }
+        if (data.expiresAt !== undefined) {
+            request.expiresAt = data.expiresAt;
+        }
+        this.requests.set(id, request);
+        return request;
+    }
+    async get(id) {
+        return this.requests.get(id);
+    }
+    async update(id, data) {
+        const request = this.requests.get(id);
+        if (!request) {
+            return undefined;
+        }
+        if (data.status !== undefined) {
+            request.status = data.status;
+        }
+        if (data.externalId !== undefined) {
+            request.externalId = data.externalId;
+            this.externalIdIndex.set(data.externalId, id);
+        }
+        if (data.result !== undefined) {
+            request.result = data.result;
+        }
+        if (data.completedAt !== undefined) {
+            request.completedAt = data.completedAt;
+        }
+        // Auto-set completedAt when status becomes terminal
+        if (data.status === 'completed' || data.status === 'expired' || data.status === 'cancelled') {
+            if (!request.completedAt) {
+                request.completedAt = new Date();
+            }
+        }
+        this.requests.set(id, request);
+        return request;
+    }
+    async findByExternalId(externalId) {
+        const requestId = this.externalIdIndex.get(externalId);
+        if (!requestId) {
+            return undefined;
+        }
+        return this.requests.get(requestId);
+    }
+    async listPending() {
+        const pending = [];
+        for (const request of this.requests.values()) {
+            if (request.status === 'pending') {
+                pending.push(request);
+            }
+        }
+        return pending;
+    }
+    async listExpired() {
+        const now = new Date();
+        const expired = [];
+        for (const request of this.requests.values()) {
+            if (request.status === 'pending' && request.expiresAt && request.expiresAt <= now) {
+                expired.push(request);
+            }
+        }
+        return expired;
+    }
+}
+// =============================================================================
+// Human Request Processor
+// =============================================================================
+/**
+ * Human Request Processor
+ *
+ * Coordinates between transport adapters and the request store to
+ * handle approval workflows, questions, and notifications.
+ *
+ * @example
+ * ```ts
+ * const processor = createHumanRequestProcessor({
+ *   store: new InMemoryRequestStore(),
+ *   transports: {
+ *     slack: createSlackTransport({ botToken, signingSecret }),
+ *     email: createEmailTransport({ apiKey }),
+ *   },
+ *   onComplete: (data) => {
+ *     console.log(`Request ${data.requestId} completed:`, data.result)
+ *   },
+ * })
+ *
+ * // Submit a request
+ * const result = await processor.submitRequest({
+ *   type: 'approval',
+ *   target: '#approvals',
+ *   content: 'Approve deployment?',
+ *   transport: 'slack',
+ * })
+ *
+ * // Handle webhook when user responds
+ * await processor.handleWebhook('slack', {
+ *   type: 'approval_response',
+ *   requestId: result.requestId,
+ *   approved: true,
+ * })
+ * ```
+ */
+export class HumanRequestProcessor {
+    store;
+    transports;
+    onCompleteCallback;
+    onTimeoutCallback;
+    notifyRequestor;
+    checkIntervalMs;
+    timeoutChecker = null;
+    destroyed = false;
+    constructor(config) {
+        this.store = config.store;
+        this.transports = config.transports;
+        this.onCompleteCallback = config.onComplete ?? null;
+        this.onTimeoutCallback = config.onTimeout ?? null;
+        this.notifyRequestor = config.notifyRequestor ?? false;
+        this.checkIntervalMs = config.checkIntervalMs ?? 30000;
+        // Start timeout checker if onTimeout callback is provided
+        if (this.onTimeoutCallback) {
+            this.startTimeoutChecker();
+        }
+    }
+    /**
+     * Submit a new human request via the specified transport
+     */
+    async submitRequest(data) {
+        // Validate transport is configured
+        const transport = this.getTransport(data.transport);
+        if (!transport) {
+            return {
+                success: false,
+                error: `Transport '${data.transport}' not configured`,
+            };
+        }
+        // Calculate expiration time if timeout specified
+        let expiresAt;
+        if (data.timeout !== undefined) {
+            expiresAt = new Date(Date.now() + data.timeout);
+        }
+        // Create request in store
+        const createData = {
+            type: data.type,
+            target: data.target,
+            content: data.content,
+            transport: data.transport,
+        };
+        if (data.requestedBy !== undefined) {
+            createData.requestedBy = data.requestedBy;
+        }
+        if (data.context !== undefined) {
+            createData.context = data.context;
+        }
+        if (data.notifyChannel !== undefined) {
+            createData.notifyChannel = data.notifyChannel;
+        }
+        if (expiresAt !== undefined) {
+            createData.expiresAt = expiresAt;
+        }
+        const request = await this.store.create(createData);
+        // Send via transport
+        let deliveryResult;
+        try {
+            deliveryResult = await this.sendViaTransport(data.transport, transport, request);
+        }
+        catch (error) {
+            // Update request status to failed
+            await this.store.update(request.id, { status: 'failed' });
+            return {
+                success: false,
+                requestId: request.id,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+        if (!deliveryResult.success) {
+            // Update request status to failed
+            await this.store.update(request.id, { status: 'failed' });
+            const errorResult = {
+                success: false,
+                requestId: request.id,
+            };
+            if (deliveryResult.error) {
+                errorResult.error = deliveryResult.error;
+            }
+            return errorResult;
+        }
+        // Update request with external ID
+        if (deliveryResult.messageId) {
+            await this.store.update(request.id, {
+                externalId: deliveryResult.messageId,
+            });
+        }
+        const successResult = {
+            success: true,
+            requestId: request.id,
+        };
+        if (deliveryResult.messageId) {
+            successResult.externalId = deliveryResult.messageId;
+        }
+        return successResult;
+    }
+    /**
+     * Handle a webhook callback from a transport
+     */
+    async handleWebhook(transport, payload) {
+        const { requestId } = payload;
+        // Find the request
+        const request = await this.store.get(requestId);
+        if (!request) {
+            return {
+                success: false,
+                requestId,
+                error: `Request '${requestId}' not found`,
+            };
+        }
+        // Check if already completed
+        if (request.status !== 'pending') {
+            return {
+                success: false,
+                requestId,
+                error: `Request '${requestId}' already completed with status '${request.status}'`,
+            };
+        }
+        // Build result based on payload type
+        let result;
+        if (payload.type === 'email_reply') {
+            // Parse email content for approval/rejection
+            const approved = this.parseEmailApproval(payload.content ?? '');
+            result = {
+                approved,
+                via: transport,
+                respondedAt: new Date(),
+            };
+            if (payload.from) {
+                result.respondedBy = { id: payload.from };
+            }
+        }
+        else {
+            result = {
+                respondedAt: new Date(),
+                via: transport,
+            };
+            if (payload.approved !== undefined) {
+                result.approved = payload.approved;
+            }
+            if (payload.answer !== undefined) {
+                result.answer = payload.answer;
+            }
+            if (payload.respondedBy !== undefined) {
+                result.respondedBy = payload.respondedBy;
+            }
+            if (payload.notes !== undefined) {
+                result.notes = payload.notes;
+            }
+        }
+        // Update the request
+        await this.store.update(requestId, {
+            status: 'completed',
+            result,
+            completedAt: new Date(),
+        });
+        // Notify requestor if configured
+        if (this.notifyRequestor && request.notifyChannel) {
+            await this.notifyRequestorOfResult(request, result);
+        }
+        // Call onComplete callback
+        if (this.onCompleteCallback) {
+            const updatedRequest = await this.store.get(requestId);
+            if (updatedRequest) {
+                try {
+                    await this.onCompleteCallback({
+                        requestId,
+                        request: updatedRequest,
+                        result,
+                    });
+                }
+                catch {
+                    // Swallow callback errors
+                }
+            }
+        }
+        return {
+            success: true,
+            requestId,
+        };
+    }
+    /**
+     * Get a request by ID
+     */
+    async getRequest(requestId) {
+        return this.store.get(requestId);
+    }
+    /**
+     * Cancel a pending request
+     */
+    async cancelRequest(requestId) {
+        const request = await this.store.get(requestId);
+        if (!request) {
+            return {
+                success: false,
+                error: `Request '${requestId}' not found`,
+            };
+        }
+        if (request.status !== 'pending') {
+            return {
+                success: false,
+                error: `Request '${requestId}' already completed with status '${request.status}'`,
+            };
+        }
+        await this.store.update(requestId, {
+            status: 'cancelled',
+            completedAt: new Date(),
+        });
+        return { success: true };
+    }
+    /**
+     * Stop the processor and clean up resources
+     */
+    destroy() {
+        this.destroyed = true;
+        if (this.timeoutChecker !== null) {
+            clearInterval(this.timeoutChecker);
+            this.timeoutChecker = null;
+        }
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    getTransport(transport) {
+        switch (transport) {
+            case 'slack':
+                return this.transports.slack;
+            case 'email':
+                return this.transports.email;
+            default:
+                return undefined;
+        }
+    }
+    async sendViaTransport(transportName, transport, request) {
+        if (transportName === 'slack') {
+            const slackTransport = transport;
+            if (request.type === 'approval') {
+                const options = { requestId: request.id };
+                if (request.context !== undefined) {
+                    options.context = request.context;
+                }
+                return slackTransport.sendApprovalRequest(request.target, request.content, options);
+            }
+            else if (request.type === 'question') {
+                return slackTransport.sendQuestion(request.target, request.content, {
+                    requestId: request.id,
+                });
+            }
+            else {
+                return slackTransport.sendNotification(request.target, request.content);
+            }
+        }
+        if (transportName === 'email') {
+            const emailTransport = transport;
+            if (request.type === 'approval') {
+                const options = {
+                    to: request.target,
+                    request: request.content,
+                    requestId: request.id,
+                };
+                if (request.context !== undefined) {
+                    options.context = request.context;
+                }
+                return emailTransport.sendApprovalRequest(options);
+            }
+            else {
+                return emailTransport.sendNotification({
+                    to: request.target,
+                    message: request.content,
+                });
+            }
+        }
+        return {
+            success: false,
+            transport: transportName,
+            error: `Unsupported transport: ${transportName}`,
+        };
+    }
+    parseEmailApproval(content) {
+        const lower = content.toLowerCase().trim();
+        const approvePatterns = [/^approved/i, /^yes/i, /^lgtm/i, /^ok\b/i];
+        for (const pattern of approvePatterns) {
+            if (pattern.test(lower)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    async notifyRequestorOfResult(request, result) {
+        if (!request.notifyChannel) {
+            return;
+        }
+        // Use Slack if available
+        const slackTransport = this.transports.slack;
+        if (slackTransport) {
+            const status = result.approved ? 'approved' : 'rejected';
+            const message = `Your request "${request.content}" was ${status}${result.notes ? `: ${result.notes}` : ''}`;
+            await slackTransport.sendNotification(request.notifyChannel, message);
+        }
+    }
+    startTimeoutChecker() {
+        this.timeoutChecker = setInterval(async () => {
+            if (this.destroyed) {
+                return;
+            }
+            try {
+                const expiredRequests = await this.store.listExpired();
+                for (const request of expiredRequests) {
+                    // Update status to expired
+                    await this.store.update(request.id, {
+                        status: 'expired',
+                        completedAt: new Date(),
+                    });
+                    // Call onTimeout callback
+                    if (this.onTimeoutCallback) {
+                        try {
+                            await this.onTimeoutCallback({
+                                requestId: request.id,
+                                request,
+                            });
+                        }
+                        catch {
+                            // Swallow callback errors
+                        }
+                    }
+                }
+            }
+            catch {
+                // Swallow errors in timeout checker
+            }
+        }, this.checkIntervalMs);
+    }
+}
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Create a HumanRequestProcessor instance
+ *
+ * @example
+ * ```ts
+ * const processor = createHumanRequestProcessor({
+ *   store: new InMemoryRequestStore(),
+ *   transports: {
+ *     slack: createSlackTransport({ botToken, signingSecret }),
+ *   },
+ *   onComplete: (data) => console.log('Completed:', data),
+ *   onTimeout: (data) => console.log('Timed out:', data),
+ * })
+ * ```
+ */
+export function createHumanRequestProcessor(config) {
+    return new HumanRequestProcessor(config);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/team.d.ts

@@ -13,7 +13,8 @@ import type { WorkerTeam } from './types.js';
  *
  * @example
  * ```ts
- * const engineeringTeam = Team({
+ * const engineeringTeam = defineTeam({
+ *   id: 'team_eng',
  *   name: 'Engineering',
  *   description: 'Product engineering team',
  *   members: [
@@ -22,18 +23,20 @@ import type { WorkerTeam } from './types.js';
  *     { id: 'ai-reviewer', name: 'Code Reviewer', role: 'Code Reviewer', type: 'ai' },
  *     { id: 'ai-tester', name: 'Test Generator', role: 'Test Engineer', type: 'ai' },
  *   ],
+ *   contacts: { slack: '#engineering', email: 'eng@company.com' },
  *   goals: [
  *     'Ship features on schedule',
  *     'Maintain code quality',
  *     'Reduce technical debt',
  *   ],
- *   lead: 'alice',
+ *   lead: { id: 'alice', type: 'human', name: 'Alice' },
  * })
  * ```
  *
  * @example
  * ```ts
- * const supportTeam = Team({
+ * const supportTeam = defineTeam({
+ *   id: 'team_support',
  *   name: 'Customer Support',
  *   description: '24/7 customer support team',
  *   members: [
@@ -41,21 +44,23 @@ import type { WorkerTeam } from './types.js';
  *     { id: 'support-ai-2', name: 'Support Bot Beta', role: 'Support Agent', type: 'ai' },
  *     { id: 'escalation-human', name: 'Jane', role: 'Senior Support', type: 'human' },
  *   ],
+ *   contacts: { slack: '#support' },
  *   goals: [
  *     'Maintain 95% satisfaction rate',
  *     'Response time under 5 minutes',
  *     'First contact resolution > 80%',
  *   ],
- *   lead: 'escalation-human',
+ *   lead: { id: 'escalation-human', type: 'human', name: 'Jane' },
  * })
  * ```
  */
-export declare function Team(definition: WorkerTeam): WorkerTeam;
-export declare namespace Team {
+export declare function defineTeam(definition: WorkerTeam): WorkerTeam;
+export declare namespace defineTeam {
     var addMember: (team: WorkerTeam, member: WorkerTeam["members"][number]) => WorkerTeam;
     var removeMember: (team: WorkerTeam, memberId: string) => WorkerTeam;
     var aiMembers: (team: WorkerTeam) => import("./types.js").WorkerRef[];
     var humanMembers: (team: WorkerTeam) => import("./types.js").WorkerRef[];
     var byRole: (team: WorkerTeam, role: string) => import("./types.js").WorkerRef[];
 }
+export { defineTeam as Team };
 //# sourceMappingURL=team.d.ts.map

package/dist/team.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../src/team.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAEvD;yBAFe,IAAI;0BAsBZ,UAAU,UACR,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KACpC,UAAU;6BAiBc,UAAU,YAAY,MAAM,KAAG,UAAU;0BAiB5C,UAAU;6BAcP,UAAU;uBAchB,UAAU,QAAQ,MAAM"}
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../src/team.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAI5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAE7D;yBAFe,UAAU;0BAqBI,UAAU,UAAU,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAG,UAAU;6BAiB3D,UAAU,YAAY,MAAM,KAAG,UAAU;0BAiB5C,UAAU;6BAcP,UAAU;uBAchB,UAAU,QAAQ,MAAM;;AAGnD,OAAO,EAAE,UAAU,IAAI,IAAI,EAAE,CAAA"}