@questionbase/deskfree 0.1.0

package/dist/deliver.js

@@ -0,0 +1,350 @@
+import { getActiveTaskId } from './gateway';
+import { resolvePluginStorePath } from './paths';
+import { getDeskFreeRuntime } from './runtime';
+import { randomUUID } from 'node:crypto';
+import { createWriteStream } from 'node:fs';
+import { mkdir, unlink } from 'node:fs/promises';
+import { dirname, extname } from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { createTypingCallbacks, logTypingFailure } from 'openclaw/plugin-sdk';
+// Maximum file size for attachments (10MB)
+const MAX_ATTACHMENT_SIZE = 10 * 1024 * 1024;
+// Download timeout (30 seconds)
+const DOWNLOAD_TIMEOUT_MS = 30 * 1000;
+// Rate limiting: maximum attachments per message
+const MAX_ATTACHMENTS_PER_MESSAGE = 10;
+// Rate limiting: maximum total download size per message (50MB)
+const MAX_TOTAL_DOWNLOAD_SIZE = 50 * 1024 * 1024;
+// Allowed content types for security
+const ALLOWED_CONTENT_TYPES = [
+    'image/',
+    'video/',
+    'audio/',
+    'application/pdf',
+    'text/',
+    'application/json',
+    'application/xml',
+    'application/zip',
+    'application/x-zip-compressed',
+    'application/gzip',
+    'application/msword',
+    'application/vnd.openxmlformats-officedocument',
+    'application/vnd.ms-excel',
+    'application/vnd.ms-powerpoint',
+];
+/**
+ * Validates if a content type is safe to download.
+ */
+export function isContentTypeAllowed(contentType) {
+    const normalized = contentType.toLowerCase().trim();
+    return ALLOWED_CONTENT_TYPES.some((allowed) => normalized.startsWith(allowed));
+}
+/**
+ * Sanitizes a filename to prevent directory traversal and other security issues.
+ */
+export function sanitizeFileName(fileName) {
+    return fileName
+        .replace(/[^a-zA-Z0-9._-]/g, '_') // Replace unsafe chars with underscore
+        .replace(/\.+/g, '.') // Replace multiple dots with single dot
+        .replace(/^\./, '_') // Replace leading dot
+        .substring(0, 100); // Limit length
+}
+/**
+ * Validates a URL to ensure it's a proper HTTPS URL.
+ */
+export function validateDownloadUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== 'https:') {
+            throw new Error('Only HTTPS URLs are allowed');
+        }
+        // Block localhost and private IP ranges
+        const hostname = parsed.hostname.toLowerCase();
+        // Strip IPv6 brackets for comparison (URL parser wraps IPv6 in brackets)
+        const bareHostname = hostname.replace(/^\[|\]$/g, '');
+        if (bareHostname === 'localhost' ||
+            bareHostname === '127.0.0.1' ||
+            bareHostname === '::1') {
+            throw new Error('Local URLs are not allowed');
+        }
+        // Block private IP ranges (RFC 1918 and others)
+        const ipv4Patterns = [
+            /^10\./, // 10.0.0.0/8
+            /^192\.168\./, // 192.168.0.0/16
+            /^172\.(1[6-9]|2[0-9]|3[0-1])\./, // 172.16.0.0/12
+            /^169\.254\./, // Link-local 169.254.0.0/16
+            /^0\./, // Current network
+            /^127\./, // Loopback
+        ];
+        for (const pattern of ipv4Patterns) {
+            if (pattern.test(hostname)) {
+                throw new Error('Private IP addresses are not allowed');
+            }
+        }
+        // Validate URL length to prevent DoS
+        if (url.length > 2048) {
+            throw new Error('URL too long (max 2048 characters)');
+        }
+    }
+    catch (error) {
+        throw new Error(`Invalid URL: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Downloads a file from a signed S3 URL and saves it to the plugin store.
+ * Includes security validations and error handling.
+ */
+async function fetchAndSaveMedia(attachment) {
+    // Validate input
+    if (!attachment.url) {
+        throw new Error('Attachment URL is required');
+    }
+    if (!attachment.name) {
+        throw new Error('Attachment name is required');
+    }
+    if (!attachment.contentType) {
+        throw new Error('Attachment content type is required');
+    }
+    // Security validations
+    validateDownloadUrl(attachment.url);
+    if (!isContentTypeAllowed(attachment.contentType)) {
+        throw new Error(`Content type not allowed: ${attachment.contentType}`);
+    }
+    if (attachment.size > MAX_ATTACHMENT_SIZE) {
+        throw new Error(`File too large: ${attachment.size} bytes (max: ${MAX_ATTACHMENT_SIZE})`);
+    }
+    // Generate safe file path with additional security checks
+    const sanitizedName = sanitizeFileName(attachment.name);
+    // Additional validation - ensure no path traversal attempts
+    if (sanitizedName.includes('..') ||
+        sanitizedName.includes('/') ||
+        sanitizedName.includes('\\')) {
+        throw new Error('Invalid filename: contains path traversal characters');
+    }
+    // Only append extension if the sanitized name doesn't already have one
+    const hasExt = extname(sanitizedName).length > 0;
+    const fileName = hasExt
+        ? `${randomUUID()}_${sanitizedName}`
+        : `${randomUUID()}_${sanitizedName}${extname(attachment.name) || '.bin'}`;
+    // Final validation of complete filename
+    if (fileName.length > 255) {
+        throw new Error('Generated filename too long (max 255 characters)');
+    }
+    const filePath = resolvePluginStorePath(`media/inbound/${fileName}`);
+    // Ensure directory exists
+    await mkdir(dirname(filePath), { recursive: true });
+    // Download with timeout and validations
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), DOWNLOAD_TIMEOUT_MS);
+    let fileStream = null;
+    try {
+        const response = await fetch(attachment.url, {
+            signal: controller.signal,
+            headers: {
+                'User-Agent': 'DeskFree-OpenClaw/1.0',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        if (!response.body) {
+            throw new Error('Empty response body');
+        }
+        // Validate content type from response
+        const responseContentType = response.headers.get('content-type');
+        if (responseContentType && !isContentTypeAllowed(responseContentType)) {
+            throw new Error(`Response content type not allowed: ${responseContentType}`);
+        }
+        // Validate content length if provided
+        const contentLength = response.headers.get('content-length');
+        if (contentLength) {
+            const size = parseInt(contentLength, 10);
+            if (size > MAX_ATTACHMENT_SIZE) {
+                throw new Error(`Content too large: ${size} bytes (max: ${MAX_ATTACHMENT_SIZE})`);
+            }
+        }
+        // Stream the response body to disk with size tracking
+        const nodeStream = Readable.fromWeb(response.body);
+        fileStream = createWriteStream(filePath);
+        let bytesWritten = 0;
+        let sizeExceeded = false;
+        nodeStream.on('data', (chunk) => {
+            bytesWritten += chunk.length;
+            if (bytesWritten > MAX_ATTACHMENT_SIZE && !sizeExceeded) {
+                sizeExceeded = true;
+                nodeStream.destroy(new Error('File size limit exceeded during download'));
+            }
+        });
+        // Handle stream errors properly
+        nodeStream.on('error', () => {
+            if (fileStream && !fileStream.destroyed) {
+                fileStream.destroy();
+            }
+        });
+        fileStream.on('error', () => {
+            if (!nodeStream.destroyed) {
+                nodeStream.destroy();
+            }
+        });
+        await pipeline(nodeStream, fileStream);
+        return {
+            path: filePath,
+            contentType: responseContentType || attachment.contentType,
+        };
+    }
+    catch (error) {
+        // Ensure streams are properly closed
+        if (fileStream && !fileStream.destroyed) {
+            fileStream.destroy();
+            fileStream = null;
+        }
+        // Clean up partial file if download failed
+        try {
+            await unlink(filePath);
+        }
+        catch {
+            // Ignore cleanup errors - file might not have been created
+        }
+        if (controller.signal.aborted) {
+            throw new Error(`Download timeout after ${DOWNLOAD_TIMEOUT_MS}ms`);
+        }
+        throw new Error(`Failed to download attachment: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    finally {
+        clearTimeout(timeoutId);
+        // Final cleanup - ensure file stream is closed
+        if (fileStream && !fileStream.destroyed) {
+            fileStream.destroy();
+        }
+    }
+}
+/**
+ * Delivers a DeskFree chat message to the OpenClaw agent pipeline.
+ *
+ * Each message produces a single inbound message.
+ * If the message has a taskId, it's set as ThreadId for conversation threading.
+ */
+export async function deliverMessageToAgent(ctx, message, client) {
+    const runtime = getDeskFreeRuntime();
+    const log = ctx.log ?? runtime.logging.createLogger('deskfree:deliver');
+    const peerId = message.humanId.trim().toLowerCase();
+    log.info(`Delivering message ${message.messageId} from ${message.userName ?? message.humanId}` +
+        (message.taskId ? ` (task: ${message.taskId})` : '') +
+        `: "${message.content.slice(0, 80)}${message.content.length > 80 ? '…' : ''}"`);
+    // Download attachments if present
+    const attachments = message.attachments ?? [];
+    // Validate attachment count
+    if (attachments.length > MAX_ATTACHMENTS_PER_MESSAGE) {
+        log.warn(`Message has ${attachments.length} attachments, limiting to ${MAX_ATTACHMENTS_PER_MESSAGE}`);
+    }
+    // Calculate total attachment size for rate limiting
+    const totalSize = attachments
+        .slice(0, MAX_ATTACHMENTS_PER_MESSAGE)
+        .reduce((sum, att) => sum + (att.size || 0), 0);
+    if (totalSize > MAX_TOTAL_DOWNLOAD_SIZE) {
+        log.warn(`Total attachment size ${totalSize} bytes exceeds limit ${MAX_TOTAL_DOWNLOAD_SIZE} bytes`);
+        // Don't fail the entire message, just log the warning
+    }
+    const mediaPaths = [];
+    const mediaTypes = [];
+    const mediaUrls = [];
+    for (const [index, attachment] of attachments
+        .slice(0, MAX_ATTACHMENTS_PER_MESSAGE)
+        .entries()) {
+        if (!attachment.url) {
+            log.warn(`Skipping attachment ${index}: no URL provided`);
+            continue;
+        }
+        try {
+            const saved = await fetchAndSaveMedia(attachment);
+            mediaPaths.push(saved.path);
+            mediaTypes.push(saved.contentType);
+            mediaUrls.push(saved.path);
+            log.info(`Downloaded attachment ${index}: ${attachment.name} (${saved.contentType})`);
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            log.warn(`Failed to download attachment ${index} (${attachment.name}): ${errorMsg}`);
+            // Non-fatal — continue processing other attachments and the message
+        }
+    }
+    const msgCtx = runtime.channel.reply.finalizeInboundContext({
+        Body: message.content,
+        RawBody: message.content,
+        ChatType: 'dm',
+        Provider: 'deskfree',
+        Surface: 'deskfree',
+        Channel: 'deskfree',
+        From: message.humanId,
+        To: message.humanId,
+        MessageSid: message.messageId,
+        ThreadId: message.taskId ?? undefined,
+        Timestamp: message.createdAt,
+        AccountId: ctx.accountId,
+        FromName: message.userName ?? 'Unknown',
+        SessionKey: `agent:main:deskfree:dm:${peerId}`,
+        // Backward-compatible: first attachment
+        MediaPath: mediaPaths[0],
+        MediaType: mediaTypes[0],
+        MediaUrl: mediaUrls[0],
+        // Array keys for multiple attachments
+        MediaPaths: mediaPaths,
+        MediaTypes: mediaTypes,
+        MediaUrls: mediaUrls,
+        MediaCount: mediaPaths.length,
+    });
+    try {
+        const cfg = runtime.config.loadConfig();
+        const typingCallbacks = createTypingCallbacks({
+            start: async () => {
+                await client.typing({ taskId: message.taskId ?? undefined });
+            },
+            onStartError: (err) => {
+                logTypingFailure({
+                    log: (m) => log.warn(m),
+                    channel: 'deskfree',
+                    action: 'start',
+                    error: err,
+                });
+            },
+        });
+        const { dispatcher, replyOptions } = runtime.channel.reply.createReplyDispatcherWithTyping({
+            channel: 'deskfree',
+            accountId: ctx.accountId,
+            onReplyStart: typingCallbacks.onReplyStart,
+            onIdle: typingCallbacks.onIdle,
+            deliver: async (payload) => {
+                const text = typeof payload === 'string'
+                    ? payload
+                    : (payload.text ?? payload.body ?? '');
+                if (text) {
+                    // Use the message's own taskId if present, otherwise
+                    // fall back to the active task for auto-threading
+                    const taskId = message.taskId ?? getActiveTaskId() ?? undefined;
+                    log.info(`Sending reply to DeskFree (task: ${taskId ?? 'none'}): "${text.slice(0, 80)}..."`);
+                    await client.sendMessage({
+                        content: text,
+                        taskId,
+                    });
+                    log.info('Reply sent successfully.');
+                }
+                else {
+                    log.warn('Deliver callback called with empty text, skipping.');
+                }
+            },
+        });
+        await runtime.channel.reply.dispatchReplyFromConfig({
+            ctx: msgCtx,
+            cfg,
+            dispatcher,
+            replyOptions,
+        });
+        log.info(`Message ${message.messageId} dispatched successfully.`);
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        log.warn(`Failed to dispatch message ${message.messageId}: ${errMsg}`);
+    }
+}
+//# sourceMappingURL=deliver.js.map

package/dist/deliver.js.map

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

package/dist/gateway.d.ts

@@ -0,0 +1,13 @@
+import type { ChannelGatewayContext } from './types';
+export declare function setActiveTaskId(taskId: string | null): void;
+export declare function getActiveTaskId(): string | null;
+/**
+ * Main entry point for the DeskFree channel gateway.
+ * Called by OpenClaw's channel manager via gateway.startAccount().
+ *
+ * Maintains a WebSocket connection for real-time notifications
+ * and polls the messages endpoint for actual data.
+ * Falls back to interval-based polling if WebSocket is unavailable.
+ */
+export declare function startDeskFreeConnection(ctx: ChannelGatewayContext): Promise<void>;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,SAAS,CAAC;AAejB,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AA6QD;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,IAAI,CAAC,CA+Ff"}