@cogitator-ai/workflows 0.1.0

package/dist/human/human-node.js

@@ -0,0 +1,342 @@
+/**
+ * Human-in-the-Loop Node
+ *
+ * Features:
+ * - Async human approvals
+ * - Multiple approval types (binary, multi-choice, free-form, rating)
+ * - Approval chains (sequential approvers)
+ * - Timeout handling with configurable actions
+ * - Delegation support
+ * - Priority-based routing
+ */
+import { nanoid } from 'nanoid';
+/**
+ * Execute a human approval node
+ */
+export async function executeHumanNode(state, config, context) {
+    const approval = config.approval;
+    const description = typeof approval.description === 'function'
+        ? approval.description(state)
+        : approval.description;
+    const assignee = typeof approval.assignee === 'function'
+        ? approval.assignee(state)
+        : approval.assignee;
+    const assigneeGroup = typeof approval.assigneeGroup === 'function'
+        ? approval.assigneeGroup(state)
+        : approval.assigneeGroup;
+    if (approval.chain && approval.chain.length > 0) {
+        return executeApprovalChain(state, config, context, approval.chain);
+    }
+    const request = {
+        id: nanoid(),
+        workflowId: context.workflowId,
+        runId: context.runId,
+        nodeId: context.nodeId,
+        type: approval.type,
+        title: approval.title,
+        description,
+        choices: approval.choices,
+        assignee,
+        assigneeGroup,
+        deadline: approval.timeout ? Date.now() + approval.timeout : undefined,
+        timeout: approval.timeout,
+        timeoutAction: approval.timeoutAction,
+        escalateTo: approval.escalateTo,
+        priority: approval.priority,
+        metadata: { state },
+        createdAt: Date.now(),
+    };
+    await context.approvalStore.createRequest(request);
+    await context.approvalNotifier?.notify(request);
+    const response = await waitForResponse(request, context.approvalStore, context.approvalNotifier);
+    const approved = isApproved(request.type, response.decision);
+    return {
+        approved,
+        decision: response.decision,
+        response,
+        state,
+        timedOut: response.respondedBy === '__timeout__',
+        escalated: response.respondedBy === '__escalation__',
+    };
+}
+/**
+ * Execute approval chain (sequential approvers)
+ */
+async function executeApprovalChain(state, config, context, chain) {
+    const approval = config.approval;
+    const responses = [];
+    let lastResponse;
+    for (let i = 0; i < chain.length; i++) {
+        const step = chain[i];
+        const effectiveTimeoutAction = step.timeoutAction === 'skip' ? 'fail' : (step.timeoutAction ?? 'fail');
+        const request = {
+            id: nanoid(),
+            workflowId: context.workflowId,
+            runId: context.runId,
+            nodeId: `${context.nodeId}:chain:${i}`,
+            type: approval.type,
+            title: `${approval.title} (Step ${i + 1}/${chain.length})`,
+            description: typeof approval.description === 'function'
+                ? approval.description(state)
+                : approval.description,
+            choices: approval.choices,
+            assignee: step.assignee,
+            deadline: step.timeout ? Date.now() + step.timeout : undefined,
+            timeout: step.timeout,
+            timeoutAction: effectiveTimeoutAction,
+            priority: approval.priority,
+            metadata: {
+                state,
+                chainStep: i,
+                chainTotal: chain.length,
+                role: step.role,
+                previousResponses: responses,
+            },
+            createdAt: Date.now(),
+        };
+        await context.approvalStore.createRequest(request);
+        await context.approvalNotifier?.notify(request);
+        const response = await waitForResponse(request, context.approvalStore, context.approvalNotifier);
+        responses.push(response);
+        lastResponse = response;
+        if (step.required && !isApproved(approval.type, response.decision)) {
+            return {
+                approved: false,
+                decision: response.decision,
+                response,
+                state,
+                timedOut: response.respondedBy === '__timeout__',
+                escalated: response.respondedBy === '__escalation__',
+            };
+        }
+    }
+    return {
+        approved: true,
+        decision: lastResponse?.decision,
+        response: lastResponse,
+        state,
+    };
+}
+/**
+ * Wait for response or handle timeout
+ */
+async function waitForResponse(request, store, notifier) {
+    return new Promise((resolve) => {
+        let timeoutId;
+        let unsubscribeFn;
+        const cleanup = () => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            unsubscribeFn?.();
+        };
+        unsubscribeFn = store.onResponse(request.id, (response) => {
+            cleanup();
+            resolve(response);
+        });
+        if (request.timeout) {
+            timeoutId = setTimeout(async () => {
+                cleanup();
+                const timeoutResponse = await handleTimeout(request, store, notifier);
+                resolve(timeoutResponse);
+            }, request.timeout);
+        }
+    });
+}
+/**
+ * Create a fail response for timeout
+ */
+async function createFailResponse(request, store) {
+    const response = {
+        requestId: request.id,
+        decision: { error: 'Timeout exceeded, no response received' },
+        respondedBy: '__timeout__',
+        respondedAt: Date.now(),
+        comment: 'Request timed out without response',
+    };
+    await store.submitResponse(response);
+    return response;
+}
+/**
+ * Handle timeout based on configured action
+ */
+async function handleTimeout(request, store, notifier) {
+    await notifier?.notifyTimeout(request);
+    const action = request.timeoutAction ?? 'fail';
+    switch (action) {
+        case 'approve': {
+            const response = {
+                requestId: request.id,
+                decision: true,
+                respondedBy: '__timeout__',
+                respondedAt: Date.now(),
+                comment: 'Auto-approved due to timeout',
+            };
+            await store.submitResponse(response);
+            return response;
+        }
+        case 'reject': {
+            const response = {
+                requestId: request.id,
+                decision: false,
+                respondedBy: '__timeout__',
+                respondedAt: Date.now(),
+                comment: 'Auto-rejected due to timeout',
+            };
+            await store.submitResponse(response);
+            return response;
+        }
+        case 'escalate': {
+            if (request.escalateTo) {
+                await notifier?.notifyEscalation(request, 'Timeout exceeded');
+                const escalatedRequest = {
+                    ...request,
+                    id: nanoid(),
+                    assignee: request.escalateTo,
+                    assigneeGroup: undefined,
+                    metadata: {
+                        ...request.metadata,
+                        escalatedFrom: request.assignee,
+                        escalationReason: 'Timeout exceeded',
+                    },
+                    createdAt: Date.now(),
+                };
+                await store.createRequest(escalatedRequest);
+                await notifier?.notify(escalatedRequest);
+                return new Promise((resolve) => {
+                    store.onResponse(escalatedRequest.id, resolve);
+                });
+            }
+            return createFailResponse(request, store);
+        }
+        case 'fail':
+        default:
+            return createFailResponse(request, store);
+    }
+}
+/**
+ * Check if decision counts as approved based on type
+ */
+function isApproved(type, decision) {
+    switch (type) {
+        case 'approve-reject':
+            return decision === true || decision === 'approve';
+        case 'multi-choice':
+            return decision !== null && decision !== undefined;
+        case 'free-form':
+            return typeof decision === 'string' && decision.trim().length > 0;
+        case 'numeric-rating':
+            return typeof decision === 'number' && !isNaN(decision);
+        default:
+            return Boolean(decision);
+    }
+}
+/**
+ * Create a human approval node factory
+ */
+export function humanNode(name, approval) {
+    return {
+        name,
+        approval,
+    };
+}
+/**
+ * Create a simple approve/reject node
+ */
+export function approvalNode(name, options) {
+    return humanNode(name, {
+        type: 'approve-reject',
+        title: options.title,
+        description: options.description,
+        assignee: options.assignee,
+        timeout: options.timeout,
+        timeoutAction: options.timeoutAction,
+        priority: options.priority,
+    });
+}
+/**
+ * Create a multi-choice selection node
+ */
+export function choiceNode(name, options) {
+    return humanNode(name, {
+        type: 'multi-choice',
+        title: options.title,
+        description: options.description,
+        choices: options.choices,
+        assignee: options.assignee,
+        timeout: options.timeout,
+        priority: options.priority,
+    });
+}
+/**
+ * Create a free-form input node
+ */
+export function inputNode(name, options) {
+    return humanNode(name, {
+        type: 'free-form',
+        title: options.title,
+        description: options.description,
+        assignee: options.assignee,
+        timeout: options.timeout,
+        priority: options.priority,
+    });
+}
+/**
+ * Create a rating node
+ */
+export function ratingNode(name, options) {
+    return humanNode(name, {
+        type: 'numeric-rating',
+        title: options.title,
+        description: options.description,
+        assignee: options.assignee,
+        timeout: options.timeout,
+        priority: options.priority,
+    });
+}
+/**
+ * Create an approval chain node
+ */
+export function chainNode(name, options) {
+    return humanNode(name, {
+        type: 'approve-reject',
+        title: options.title,
+        description: options.description,
+        chain: options.chain,
+        priority: options.priority,
+    });
+}
+/**
+ * Create a manager → director → VP chain
+ */
+export function managementChain(name, options) {
+    const chain = [
+        {
+            assignee: options.manager,
+            role: 'Manager',
+            required: true,
+            timeout: options.timeoutPerStep,
+        },
+    ];
+    if (options.director) {
+        chain.push({
+            assignee: options.director,
+            role: 'Director',
+            required: true,
+            timeout: options.timeoutPerStep,
+        });
+    }
+    if (options.vp) {
+        chain.push({
+            assignee: options.vp,
+            role: 'VP',
+            required: true,
+            timeout: options.timeoutPerStep,
+        });
+    }
+    return chainNode(name, {
+        title: options.title,
+        description: options.description,
+        chain,
+    });
+}
+//# sourceMappingURL=human-node.js.map

