@loopman/langchain-sdk 1.0.9

package/dist/services/polling.service.js

@@ -0,0 +1,428 @@
+/**
+ * Service for polling decision status and waiting for human review
+ *
+ * Inspired by the Python SDK PollingService with improvements:
+ * - Session management (start/stop polling)
+ * - Interruption notifications to backend
+ * - Jitter in polling intervals (±20%)
+ * - Graceful handling of 500 errors
+ * - Consecutive error tracking
+ * - AbortSignal support for cancellation
+ * - Progress callbacks
+ * - Centralized logging with LoggerService
+ */
+export class PollingService {
+    apiClient;
+    logger = null;
+    debug = false;
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Set logger for this polling service
+     * Called by LoopmanService to inject the logger
+     */
+    setLogger(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Wait for a human decision on a specific decision
+     * @param options Polling options
+     * @returns Polling result with final decision
+     */
+    async waitForDecision(options) {
+        const { taskId, workflowId, executionId, apiKey, timeoutMs = 5 * 60 * 1000, // 5 minutes
+        pollingIntervalMs = 5000, // 5 seconds
+        abortSignal, onStatusUpdate, } = options;
+        this.logger?.setTaskId(taskId);
+        // Store debug flag for this polling session
+        this.debug = options.debug ?? false;
+        this.logInfo("🚀 Starting polling for decision", {
+            taskId,
+            workflowId,
+            executionId,
+            timeoutMs,
+            pollingIntervalMs,
+            hasAbortSignal: !!abortSignal,
+        });
+        // Start polling session on backend
+        await this.startPollingSession(taskId, workflowId, executionId, apiKey);
+        const startTime = Date.now();
+        let iterationCount = 0;
+        let consecutiveErrors = 0;
+        const MAX_CONSECUTIVE_ERRORS = 50;
+        try {
+            while (Date.now() - startTime < timeoutMs) {
+                iterationCount++;
+                const elapsedTime = Date.now() - startTime;
+                this.logDebug(`🔄 Polling iteration #${iterationCount}`, {
+                    taskId,
+                    elapsedTime,
+                    remainingTime: timeoutMs - elapsedTime,
+                });
+                // Check for abort signal
+                if (abortSignal?.aborted) {
+                    this.logInfo("🛑 Polling aborted by signal", {
+                        taskId,
+                        iterationCount,
+                    });
+                    await this.notifyInterruption(taskId, apiKey, "aborted", {
+                        elapsedTime,
+                        iteration: iterationCount,
+                        reason: "aborted_by_signal",
+                    });
+                    await this.stopPollingSession(taskId, apiKey, "aborted");
+                    return {
+                        status: "ABORTED",
+                        taskId,
+                        elapsedTime,
+                        iterations: iterationCount,
+                    };
+                }
+                try {
+                    // Check decision status
+                    const statusResponse = await this.checkTaskStatus(taskId, workflowId, executionId, apiKey);
+                    if (onStatusUpdate) {
+                        onStatusUpdate(statusResponse.status, iterationCount);
+                    }
+                    // Check if decision is resolved
+                    if (statusResponse.status !== "PENDING") {
+                        this.logInfo("🎯 Decision resolved", {
+                            taskId,
+                            status: statusResponse.status,
+                            iterationCount,
+                        });
+                        await this.stopPollingSession(taskId, apiKey, "completed");
+                        return {
+                            status: statusResponse.status,
+                            taskId,
+                            elapsedTime: Date.now() - startTime,
+                            iterations: iterationCount,
+                            data: statusResponse,
+                        };
+                    }
+                    // Reset error counter on success
+                    consecutiveErrors = 0;
+                }
+                catch (error) {
+                    consecutiveErrors++;
+                    this.logWarn(`⚠️ Error in polling iteration #${iterationCount}`, error);
+                    // Ignore 500 errors (server issues are temporary)
+                    if (this.is500Error(error)) {
+                        this.logInfo("Server error 500, continuing polling", {
+                            taskId,
+                        });
+                        consecutiveErrors = 0; // Don't count 500 as critical error
+                    }
+                    else if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
+                        this.logWarn("🚨 Too many consecutive errors, stopping polling", {
+                            consecutiveErrors,
+                            taskId,
+                        });
+                        await this.notifyInterruption(taskId, apiKey, "error", {
+                            elapsedTime: Date.now() - startTime,
+                            reason: "consecutive_errors",
+                            consecutiveErrors,
+                        });
+                        await this.stopPollingSession(taskId, apiKey, "error");
+                        throw new Error(`Too many consecutive errors (${consecutiveErrors}) during polling for task ${taskId}`);
+                    }
+                }
+                // Sleep with jitter before next iteration
+                const sleepMs = this.addJitter(pollingIntervalMs);
+                this.logDebug(`😴 Sleeping for ${sleepMs}ms before next poll`, {
+                    taskId,
+                });
+                try {
+                    await this.sleep(sleepMs, abortSignal);
+                }
+                catch (error) {
+                    if (error instanceof Error && error.message === "Sleep aborted") {
+                        this.logInfo("🛑 Sleep interrupted by abort signal", {
+                            taskId,
+                        });
+                        await this.notifyInterruption(taskId, apiKey, "aborted", {
+                            elapsedTime: Date.now() - startTime,
+                            reason: "sleep_interrupted",
+                            phase: "sleep",
+                        });
+                        await this.stopPollingSession(taskId, apiKey, "aborted");
+                        return {
+                            status: "ABORTED",
+                            taskId,
+                            elapsedTime: Date.now() - startTime,
+                            iterations: iterationCount,
+                        };
+                    }
+                    throw error;
+                }
+            }
+            // Timeout reached
+            this.logWarn("⏰ Polling timeout reached", {
+                taskId,
+                timeoutMs,
+            });
+            await this.notifyInterruption(taskId, apiKey, "timeout", {
+                elapsedTime: Date.now() - startTime,
+                timeoutMs,
+                reason: "polling_timeout",
+            });
+            await this.stopPollingSession(taskId, apiKey, "timeout");
+            return {
+                status: "TIMEOUT",
+                taskId,
+                elapsedTime: Date.now() - startTime,
+                iterations: iterationCount,
+            };
+        }
+        catch (error) {
+            await this.stopPollingSession(taskId, apiKey, "error");
+            throw error;
+        }
+    }
+    /**
+     * Check task status via API
+     * Uses the simplified /api/v1/tasks/:id/status endpoint
+     */
+    async checkTaskStatus(taskId, workflowId, executionId, apiKey) {
+        this.logDebug("📡 Checking task status", { taskId });
+        // Use the lightweight status endpoint for polling
+        const statusResponse = await this.apiClient.get(apiKey, `/api/v1/tasks/${taskId}/status`);
+        const status = this.mapTaskStatusToDecisionStatus(statusResponse.status);
+        // If status is NEED_CHANGES, fetch full task to get feedback
+        let feedback;
+        let modified_data;
+        if (status === "NEED_CHANGES") {
+            this.logDebug("🔄 Status is NEED_CHANGES, fetching full task for feedback", { taskId });
+            const fullTask = await this.apiClient.get(apiKey, `/api/v1/tasks/${taskId}`);
+            // Extract feedback from all NEED_CHANGES decisions (there can be multiple iterations)
+            if (fullTask.decisions &&
+                Array.isArray(fullTask.decisions) &&
+                fullTask.decisions.length > 0) {
+                // Filter NEED_CHANGES decisions (decisions are sorted by date desc)
+                const needChangesDecisions = fullTask.decisions.filter((d) => d.status === "NEED_CHANGES" || d.type === "NEED_CHANGES");
+                if (needChangesDecisions.length > 0) {
+                    // Aggregate all feedback from NEED_CHANGES iterations with user names
+                    const feedbacksWithUsers = needChangesDecisions
+                        .map((d) => {
+                        const comment = d.comment || d.feedback;
+                        if (!comment)
+                            return null;
+                        // Extract user name
+                        let userName = "Unknown user";
+                        if (d.user) {
+                            const firstName = d.user.firstName || d.user.first_name || "";
+                            const lastName = d.user.lastName || d.user.last_name || "";
+                            if (firstName || lastName) {
+                                userName = `${firstName} ${lastName}`.trim();
+                            }
+                            else if (d.user.email) {
+                                userName = d.user.email;
+                            }
+                        }
+                        return { comment, userName };
+                    })
+                        .filter((item) => item !== null)
+                        .reverse(); // Reverse to get chronological order (oldest first)
+                    if (feedbacksWithUsers.length > 0) {
+                        // Combine all feedback with iteration numbers and user names
+                        feedback = feedbacksWithUsers
+                            .map((item, index) => {
+                            if (feedbacksWithUsers.length > 1) {
+                                return `[Iteration ${index + 1}] ${item.userName}: ${item.comment}`;
+                            }
+                            else {
+                                return `${item.userName}: ${item.comment}`;
+                            }
+                        })
+                            .join("\n\n");
+                    }
+                    // Use modified_data from the latest NEED_CHANGES
+                    const latestNeedChanges = needChangesDecisions[0];
+                    modified_data =
+                        latestNeedChanges.modified_data || latestNeedChanges.modifiedData;
+                }
+            }
+        }
+        // Map task status response to decision status format
+        const mappedResponse = {
+            id: statusResponse.taskId || statusResponse.taskUuid || taskId,
+            status: status,
+            createdAt: statusResponse.createdAt || new Date().toISOString(),
+            updatedAt: statusResponse.updatedAt || new Date().toISOString(),
+            feedback: feedback || statusResponse.feedback,
+            modified_data: modified_data ||
+                statusResponse.modified_data ||
+                statusResponse.modifiedData,
+        };
+        this.logDebug("✅ Status response received", {
+            taskId,
+            status: mappedResponse.status,
+            hasFeedback: !!mappedResponse.feedback,
+        });
+        return mappedResponse;
+    }
+    /**
+     * Map task status from API to decision status
+     */
+    mapTaskStatusToDecisionStatus(taskStatus) {
+        switch (taskStatus) {
+            case "APPROVED":
+                return "VALIDATED";
+            case "REJECTED":
+                return "REFUSED";
+            case "NEEDS_CHANGES":
+                return "NEED_CHANGES";
+            case "CANCELLED":
+                return "CANCELLED";
+            case "EXPIRED":
+                return "EXPIRED";
+            case "PENDING":
+            default:
+                return "PENDING";
+        }
+    }
+    /**
+     * Start polling session on backend
+     * Uses the simplified /api/v1/tasks/:id/polling/start endpoint
+     */
+    async startPollingSession(taskId, workflowId, executionId, apiKey) {
+        try {
+            await this.apiClient.post(apiKey, `/api/v1/tasks/${taskId}/polling/start`, {
+                source: "loopman-langchain-sdk-typescript",
+                timestamp: new Date().toISOString(),
+            });
+            this.logDebug("✅ Polling session started", { taskId });
+        }
+        catch (error) {
+            this.logWarn("Failed to start polling session", error);
+            // Non-critical, continue anyway
+        }
+    }
+    /**
+     * Stop polling session on backend
+     * Uses the simplified /api/v1/tasks/:id/polling/stop endpoint
+     */
+    async stopPollingSession(taskId, apiKey, reason) {
+        try {
+            await this.apiClient.post(apiKey, `/api/v1/tasks/${taskId}/polling/stop`, {
+                reason,
+                timestamp: new Date().toISOString(),
+            });
+            this.logInfo("✅ Polling session stopped", {
+                taskId,
+                reason,
+            });
+        }
+        catch (error) {
+            this.logWarn("Failed to stop polling session", error);
+            // Non-critical
+        }
+    }
+    /**
+     * Notify backend about workflow interruption
+     * Uses /api/v1/tasks/:id/interruption endpoint (best effort - may not exist yet)
+     */
+    async notifyInterruption(taskId, apiKey, type, metadata) {
+        try {
+            await this.apiClient.post(apiKey, `/api/v1/tasks/${taskId}/interruption`, {
+                type,
+                metadata: {
+                    ...metadata,
+                    timestamp: new Date().toISOString(),
+                },
+            });
+            this.logInfo("✅ Interruption notified", {
+                taskId,
+                type,
+            });
+        }
+        catch (error) {
+            this.logWarn("Failed to notify interruption (endpoint may not exist yet)", error);
+            // Non-critical - endpoint might not be implemented yet
+        }
+    }
+    /**
+     * Check if error is a 500 error (server-side issue)
+     */
+    is500Error(error) {
+        if (error instanceof Error) {
+            const message = error.message.toLowerCase();
+            return (message.includes("500") || message.includes("internal server error"));
+        }
+        return false;
+    }
+    /**
+     * Add jitter to polling interval (±20%)
+     * This helps distribute load on the server when multiple clients are polling
+     */
+    addJitter(intervalMs) {
+        const jitterPercent = (Math.random() - 0.5) * 0.4; // -20% to +20%
+        const jitteredInterval = intervalMs * (1 + jitterPercent);
+        return Math.round(jitteredInterval);
+    }
+    /**
+     * Sleep with optional abort signal support
+     */
+    sleep(ms, abortSignal) {
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(resolve, ms);
+            if (abortSignal) {
+                const abortHandler = () => {
+                    clearTimeout(timeoutId);
+                    reject(new Error("Sleep aborted"));
+                };
+                abortSignal.addEventListener("abort", abortHandler, { once: true });
+                // Cleanup listener after timeout
+                setTimeout(() => {
+                    abortSignal.removeEventListener("abort", abortHandler);
+                }, ms);
+            }
+        });
+    }
+    /**
+     * Log debug message
+     */
+    logDebug(message, data) {
+        if (this.logger) {
+            this.logger.debug(message, data);
+        }
+        else if (this.debug) {
+            console.log("[PollingService]", message, data !== undefined ? data : "");
+        }
+    }
+    /**
+     * Log info message
+     */
+    logInfo(message, data) {
+        if (this.logger) {
+            this.logger.info(message, data);
+        }
+        else if (this.debug) {
+            console.log("[PollingService]", message, data !== undefined ? data : "");
+        }
+    }
+    /**
+     * Log warning message
+     */
+    logWarn(message, data) {
+        if (this.logger) {
+            this.logger.warn(message, data);
+        }
+        else {
+            console.warn("[PollingService]", message, data !== undefined ? data : "");
+        }
+    }
+    /**
+     * Log error message
+     */
+    logError(message, data) {
+        if (this.logger) {
+            this.logger.error(message, data);
+        }
+        else {
+            console.error("[PollingService]", message, data !== undefined ? data : "");
+        }
+    }
+}
+//# sourceMappingURL=polling.service.js.map

