crewly 1.2.3 → 1.2.6

package/dist/backend/backend/src/controllers/cloud/magic-moment/magic-moment.controller.js

@@ -0,0 +1,155 @@
+/**
+ * Magic Moment REST Controller
+ *
+ * Handles anonymous free trial task submissions. No authentication
+ * required — trials are tracked by a client-provided device fingerprint.
+ *
+ * Endpoints:
+ * - POST /api/magic/submit   — Submit an anonymous task (consumes 1 trial)
+ * - GET  /api/magic/status    — Check remaining trials for a fingerprint
+ * - GET  /api/magic/task/:id  — Check task status / result (no auth)
+ *
+ * @module controllers/cloud/magic-moment/magic-moment.controller
+ */
+import { MagicMomentService } from '../../../services/payment/magic-moment.service.js';
+import { CloudTaskService } from '../../../services/cloud/cloud-task.service.js';
+import { CloudFileService } from '../../../services/cloud/cloud-file.service.js';
+import { CLOUD_TASK_TYPES } from '../tasks/cloud-task.types.js';
+import { validateMagicSubmitBody, validateFingerprint, } from '../../../services/payment/magic-moment.types.js';
+import { asyncHandler } from '../../../utils/async-handler.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Anonymous user ID prefix for magic moment tasks. */
+const ANON_USER_PREFIX = 'anon-';
+// ---------------------------------------------------------------------------
+// Handlers
+// ---------------------------------------------------------------------------
+/**
+ * POST /api/magic/submit
+ *
+ * Submit a task anonymously, consuming one free trial.
+ * Requires a device fingerprint in the request body.
+ *
+ * @param req - Request with body: MagicSubmitBody
+ * @param res - Response with MagicSubmitResponse or error
+ */
+export const handleMagicSubmit = asyncHandler(async (req, res) => {
+    const body = req.body;
+    const validationError = validateMagicSubmitBody(body);
+    if (validationError) {
+        res.status(400).json({ success: false, error: validationError });
+        return;
+    }
+    const magicService = MagicMomentService.getInstance();
+    // Check trial availability
+    const availability = await magicService.checkTrialAvailability(body.fingerprint);
+    if (!availability.available) {
+        res.status(429).json({
+            success: false,
+            error: 'Free trial limit reached. Please sign up to continue using the service.',
+            data: availability,
+        });
+        return;
+    }
+    // Create an anonymous user ID from the fingerprint
+    const anonUserId = `${ANON_USER_PREFIX}${body.fingerprint.slice(0, 16)}`;
+    const fileKeys = [];
+    // Handle file upload if provided
+    if (body.fileData && body.fileName && body.fileMimeType) {
+        let buffer;
+        try {
+            buffer = Buffer.from(body.fileData, 'base64');
+        }
+        catch {
+            res.status(400).json({ success: false, error: 'Invalid base64 file data' });
+            return;
+        }
+        const fileService = CloudFileService.getInstance();
+        const uploadResult = await fileService.saveFile(anonUserId, body.fileName.trim(), buffer, body.fileMimeType);
+        if (!uploadResult.success) {
+            res.status(400).json({ success: false, error: uploadResult.error ?? 'File upload failed' });
+            return;
+        }
+        fileKeys.push(uploadResult.fileKey);
+    }
+    // Determine task type
+    const hasImage = body.fileMimeType?.startsWith('image/');
+    const taskType = hasImage ? CLOUD_TASK_TYPES.IMAGE_ANALYSIS : CLOUD_TASK_TYPES.TEXT;
+    // Build prompt
+    const prompt = body.prompt?.trim() || '请分析上传的图片内容并生成摘要';
+    // Create cloud task
+    const taskService = CloudTaskService.getInstance();
+    const task = await taskService.createTask(anonUserId, taskType, prompt, fileKeys);
+    // Consume the trial AFTER task creation succeeds
+    const updatedAvailability = await magicService.consumeTrial(body.fingerprint);
+    res.status(201).json({
+        success: true,
+        data: {
+            taskId: task.id,
+            message: '任务已提交，正在处理中',
+            trialsRemaining: updatedAvailability?.remaining ?? 0,
+        },
+    });
+});
+/**
+ * GET /api/magic/status
+ *
+ * Check remaining free trials for a device fingerprint.
+ * Fingerprint is passed as a query parameter.
+ *
+ * @param req - Request with query: { fingerprint }
+ * @param res - Response with MagicStatusResponse
+ */
+export const handleMagicStatus = asyncHandler(async (req, res) => {
+    const fingerprint = req.query.fingerprint;
+    const fpError = validateFingerprint(fingerprint);
+    if (fpError) {
+        res.status(400).json({ success: false, error: fpError });
+        return;
+    }
+    const magicService = MagicMomentService.getInstance();
+    const availability = await magicService.checkTrialAvailability(fingerprint);
+    res.json({ success: true, data: availability });
+});
+/**
+ * GET /api/magic/task/:taskId
+ *
+ * Check the status of a task submitted via magic moment.
+ * No authentication required — uses anonymous user ID derivation.
+ *
+ * @param req - Request with params: { taskId } and query: { fingerprint }
+ * @param res - Response with task status
+ */
+export const handleMagicTaskStatus = asyncHandler(async (req, res) => {
+    const { taskId } = req.params;
+    const fingerprint = req.query.fingerprint;
+    if (!taskId) {
+        res.status(400).json({ success: false, error: 'taskId is required' });
+        return;
+    }
+    const fpError = validateFingerprint(fingerprint);
+    if (fpError) {
+        res.status(400).json({ success: false, error: fpError });
+        return;
+    }
+    const anonUserId = `${ANON_USER_PREFIX}${fingerprint.slice(0, 16)}`;
+    const taskService = CloudTaskService.getInstance();
+    const task = await taskService.getTask(taskId, anonUserId);
+    if (!task) {
+        res.status(404).json({ success: false, error: 'Task not found' });
+        return;
+    }
+    res.json({
+        success: true,
+        data: {
+            taskId: task.id,
+            status: task.status,
+            result: task.result,
+            error: task.error,
+            createdAt: task.createdAt,
+            updatedAt: task.updatedAt,
+        },
+    });
+});
+//# sourceMappingURL=magic-moment.controller.js.map

