@cogitator-ai/workflows 0.1.0

package/dist/human/approval-store.js

@@ -0,0 +1,377 @@
+/**
+ * Approval Store implementations
+ *
+ * Features:
+ * - In-memory store for development/testing
+ * - File-based store for persistence
+ * - Response callbacks for async notifications
+ * - TTL-based cleanup
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * In-memory approval store for development and testing
+ */
+export class InMemoryApprovalStore {
+    requests = new Map();
+    responses = new Map();
+    callbacks = new Map();
+    ttl;
+    cleanupInterval;
+    constructor(options = {}) {
+        this.ttl = options.ttl ?? 7 * 24 * 60 * 60 * 1000;
+        if (options.cleanupInterval) {
+            this.cleanupInterval = setInterval(() => this.cleanup(), options.cleanupInterval);
+        }
+    }
+    async createRequest(request) {
+        this.requests.set(request.id, { ...request });
+    }
+    async getRequest(id) {
+        return this.requests.get(id) ?? null;
+    }
+    async getPendingRequests(workflowId) {
+        const pending = [];
+        for (const request of this.requests.values()) {
+            if (this.responses.has(request.id))
+                continue;
+            if (workflowId && request.workflowId !== workflowId)
+                continue;
+            pending.push(request);
+        }
+        return pending;
+    }
+    async getPendingForAssignee(assignee) {
+        const pending = [];
+        for (const request of this.requests.values()) {
+            if (this.responses.has(request.id))
+                continue;
+            const isAssigned = request.assignee === assignee ||
+                request.assigneeGroup?.includes(assignee);
+            if (isAssigned) {
+                pending.push(request);
+            }
+        }
+        return pending;
+    }
+    async submitResponse(response) {
+        this.responses.set(response.requestId, { ...response });
+        const callbacks = this.callbacks.get(response.requestId);
+        if (callbacks) {
+            for (const callback of callbacks) {
+                try {
+                    callback(response);
+                }
+                catch {
+                }
+            }
+            this.callbacks.delete(response.requestId);
+        }
+    }
+    async getResponse(requestId) {
+        return this.responses.get(requestId) ?? null;
+    }
+    async deleteRequest(id) {
+        this.requests.delete(id);
+        this.responses.delete(id);
+        this.callbacks.delete(id);
+    }
+    onResponse(requestId, callback) {
+        const existingResponse = this.responses.get(requestId);
+        if (existingResponse) {
+            queueMicrotask(() => callback(existingResponse));
+            return () => { };
+        }
+        let callbacks = this.callbacks.get(requestId);
+        if (!callbacks) {
+            callbacks = new Set();
+            this.callbacks.set(requestId, callbacks);
+        }
+        callbacks.add(callback);
+        return () => {
+            callbacks?.delete(callback);
+            if (callbacks?.size === 0) {
+                this.callbacks.delete(requestId);
+            }
+        };
+    }
+    /**
+     * Clean up expired requests
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [id, request] of this.requests) {
+            if (now - request.createdAt > this.ttl) {
+                this.deleteRequest(id);
+            }
+        }
+    }
+    /**
+     * Stop cleanup interval
+     */
+    dispose() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+    }
+    /**
+     * Get all requests (for debugging)
+     */
+    getAllRequests() {
+        return Array.from(this.requests.values());
+    }
+    /**
+     * Get all responses (for debugging)
+     */
+    getAllResponses() {
+        return Array.from(this.responses.values());
+    }
+    /**
+     * Clear all data
+     */
+    clear() {
+        this.requests.clear();
+        this.responses.clear();
+        this.callbacks.clear();
+    }
+}
+/**
+ * File-based approval store for persistence across restarts
+ */
+export class FileApprovalStore {
+    directory;
+    callbacks = new Map();
+    watchInterval;
+    lastResponseCheck = new Map();
+    constructor(options) {
+        this.directory = options.directory;
+        if (options.pollInterval) {
+            this.watchInterval = setInterval(() => this.checkForResponses(), options.pollInterval);
+        }
+    }
+    getRequestPath(id) {
+        return path.join(this.directory, 'requests', `${id}.json`);
+    }
+    getResponsePath(requestId) {
+        return path.join(this.directory, 'responses', `${requestId}.json`);
+    }
+    async createRequest(request) {
+        const filePath = this.getRequestPath(request.id);
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, JSON.stringify(request, null, 2), 'utf-8');
+    }
+    async getRequest(id) {
+        try {
+            const content = await fs.readFile(this.getRequestPath(id), 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    async getPendingRequests(workflowId) {
+        const requestsDir = path.join(this.directory, 'requests');
+        const responsesDir = path.join(this.directory, 'responses');
+        try {
+            await fs.mkdir(requestsDir, { recursive: true });
+        }
+        catch {
+        }
+        const pending = [];
+        try {
+            const files = await fs.readdir(requestsDir);
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                const requestId = file.replace('.json', '');
+                const responsePath = path.join(responsesDir, `${requestId}.json`);
+                try {
+                    await fs.access(responsePath);
+                    continue;
+                }
+                catch {
+                }
+                try {
+                    const content = await fs.readFile(path.join(requestsDir, file), 'utf-8');
+                    const request = JSON.parse(content);
+                    if (!workflowId || request.workflowId === workflowId) {
+                        pending.push(request);
+                    }
+                }
+                catch {
+                }
+            }
+        }
+        catch {
+        }
+        return pending;
+    }
+    async getPendingForAssignee(assignee) {
+        const allPending = await this.getPendingRequests();
+        return allPending.filter((request) => request.assignee === assignee ||
+            request.assigneeGroup?.includes(assignee));
+    }
+    async submitResponse(response) {
+        const filePath = this.getResponsePath(response.requestId);
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, JSON.stringify(response, null, 2), 'utf-8');
+        const callbacks = this.callbacks.get(response.requestId);
+        if (callbacks) {
+            for (const callback of callbacks) {
+                try {
+                    callback(response);
+                }
+                catch {
+                }
+            }
+            this.callbacks.delete(response.requestId);
+        }
+    }
+    async getResponse(requestId) {
+        try {
+            const content = await fs.readFile(this.getResponsePath(requestId), 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    async deleteRequest(id) {
+        try {
+            await fs.unlink(this.getRequestPath(id));
+        }
+        catch {
+        }
+        try {
+            await fs.unlink(this.getResponsePath(id));
+        }
+        catch {
+        }
+        this.callbacks.delete(id);
+    }
+    onResponse(requestId, callback) {
+        this.getResponse(requestId).then((existingResponse) => {
+            if (existingResponse) {
+                callback(existingResponse);
+            }
+        });
+        let callbacks = this.callbacks.get(requestId);
+        if (!callbacks) {
+            callbacks = new Set();
+            this.callbacks.set(requestId, callbacks);
+        }
+        callbacks.add(callback);
+        return () => {
+            callbacks?.delete(callback);
+            if (callbacks?.size === 0) {
+                this.callbacks.delete(requestId);
+            }
+        };
+    }
+    /**
+     * Check for new responses (called by poll interval)
+     */
+    async checkForResponses() {
+        const responsesDir = path.join(this.directory, 'responses');
+        try {
+            const files = await fs.readdir(responsesDir);
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                const requestId = file.replace('.json', '');
+                const callbacks = this.callbacks.get(requestId);
+                if (!callbacks || callbacks.size === 0)
+                    continue;
+                const filePath = path.join(responsesDir, file);
+                const stats = await fs.stat(filePath);
+                const lastCheck = this.lastResponseCheck.get(requestId) ?? 0;
+                if (stats.mtimeMs > lastCheck) {
+                    this.lastResponseCheck.set(requestId, stats.mtimeMs);
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    const response = JSON.parse(content);
+                    for (const callback of callbacks) {
+                        try {
+                            callback(response);
+                        }
+                        catch {
+                        }
+                    }
+                    this.callbacks.delete(requestId);
+                }
+            }
+        }
+        catch {
+        }
+    }
+    /**
+     * Stop polling
+     */
+    dispose() {
+        if (this.watchInterval) {
+            clearInterval(this.watchInterval);
+            this.watchInterval = undefined;
+        }
+    }
+    /**
+     * Clean up expired requests
+     */
+    async cleanup(maxAge) {
+        const now = Date.now();
+        let deleted = 0;
+        const requestsDir = path.join(this.directory, 'requests');
+        try {
+            const files = await fs.readdir(requestsDir);
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                const filePath = path.join(requestsDir, file);
+                try {
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    const request = JSON.parse(content);
+                    if (now - request.createdAt > maxAge) {
+                        const id = file.replace('.json', '');
+                        await this.deleteRequest(id);
+                        deleted++;
+                    }
+                }
+                catch {
+                }
+            }
+        }
+        catch {
+        }
+        return deleted;
+    }
+}
+/**
+ * Create an approval store that delegates responses
+ * to another store (e.g., for delegation handling)
+ */
+export function withDelegation(store, options = {}) {
+    return {
+        ...store,
+        async submitResponse(response) {
+            if (response.delegatedTo) {
+                const request = await store.getRequest(response.requestId);
+                if (request) {
+                    const delegatedRequest = {
+                        ...request,
+                        assignee: response.delegatedTo,
+                        metadata: {
+                            ...request.metadata,
+                            delegatedFrom: response.respondedBy,
+                            delegatedAt: response.respondedAt,
+                            delegationReason: response.delegationReason,
+                        },
+                    };
+                    await store.createRequest(delegatedRequest);
+                    await options.onDelegation?.(delegatedRequest, response.respondedBy, response.delegatedTo);
+                    return;
+                }
+            }
+            await store.submitResponse(response);
+        },
+    };
+}
+//# sourceMappingURL=approval-store.js.map

package/dist/human/approval-store.js.map

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

package/dist/human/human-node.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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 type { WorkflowState, HumanNodeConfig, ApprovalResponse, ApprovalStore, ApprovalNotifier, ApprovalChoice, ApprovalChainStep } from '@cogitator-ai/types';
+/**
+ * Context for human node execution
+ */
+export interface HumanNodeContext {
+    workflowId: string;
+    runId: string;
+    nodeId: string;
+    approvalStore: ApprovalStore;
+    approvalNotifier?: ApprovalNotifier;
+}
+/**
+ * Result of human node execution
+ */
+export interface HumanNodeResult<S extends WorkflowState> {
+    approved: boolean;
+    decision: unknown;
+    response: ApprovalResponse;
+    state: S;
+    timedOut?: boolean;
+    escalated?: boolean;
+}
+/**
+ * Execute a human approval node
+ */
+export declare function executeHumanNode<S extends WorkflowState>(state: S, config: HumanNodeConfig<S>, context: HumanNodeContext): Promise<HumanNodeResult<S>>;
+/**
+ * Create a human approval node factory
+ */
+export declare function humanNode<S extends WorkflowState>(name: string, approval: HumanNodeConfig<S>['approval']): HumanNodeConfig<S>;
+/**
+ * Create a simple approve/reject node
+ */
+export declare function approvalNode<S extends WorkflowState>(name: string, options: {
+    title: string;
+    description?: string | ((state: S) => string);
+    assignee?: string | ((state: S) => string);
+    timeout?: number;
+    timeoutAction?: 'approve' | 'reject' | 'fail';
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
+}): HumanNodeConfig<S>;
+/**
+ * Create a multi-choice selection node
+ */
+export declare function choiceNode<S extends WorkflowState>(name: string, options: {
+    title: string;
+    description?: string | ((state: S) => string);
+    choices: ApprovalChoice[];
+    assignee?: string | ((state: S) => string);
+    timeout?: number;
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
+}): HumanNodeConfig<S>;
+/**
+ * Create a free-form input node
+ */
+export declare function inputNode<S extends WorkflowState>(name: string, options: {
+    title: string;
+    description?: string | ((state: S) => string);
+    assignee?: string | ((state: S) => string);
+    timeout?: number;
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
+}): HumanNodeConfig<S>;
+/**
+ * Create a rating node
+ */
+export declare function ratingNode<S extends WorkflowState>(name: string, options: {
+    title: string;
+    description?: string | ((state: S) => string);
+    assignee?: string | ((state: S) => string);
+    timeout?: number;
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
+}): HumanNodeConfig<S>;
+/**
+ * Create an approval chain node
+ */
+export declare function chainNode<S extends WorkflowState>(name: string, options: {
+    title: string;
+    description?: string | ((state: S) => string);
+    chain: ApprovalChainStep[];
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
+}): HumanNodeConfig<S>;
+/**
+ * Create a manager → director → VP chain
+ */
+export declare function managementChain<S extends WorkflowState>(name: string, options: {
+    title: string;
+    description?: string | ((state: S) => string);
+    manager: string;
+    director?: string;
+    vp?: string;
+    timeoutPerStep?: number;
+}): HumanNodeConfig<S>;
+//# sourceMappingURL=human-node.d.ts.map

package/dist/human/human-node.d.ts.map

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