package/dist/services/polling.service.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Core types for Loopman SDK TypeScript
+ */
+import { LoopmanMcpClientConfig } from "./mcp/loopman-mcp-client";
+export interface LoopmanConfig {
+    /** Loopman API key for authentication */
+    apiKey: string;
+    /** Optional timeout for API operations (default: 30000ms) */
+    timeout?: number;
+    /** Optional retry configuration */
+    retry?: {
+        attempts: number;
+        delay: number;
+    };
+}
+export interface LoopmanAgentConfig {
+    model: string | unknown;
+    systemPrompt?: string;
+    additionalTools?: any[];
+    apiKey: string;
+    workflowId: string;
+    executionId?: string;
+    channelId?: string;
+    category?: string;
+    language?: string;
+    maxIterations?: number;
+    maxRetries?: number;
+    pollingTimeoutMs?: number;
+    pollingIntervalMs?: number;
+    debug?: boolean;
+    mcp?: Partial<LoopmanMcpClientConfig>;
+    manualExecutionMode?: boolean;
+    requireApprovalForTools?: string[];
+}
+export interface CreateLoopmanAgentParams extends LoopmanAgentConfig {
+    tools?: any[];
+    prompt?: string;
+}
+export interface LoopmanAgentInput {
+    input: string;
+    context?: Record<string, unknown>;
+}
+export interface LoopmanAgentDecisionResult {
+    taskId: string;
+    status: "VALIDATED" | "REFUSED" | "NEED_CHANGES" | "CANCELLED" | "EXPIRED" | "TIMEOUT" | "ABORTED";
+    feedback?: string;
+    modifiedData?: any;
+}
+export interface LoopmanAgentOutput {
+    response: string;
+    taskId?: string;
+    status: "completed" | "pending_review" | "approved" | "rejected" | "needs_changes" | "timeout" | "aborted" | "error";
+    confidence?: number;
+    decision?: LoopmanAgentDecisionResult;
+    retries?: number;
+}
+/**
+ * User interface
+ */
+export interface LoopmanUser {
+    id: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    tenantId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Token exchange response interface
+ */
+export interface TokenExchangeResponse {
+    accessToken: string;
+    refreshToken: string;
+    expiresIn: number;
+    serverUrl: string;
+}
+/**
+ * Cached token data interface
+ */
+export interface TokenData {
+    accessToken: string;
+    refreshToken?: string;
+    serverUrl: string;
+    expiresIn: number;
+}
+/**
+ * Cached token result interface
+ */
+export interface CachedToken {
+    accessToken: string;
+    serverUrl: string;
+    fromCache: boolean;
+}
+/**
+ * Configuration for LoopmanService
+ */
+export interface LoopmanServiceConfig {
+    apiKey: string;
+    workflowId: string;
+    executionId: string;
+    channelId?: string;
+    timeout?: number;
+    pollingInterval?: number;
+    debug?: boolean;
+}
+/**
+ * Loopman Task Status - Matches Prisma TaskStatus enum
+ */
+export type LoopmanTaskStatus = "PENDING" | "APPROVED" | "REJECTED" | "NEEDS_CHANGES";
+/**
+ * Task response from Loopman API
+ * This is what POST /api/v1/tasks and GET /api/v1/tasks/:id/status return
+ */
+export interface LoopmanTaskResponse {
+    id: string;
+    status: LoopmanTaskStatus;
+    title?: string;
+    description?: string;
+    workflowIdentifier?: string;
+    executionIdentifier?: string;
+    metadata?: any;
+    createdAt: string;
+    updatedAt: string;
+    priority?: "LOW" | "MEDIUM" | "HIGH";
+    channelId?: string;
+    externalReference?: string;
+    businessContext?: string;
+    proposedDecision?: string;
+    decisionReasoning?: string;
+    decisions?: Array<{
+        id: string;
+        status: string;
+        comment?: string;
+        createdAt: string;
+        user?: {
+            id: string;
+            firstName?: string;
+            lastName?: string;
+            email: string;
+        };
+    }>;
+}
+/**
+ * Decision response from Loopman API (for backward compatibility and context)
+ * This maintains the existing interface for decision-based logic
+ */
+export interface LoopmanDecisionResponse {
+    id: string;
+    status: "PENDING" | "VALIDATED" | "REFUSED" | "NEED_CHANGES" | "CANCELLED" | "EXPIRED";
+    feedback?: string;
+    modified_data?: any;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Information item for task display
+ */
+export interface TaskInformation {
+    label?: string;
+    type: "text" | "url" | "image" | "bulletPoints";
+    value: string | string[];
+    importance?: number;
+    ruleIds?: string[];
+}
+/**
+ * Request body for creating a task in Loopman
+ * Maps tool call data to task fields for POST /api/v1/tasks
+ */
+export interface CreateTaskRequest {
+    title: string;
+    description: string;
+    workflowIdentifier: string;
+    executionIdentifier: string;
+    channelId?: string;
+    category?: string;
+    businessContext?: string;
+    proposedDecision?: string;
+    decisionReasoning?: string;
+    metadata: {
+        source: string;
+        timestamp: string;
+        toolName: string;
+        toolArgs: any;
+        parentTaskId?: string;
+    };
+    information?: TaskInformation[];
+    priority?: "LOW" | "MEDIUM" | "HIGH";
+    externalReference?: string;
+    idempotencyKey?: string;
+}
+/**
+ * Guideline from Loopman API
+ */
+export interface Guideline {
+    ruleId: string;
+    description: string;
+    category?: string | null;
+    severity: "CRITICAL" | "MAJOR" | "MINOR";
+    workflowId?: string | null;
+}
+/**
+ * Guidelines response from API
+ */
+export interface GuidelinesResponse {
+    guidelines: Guideline[];
+}
+/**
+ * Decision context entry (decision history)
+ */
+export interface DecisionContextEntry {
+    date: Date | string;
+    userType: string;
+    lastName?: string;
+    firstName?: string;
+    status: "PENDING" | "APPROVED" | "REJECTED" | "NEEDS_CHANGES" | "CANCELLED" | "EXPIRED";
+    comment?: string;
+}
+/**
+ * Decision context response from API v1
+ */
+export interface DecisionContextResponse {
+    decisions: DecisionContextEntry[];
+}
+/**
+ * Loopman errors
+ */
+export declare class LoopmanError extends Error {
+    code: string;
+    details?: any | undefined;
+    constructor(message: string, code: string, details?: any | undefined);
+}
+export declare class LoopmanConnectionError extends LoopmanError {
+    constructor(message: string, details?: any);
+}
+export declare class LoopmanValidationError extends LoopmanError {
+    constructor(message: string, details?: any);
+}
+export declare class LoopmanTimeoutError extends LoopmanError {
+    constructor(message: string, details?: any);
+}
+//# sourceMappingURL=types.d.ts.map