package/dist/backend/backend/src/controllers/cloud/magic-moment/magic-moment.controller.js.map

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

package/dist/backend/backend/src/controllers/cloud/magic-moment/magic-moment.routes.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Magic Moment REST Routes
+ *
+ * Router for anonymous free trial endpoints. No authentication required.
+ *
+ * Endpoints:
+ * - POST /submit       — Submit anonymous task (consumes trial)
+ * - GET  /status       — Check remaining trials
+ * - GET  /task/:taskId — Check task result
+ *
+ * @module controllers/cloud/magic-moment/magic-moment.routes
+ */
+import { Router } from 'express';
+/**
+ * Creates the magic moment router with all anonymous trial endpoints.
+ *
+ * All endpoints are public (no auth required):
+ * - POST /submit        — Submit anonymous task
+ * - GET  /status        — Check trial availability
+ * - GET  /task/:taskId  — Get task result
+ *
+ * @returns Express router configured with magic moment routes
+ */
+export declare function createMagicMomentRouter(): Router;
+//# sourceMappingURL=magic-moment.routes.d.ts.map

package/dist/backend/backend/src/controllers/cloud/magic-moment/magic-moment.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-moment.routes.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/magic-moment/magic-moment.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAOjC;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAQhD"}

package/dist/backend/backend/src/controllers/cloud/magic-moment/magic-moment.routes.js

@@ -0,0 +1,32 @@
+/**
+ * Magic Moment REST Routes
+ *
+ * Router for anonymous free trial endpoints. No authentication required.
+ *
+ * Endpoints:
+ * - POST /submit       — Submit anonymous task (consumes trial)
+ * - GET  /status       — Check remaining trials
+ * - GET  /task/:taskId — Check task result
+ *
+ * @module controllers/cloud/magic-moment/magic-moment.routes
+ */
+import { Router } from 'express';
+import { handleMagicSubmit, handleMagicStatus, handleMagicTaskStatus, } from './magic-moment.controller.js';
+/**
+ * Creates the magic moment router with all anonymous trial endpoints.
+ *
+ * All endpoints are public (no auth required):
+ * - POST /submit        — Submit anonymous task
+ * - GET  /status        — Check trial availability
+ * - GET  /task/:taskId  — Get task result
+ *
+ * @returns Express router configured with magic moment routes
+ */
+export function createMagicMomentRouter() {
+    const router = Router();
+    router.post('/submit', handleMagicSubmit);
+    router.get('/status', handleMagicStatus);
+    router.get('/task/:taskId', handleMagicTaskStatus);
+    return router;
+}
+//# sourceMappingURL=magic-moment.routes.js.map