package/dist/human/human-node.js.map

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

package/dist/human/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @cogitator-ai/workflows - Human-in-the-Loop module
+ *
+ * Enables human approvals in workflow execution.
+ *
+ * Features:
+ * - Async approvals (can take days)
+ * - Multiple types: approve/reject, multi-choice, free-form, rating
+ * - Timeout with configurable actions (approve/reject/escalate/fail)
+ * - Approval chains (manager → director → CEO)
+ * - Delegation support
+ * - Audit trail via checkpoint store
+ */
+export { InMemoryApprovalStore, FileApprovalStore, withDelegation, } from './approval-store';
+export { ConsoleNotifier, WebhookNotifier, CompositeNotifier, slackNotifier, filteredNotifier, priorityRouter, nullNotifier, } from './notifiers';
+export { type HumanNodeContext, type HumanNodeResult, executeHumanNode, humanNode, approvalNode, choiceNode, inputNode, ratingNode, chainNode, managementChain, } from './human-node';
+//# sourceMappingURL=index.d.ts.map

package/dist/human/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/human/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/human/index.js

@@ -0,0 +1,17 @@
+/**
+ * @cogitator-ai/workflows - Human-in-the-Loop module
+ *
+ * Enables human approvals in workflow execution.
+ *
+ * Features:
+ * - Async approvals (can take days)
+ * - Multiple types: approve/reject, multi-choice, free-form, rating
+ * - Timeout with configurable actions (approve/reject/escalate/fail)
+ * - Approval chains (manager → director → CEO)
+ * - Delegation support
+ * - Audit trail via checkpoint store
+ */
+export { InMemoryApprovalStore, FileApprovalStore, withDelegation, } from './approval-store';
+export { ConsoleNotifier, WebhookNotifier, CompositeNotifier, slackNotifier, filteredNotifier, priorityRouter, nullNotifier, } from './notifiers';
+export { executeHumanNode, humanNode, approvalNode, choiceNode, inputNode, ratingNode, chainNode, managementChain, } from './human-node';
+//# sourceMappingURL=index.js.map

