@questionbase/deskfree 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,148 @@
+import type { ChannelProbeResult, CreateTaskResponse, MessagesResponse, Task, TasksListResponse, WsTicketResponse } from './types';
+/** Enhanced error class for DeskFree API errors with user-friendly messages */
+export declare class DeskFreeError extends Error {
+    readonly type: 'network' | 'auth' | 'server' | 'client' | 'timeout' | 'invalid_response';
+    readonly statusCode?: number;
+    readonly userMessage: string;
+    readonly procedure: string;
+    constructor(type: DeskFreeError['type'], procedure: string, message: string, userMessage: string, statusCode?: number);
+    static fromResponse(response: Response, procedure: string, responseText: string): DeskFreeError;
+    static timeout(procedure: string, timeoutMs: number): DeskFreeError;
+    static invalidResponse(procedure: string): DeskFreeError;
+    static network(procedure: string, originalError: Error): DeskFreeError;
+}
+export declare class DeskFreeClient {
+    private botToken;
+    private apiUrl;
+    private requestTimeoutMs;
+    constructor(botToken: string, apiUrl: string, options?: {
+        requestTimeoutMs?: number;
+    });
+    private request;
+    /**
+     * Validates that a string parameter is non-empty.
+     * Catches invalid inputs before they hit the network.
+     */
+    private requireNonEmpty;
+    /**
+     * Send a typing indicator to the DeskFree conversation.
+     *
+     * @param input - Optional parameters including taskId to scope the indicator
+     */
+    typing(input?: {
+        taskId?: string;
+    }): Promise<void>;
+    /**
+     * Send a text message (with optional attachments) to a DeskFree conversation.
+     *
+     * @param input - Message content, optional userId, taskId, and attachments
+     */
+    sendMessage(input: {
+        userId?: string;
+        content: string;
+        taskId?: string;
+        attachments?: Array<{
+            s3Key: string;
+            name: string;
+            contentType: string;
+            size: number;
+        }>;
+    }): Promise<void>;
+    /** Fetch paginated message history for a conversation. */
+    listMessages(input: {
+        userId?: string;
+        cursor?: string | null;
+        limit?: number;
+    }): Promise<MessagesResponse>;
+    /** Obtain a one-time WebSocket authentication ticket for real-time notifications. */
+    getWsTicket(): Promise<WsTicketResponse>;
+    /** Create a new task, optionally with a recurring schedule. */
+    createTask(input: {
+        title: string;
+        instructions?: string;
+        isRecurring?: boolean;
+        recurringSchedule?: {
+            frequency: 'daily' | 'weekly' | 'biweekly' | 'monthly';
+            dayOfWeek?: number;
+            dayOfMonth?: number;
+            time: string;
+            timezone?: string;
+        };
+    }): Promise<CreateTaskResponse>;
+    /** Snooze a task until a given ISO-8601 datetime. */
+    snoozeTask(input: {
+        taskId: string;
+        snoozedUntil: string;
+    }): Promise<Task>;
+    /** Unsnooze a previously snoozed task, making it active again. */
+    unsnoozeTask(input: {
+        taskId: string;
+    }): Promise<Task>;
+    /** List tasks, optionally filtered by status. */
+    listTasks(input?: {
+        status?: string;
+    }): Promise<TasksListResponse>;
+    /** Claim a task so the bot can begin working on it. */
+    claimTask(input: {
+        taskId: string;
+    }): Promise<Task>;
+    /** Release a previously claimed task back to the queue. */
+    releaseTask(input: {
+        taskId: string;
+    }): Promise<Task>;
+    /** Submit a task for human review, optionally with a comment. */
+    requestReview(input: {
+        taskId: string;
+        comment?: string;
+    }): Promise<Task>;
+    /** Update the deliverable (markdown content) for a task. */
+    updateDeliverable(input: {
+        taskId: string;
+        deliverable: string;
+    }): Promise<void>;
+    /** Fetch a single task by ID. */
+    getTask(input: {
+        taskId: string;
+    }): Promise<Task>;
+    /** Send an agent status update to DeskFree. */
+    statusUpdate(input: {
+        status: 'idle' | 'working' | 'responding';
+        activeSubAgents: Array<{
+            label: string;
+            status: 'running' | 'completed' | 'failed';
+            startedAt: string;
+            completedAt?: string;
+            tokenUsage?: number;
+            task?: string;
+        }>;
+        model?: string;
+        lastActivity?: string;
+        pluginVersion?: string;
+        openclawVersion?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    /** Get short-lived AWS credentials for S3 workspace access. */
+    workspaceCredentials(): Promise<{
+        accessKeyId: string;
+        secretAccessKey: string;
+        sessionToken: string;
+        expiration: Date;
+    }>;
+    /** Notify DeskFree that workspace files have changed locally. */
+    workspaceRead(input: {
+        path: string;
+    }): Promise<{
+        path: string;
+        content: string;
+        lastModified: string;
+    }>;
+    /**
+     * Lightweight health check that verifies connectivity and authentication.
+     *
+     * @param timeoutMs - Maximum time to wait for the probe response
+     * @returns Probe result indicating success or a descriptive error
+     */
+    probe(timeoutMs: number): Promise<ChannelProbeResult>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,255 @@
+/**
+ * HTTP client for the DeskFree bot API.
+ * All endpoints use tRPC via HTTP POST/GET.
+ */
+/** Default timeout for API requests (30 seconds). */
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+/** Enhanced error class for DeskFree API errors with user-friendly messages */
+export class DeskFreeError extends Error {
+    type;
+    statusCode;
+    userMessage;
+    procedure;
+    constructor(type, procedure, message, userMessage, statusCode) {
+        super(message);
+        this.name = 'DeskFreeError';
+        this.type = type;
+        this.procedure = procedure;
+        this.userMessage = userMessage;
+        this.statusCode = statusCode;
+    }
+    static fromResponse(response, procedure, responseText) {
+        const status = response.status;
+        const statusText = response.statusText;
+        if (status === 401) {
+            return new DeskFreeError('auth', procedure, `Authentication failed: ${status} ${statusText} — ${responseText}`, 'Your bot token is invalid or has expired. Please check your authentication credentials.', status);
+        }
+        if (status === 403) {
+            return new DeskFreeError('auth', procedure, `Authorization failed: ${status} ${statusText} — ${responseText}`, 'Your bot does not have permission to perform this action. Contact your administrator.', status);
+        }
+        if (status >= 500) {
+            return new DeskFreeError('server', procedure, `Server error: ${status} ${statusText} — ${responseText}`, 'DeskFree service is temporarily unavailable. Please try again in a few minutes.', status);
+        }
+        if (status === 429) {
+            return new DeskFreeError('client', procedure, `Rate limit exceeded: ${status} ${statusText} — ${responseText}`, 'Too many requests. Please wait a moment before trying again.', status);
+        }
+        if (status === 400) {
+            return new DeskFreeError('client', procedure, `Bad request: ${status} ${statusText} — ${responseText}`, 'The request was invalid. Please check your input and try again.', status);
+        }
+        return new DeskFreeError('client', procedure, `HTTP error: ${status} ${statusText} — ${responseText}`, `Request failed with error ${status}. Please try again or contact support if the problem persists.`, status);
+    }
+    static timeout(procedure, timeoutMs) {
+        return new DeskFreeError('timeout', procedure, `Request to ${procedure} timed out after ${timeoutMs}ms`, 'The request took too long to complete. Please check your network connection and try again.');
+    }
+    static invalidResponse(procedure) {
+        return new DeskFreeError('invalid_response', procedure, `Invalid tRPC response structure for ${procedure}`, 'Received an unexpected response from the server. Please try again or contact support.');
+    }
+    static network(procedure, originalError) {
+        return new DeskFreeError('network', procedure, `Network error for ${procedure}: ${originalError.message}`, 'Unable to connect to DeskFree. Please check your internet connection and try again.');
+    }
+}
+export class DeskFreeClient {
+    botToken;
+    apiUrl;
+    requestTimeoutMs;
+    constructor(botToken, apiUrl, options) {
+        this.botToken = botToken;
+        this.apiUrl = apiUrl.replace(/\/$/, '');
+        this.requestTimeoutMs =
+            options?.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    }
+    async request(method, procedure, input) {
+        const url = method === 'GET' && input
+            ? `${this.apiUrl}/${procedure}?input=${encodeURIComponent(JSON.stringify(input))}`
+            : `${this.apiUrl}/${procedure}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.requestTimeoutMs);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    Authorization: `Bot ${this.botToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: method === 'POST' ? JSON.stringify(input) : undefined,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const text = await response.text().catch((err) => {
+                    const errMsg = err instanceof Error ? err.message : String(err);
+                    return `(failed to read response body: ${errMsg})`;
+                });
+                throw DeskFreeError.fromResponse(response, procedure, text);
+            }
+            const json = (await response.json());
+            // Validate tRPC response structure
+            if (!json.result || json.result.data === undefined) {
+                throw DeskFreeError.invalidResponse(procedure);
+            }
+            return json.result.data;
+        }
+        catch (err) {
+            if (err instanceof DeskFreeError) {
+                throw err;
+            }
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw DeskFreeError.timeout(procedure, this.requestTimeoutMs);
+            }
+            if (err instanceof Error) {
+                // Network or other fetch errors
+                throw DeskFreeError.network(procedure, err);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Validates that a string parameter is non-empty.
+     * Catches invalid inputs before they hit the network.
+     */
+    requireNonEmpty(value, name) {
+        if (!value || value.trim() === '') {
+            throw new DeskFreeError('client', name, `${name} is required and cannot be empty`, `Missing required parameter: ${name}. Please provide a valid value.`);
+        }
+    }
+    /**
+     * Send a typing indicator to the DeskFree conversation.
+     *
+     * @param input - Optional parameters including taskId to scope the indicator
+     */
+    async typing(input) {
+        return this.request('POST', 'messages.typing', input ?? {});
+    }
+    /**
+     * Send a text message (with optional attachments) to a DeskFree conversation.
+     *
+     * @param input - Message content, optional userId, taskId, and attachments
+     */
+    async sendMessage(input) {
+        this.requireNonEmpty(input.content, 'content');
+        return this.request('POST', 'messages.send', input);
+    }
+    /** Fetch paginated message history for a conversation. */
+    async listMessages(input) {
+        if (input.limit !== undefined && (input.limit < 1 || input.limit > 100)) {
+            throw new DeskFreeError('client', 'limit', 'limit must be between 1 and 100', 'The limit parameter must be between 1 and 100.');
+        }
+        return this.request('GET', 'messages.list', input);
+    }
+    /** Obtain a one-time WebSocket authentication ticket for real-time notifications. */
+    async getWsTicket() {
+        return this.request('POST', 'messages.wsTicket', {});
+    }
+    /** Create a new task, optionally with a recurring schedule. */
+    async createTask(input) {
+        this.requireNonEmpty(input.title, 'title');
+        return this.request('POST', 'tasks.create', input);
+    }
+    /** Snooze a task until a given ISO-8601 datetime. */
+    async snoozeTask(input) {
+        this.requireNonEmpty(input.taskId, 'taskId');
+        this.requireNonEmpty(input.snoozedUntil, 'snoozedUntil');
+        return this.request('POST', 'tasks.snooze', input);
+    }
+    /** Unsnooze a previously snoozed task, making it active again. */
+    async unsnoozeTask(input) {
+        this.requireNonEmpty(input.taskId, 'taskId');
+        return this.request('POST', 'tasks.unsnooze', input);
+    }
+    /** List tasks, optionally filtered by status. */
+    async listTasks(input) {
+        return this.request('GET', 'tasks.list', input ?? {});
+    }
+    /** Claim a task so the bot can begin working on it. */
+    async claimTask(input) {
+        this.requireNonEmpty(input.taskId, 'taskId');
+        return this.request('POST', 'tasks.claim', input);
+    }
+    /** Release a previously claimed task back to the queue. */
+    async releaseTask(input) {
+        this.requireNonEmpty(input.taskId, 'taskId');
+        return this.request('POST', 'tasks.release', input);
+    }
+    /** Submit a task for human review, optionally with a comment. */
+    async requestReview(input) {
+        this.requireNonEmpty(input.taskId, 'taskId');
+        return this.request('POST', 'tasks.requestReview', input);
+    }
+    /** Update the deliverable (markdown content) for a task. */
+    async updateDeliverable(input) {
+        this.requireNonEmpty(input.taskId, 'taskId');
+        this.requireNonEmpty(input.deliverable, 'deliverable');
+        return this.request('POST', 'tasks.updateDeliverable', input);
+    }
+    /** Fetch a single task by ID. */
+    async getTask(input) {
+        this.requireNonEmpty(input.taskId, 'taskId');
+        return this.request('GET', 'tasks.get', input);
+    }
+    /** Send an agent status update to DeskFree. */
+    async statusUpdate(input) {
+        return this.request('POST', 'agent.statusUpdate', input);
+    }
+    /** Get short-lived AWS credentials for S3 workspace access. */
+    async workspaceCredentials() {
+        return this.request('POST', 'workspace.credentials', {});
+    }
+    /** Notify DeskFree that workspace files have changed locally. */
+    async workspaceRead(input) {
+        return this.request('GET', 'workspace.read', input);
+    }
+    /**
+     * Lightweight health check that verifies connectivity and authentication.
+     *
+     * @param timeoutMs - Maximum time to wait for the probe response
+     * @returns Probe result indicating success or a descriptive error
+     */
+    async probe(timeoutMs) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(`${this.apiUrl}/tasks.list?input=${encodeURIComponent(JSON.stringify({ limit: 1 }))}`, {
+                method: 'GET',
+                headers: {
+                    Authorization: `Bot ${this.botToken}`,
+                    'Content-Type': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                // Provide more user-friendly probe error messages
+                if (response.status === 401 || response.status === 403) {
+                    return {
+                        ok: false,
+                        error: 'Authentication failed - check bot token',
+                    };
+                }
+                if (response.status >= 500) {
+                    return { ok: false, error: 'DeskFree server unavailable' };
+                }
+                return {
+                    ok: false,
+                    error: `HTTP ${response.status} - ${response.statusText}`,
+                };
+            }
+            return { ok: true };
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                return { ok: false, error: `Connection timeout after ${timeoutMs}ms` };
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            // Simplify network errors for probe results
+            if (message.includes('fetch')) {
+                return { ok: false, error: 'Network connection failed' };
+            }
+            return { ok: false, error: message };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/deliver.d.ts

@@ -0,0 +1,22 @@
+import { DeskFreeClient } from './client';
+import type { ChannelGatewayContext, ChatMessage } from './types';
+/**
+ * Validates if a content type is safe to download.
+ */
+export declare function isContentTypeAllowed(contentType: string): boolean;
+/**
+ * Sanitizes a filename to prevent directory traversal and other security issues.
+ */
+export declare function sanitizeFileName(fileName: string): string;
+/**
+ * Validates a URL to ensure it's a proper HTTPS URL.
+ */
+export declare function validateDownloadUrl(url: string): void;
+/**
+ * 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 declare function deliverMessageToAgent(ctx: ChannelGatewayContext, message: ChatMessage, client: DeskFreeClient): Promise<void>;
+//# sourceMappingURL=deliver.d.ts.map

package/dist/deliver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver.d.ts","sourceRoot":"","sources":["../src/deliver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI1C,OAAO,KAAK,EACV,qBAAqB,EACrB,WAAW,EAGZ,MAAM,SAAS,CAAC;AAuCjB;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA4CrD;AAyKD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAoJf"}