@chaaskit/server 0.1.0

package/dist/queue/handlers/scheduled-prompt.js

@@ -0,0 +1,270 @@
+/**
+ * Scheduled Prompt Job Handlers
+ *
+ * Handles execution and notification of scheduled prompts (automations).
+ */
+import { db } from '@chaaskit/db';
+import { registerJobHandler } from '../index.js';
+import { createAgentService } from '../../services/agent.js';
+import { getAgentById, getDefaultAgent, toAgentConfig, isBuiltInAgent } from '../../services/agents.js';
+import { sendEmail, isEmailEnabled } from '../../services/email/index.js';
+import { getConfig } from '../../config/loader.js';
+import { getQueueProvider } from '../index.js';
+/**
+ * scheduled-prompt:execute
+ *
+ * Executes a scheduled prompt:
+ * 1. Loads the ScheduledPrompt with user/team context
+ * 2. Gets or creates the dedicated thread
+ * 3. Creates user message with the prompt
+ * 4. Runs the agent and collects the response
+ * 5. Saves the assistant message
+ * 6. Updates tracking (lastRunAt, runCount)
+ * 7. Enqueues notification job
+ */
+registerJobHandler('scheduled-prompt:execute', async (job, ctx) => {
+    const { scheduledPromptId } = job.payload;
+    const startTime = Date.now();
+    ctx.log(`Executing scheduled prompt: ${scheduledPromptId}`);
+    // 1. Load the scheduled prompt
+    const prompt = await db.scheduledPrompt.findUnique({
+        where: { id: scheduledPromptId },
+        include: {
+            thread: true,
+            user: true,
+            team: {
+                include: {
+                    slackIntegration: true,
+                },
+            },
+        },
+    });
+    if (!prompt) {
+        throw new Error(`Scheduled prompt not found: ${scheduledPromptId}`);
+    }
+    if (!prompt.enabled) {
+        ctx.log('Scheduled prompt is disabled, skipping execution');
+        return;
+    }
+    ctx.log(`Running prompt: "${prompt.name}"`);
+    try {
+        // 2. Get or create dedicated thread
+        let thread = prompt.thread;
+        if (!thread) {
+            thread = await db.thread.create({
+                data: {
+                    title: `[Auto] ${prompt.name}`,
+                    userId: prompt.userId,
+                    teamId: prompt.teamId,
+                    agentId: prompt.agentId,
+                },
+            });
+            // Update the scheduled prompt with the new thread
+            await db.scheduledPrompt.update({
+                where: { id: scheduledPromptId },
+                data: { threadId: thread.id },
+            });
+            ctx.log(`Created new thread: ${thread.id}`);
+        }
+        // 3. Create user message
+        await db.message.create({
+            data: {
+                threadId: thread.id,
+                role: 'user',
+                content: prompt.prompt,
+            },
+        });
+        // 4. Get agent and run
+        const agent = prompt.agentId
+            ? getAgentById(prompt.agentId)
+            : getDefaultAgent();
+        if (!agent) {
+            throw new Error(`Agent not found: ${prompt.agentId || 'default'}`);
+        }
+        const agentConfig = toAgentConfig(agent);
+        const agentService = createAgentService(agentConfig);
+        // Get system prompt
+        let systemPrompt = 'You are a helpful assistant.';
+        if (isBuiltInAgent(agent)) {
+            systemPrompt = agent.systemPrompt;
+        }
+        // Add team context if applicable
+        let teamContext = null;
+        if (prompt.team?.context) {
+            teamContext = prompt.team.context;
+        }
+        // Load thread messages for context
+        const messages = await db.message.findMany({
+            where: { threadId: thread.id },
+            orderBy: { createdAt: 'asc' },
+        });
+        const chatMessages = messages.map((m) => ({
+            role: m.role,
+            content: m.content,
+        }));
+        // Run agent
+        let result = '';
+        let inputTokens = 0;
+        let outputTokens = 0;
+        ctx.log('Running agent...');
+        for await (const chunk of agentService.chat(chatMessages, {
+            systemPrompt,
+            teamContext,
+        })) {
+            if (chunk.type === 'text' && chunk.content) {
+                result += chunk.content;
+            }
+            else if (chunk.type === 'usage' && chunk.usage) {
+                inputTokens = chunk.usage.inputTokens;
+                outputTokens = chunk.usage.outputTokens;
+            }
+        }
+        ctx.log(`Agent response: ${result.length} chars, ${inputTokens} in / ${outputTokens} out`);
+        // 5. Save assistant message
+        await db.message.create({
+            data: {
+                threadId: thread.id,
+                role: 'assistant',
+                content: result,
+                inputTokens,
+                outputTokens,
+            },
+        });
+        const runDuration = Date.now() - startTime;
+        // 6. Update tracking
+        await db.scheduledPrompt.update({
+            where: { id: scheduledPromptId },
+            data: {
+                lastRunAt: new Date(),
+                lastRunStatus: 'success',
+                lastError: null,
+                runCount: { increment: 1 },
+            },
+        });
+        // 7. Enqueue notification
+        if (prompt.notifySlack || prompt.notifyEmail) {
+            const queue = getQueueProvider();
+            await queue.enqueue('scheduled-prompt:notify', {
+                scheduledPromptId,
+                threadId: thread.id,
+                result,
+                runDuration,
+            });
+            ctx.log('Notification job enqueued');
+        }
+        ctx.log(`Completed in ${runDuration}ms`);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Update tracking with failure
+        await db.scheduledPrompt.update({
+            where: { id: scheduledPromptId },
+            data: {
+                lastRunAt: new Date(),
+                lastRunStatus: 'failed',
+                lastError: errorMessage,
+            },
+        });
+        throw error;
+    }
+}, 'Execute scheduled prompt and store result');
+/**
+ * scheduled-prompt:notify
+ *
+ * Sends notifications after a scheduled prompt completes:
+ * 1. Slack notification (if enabled and team has integration)
+ * 2. Email notification (if enabled and recipients configured)
+ */
+registerJobHandler('scheduled-prompt:notify', async (job, ctx) => {
+    const { scheduledPromptId, threadId, result, runDuration } = job.payload;
+    ctx.log(`Sending notifications for scheduled prompt: ${scheduledPromptId}`);
+    // Load prompt with team and slack integration
+    const prompt = await db.scheduledPrompt.findUnique({
+        where: { id: scheduledPromptId },
+        include: {
+            user: true,
+            team: {
+                include: {
+                    slackIntegration: true,
+                },
+            },
+        },
+    });
+    if (!prompt) {
+        throw new Error(`Scheduled prompt not found: ${scheduledPromptId}`);
+    }
+    const config = getConfig();
+    const appUrl = config.app.url;
+    const appName = config.app.name;
+    const threadUrl = `${appUrl}/chat/${threadId}`;
+    // Helper to truncate text
+    const truncate = (text, maxLength) => {
+        if (text.length <= maxLength)
+            return text;
+        return text.slice(0, maxLength - 3) + '...';
+    };
+    // Slack notification
+    if (prompt.notifySlack && prompt.team?.slackIntegration) {
+        try {
+            const { SlackClient } = await import('../../services/slack/client.js');
+            const integration = prompt.team.slackIntegration;
+            if (integration.status === 'active' && integration.notificationChannel) {
+                const client = SlackClient.fromEncrypted(integration.encryptedTokens);
+                const message = [
+                    `*${prompt.name}* completed in ${(runDuration / 1000).toFixed(1)}s`,
+                    '',
+                    truncate(result, 500),
+                    '',
+                    `<${threadUrl}|View full thread>`,
+                ].join('\n');
+                await client.postMessage(integration.notificationChannel, message);
+                ctx.log('Slack notification sent');
+            }
+        }
+        catch (error) {
+            ctx.log(`Slack notification failed: ${error instanceof Error ? error.message : error}`);
+            // Don't throw - continue with email
+        }
+    }
+    // Email notification
+    if (prompt.notifyEmail && prompt.emailRecipients && isEmailEnabled()) {
+        try {
+            const emails = JSON.parse(prompt.emailRecipients);
+            for (const email of emails) {
+                await sendEmail({
+                    to: email,
+                    subject: `[${appName}] ${prompt.name} completed`,
+                    html: `
+              <div style="font-family: sans-serif; max-width: 600px; margin: 0 auto;">
+                <h2>${prompt.name}</h2>
+                <p style="color: #666;">Completed in ${(runDuration / 1000).toFixed(1)} seconds</p>
+
+                <div style="background: #f5f5f5; padding: 16px; border-radius: 8px; margin: 16px 0;">
+                  <pre style="white-space: pre-wrap; word-break: break-word; margin: 0;">${truncate(result, 1000)}</pre>
+                </div>
+
+                <p>
+                  <a href="${threadUrl}" style="display: inline-block; background: #4f46e5; color: white; padding: 8px 16px; text-decoration: none; border-radius: 4px;">
+                    View Full Thread
+                  </a>
+                </p>
+
+                <p style="color: #999; font-size: 12px; margin-top: 32px;">
+                  This email was sent by ${appName}.
+                  <a href="${appUrl}/automations">Manage automations</a>
+                </p>
+              </div>
+            `,
+                    text: `${prompt.name} completed in ${(runDuration / 1000).toFixed(1)} seconds\n\n${truncate(result, 1000)}\n\nView thread: ${threadUrl}`,
+                });
+                ctx.log(`Email sent to ${email}`);
+            }
+        }
+        catch (error) {
+            ctx.log(`Email notification failed: ${error instanceof Error ? error.message : error}`);
+            throw error;
+        }
+    }
+    ctx.log('Notifications complete');
+}, 'Send notifications for completed scheduled prompt');
+//# sourceMappingURL=scheduled-prompt.js.map