package/dist/human/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/human/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAGL,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/human/notifiers.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Approval Notifiers
+ *
+ * Features:
+ * - Console notifier for development
+ * - Webhook notifier for HTTP integrations
+ * - Composite notifier for multiple channels
+ */
+import type { ApprovalNotifier, ApprovalRequest } from '@cogitator-ai/types';
+/**
+ * Console notifier for development and debugging
+ */
+export declare class ConsoleNotifier implements ApprovalNotifier {
+    private prefix;
+    constructor(options?: {
+        prefix?: string;
+    });
+    notify(request: ApprovalRequest): Promise<void>;
+    notifyEscalation(request: ApprovalRequest, reason: string): Promise<void>;
+    notifyTimeout(request: ApprovalRequest): Promise<void>;
+    notifyDelegation(request: ApprovalRequest, from: string, to: string): Promise<void>;
+}
+/**
+ * Webhook notifier for HTTP integrations (Slack, Teams, custom)
+ */
+export declare class WebhookNotifier implements ApprovalNotifier {
+    private url;
+    private headers;
+    private formatPayload;
+    private timeout;
+    constructor(options: {
+        url: string;
+        headers?: Record<string, string>;
+        formatPayload?: (event: 'request' | 'escalation' | 'timeout' | 'delegation', request: ApprovalRequest, extra?: Record<string, unknown>) => unknown;
+        timeout?: number;
+    });
+    private defaultFormat;
+    private send;
+    notify(request: ApprovalRequest): Promise<void>;
+    notifyEscalation(request: ApprovalRequest, reason: string): Promise<void>;
+    notifyTimeout(request: ApprovalRequest): Promise<void>;
+    notifyDelegation(request: ApprovalRequest, from: string, to: string): Promise<void>;
+}
+/**
+ * Slack-formatted webhook notifier
+ */
+export declare function slackNotifier(webhookUrl: string, options?: {
+    channel?: string;
+    username?: string;
+    iconEmoji?: string;
+}): WebhookNotifier;
+/**
+ * Composite notifier that sends to multiple channels
+ */
+export declare class CompositeNotifier implements ApprovalNotifier {
+    private notifiers;
+    private continueOnError;
+    constructor(notifiers: ApprovalNotifier[], options?: {
+        continueOnError?: boolean;
+    });
+    notify(request: ApprovalRequest): Promise<void>;
+    notifyEscalation(request: ApprovalRequest, reason: string): Promise<void>;
+    notifyTimeout(request: ApprovalRequest): Promise<void>;
+    notifyDelegation(request: ApprovalRequest, from: string, to: string): Promise<void>;
+    private fanOut;
+}
+/**
+ * Filtered notifier that only notifies for certain requests
+ */
+export declare function filteredNotifier(notifier: ApprovalNotifier, filter: (request: ApprovalRequest) => boolean): ApprovalNotifier;
+/**
+ * Priority-based notifier routing
+ */
+export declare function priorityRouter(options: {
+    urgent?: ApprovalNotifier;
+    high?: ApprovalNotifier;
+    normal?: ApprovalNotifier;
+    low?: ApprovalNotifier;
+    default?: ApprovalNotifier;
+}): ApprovalNotifier;
+/**
+ * Null notifier that does nothing (useful for testing)
+ */
+export declare const nullNotifier: ApprovalNotifier;
+//# sourceMappingURL=notifiers.d.ts.map

package/dist/human/notifiers.d.ts.map

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