@loopman/langchain-sdk 1.0.9

package/dist/services/loopman.service.js

@@ -0,0 +1,271 @@
+import { LoopmanApiClient } from "../client/loopman-api";
+import { LoggerService } from "./logger.service";
+import { PollingService } from "./polling.service";
+/**
+ * Service to interact with Loopman Backoffice API
+ * Handles logs, decisions, and polling
+ */
+export class LoopmanService {
+    apiClient;
+    config;
+    // Expose services for direct access
+    polling;
+    logger;
+    constructor(config) {
+        this.config = {
+            timeout: 5 * 60 * 1000, // 5 minutes
+            pollingInterval: 5000, // 5 seconds
+            debug: false,
+            ...config,
+        };
+        this.apiClient = new LoopmanApiClient({ apiKey: config.apiKey });
+        // Create logger service
+        this.logger = new LoggerService({
+            apiClient: this.apiClient,
+            apiKey: this.config.apiKey,
+            workflowId: this.config.workflowId,
+            executionId: this.config.executionId,
+            source: "LoopmanService",
+            debug: this.config.debug,
+            enableRemoteLogs: true,
+        });
+        // Create polling service and inject a dedicated logger
+        this.polling = new PollingService(this.apiClient);
+        const pollingLogger = new LoggerService({
+            apiClient: this.apiClient,
+            apiKey: this.config.apiKey,
+            workflowId: this.config.workflowId,
+            executionId: this.config.executionId,
+            source: "PollingService",
+            debug: this.config.debug,
+            enableRemoteLogs: true,
+        });
+        this.polling.setLogger(pollingLogger);
+    }
+    /**
+     * Send a log to Loopman API
+     * @deprecated Use logger.info(), logger.warn(), etc. instead
+     */
+    async sendLog(level, message) {
+        // Delegate to logger service
+        this.logger[level](message);
+    }
+    /**
+     * Get current user information
+     */
+    async getCurrentUser() {
+        return await this.apiClient.getCurrentUser(this.config.apiKey);
+    }
+    /**
+     * Get guidelines for the current workflow
+     * @param category - Optional category filter
+     * @returns Guidelines response with list of guidelines
+     */
+    async getGuidelines(category) {
+        try {
+            const params = new URLSearchParams();
+            params.append("workflow_external_id", this.config.workflowId);
+            if (category) {
+                params.append("category", category);
+            }
+            const response = await this.apiClient.get(this.config.apiKey, `/api/v1/guidelines?${params.toString()}`);
+            if (this.config.debug) {
+                console.log(`[LoopmanService] Retrieved ${response.guidelines.length} guidelines`);
+            }
+            return response;
+        }
+        catch (error) {
+            if (this.config.debug) {
+                console.error("[LoopmanService] Failed to get guidelines:", error);
+            }
+            // Return empty guidelines on error
+            return { guidelines: [] };
+        }
+    }
+    /**
+     * Get decision context (history of decisions) for the current workflow execution
+     * @returns Decision context with history of previous decisions
+     */
+    async getDecisionContext() {
+        try {
+            const response = await this.apiClient.get(this.config.apiKey, `/api/v1/workflows/${this.config.workflowId}/executions/${this.config.executionId}/decisions`);
+            if (this.config.debug) {
+                console.log(`[LoopmanService] Retrieved ${response.decisions.length} decisions in context`);
+            }
+            return response;
+        }
+        catch (error) {
+            if (this.config.debug) {
+                console.error("[LoopmanService] Failed to get decision context:", error);
+            }
+            // Return empty decisions on error
+            return { decisions: [] };
+        }
+    }
+    /**
+     * Get workflow categories
+     * Returns available categories for guidelines in this workflow
+     * @returns Array of category names
+     */
+    async getWorkflowCategories() {
+        try {
+            const response = await this.apiClient.get(this.config.apiKey, `/api/v1/workflows/${this.config.workflowId}/categories`);
+            if (this.config.debug) {
+                console.log(`[LoopmanService] Retrieved ${response.categories.length} categories`);
+            }
+            return response.categories;
+        }
+        catch (error) {
+            if (this.config.debug) {
+                console.error("[LoopmanService] Failed to get workflow categories:", error);
+            }
+            return [];
+        }
+    }
+    /**
+     * Convert tool arguments to structured information items
+     * Formats tool parameters for human-readable display in Loopman UI
+     */
+    convertToolArgsToInformation(toolName, toolArgs) {
+        const information = [];
+        information.push({
+            type: "text",
+            label: `Tool`,
+            value: toolName,
+        });
+        if (!toolArgs || typeof toolArgs !== "object") {
+            return information;
+        }
+        // Iterate through tool arguments and create information items
+        for (const [key, value] of Object.entries(toolArgs)) {
+            if (value === null || value === undefined) {
+                continue;
+            }
+            const label = key.charAt(0).toUpperCase() + key.slice(1).replace(/_/g, " ");
+            // Detect URLs
+            if (typeof value === "string" &&
+                (value.startsWith("http://") || value.startsWith("https://"))) {
+                information.push({
+                    type: "url",
+                    label: `${label} URL`,
+                    value: value,
+                });
+            }
+            // Detect arrays (convert to bullet points)
+            else if (Array.isArray(value)) {
+                information.push({
+                    type: "bulletPoints",
+                    label: label,
+                    value: value.map(String),
+                });
+            }
+            // Text values
+            else {
+                information.push({
+                    type: "text",
+                    label: label,
+                    value: String(value),
+                });
+            }
+        }
+        return information;
+    }
+    /**
+     * Create a task in Loopman for human review of a tool call
+     * Maps tool call data to a task that humans can validate/reject/modify
+     *
+     * @param toolName - Name of the tool to be validated
+     * @param toolArgs - Arguments for the tool call
+     * @param description - Optional description of the action
+     * @param toolCallId - Optional unique ID from LangChain tool call
+     * @param businessContext - Optional business context explaining the action
+     * @param parentTaskId - Optional parent task ID to create hierarchical link
+     * @param proposedDecision - Optional proposed decision from parent task
+     * @param decisionReasoning - Optional decision reasoning from parent task
+     * @returns The created task response from Loopman API
+     */
+    async createTaskForValidation(toolName, toolArgs, description, toolCallId, businessContext, parentTaskId, proposedDecision, decisionReasoning) {
+        try {
+            const timestamp = new Date().toISOString();
+            const externalReference = `${this.config.workflowId}-${this.config.executionId}-${toolName}-${Date.now()}`;
+            // Generate idempotency key based on execution, tool call, and unique call ID
+            // This prevents duplicate tasks while allowing multiple calls with same args
+            let idempotencyKey;
+            if (toolCallId) {
+                // Use tool_call_id from LangChain for uniqueness (preferred)
+                idempotencyKey = `${this.config.executionId}-${toolName}-${toolCallId}`;
+            }
+            else {
+                // Fallback: hash of args + timestamp for uniqueness
+                const argsHash = JSON.stringify(toolArgs);
+                const uniqueSuffix = `${Date.now()}-${Buffer.from(argsHash)
+                    .toString("base64")
+                    .slice(0, 20)}`;
+                idempotencyKey = `${this.config.executionId}-${toolName}-${uniqueSuffix}`;
+            }
+            const payload = {
+                title: `Tool validation`,
+                description: description || `Validation required for tool: ${toolName}`,
+                workflowIdentifier: this.config.workflowId,
+                executionIdentifier: this.config.executionId,
+                channelId: this.config.channelId,
+                category: "tool-validation",
+                businessContext: businessContext, // Business explanation (from parent or current)
+                proposedDecision, // Inherited from parent task if available
+                decisionReasoning, // Inherited from parent task if available
+                metadata: {
+                    source: "loopman-langchain-sdk-typescript",
+                    timestamp,
+                    toolName,
+                    toolArgs,
+                    parentTaskId, // Link to parent reflection task
+                },
+                information: this.convertToolArgsToInformation(toolName, toolArgs),
+                priority: "MEDIUM",
+                externalReference,
+                idempotencyKey,
+            };
+            this.logger.debug("[LoopmanService] Creating task for tool validation:", payload);
+            const taskResponse = await this.apiClient.post(this.config.apiKey, `/api/v1/tasks`, payload);
+            this.logger.debug(`[LoopmanService] Task created with ID: ${taskResponse.id}`, { status: taskResponse.status });
+            return taskResponse;
+        }
+        catch (error) {
+            this.logger.error("[LoopmanService] Failed to create task:", error);
+            throw new Error(`Failed to create task in Loopman: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get the current status of a task
+     * @param taskId - The ID of the task to check
+     * @returns The task response from Loopman API
+     */
+    async getTask(taskId) {
+        try {
+            const taskResponse = await this.apiClient.get(this.config.apiKey, `/api/v1/tasks/${taskId}`);
+            this.logger.debug(`[LoopmanService] Task ${taskId} status: ${taskResponse.status}`);
+            return taskResponse;
+        }
+        catch (error) {
+            this.logger.error("[LoopmanService] Failed to get task:", error);
+            throw new Error(`Failed to get task from Loopman: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get polling options with current configuration
+     * Helper method to construct PollingOptions for direct PollingService usage
+     */
+    getPollingOptions(taskId, abortSignal) {
+        return {
+            taskId,
+            workflowId: this.config.workflowId,
+            executionId: this.config.executionId,
+            apiKey: this.config.apiKey,
+            timeoutMs: this.config.timeout,
+            pollingIntervalMs: this.config.pollingInterval,
+            abortSignal,
+            debug: this.config.debug,
+        };
+    }
+}
+//# sourceMappingURL=loopman.service.js.map

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

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

package/dist/services/polling.service.d.ts

@@ -0,0 +1,136 @@
+import { LoopmanApiClient } from "../client/loopman-api";
+import { LoggerService } from "./logger.service";
+/**
+ * Polling options for decision monitoring
+ */
+export interface PollingOptions {
+    /** Decision ID to poll for */
+    taskId: string;
+    /** Workflow ID */
+    workflowId: string;
+    /** Execution ID */
+    executionId: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Timeout in milliseconds (default: 5 minutes) */
+    timeoutMs?: number;
+    /** Base polling interval in milliseconds (default: 5000) */
+    pollingIntervalMs?: number;
+    /** Abort signal for cancellation */
+    abortSignal?: AbortSignal;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Callback for status updates */
+    onStatusUpdate?: (status: string, iteration: number) => void;
+}
+/**
+ * Decision status response from API
+ */
+export interface DecisionStatusResponse {
+    id: string;
+    status: "PENDING" | "VALIDATED" | "REFUSED" | "NEED_CHANGES" | "CANCELLED" | "EXPIRED";
+    feedback?: string;
+    modified_data?: any;
+    createdAt: string;
+    updatedAt: string;
+    [key: string]: any;
+}
+/**
+ * Polling result with final decision
+ */
+export interface PollingResult {
+    /** Decision status */
+    status: "VALIDATED" | "REFUSED" | "NEED_CHANGES" | "CANCELLED" | "EXPIRED" | "ABORTED" | "TIMEOUT";
+    /** Decision ID */
+    taskId: string;
+    /** Elapsed time in milliseconds */
+    elapsedTime: number;
+    /** Number of polling iterations */
+    iterations: number;
+    /** Full decision data */
+    data?: DecisionStatusResponse;
+}
+/**
+ * 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 declare class PollingService {
+    private apiClient;
+    private logger;
+    private debug;
+    constructor(apiClient: LoopmanApiClient);
+    /**
+     * Set logger for this polling service
+     * Called by LoopmanService to inject the logger
+     */
+    setLogger(logger: LoggerService): void;
+    /**
+     * Wait for a human decision on a specific decision
+     * @param options Polling options
+     * @returns Polling result with final decision
+     */
+    waitForDecision(options: PollingOptions): Promise<PollingResult>;
+    /**
+     * Check task status via API
+     * Uses the simplified /api/v1/tasks/:id/status endpoint
+     */
+    private checkTaskStatus;
+    /**
+     * Map task status from API to decision status
+     */
+    private mapTaskStatusToDecisionStatus;
+    /**
+     * Start polling session on backend
+     * Uses the simplified /api/v1/tasks/:id/polling/start endpoint
+     */
+    private startPollingSession;
+    /**
+     * Stop polling session on backend
+     * Uses the simplified /api/v1/tasks/:id/polling/stop endpoint
+     */
+    private stopPollingSession;
+    /**
+     * Notify backend about workflow interruption
+     * Uses /api/v1/tasks/:id/interruption endpoint (best effort - may not exist yet)
+     */
+    private notifyInterruption;
+    /**
+     * Check if error is a 500 error (server-side issue)
+     */
+    private is500Error;
+    /**
+     * Add jitter to polling interval (±20%)
+     * This helps distribute load on the server when multiple clients are polling
+     */
+    private addJitter;
+    /**
+     * Sleep with optional abort signal support
+     */
+    private sleep;
+    /**
+     * Log debug message
+     */
+    private logDebug;
+    /**
+     * Log info message
+     */
+    private logInfo;
+    /**
+     * Log warning message
+     */
+    private logWarn;
+    /**
+     * Log error message
+     */
+    private logError;
+}
+//# sourceMappingURL=polling.service.d.ts.map

package/dist/services/polling.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.service.d.ts","sourceRoot":"","sources":["../../src/services/polling.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EACF,SAAS,GACT,WAAW,GACX,SAAS,GACT,cAAc,GACd,WAAW,GACX,SAAS,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,MAAM,EACF,WAAW,GACX,SAAS,GACT,cAAc,GACd,WAAW,GACX,SAAS,GACT,SAAS,GACT,SAAS,CAAC;IACd,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,IAAI,CAAC,EAAE,sBAAsB,CAAC;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,KAAK,CAAkB;gBAEnB,SAAS,EAAE,gBAAgB;IAIvC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAItC;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAsLtE;;;OAGG;YACW,eAAe;IA8G7B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAoBrC;;;OAGG;YACW,mBAAmB;IAsBjC;;;OAGG;YACW,kBAAkB;IAwBhC;;;OAGG;YACW,kBAAkB;IA+BhC;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACH,OAAO,CAAC,KAAK;IAoBb;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;OAEG;IACH,OAAO,CAAC,QAAQ;CAWjB"}