@loopman/langchain-sdk 1.0.9

package/dist/client/loopman-api.js

@@ -0,0 +1,407 @@
+import { LoopmanConnectionError, } from "../types";
+/**
+ * Loopman client for direct API connection
+ * Allows authentication with an API key and direct backoffice calls
+ */
+export class LoopmanApiClient {
+    config;
+    authServiceUrl;
+    tokenCache = new Map();
+    bufferTimeSeconds = 60; // Renew token 60s before expiration
+    constructor(config) {
+        this.config = config;
+        this.authServiceUrl =
+            process.env.LOOPMAN_AUTH_URL || "https://auth.loopman.ai";
+        // Clean expired tokens every 5 minutes
+        setInterval(() => this.cleanupExpiredTokens(), 5 * 60 * 1000);
+    }
+    /**
+     * Exchange an API key for JWT tokens with caching
+     * @param apiKey The API key to exchange
+     * @returns Object containing accessToken and serverUrl
+     */
+    async getTokenFromApiKey(apiKey) {
+        // Check cache first
+        const cached = this.getCachedToken(apiKey);
+        if (cached) {
+            return cached;
+        }
+        // Cache miss or expired, get a new token
+        console.log("🔑 Getting a new token from the authentication service");
+        try {
+            const response = await fetch(`${this.authServiceUrl}/auth/tokens/exchange`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({ apiKey }),
+            });
+            if (!response.ok) {
+                const errorData = (await response
+                    .json()
+                    .catch(() => ({})));
+                throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
+            }
+            const data = (await response.json());
+            const { accessToken, refreshToken, expiresIn, serverUrl } = data;
+            // Store in cache
+            this.setCachedToken(apiKey, {
+                accessToken,
+                refreshToken,
+                serverUrl,
+                expiresIn,
+            });
+            return { accessToken, serverUrl, fromCache: false };
+        }
+        catch (error) {
+            console.error("❌ Failed to exchange API key:", error);
+            this.handleNetworkError(error, "Authentication service", this.authServiceUrl);
+        }
+    }
+    /**
+     * Get authorization headers with access token and server URL
+     */
+    async getAuthHeaders(apiKey) {
+        const { accessToken, serverUrl } = await this.getTokenFromApiKey(apiKey);
+        return {
+            Authorization: `Bearer ${accessToken}`,
+            serverUrl,
+        };
+    }
+    /**
+     * Get current user from backoffice
+     * @param apiKey The API key for authentication
+     * @returns Current user information
+     */
+    async getCurrentUser(apiKey) {
+        console.log("👤 Getting current user from backoffice");
+        try {
+            const { Authorization, serverUrl } = await this.getAuthHeaders(apiKey);
+            //console.log(`🔗 Using backoffice URL: ${serverUrl}`);
+            const response = await fetch(`${serverUrl}/user/me`, {
+                headers: { Authorization },
+            });
+            if (!response.ok) {
+                const errorData = (await response
+                    .json()
+                    .catch(() => ({})));
+                throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
+            }
+            const user = (await response.json());
+            console.log(`✅ Current user retrieved: ${user.email}`);
+            return user;
+        }
+        catch (error) {
+            console.error("❌ Failed to get current user:", error);
+            // Specific error handling for network errors
+            if (error instanceof TypeError &&
+                error.message.includes("fetch failed")) {
+                throw new LoopmanConnectionError(`Backoffice service inaccessible. ` +
+                    `Check that the backoffice server is started and accessible. ` +
+                    `Network error: ${error.message}`);
+            }
+            throw new LoopmanConnectionError(`Failed to get user: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Generic method to make GET requests to backoffice
+     * @param apiKey The API key for authentication
+     * @param endpoint The endpoint to call (e.g. '/tasks', '/channels')
+     * @returns Response data
+     */
+    async get(apiKey, endpoint) {
+        console.log(`📥 GET ${endpoint}`);
+        try {
+            const { Authorization, serverUrl } = await this.getAuthHeaders(apiKey);
+            //console.log(`🔗 Using backoffice URL: ${serverUrl}`);
+            const response = await fetch(`${serverUrl}${endpoint}`, {
+                headers: { Authorization },
+            });
+            if (!response.ok) {
+                const errorData = (await response
+                    .json()
+                    .catch(() => ({})));
+                throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(`❌ Failed GET ${endpoint}:`, error);
+            throw new LoopmanConnectionError(`Failed GET ${endpoint}: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Generic method to make POST requests to backoffice
+     * @param apiKey The API key for authentication
+     * @param endpoint The endpoint to call
+     * @param data The data to send
+     * @returns Response data
+     */
+    async post(apiKey, endpoint, data) {
+        console.log(`📤 POST ${endpoint}`);
+        try {
+            const { Authorization, serverUrl } = await this.getAuthHeaders(apiKey);
+            //console.log(`🔗 Using backoffice URL: ${serverUrl}`);
+            const response = await fetch(`${serverUrl}${endpoint}`, {
+                method: "POST",
+                headers: {
+                    Authorization,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(data),
+            });
+            if (!response.ok) {
+                const errorData = (await response
+                    .json()
+                    .catch(() => ({})));
+                throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(`❌ Failed POST ${endpoint}:`, error);
+            throw new LoopmanConnectionError(`Failed POST ${endpoint}: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Generic method to make PUT requests to backoffice
+     * @param apiKey The API key for authentication
+     * @param endpoint The endpoint to call
+     * @param data The data to send
+     * @returns Response data
+     */
+    async put(apiKey, endpoint, data) {
+        console.log(`📝 PUT ${endpoint}`);
+        try {
+            const { Authorization, serverUrl } = await this.getAuthHeaders(apiKey);
+            //console.log(`🔗 Using backoffice URL: ${serverUrl}`);
+            const response = await fetch(`${serverUrl}${endpoint}`, {
+                method: "PUT",
+                headers: {
+                    Authorization,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(data),
+            });
+            if (!response.ok) {
+                const errorData = (await response
+                    .json()
+                    .catch(() => ({})));
+                throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(`❌ Failed PUT ${endpoint}:`, error);
+            throw new LoopmanConnectionError(`Failed PUT ${endpoint}: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Generic method to make PATCH requests to backoffice
+     * @param apiKey The API key for authentication
+     * @param endpoint The endpoint to call
+     * @param data The data to send
+     * @returns Response data
+     */
+    async patch(apiKey, endpoint, data) {
+        console.log(`🔧 PATCH ${endpoint}`);
+        try {
+            const { Authorization, serverUrl } = await this.getAuthHeaders(apiKey);
+            //console.log(`🔗 Using backoffice URL: ${serverUrl}`);
+            const response = await fetch(`${serverUrl}${endpoint}`, {
+                method: "PATCH",
+                headers: {
+                    Authorization,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(data),
+            });
+            if (!response.ok) {
+                const errorData = (await response
+                    .json()
+                    .catch(() => ({})));
+                throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(`❌ Failed PATCH ${endpoint}:`, error);
+            throw new LoopmanConnectionError(`Failed PATCH ${endpoint}: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Generic method to make DELETE requests to backoffice
+     * @param apiKey The API key for authentication
+     * @param endpoint The endpoint to call
+     * @returns Response data
+     */
+    async delete(apiKey, endpoint) {
+        console.log(`🗑️ DELETE ${endpoint}`);
+        try {
+            const { Authorization, serverUrl } = await this.getAuthHeaders(apiKey);
+            //console.log(`🔗 Using backoffice URL: ${serverUrl}`);
+            const response = await fetch(`${serverUrl}${endpoint}`, {
+                method: "DELETE",
+                headers: { Authorization },
+            });
+            if (!response.ok) {
+                const errorData = (await response
+                    .json()
+                    .catch(() => ({})));
+                throw new Error(errorData.message || `HTTP ${response.status}: ${response.statusText}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            console.error(`❌ Failed DELETE ${endpoint}:`, error);
+            throw new LoopmanConnectionError(`Failed DELETE ${endpoint}: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Get token from cache if valid, otherwise return null
+     */
+    getCachedToken(apiKey) {
+        const cached = this.tokenCache.get(apiKey);
+        if (!cached) {
+            console.log(`🔍 Cache miss for key: ${this.maskApiKey(apiKey)}`);
+            return null;
+        }
+        // Check if token is still valid
+        const now = Date.now();
+        if (cached.expiresAt <= now) {
+            console.log(`⏰ Token expired for key: ${this.maskApiKey(apiKey)} (expired ${Math.floor((now - cached.expiresAt) / 1000)}s ago)`);
+            this.tokenCache.delete(apiKey);
+            return null;
+        }
+        const ttl = Math.floor((cached.expiresAt - now) / 1000);
+        console.log(`✅ Cache hit for key: ${this.maskApiKey(apiKey)} (TTL: ${ttl}s)`);
+        return {
+            accessToken: cached.data.accessToken,
+            serverUrl: cached.data.serverUrl,
+            fromCache: true,
+        };
+    }
+    /**
+     * Store token in cache with expiration
+     */
+    setCachedToken(apiKey, tokenData) {
+        const now = Date.now();
+        const expiresAt = now + (tokenData.expiresIn - this.bufferTimeSeconds) * 1000;
+        this.tokenCache.set(apiKey, {
+            data: tokenData,
+            expiresAt,
+        });
+        const ttl = Math.floor((expiresAt - now) / 1000);
+        console.log(`💾 Token cached for key: ${this.maskApiKey(apiKey)} (TTL: ${ttl}s, expires at: ${new Date(expiresAt).toISOString()})`);
+    }
+    /**
+     * Remove a token from cache
+     */
+    clearCache(apiKey) {
+        const deleted = this.tokenCache.delete(apiKey);
+        if (deleted) {
+            console.log(`🗑️ Token removed from cache for key: ${this.maskApiKey(apiKey)}`);
+        }
+    }
+    /**
+     * Clear all token cache
+     */
+    clearAllCache() {
+        const size = this.tokenCache.size;
+        this.tokenCache.clear();
+        console.log(`🧹 Token cache cleared (${size} entries removed)`);
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        const now = Date.now();
+        const entries = Array.from(this.tokenCache.entries()).map(([apiKey, cached]) => ({
+            apiKey: this.maskApiKey(apiKey),
+            serverUrl: cached.data.serverUrl,
+            expiresAt: new Date(cached.expiresAt).toISOString(),
+            ttl: Math.floor((cached.expiresAt - now) / 1000), // seconds until expiration
+        }));
+        return {
+            size: this.tokenCache.size,
+            entries,
+        };
+    }
+    /**
+     * Check if a token exists and is valid
+     */
+    hasValidToken(apiKey) {
+        const cached = this.tokenCache.get(apiKey);
+        if (!cached)
+            return false;
+        const isValid = cached.expiresAt > Date.now();
+        if (!isValid) {
+            this.tokenCache.delete(apiKey);
+        }
+        return isValid;
+    }
+    /**
+     * Get remaining TTL for a cached token
+     */
+    getTokenTTL(apiKey) {
+        const cached = this.tokenCache.get(apiKey);
+        if (!cached)
+            return 0;
+        const ttl = Math.floor((cached.expiresAt - Date.now()) / 1000);
+        return Math.max(0, ttl);
+    }
+    /**
+     * Clean up expired tokens from cache
+     */
+    cleanupExpiredTokens() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [apiKey, cached] of this.tokenCache.entries()) {
+            if (cached.expiresAt <= now) {
+                this.tokenCache.delete(apiKey);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            console.log(`🧹 ${removed} expired token(s) cleaned from cache (${this.tokenCache.size} remaining)`);
+        }
+    }
+    /**
+     * Handle network errors consistently
+     */
+    handleNetworkError(error, serviceName, serviceUrl) {
+        if (error instanceof TypeError && error.message.includes("fetch failed")) {
+            throw new LoopmanConnectionError(`${serviceName} inaccessible at ${serviceUrl}. ` +
+                `Check that the server is started and accessible. ` +
+                `Network error: ${error.message}`);
+        }
+        if (error instanceof Error && error.message.includes("ECONNREFUSED")) {
+            throw new LoopmanConnectionError(`Connection refused to ${serviceName} (${serviceUrl}). ` +
+                `The server is probably not started. ` +
+                `Check that the service is running.`);
+        }
+        if (error instanceof Error && error.message.includes("ENOTFOUND")) {
+            throw new LoopmanConnectionError(`${serviceName} not found (${serviceUrl}). ` +
+                `Check the service URL in your configuration. ` +
+                `DNS error: ${error.message}`);
+        }
+        throw new LoopmanConnectionError(`Connection error to ${serviceName}. ` +
+            `Service: ${serviceUrl}. ` +
+            `Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    /**
+     * Mask API key for logs (show only first 8 characters)
+     */
+    maskApiKey(apiKey) {
+        if (apiKey.length <= 8)
+            return apiKey;
+        return `${apiKey.substring(0, 8)}...`;
+    }
+    /**
+     * Get current configuration
+     */
+    get configuration() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=loopman-api.js.map

package/dist/client/loopman-api.js.map

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

package/dist/helpers/prompt-orchestrator.d.ts

@@ -0,0 +1,12 @@
+export interface LoopmanPromptOptions {
+    workflowId: string;
+    executionId: string;
+    taskId?: string;
+    category?: string;
+    systemPrompt?: string;
+    language?: string;
+}
+export declare function buildLoopmanSystemPrompt(options: LoopmanPromptOptions): string;
+export declare function extractTaskId(response: string): string | undefined;
+export declare function extractConfidence(response: string): number | undefined;
+//# sourceMappingURL=prompt-orchestrator.d.ts.map

package/dist/helpers/prompt-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-orchestrator.d.ts","sourceRoot":"","sources":["../../src/helpers/prompt-orchestrator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAgBR;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGlE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtE"}

package/dist/helpers/prompt-orchestrator.js

@@ -0,0 +1,133 @@
+export function buildLoopmanSystemPrompt(options) {
+    const before = sanitizePlaceholders(ORCHESTRATOR_BEFORE, options);
+    const after = sanitizePlaceholders(ORCHESTRATOR_AFTER, options);
+    const variablePrompt = options.systemPrompt ?? "";
+    // Add language instruction if specified
+    let languageInstruction = "";
+    if (options.language) {
+        languageInstruction = `\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n🌍 LANGUAGE REQUIREMENT\n\nAll text content you provide to submitForHumanReview MUST be written in ${options.language}.\nThis includes:\n- title\n- description\n- proposedDecision\n- decisionReasoning\n- businessContext\n- information labels and values\n\nEven if the user communicates in another language, always use ${options.language} for human review content.\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+    }
+    if (variablePrompt.trim().length === 0) {
+        return `${before}${languageInstruction}\n${after}`;
+    }
+    return `${before}\n${variablePrompt}${languageInstruction}\n${after}`;
+}
+export function extractTaskId(response) {
+    const match = response.match(/<task_id>([^<]+)<\/task_id>/);
+    return match ? match[1] : undefined;
+}
+export function extractConfidence(response) {
+    const match = response.match(/confidence[:\s]+(\d+(?:\.\d+)?)/i);
+    return match ? parseFloat(match[1]) : undefined;
+}
+function sanitizePlaceholders(template, options) {
+    const replaced = template
+        .replace(/\{\{\s*\$workflow\.id\s*\}\}/g, options.workflowId)
+        .replace(/\{\{\s*\$execution\.id\s*\}\}/g, options.executionId)
+        .replace(/\{\{\s*\$json\.taskId\s*\}\}/g, options.taskId ?? "")
+        .replace(/\{\{\s*\$category\s*\}\}/g, options.category ?? "general");
+    return replaced;
+}
+const ORCHESTRATOR_BEFORE = `
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔧 LOOPMAN HUMAN-IN-THE-LOOP WORKFLOW
+
+🚨 IMPORTANT: This is a STRICT workflow. You MUST NOT deviate from it.
+
+❌ DO NOT call business tools directly (send_email, publish_content, delete_data, etc.)
+✅ ALWAYS follow the 4-step process below
+
+You MUST follow these steps IN ORDER:
+
+1️⃣ STEP 1: Call getHumanGuidelines
+   - workflow_id: "{{ $workflow.id }}"
+   - execution_id: "{{ $execution.id }}"
+   - category: "{{ $category }}"
+
+2️⃣ STEP 2: Call getDecisionContext
+   - workflow_id: "{{ $workflow.id }}"
+   - execution_id: "{{ $execution.id }}"
+
+3️⃣ STEP 3: Analyze the context
+
+   After completing Steps 1 and 2, analyze in your next Thought:
+
+   Thought: Steps 1 and 2 complete. Analyzing context:
+
+   🚨 DECISION HIERARCHY (from highest to lowest priority):
+     1. HUMAN DECISIONS (userType: USER) - Most authoritative
+     2. GUIDELINES - Generic rules and policies
+     3. SYSTEM DECISIONS (userType: SYSTEM) - Lowest priority
+
+     If a human previously approved/rejected something that contradicts a guideline,
+     the human decision takes precedence. Humans provide contextual judgment that
+     overrides generic rules.
+
+   Guidelines received:
+   - [RULE-ID-1]: [Description] → Applicable? [YES/NO and why]
+   - [RULE-ID-2]: [Description] → Applicable? [YES/NO and why]
+   - Initially applicable: [list]
+
+   Decision History analysis:
+   - Human decisions: [X] found
+     → [Summarize: what did humans approve/reject and why]
+     → [Note any conflicts with guidelines]
+   - System decisions: [Y] found
+     → [Summarize if no human override exists]
+
+   Conflicts resolution:
+   - Human override guideline [RULE-ID]? → [YES/NO: explain]
+   - Human override system decision? → [YES/NO: explain]
+
+   Final authoritative context:
+   - Must follow: [Human decisions that override guidelines/system]
+   - Must respect: [Guidelines not contradicted by humans]
+   - Can consider: [System decisions if no human/guideline exists]
+
+   Example:
+   - Guideline says "Reject emails from unknown domains"
+   - Human previously approved email from unknown domain X with comment "Trusted partner"
+   - → FOLLOW HUMAN: Approve similar emails from domain X
+   - → Human judgment > Generic guideline
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`;
+const ORCHESTRATOR_AFTER = `
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+4️⃣ STEP 4: Submit for human review
+
+   🚨 CRITICAL RULES - READ CAREFULLY:
+   
+   ❌ NEVER call business tools directly (like send_email, publish_content, delete_data, etc.)
+   ❌ NEVER skip the submitForHumanReview step
+   ✅ ALWAYS go through submitForHumanReview FIRST before any action
+   
+   You MUST call submitForHumanReview in these cases:
+   
+   A) First attempt: No previous decisions found
+   B) After NEED_CHANGES: getDecisionContext shows human feedback
+      → In this case, you MUST incorporate the feedback and RE-SUBMIT a corrected proposal
+   
+   Do NOT skip this step if you see previous NEED_CHANGES feedback!
+   The human is waiting for your corrected proposal.
+
+   Call submitForHumanReview with ALL these REQUIRED fields:
+     * title (string, required): Brief description of the action (e.g., "Send email to Alice")
+     * description (string, required): Brief description of the decision being requested
+     * proposedDecision (string, REQUIRED): The exact action you propose (e.g., "Send email with subject 'Meeting' to alice@example.com")
+       - If re-submitting after NEED_CHANGES, incorporate the human feedback into your proposal
+     * decisionReasoning (string, required): Detailed explanation of why you made this decision based on guidelines
+       - If getDecisionContext returned previous human decisions, ALWAYS mention them in your reasoning
+       - Example: "Based on John Doe's previous feedback on 2024-01-15 requesting changes, I have updated the proposal to..."
+       - Include the human's name and their decision to show you incorporated their feedback
+     * businessContext (string, required): Background context about the situation - explain the circumstances like you're writing to your supervisor
+     * information (array, required): Supporting evidence with descriptive labels (e.g., [{"type": "text", "label": "Recipient", "value": "alice@example.com"}])
+   - The tool will automatically inject workflowIdentifier, executionIdentifier, and category
+   - Do NOT leave any required field empty or the call will fail
+
+After calling submitForHumanReview, STOP and provide your final answer.
+DO NOT call any other tools after submitForHumanReview.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`;
+//# sourceMappingURL=prompt-orchestrator.js.map

package/dist/helpers/prompt-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-orchestrator.js","sourceRoot":"","sources":["../../src/helpers/prompt-orchestrator.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,wBAAwB,CACtC,OAA6B;IAE7B,MAAM,MAAM,GAAG,oBAAoB,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,oBAAoB,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;IAElD,wCAAwC;IACxC,IAAI,mBAAmB,GAAG,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,mBAAmB,GAAG,wKAAwK,OAAO,CAAC,QAAQ,2MAA2M,OAAO,CAAC,QAAQ,8FAA8F,CAAC;IAC1gB,CAAC;IAED,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,GAAG,MAAM,GAAG,mBAAmB,KAAK,KAAK,EAAE,CAAC;IACrD,CAAC;IAED,OAAO,GAAG,MAAM,KAAK,cAAc,GAAG,mBAAmB,KAAK,KAAK,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,SAAS,oBAAoB,CAC3B,QAAgB,EAChB,OAA6B;IAE7B,MAAM,QAAQ,GAAG,QAAQ;SACtB,OAAO,CAAC,+BAA+B,EAAE,OAAO,CAAC,UAAU,CAAC;SAC5D,OAAO,CAAC,gCAAgC,EAAE,OAAO,CAAC,WAAW,CAAC;SAC9D,OAAO,CAAC,+BAA+B,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;SAC9D,OAAO,CAAC,2BAA2B,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC;IAEvE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DA+DiC,CAAC;AAE9D,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DAqCkC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Loopman SDK TypeScript
+ *
+ * LangChain middleware for Human-in-the-Loop validation via Loopman platform
+ */
+export { loopmanMiddleware } from "./loopman-middleware";
+export type { LoopmanDecision, LoopmanMiddlewareConfig, ToolCall, } from "./loopman-middleware";
+export { createLoopmanAgent as createLoopmanAgentWrapper, createLoopmanAgent as deprecatedCreateLoopmanAgent, invokeWithRetry, // Recommended: explicit retry helper for invoke()
+streamWithRetry, } from "./loopman-agent-wrapper";
+export { createLoopmanAgent, LoopmanAgent } from "./agents/loopman-agent";
+export { buildLoopmanSystemPrompt, extractConfidence, extractTaskId, } from "./helpers/prompt-orchestrator";
+export { LoopmanMcpClient } from "./mcp/loopman-mcp-client";
+export { LoopmanApiClient } from "./client/loopman-api";
+export * from "./services";
+export type { CachedToken, LoopmanConfig, LoopmanUser, TokenData, TokenExchangeResponse, } from "./types";
+export { LoopmanConnectionError, LoopmanError, LoopmanTimeoutError, LoopmanValidationError, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,kBAAkB,IAAI,yBAAyB,EAC/C,kBAAkB,IAAI,4BAA4B,EAClD,eAAe,EAAE,kDAAkD;AACnE,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG1E,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,GACd,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,cAAc,YAAY,CAAC;AAG3B,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,SAAS,EACT,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * Loopman SDK TypeScript
+ *
+ * LangChain middleware for Human-in-the-Loop validation via Loopman platform
+ */
+// Middleware exports
+export { loopmanMiddleware } from "./loopman-middleware";
+// Agent helper exports (optional auto-retry on human feedback)
+export { createLoopmanAgent as createLoopmanAgentWrapper, createLoopmanAgent as deprecatedCreateLoopmanAgent, invokeWithRetry, // Recommended: explicit retry helper for invoke()
+streamWithRetry, } from "./loopman-agent-wrapper";
+// New Agent implementation (MCP + HITL)
+export { createLoopmanAgent, LoopmanAgent } from "./agents/loopman-agent";
+// Prompt helpers
+export { buildLoopmanSystemPrompt, extractConfidence, extractTaskId, } from "./helpers/prompt-orchestrator";
+// MCP utilities
+export { LoopmanMcpClient } from "./mcp/loopman-mcp-client";
+// Client exports
+export { LoopmanApiClient } from "./client/loopman-api";
+// Service exports (import from services/index.ts for centralized exports)
+export * from "./services";
+export { LoopmanConnectionError, LoopmanError, LoopmanTimeoutError, LoopmanValidationError, } from "./types";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAOzD,+DAA+D;AAC/D,OAAO,EACL,kBAAkB,IAAI,yBAAyB,EAC/C,kBAAkB,IAAI,4BAA4B,EAClD,eAAe,EAAE,kDAAkD;AACnE,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,wCAAwC;AACxC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE1E,iBAAiB;AACjB,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,GACd,MAAM,+BAA+B,CAAC;AAEvC,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,iBAAiB;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,0EAA0E;AAC1E,cAAc,YAAY,CAAC;AAW3B,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,SAAS,CAAC"}