package/dist/queue/handlers/scheduled-prompt.js.map

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

package/dist/queue/index.js

@@ -0,0 +1,91 @@
+import { MemoryQueueProvider } from './providers/memory.js';
+export * from './types.js';
+// Re-export handlers
+export { registerJobHandler, getJobHandler, hasJobHandler, getRegisteredJobTypes, unregisterJobHandler, clearJobHandlers, executeJob, } from './handlers/index.js';
+// Re-export worker
+export { Worker, startWorker, stopWorker, getWorker, resetWorker, } from './worker.js';
+// Re-export scheduler
+export { Scheduler, startScheduler, stopScheduler, getScheduler, resetScheduler, } from './scheduler.js';
+let queueProvider = null;
+/**
+ * Get default queue provider config for development
+ */
+export function getDefaultProviderConfig() {
+    return {
+        type: 'memory',
+        maxHistorySize: 1000,
+    };
+}
+/**
+ * Create a queue provider based on configuration.
+ * Uses dynamic imports for optional dependencies (SQS SDK only loaded if needed).
+ */
+export async function createQueueProvider(config) {
+    switch (config.type) {
+        case 'memory':
+            return new MemoryQueueProvider(config);
+        case 'sqs':
+            // Dynamic import - @aws-sdk/client-sqs is optional peer dependency
+            try {
+                const { SQSQueueProvider } = await import('./providers/sqs.js');
+                return new SQSQueueProvider(config);
+            }
+            catch (e) {
+                if (e.code === 'ERR_MODULE_NOT_FOUND') {
+                    throw new Error('SQS provider requires @aws-sdk/client-sqs. Install it with: pnpm add @aws-sdk/client-sqs');
+                }
+                throw e;
+            }
+        default:
+            throw new Error(`Unknown queue provider type: ${config.type}`);
+    }
+}
+/**
+ * Get or create the queue provider singleton.
+ * Must be initialized with initializeQueueProvider() first, or returns a memory provider.
+ */
+export function getQueueProvider() {
+    if (!queueProvider) {
+        // Default to memory provider if not initialized
+        console.warn('[Queue] Provider not initialized, using default memory provider');
+        queueProvider = new MemoryQueueProvider({ type: 'memory' });
+    }
+    return queueProvider;
+}
+/**
+ * Initialize the queue provider singleton.
+ * Call this during server startup with the app's queue config.
+ */
+export async function initializeQueueProvider(config) {
+    if (queueProvider) {
+        console.warn('[Queue] Provider already initialized');
+        return queueProvider;
+    }
+    if (!config.enabled) {
+        console.log('[Queue] Queue system is disabled');
+        // Return a no-op provider that just logs
+        queueProvider = new MemoryQueueProvider({ type: 'memory' });
+        return queueProvider;
+    }
+    console.log(`[Queue] Initializing ${config.providerConfig.type} provider...`);
+    queueProvider = await createQueueProvider(config.providerConfig);
+    console.log(`[Queue] ${queueProvider.name} provider initialized`);
+    return queueProvider;
+}
+/**
+ * Close and reset the queue provider (for testing or shutdown)
+ */
+export async function closeQueueProvider() {
+    if (queueProvider) {
+        await queueProvider.close();
+        queueProvider = null;
+        console.log('[Queue] Provider closed');
+    }
+}
+/**
+ * Reset the queue provider singleton (for testing)
+ */
+export function resetQueueProvider() {
+    queueProvider = null;
+}
+//# sourceMappingURL=index.js.map