package/dist/backend/backend/src/controllers/cloud/magic-moment/magic-moment.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-moment.routes.js","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/magic-moment/magic-moment.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB;IACtC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC;IAEnD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/backend/backend/src/controllers/cloud/relay.controller.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Relay REST Controller (Client-side only)
+ *
+ * Handles HTTP requests for the relay client lifecycle (connecting
+ * to a remote relay server). Server-side relay management has been
+ * moved to the cloud services repository.
+ *
+ * Client-side endpoints:
+ * - POST /relay/connect    — connect to a remote relay server
+ * - POST /relay/disconnect — disconnect from the relay server
+ * - GET  /relay/devices    — list paired/connected devices
+ * - POST /relay/send       — send a message to the paired peer
+ *
+ * @module controllers/cloud/relay.controller
+ */
+import type { Request, Response, NextFunction } from 'express';
+/**
+ * POST /relay/connect
+ *
+ * Connect the local Crewly instance to a remote relay server as a client.
+ * Initiates WebSocket connection, registration, and waits for pairing.
+ *
+ * @param req - Request with body: { wsUrl, pairingCode, role, token, sharedSecret }
+ * @param res - Response with connection status
+ * @param next - Next function for error propagation
+ */
+export declare function connectToRelay(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /relay/disconnect
+ *
+ * Disconnect the local relay client from the remote relay server.
+ * Closes the WebSocket cleanly and stops heartbeats and reconnection.
+ *
+ * @param req - Express request (no body required)
+ * @param res - Response with disconnection confirmation
+ * @param next - Next function for error propagation
+ */
+export declare function disconnectFromRelay(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * GET /relay/devices
+ *
+ * List connected devices visible through the relay. Returns the local
+ * relay client state.
+ *
+ * @param req - Express request (no params required)
+ * @param res - Response with device list
+ * @param next - Next function for error propagation
+ */
+export declare function getRelayDevices(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /relay/send
+ *
+ * Send an encrypted message to the paired peer via the relay.
+ * The message is encrypted locally using the shared secret before
+ * being forwarded through the relay server.
+ *
+ * @param req - Request with body: { message }
+ * @param res - Response with send confirmation
+ * @param next - Next function for error propagation
+ */
+export declare function sendRelayMessage(req: Request, res: Response, next: NextFunction): Promise<void>;
+//# sourceMappingURL=relay.controller.d.ts.map

package/dist/backend/backend/src/controllers/cloud/relay.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.controller.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/cloud/relay.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAyB/D;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDnG;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBxG;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBpG;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCrG"}

package/dist/backend/backend/src/controllers/cloud/relay.controller.js

@@ -0,0 +1,184 @@
+/**
+ * Relay REST Controller (Client-side only)
+ *
+ * Handles HTTP requests for the relay client lifecycle (connecting
+ * to a remote relay server). Server-side relay management has been
+ * moved to the cloud services repository.
+ *
+ * Client-side endpoints:
+ * - POST /relay/connect    — connect to a remote relay server
+ * - POST /relay/disconnect — disconnect from the relay server
+ * - GET  /relay/devices    — list paired/connected devices
+ * - POST /relay/send       — send a message to the paired peer
+ *
+ * @module controllers/cloud/relay.controller
+ */
+import { RelayClientService } from '../../services/cloud/relay-client.service.js';
+import { LoggerService } from '../../services/core/logger.service.js';
+const logger = LoggerService.getInstance().createComponentLogger('RelayController');
+/** Valid relay node roles for request validation. */
+const VALID_ROLES = new Set(['orchestrator', 'agent']);
+/**
+ * POST /relay/connect
+ *
+ * Connect the local Crewly instance to a remote relay server as a client.
+ * Initiates WebSocket connection, registration, and waits for pairing.
+ *
+ * @param req - Request with body: { wsUrl, pairingCode, role, token, sharedSecret }
+ * @param res - Response with connection status
+ * @param next - Next function for error propagation
+ */
+export async function connectToRelay(req, res, next) {
+    try {
+        const { wsUrl, pairingCode, role, token, sharedSecret } = req.body;
+        if (!wsUrl || !pairingCode || !role || !token || !sharedSecret) {
+            res.status(400).json({
+                success: false,
+                error: 'Missing required parameters: wsUrl, pairingCode, role, token, sharedSecret',
+            });
+            return;
+        }
+        if (!VALID_ROLES.has(role)) {
+            res.status(400).json({
+                success: false,
+                error: `Invalid role: "${role}". Must be "orchestrator" or "agent".`,
+            });
+            return;
+        }
+        const client = RelayClientService.getInstance();
+        const currentState = client.getState();
+        if (currentState !== 'disconnected' && currentState !== 'error') {
+            res.status(409).json({
+                success: false,
+                error: `Relay client is already in "${currentState}" state. Disconnect first.`,
+            });
+            return;
+        }
+        const config = { wsUrl, pairingCode, role, token, sharedSecret };
+        client.connect(config);
+        logger.info('Relay client connecting', { wsUrl, pairingCode, role });
+        res.json({
+            success: true,
+            data: {
+                state: client.getState(),
+                message: 'Relay client connection initiated',
+            },
+        });
+    }
+    catch (error) {
+        logger.error('Failed to connect relay client', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        next(error);
+    }
+}
+/**
+ * POST /relay/disconnect
+ *
+ * Disconnect the local relay client from the remote relay server.
+ * Closes the WebSocket cleanly and stops heartbeats and reconnection.
+ *
+ * @param req - Express request (no body required)
+ * @param res - Response with disconnection confirmation
+ * @param next - Next function for error propagation
+ */
+export async function disconnectFromRelay(req, res, next) {
+    try {
+        const client = RelayClientService.getInstance();
+        const previousState = client.getState();
+        client.disconnect();
+        logger.info('Relay client disconnected', { previousState });
+        res.json({
+            success: true,
+            data: {
+                previousState,
+                state: client.getState(),
+                message: 'Relay client disconnected',
+            },
+        });
+    }
+    catch (error) {
+        logger.error('Failed to disconnect relay client', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        next(error);
+    }
+}
+/**
+ * GET /relay/devices
+ *
+ * List connected devices visible through the relay. Returns the local
+ * relay client state.
+ *
+ * @param req - Express request (no params required)
+ * @param res - Response with device list
+ * @param next - Next function for error propagation
+ */
+export async function getRelayDevices(req, res, next) {
+    try {
+        const client = RelayClientService.getInstance();
+        const clientInfo = {
+            state: client.getState(),
+            sessionId: client.getSessionId(),
+        };
+        res.json({
+            success: true,
+            data: {
+                client: clientInfo,
+            },
+        });
+    }
+    catch (error) {
+        logger.error('Failed to get relay devices', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        next(error);
+    }
+}
+/**
+ * POST /relay/send
+ *
+ * Send an encrypted message to the paired peer via the relay.
+ * The message is encrypted locally using the shared secret before
+ * being forwarded through the relay server.
+ *
+ * @param req - Request with body: { message }
+ * @param res - Response with send confirmation
+ * @param next - Next function for error propagation
+ */
+export async function sendRelayMessage(req, res, next) {
+    try {
+        const { message } = req.body;
+        if (typeof message !== 'string' || message.length === 0) {
+            res.status(400).json({
+                success: false,
+                error: 'Missing or empty required parameter: message',
+            });
+            return;
+        }
+        const client = RelayClientService.getInstance();
+        if (client.getState() !== 'paired') {
+            res.status(409).json({
+                success: false,
+                error: `Cannot send — relay client is in "${client.getState()}" state, must be "paired".`,
+            });
+            return;
+        }
+        client.send(message);
+        logger.info('Relay message sent', { messageLength: message.length });
+        res.json({
+            success: true,
+            data: {
+                sent: true,
+                messageLength: message.length,
+            },
+        });
+    }
+    catch (error) {
+        logger.error('Failed to send relay message', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        next(error);
+    }
+}
+//# sourceMappingURL=relay.controller.js.map

package/dist/backend/backend/src/controllers/cloud/relay.controller.js.map

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

package/dist/backend/backend/src/controllers/cloud/relay.routes.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Relay REST Routes
+ *
+ * Router configuration for relay client endpoints.
+ * Server-side relay management has been moved to the cloud services repository.
+ *
+ * Client-side endpoints (require cloud connection + Pro plan):
+ * - POST /connect     - Connect to a remote relay server
+ * - POST /disconnect  - Disconnect from the relay server
+ * - GET  /devices     - List paired/connected devices
+ * - POST /send        - Send a message to the paired peer
+ *
+ * @module controllers/cloud/relay.routes
+ */
+import { Router } from 'express';
+/**
+ * Creates the relay router with client-side relay endpoints.
+ *
+ * All endpoints require a cloud connection and a Pro plan,
+ * since Cloud Relay is a paid feature.
+ *
+ * @returns Express router configured with relay routes
+ */
+export declare function createRelayRouter(): Router;
+//# sourceMappingURL=relay.routes.d.ts.map

package/dist/backend/backend/src/controllers/cloud/relay.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.routes.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/cloud/relay.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AASjC;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C"}

package/dist/backend/backend/src/controllers/cloud/relay.routes.js

@@ -0,0 +1,34 @@
+/**
+ * Relay REST Routes
+ *
+ * Router configuration for relay client endpoints.
+ * Server-side relay management has been moved to the cloud services repository.
+ *
+ * Client-side endpoints (require cloud connection + Pro plan):
+ * - POST /connect     - Connect to a remote relay server
+ * - POST /disconnect  - Disconnect from the relay server
+ * - GET  /devices     - List paired/connected devices
+ * - POST /send        - Send a message to the paired peer
+ *
+ * @module controllers/cloud/relay.routes
+ */
+import { Router } from 'express';
+import { connectToRelay, disconnectFromRelay, getRelayDevices, sendRelayMessage, } from './relay.controller.js';
+import { requireCloudConnection, requireTier } from '../../services/cloud/cloud-auth.middleware.js';
+/**
+ * Creates the relay router with client-side relay endpoints.
+ *
+ * All endpoints require a cloud connection and a Pro plan,
+ * since Cloud Relay is a paid feature.
+ *
+ * @returns Express router configured with relay routes
+ */
+export function createRelayRouter() {
+    const router = Router();
+    router.post('/connect', requireCloudConnection, requireTier('pro'), connectToRelay);
+    router.post('/disconnect', requireCloudConnection, requireTier('pro'), disconnectFromRelay);
+    router.get('/devices', requireCloudConnection, requireTier('pro'), getRelayDevices);
+    router.post('/send', requireCloudConnection, requireTier('pro'), sendRelayMessage);
+    return router;
+}
+//# sourceMappingURL=relay.routes.js.map

package/dist/backend/backend/src/controllers/cloud/relay.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.routes.js","sourceRoot":"","sources":["../../../../../../backend/src/controllers/cloud/relay.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAEpG;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC;IACpF,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,sBAAsB,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAC5F,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,sBAAsB,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC;IACpF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,sBAAsB,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAEnF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/backend/backend/src/controllers/cloud/tasks/cloud-task.controller.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Cloud Task REST Controller
+ *
+ * Handles CRUD endpoints for cloud AI employee tasks:
+ * submit tasks, get status, list history.
+ *
+ * All endpoints require Supabase authentication.
+ *
+ * @module controllers/cloud/tasks/cloud-task.controller
+ */
+import type { Request, Response } from 'express';
+/**
+ * POST /api/cloud/tasks
+ *
+ * Create a new cloud task. The task is queued for processing
+ * by the cloud AI runtime.
+ *
+ * @param req - Request with body: { type, prompt, files? }
+ * @param res - Response with { success, data: CloudTask }
+ */
+export declare const handleCreateCloudTask: (req: Request, res: Response, next: import("express").NextFunction) => Promise<void>;
+/**
+ * GET /api/cloud/tasks/:taskId
+ *
+ * Get a single task by ID. Only the task owner can view it.
+ *
+ * @param req - Request with params: { taskId }
+ * @param res - Response with { success, data: CloudTask }
+ */
+export declare const handleGetCloudTask: (req: Request, res: Response, next: import("express").NextFunction) => Promise<void>;
+/**
+ * GET /api/cloud/tasks
+ *
+ * List tasks for the authenticated user with optional filters.
+ *
+ * @param req - Request with query: { status?, limit?, offset? }
+ * @param res - Response with { success, data: { tasks, total } }
+ */
+export declare const handleListCloudTasks: (req: Request, res: Response, next: import("express").NextFunction) => Promise<void>;
+/**
+ * GET /api/cloud/tasks/stats
+ *
+ * Get queue statistics (count by status). Admin/debugging endpoint.
+ *
+ * @param req - Authenticated request
+ * @param res - Response with { success, data: Record<status, count> }
+ */
+export declare const handleGetCloudTaskStats: (req: Request, res: Response, next: import("express").NextFunction) => Promise<void>;
+//# sourceMappingURL=cloud-task.controller.d.ts.map

package/dist/backend/backend/src/controllers/cloud/tasks/cloud-task.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-task.controller.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/tasks/cloud-task.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAWjD;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,sFAwDhC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,sFAkB7B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,sFAkC/B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,sFAIlC,CAAC"}