package/dist/queue/index.js.map

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

package/dist/queue/providers/memory.js

@@ -0,0 +1,296 @@
+import { EventEmitter } from 'events';
+import { randomUUID } from 'crypto';
+/**
+ * In-memory queue provider for development and testing.
+ * Uses EventEmitter for instant notification when jobs are enqueued.
+ */
+export class MemoryQueueProvider {
+    name = 'memory';
+    jobs = new Map();
+    pendingQueue = []; // Job IDs in order
+    completedHistory = [];
+    maxHistorySize;
+    emitter;
+    deduplicationKeys = new Map(); // dedupKey -> jobId
+    closed = false;
+    constructor(config) {
+        this.maxHistorySize = config.maxHistorySize ?? 1000;
+        this.emitter = new EventEmitter();
+        this.emitter.setMaxListeners(100); // Allow many concurrent receivers
+    }
+    async enqueue(type, payload, options) {
+        if (this.closed) {
+            throw new Error('Queue provider is closed');
+        }
+        // Check deduplication
+        if (options?.deduplicationKey) {
+            const existingJobId = this.deduplicationKeys.get(options.deduplicationKey);
+            if (existingJobId) {
+                const existingJob = this.jobs.get(existingJobId);
+                if (existingJob && !['completed', 'failed', 'dead'].includes(existingJob.status)) {
+                    // Return existing job instead of creating duplicate
+                    return existingJob;
+                }
+                // Clean up old dedup key if job is done
+                this.deduplicationKeys.delete(options.deduplicationKey);
+            }
+        }
+        const now = new Date();
+        const jobOptions = {
+            maxRetries: options?.maxRetries ?? 3,
+            timeout: options?.timeout ?? 30000,
+            priority: options?.priority ?? 0,
+            deduplicationKey: options?.deduplicationKey,
+        };
+        // Calculate when job becomes visible
+        let visibleAt = now;
+        let status = 'pending';
+        let scheduledFor;
+        if (options?.scheduledFor) {
+            visibleAt = options.scheduledFor;
+            scheduledFor = options.scheduledFor;
+            status = 'scheduled';
+        }
+        else if (options?.delay) {
+            visibleAt = new Date(now.getTime() + options.delay);
+            scheduledFor = visibleAt;
+            status = options.delay > 0 ? 'scheduled' : 'pending';
+        }
+        const job = {
+            id: randomUUID(),
+            type,
+            payload,
+            options: jobOptions,
+            status,
+            attempts: 0,
+            createdAt: now,
+            scheduledFor,
+            visibleAt,
+        };
+        this.jobs.set(job.id, job);
+        if (options?.deduplicationKey) {
+            this.deduplicationKeys.set(options.deduplicationKey, job.id);
+        }
+        // Add to pending queue based on visibility
+        if (status === 'pending') {
+            this.insertIntoQueue(job.id);
+            // Emit event to wake up any waiting receivers
+            this.emitter.emit('job');
+        }
+        else {
+            // Schedule for later
+            const delay = visibleAt.getTime() - now.getTime();
+            setTimeout(() => {
+                const j = this.jobs.get(job.id);
+                if (j && j.status === 'scheduled') {
+                    j.status = 'pending';
+                    this.insertIntoQueue(job.id);
+                    this.emitter.emit('job');
+                }
+            }, delay);
+        }
+        // Return job without internal fields
+        return this.toPublicJob(job);
+    }
+    async receive(maxMessages = 1, waitTimeSeconds = 20) {
+        if (this.closed) {
+            return [];
+        }
+        const jobs = this.getVisibleJobs(maxMessages);
+        if (jobs.length > 0) {
+            return jobs;
+        }
+        // Wait for jobs to arrive
+        return new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                this.emitter.removeListener('job', onJob);
+                resolve([]);
+            }, waitTimeSeconds * 1000);
+            const onJob = () => {
+                const jobs = this.getVisibleJobs(maxMessages);
+                if (jobs.length > 0) {
+                    clearTimeout(timeout);
+                    this.emitter.removeListener('job', onJob);
+                    resolve(jobs);
+                }
+            };
+            this.emitter.on('job', onJob);
+            // Check if closed while waiting
+            const onClose = () => {
+                clearTimeout(timeout);
+                this.emitter.removeListener('job', onJob);
+                this.emitter.removeListener('close', onClose);
+                resolve([]);
+            };
+            this.emitter.once('close', onClose);
+        });
+    }
+    getVisibleJobs(maxMessages) {
+        const now = new Date();
+        const results = [];
+        const toRemove = [];
+        for (let i = 0; i < this.pendingQueue.length && results.length < maxMessages; i++) {
+            const jobId = this.pendingQueue[i];
+            const job = this.jobs.get(jobId);
+            if (!job) {
+                toRemove.push(i);
+                continue;
+            }
+            if (job.status !== 'pending' || job.visibleAt > now) {
+                continue;
+            }
+            // Mark as processing and create receipt handle
+            const receiptHandle = randomUUID();
+            job.status = 'processing';
+            job.receiptHandle = receiptHandle;
+            job.startedAt = now;
+            job.attempts += 1;
+            toRemove.push(i);
+            results.push({
+                ...this.toPublicJob(job),
+                receiptHandle,
+            });
+        }
+        // Remove processed jobs from queue (in reverse to maintain indices)
+        for (let i = toRemove.length - 1; i >= 0; i--) {
+            this.pendingQueue.splice(toRemove[i], 1);
+        }
+        return results;
+    }
+    async acknowledge(receiptHandle) {
+        const job = this.findByReceiptHandle(receiptHandle);
+        if (!job) {
+            throw new Error(`Job not found for receipt handle: ${receiptHandle}`);
+        }
+        job.status = 'completed';
+        job.completedAt = new Date();
+        delete job.receiptHandle;
+        // Add to completed history
+        this.completedHistory.push(job.id);
+        this.trimHistory();
+        // Clean up deduplication key
+        if (job.options.deduplicationKey) {
+            this.deduplicationKeys.delete(job.options.deduplicationKey);
+        }
+    }
+    async fail(receiptHandle, error) {
+        const job = this.findByReceiptHandle(receiptHandle);
+        if (!job) {
+            throw new Error(`Job not found for receipt handle: ${receiptHandle}`);
+        }
+        job.lastError = error.message;
+        delete job.receiptHandle;
+        if (job.attempts >= job.options.maxRetries) {
+            // No more retries, mark as dead
+            job.status = 'dead';
+            job.completedAt = new Date();
+            // Clean up deduplication key
+            if (job.options.deduplicationKey) {
+                this.deduplicationKeys.delete(job.options.deduplicationKey);
+            }
+        }
+        else {
+            // Requeue with exponential backoff
+            const backoffMs = Math.min(1000 * Math.pow(2, job.attempts), 60000);
+            job.status = 'pending';
+            job.visibleAt = new Date(Date.now() + backoffMs);
+            setTimeout(() => {
+                if (job.status === 'pending') {
+                    this.insertIntoQueue(job.id);
+                    this.emitter.emit('job');
+                }
+            }, backoffMs);
+        }
+    }
+    async getJob(jobId) {
+        const job = this.jobs.get(jobId);
+        return job ? this.toPublicJob(job) : null;
+    }
+    async getStats() {
+        let pending = 0;
+        let processing = 0;
+        let completed = 0;
+        let failed = 0;
+        let dead = 0;
+        let scheduled = 0;
+        for (const job of this.jobs.values()) {
+            switch (job.status) {
+                case 'pending':
+                    pending++;
+                    break;
+                case 'scheduled':
+                    scheduled++;
+                    break;
+                case 'processing':
+                    processing++;
+                    break;
+                case 'completed':
+                    completed++;
+                    break;
+                case 'failed':
+                    failed++;
+                    break;
+                case 'dead':
+                    dead++;
+                    break;
+            }
+        }
+        return { pending, processing, completed, failed, dead, scheduled };
+    }
+    async close() {
+        this.closed = true;
+        this.emitter.emit('close');
+        this.emitter.removeAllListeners();
+    }
+    findByReceiptHandle(receiptHandle) {
+        for (const job of this.jobs.values()) {
+            if (job.receiptHandle === receiptHandle) {
+                return job;
+            }
+        }
+        return undefined;
+    }
+    insertIntoQueue(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job)
+            return;
+        // Insert by priority (lower = higher priority)
+        let insertIndex = this.pendingQueue.length;
+        for (let i = 0; i < this.pendingQueue.length; i++) {
+            const existingJob = this.jobs.get(this.pendingQueue[i]);
+            if (existingJob && job.options.priority < existingJob.options.priority) {
+                insertIndex = i;
+                break;
+            }
+        }
+        this.pendingQueue.splice(insertIndex, 0, jobId);
+    }
+    trimHistory() {
+        // Remove oldest completed jobs if we exceed maxHistorySize
+        while (this.completedHistory.length > this.maxHistorySize) {
+            const oldJobId = this.completedHistory.shift();
+            if (oldJobId) {
+                const job = this.jobs.get(oldJobId);
+                if (job && job.status === 'completed') {
+                    this.jobs.delete(oldJobId);
+                }
+            }
+        }
+    }
+    toPublicJob(job) {
+        return {
+            id: job.id,
+            type: job.type,
+            payload: job.payload,
+            options: job.options,
+            status: job.status,
+            attempts: job.attempts,
+            createdAt: job.createdAt,
+            scheduledFor: job.scheduledFor,
+            startedAt: job.startedAt,
+            completedAt: job.completedAt,
+            lastError: job.lastError,
+        };
+    }
+}
+//# sourceMappingURL=memory.js.map