@agent-relay/cloud 0.1.0

package/dist/services/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Cloud Services Index
+ *
+ * Exports all cloud-side services for easy importing.
+ */
+export { ScalingPolicyService, type ScalingThresholds, type ScalingPolicy, type ScalingCondition, type ScalingAction, type ScalingDecision, type UserScalingContext, type WorkspaceMetrics, getScalingPolicyService, } from './scaling-policy.js';
+export { AutoScaler, type AutoScalerConfig, type ScalingOperation, type MetricsSnapshot, getAutoScaler, createAutoScaler, } from './auto-scaler.js';
+export { CapacityManager, type CapacityManagerConfig, type WorkspaceCapacity, type PlacementRecommendation, type CapacitySnapshot, type CapacityForecast, getCapacityManager, createCapacityManager, } from './capacity-manager.js';
+export { ScalingOrchestrator, type OrchestratorConfig, type ScalingEvent, getScalingOrchestrator, createScalingOrchestrator, } from './scaling-orchestrator.js';
+export { spawnCIFixAgent, notifyAgentOfCIFailure, completeFixAttempt, getFailureHistory, getPRFailureHistory, } from './ci-agent-spawner.js';
+export { handleMention, handleIssueAssignment, getPendingMentions, getPendingIssueAssignments, processPendingMentions, processPendingIssueAssignments, KNOWN_AGENTS, isKnownAgent, } from './mention-handler.js';
+export { ComputeEnforcementService, type ComputeEnforcementConfig, type EnforcementResult, getComputeEnforcementService, createComputeEnforcementService, } from './compute-enforcement.js';
+export { IntroExpirationService, type IntroExpirationConfig, type IntroStatus, type ExpirationResult as IntroExpirationResult, INTRO_PERIOD_DAYS, DESTROY_GRACE_PERIOD_DAYS, getIntroStatus, getIntroExpirationService, startIntroExpirationService, stopIntroExpirationService, } from './intro-expiration.js';
+export { WorkspaceKeepaliveService, type WorkspaceKeepaliveConfig, type KeepaliveStats, getWorkspaceKeepaliveService, createWorkspaceKeepaliveService, } from './workspace-keepalive.js';
+export { registerUserPresence, unregisterUserPresence, updateUserLastSeen, isUserOnline, getOnlineUser, getOnlineUsers, getOnlineUsersForDiscovery, clearAllPresence, type PresenceUserInfo, } from './presence-registry.js';
+export { cloudMessageBus, type CloudMessage, } from './cloud-message-bus.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,8BAA8B,EAC9B,YAAY,EACZ,YAAY,GACb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,yBAAyB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,gBAAgB,IAAI,qBAAqB,EAC9C,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,yBAAyB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,0BAA0B,EAC1B,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,eAAe,EACf,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,25 @@
+/**
+ * Cloud Services Index
+ *
+ * Exports all cloud-side services for easy importing.
+ */
+// Scaling infrastructure
+export { ScalingPolicyService, getScalingPolicyService, } from './scaling-policy.js';
+export { AutoScaler, getAutoScaler, createAutoScaler, } from './auto-scaler.js';
+export { CapacityManager, getCapacityManager, createCapacityManager, } from './capacity-manager.js';
+export { ScalingOrchestrator, getScalingOrchestrator, createScalingOrchestrator, } from './scaling-orchestrator.js';
+// CI failure handling
+export { spawnCIFixAgent, notifyAgentOfCIFailure, completeFixAttempt, getFailureHistory, getPRFailureHistory, } from './ci-agent-spawner.js';
+// Issue and mention handling
+export { handleMention, handleIssueAssignment, getPendingMentions, getPendingIssueAssignments, processPendingMentions, processPendingIssueAssignments, KNOWN_AGENTS, isKnownAgent, } from './mention-handler.js';
+// Compute enforcement (free tier limits)
+export { ComputeEnforcementService, getComputeEnforcementService, createComputeEnforcementService, } from './compute-enforcement.js';
+// Intro expiration (auto-resize/destroy after free tier intro period)
+export { IntroExpirationService, INTRO_PERIOD_DAYS, DESTROY_GRACE_PERIOD_DAYS, getIntroStatus, getIntroExpirationService, startIntroExpirationService, stopIntroExpirationService, } from './intro-expiration.js';
+// Workspace keepalive (prevent Fly.io from idling machines with active agents)
+export { WorkspaceKeepaliveService, getWorkspaceKeepaliveService, createWorkspaceKeepaliveService, } from './workspace-keepalive.js';
+// Presence registry (shared registry for tracking online users)
+export { registerUserPresence, unregisterUserPresence, updateUserLastSeen, isUserOnline, getOnlineUser, getOnlineUsers, getOnlineUsersForDiscovery, clearAllPresence, } from './presence-registry.js';
+// Cloud message bus (event-based message delivery for cloud users)
+export { cloudMessageBus, } from './cloud-message-bus.js';
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yBAAyB;AACzB,OAAO,EACL,oBAAoB,EAQpB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EAIV,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EAMf,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,mBAAmB,EAGnB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,sBAAsB;AACtB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,6BAA6B;AAC7B,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,8BAA8B,EAC9B,YAAY,EACZ,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,yCAAyC;AACzC,OAAO,EACL,yBAAyB,EAGzB,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,0BAA0B,CAAC;AAElC,sEAAsE;AACtE,OAAO,EACL,sBAAsB,EAItB,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,+EAA+E;AAC/E,OAAO,EACL,yBAAyB,EAGzB,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,0BAA0B,CAAC;AAElC,gEAAgE;AAChE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,0BAA0B,EAC1B,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC;AAEhC,mEAAmE;AACnE,OAAO,EACL,eAAe,GAEhB,MAAM,wBAAwB,CAAC"}

package/dist/services/intro-expiration.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Intro Expiration Service
+ *
+ * Handles auto-resize and auto-destroy of free tier workspaces:
+ * 1. Resize: Free users get Pro-level resources (2 CPU / 4GB) for the first 14 days,
+ *    then get automatically downsized to standard free tier (1 CPU / 2GB).
+ * 2. Destroy: Free workspaces inactive for 7+ days after intro expires get auto-destroyed
+ *    to prevent ongoing infrastructure costs for churned users.
+ */
+export declare const INTRO_PERIOD_DAYS = 14;
+export declare const DESTROY_GRACE_PERIOD_DAYS = 7;
+export interface IntroExpirationConfig {
+    enabled: boolean;
+    checkIntervalMs: number;
+}
+export interface IntroStatus {
+    isIntroPeriod: boolean;
+    daysRemaining: number;
+    introPeriodDays: number;
+    expiresAt: Date | null;
+}
+export interface ExpirationResult {
+    userId: string;
+    workspaceId: string;
+    workspaceName: string;
+    action: 'resized' | 'destroyed' | 'skipped' | 'error';
+    reason?: string;
+}
+/**
+ * Get intro period status for a user
+ */
+export declare function getIntroStatus(userCreatedAt: Date | string | null, plan: string): IntroStatus;
+export declare class IntroExpirationService {
+    private config;
+    private checkTimer;
+    private isRunning;
+    constructor(config?: Partial<IntroExpirationConfig>);
+    /**
+     * Start the expiration service
+     */
+    start(): void;
+    /**
+     * Stop the expiration service
+     */
+    stop(): void;
+    /**
+     * Run expiration check for all free tier users with expired intro periods
+     */
+    runExpirationCheck(): Promise<ExpirationResult[]>;
+    /**
+     * Check and process workspaces for a user whose intro period has expired
+     * - Resize workspaces that are still at intro-tier resources
+     * - Destroy workspaces that have been inactive for DESTROY_GRACE_PERIOD_DAYS
+     */
+    private checkAndProcessUserWorkspaces;
+}
+export declare function getIntroExpirationService(): IntroExpirationService;
+export declare function startIntroExpirationService(): void;
+export declare function stopIntroExpirationService(): void;
+//# sourceMappingURL=intro-expiration.d.ts.map

package/dist/services/intro-expiration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intro-expiration.d.ts","sourceRoot":"","sources":["../../src/services/intro-expiration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAOD,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CA0B7F;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAIvD;;OAEG;IACH,KAAK,IAAI,IAAI;IA6Bb;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA6CvD;;;;OAIG;YACW,6BAA6B;CAkH5C;AAKD,wBAAgB,yBAAyB,IAAI,sBAAsB,CAKlE;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD"}

package/dist/services/intro-expiration.js

@@ -0,0 +1,252 @@
+/**
+ * Intro Expiration Service
+ *
+ * Handles auto-resize and auto-destroy of free tier workspaces:
+ * 1. Resize: Free users get Pro-level resources (2 CPU / 4GB) for the first 14 days,
+ *    then get automatically downsized to standard free tier (1 CPU / 2GB).
+ * 2. Destroy: Free workspaces inactive for 7+ days after intro expires get auto-destroyed
+ *    to prevent ongoing infrastructure costs for churned users.
+ */
+import { db } from '../db/index.js';
+import { getProvisioner } from '../provisioner/index.js';
+export const INTRO_PERIOD_DAYS = 14;
+export const DESTROY_GRACE_PERIOD_DAYS = 7; // Days of inactivity after intro before auto-destroy
+const DEFAULT_CONFIG = {
+    enabled: true,
+    checkIntervalMs: 60 * 60 * 1000, // 1 hour
+};
+/**
+ * Get intro period status for a user
+ */
+export function getIntroStatus(userCreatedAt, plan) {
+    const introPeriodDays = INTRO_PERIOD_DAYS;
+    // Only free tier users get intro bonus
+    if (plan !== 'free' || !userCreatedAt) {
+        return {
+            isIntroPeriod: false,
+            daysRemaining: 0,
+            introPeriodDays,
+            expiresAt: null,
+        };
+    }
+    const createdAt = typeof userCreatedAt === 'string' ? new Date(userCreatedAt) : userCreatedAt;
+    const daysSinceSignup = (Date.now() - createdAt.getTime()) / (1000 * 60 * 60 * 24);
+    const isIntroPeriod = daysSinceSignup < introPeriodDays;
+    const daysRemaining = Math.max(0, Math.ceil(introPeriodDays - daysSinceSignup));
+    const expiresAt = new Date(createdAt.getTime() + introPeriodDays * 24 * 60 * 60 * 1000);
+    return {
+        isIntroPeriod,
+        daysRemaining,
+        introPeriodDays,
+        expiresAt,
+    };
+}
+export class IntroExpirationService {
+    config;
+    checkTimer = null;
+    isRunning = false;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Start the expiration service
+     */
+    start() {
+        if (!this.config.enabled) {
+            console.log('[intro-expiration] Service disabled');
+            return;
+        }
+        if (this.isRunning) {
+            console.warn('[intro-expiration] Service already running');
+            return;
+        }
+        this.isRunning = true;
+        console.log(`[intro-expiration] Started (checking every ${this.config.checkIntervalMs / 1000 / 60} minutes)`);
+        // Run immediately on start
+        this.runExpirationCheck().catch((err) => {
+            console.error('[intro-expiration] Initial run failed:', err);
+        });
+        // Then run periodically
+        this.checkTimer = setInterval(() => {
+            this.runExpirationCheck().catch((err) => {
+                console.error('[intro-expiration] Periodic run failed:', err);
+            });
+        }, this.config.checkIntervalMs);
+    }
+    /**
+     * Stop the expiration service
+     */
+    stop() {
+        if (this.checkTimer) {
+            clearInterval(this.checkTimer);
+            this.checkTimer = null;
+        }
+        this.isRunning = false;
+        console.log('[intro-expiration] Stopped');
+    }
+    /**
+     * Run expiration check for all free tier users with expired intro periods
+     */
+    async runExpirationCheck() {
+        const results = [];
+        try {
+            // Get all users on free tier
+            const freeUsers = await db.users.findByPlan('free');
+            // Filter to users whose intro period has expired
+            const expiredUsers = freeUsers.filter((user) => {
+                const status = getIntroStatus(user.createdAt, user.plan || 'free');
+                return !status.isIntroPeriod && status.expiresAt !== null;
+            });
+            if (expiredUsers.length === 0) {
+                return results;
+            }
+            console.log(`[intro-expiration] Checking ${expiredUsers.length} users with expired intro periods`);
+            for (const user of expiredUsers) {
+                try {
+                    const userResults = await this.checkAndProcessUserWorkspaces(user.id, user.createdAt);
+                    results.push(...userResults);
+                }
+                catch (err) {
+                    console.error(`[intro-expiration] Error checking user ${user.id}:`, err);
+                }
+            }
+            // Summary
+            const resized = results.filter((r) => r.action === 'resized').length;
+            const destroyed = results.filter((r) => r.action === 'destroyed').length;
+            const skipped = results.filter((r) => r.action === 'skipped').length;
+            const errors = results.filter((r) => r.action === 'error').length;
+            if (resized > 0 || destroyed > 0 || errors > 0) {
+                console.log(`[intro-expiration] Results: ${resized} resized, ${destroyed} destroyed, ${skipped} skipped, ${errors} errors`);
+            }
+            return results;
+        }
+        catch (err) {
+            console.error('[intro-expiration] Run failed:', err);
+            return results;
+        }
+    }
+    /**
+     * Check and process workspaces for a user whose intro period has expired
+     * - Resize workspaces that are still at intro-tier resources
+     * - Destroy workspaces that have been inactive for DESTROY_GRACE_PERIOD_DAYS
+     */
+    async checkAndProcessUserWorkspaces(userId, userCreatedAt) {
+        const results = [];
+        const provisioner = getProvisioner();
+        // Get user's workspaces
+        const workspaces = await db.workspaces.findByUserId(userId);
+        // Calculate when intro period expired for this user
+        const introExpiredAt = new Date(userCreatedAt.getTime() + INTRO_PERIOD_DAYS * 24 * 60 * 60 * 1000);
+        const destroyThreshold = new Date(introExpiredAt.getTime() + DESTROY_GRACE_PERIOD_DAYS * 24 * 60 * 60 * 1000);
+        const now = new Date();
+        for (const workspace of workspaces) {
+            try {
+                // Check if workspace has intro-sized resources
+                const config = workspace.config;
+                const resourceTier = config?.resourceTier;
+                // Check last activity via linked daemons
+                const daemons = await db.linkedDaemons.findByWorkspaceId(workspace.id);
+                const lastActivity = daemons.length > 0
+                    ? daemons.reduce((latest, d) => {
+                        const seen = d.lastSeenAt ? new Date(d.lastSeenAt) : new Date(0);
+                        return seen > latest ? seen : latest;
+                    }, new Date(0))
+                    : workspace.updatedAt; // Fall back to workspace updatedAt
+                // Check if workspace should be destroyed (inactive for grace period after intro)
+                const daysSinceActivity = (now.getTime() - lastActivity.getTime()) / (1000 * 60 * 60 * 24);
+                const shouldDestroy = now > destroyThreshold && daysSinceActivity >= DESTROY_GRACE_PERIOD_DAYS;
+                if (shouldDestroy) {
+                    console.log(`[intro-expiration] Destroying inactive free workspace ${workspace.name} (${daysSinceActivity.toFixed(1)} days inactive)`);
+                    try {
+                        await provisioner.deprovision(workspace.id);
+                        results.push({
+                            userId,
+                            workspaceId: workspace.id,
+                            workspaceName: workspace.name,
+                            action: 'destroyed',
+                            reason: `Inactive for ${Math.round(daysSinceActivity)} days after intro period expired`,
+                        });
+                    }
+                    catch (deprovisionErr) {
+                        console.error(`[intro-expiration] Failed to destroy workspace ${workspace.id}:`, deprovisionErr);
+                        results.push({
+                            userId,
+                            workspaceId: workspace.id,
+                            workspaceName: workspace.name,
+                            action: 'error',
+                            reason: `Failed to destroy: ${deprovisionErr instanceof Error ? deprovisionErr.message : 'Unknown error'}`,
+                        });
+                    }
+                    continue;
+                }
+                // Skip resize if already at standard free tier
+                if (resourceTier === 'small') {
+                    results.push({
+                        userId,
+                        workspaceId: workspace.id,
+                        workspaceName: workspace.name,
+                        action: 'skipped',
+                        reason: 'Already at standard free tier size',
+                    });
+                    continue;
+                }
+                // Skip if workspace is not running (resize happens on next start)
+                if (workspace.status !== 'running') {
+                    results.push({
+                        userId,
+                        workspaceId: workspace.id,
+                        workspaceName: workspace.name,
+                        action: 'skipped',
+                        reason: `Workspace status is ${workspace.status}`,
+                    });
+                    continue;
+                }
+                // Resize to standard free tier (small: 2 CPU / 2GB)
+                // Use skipRestart=true to not disrupt running agents
+                console.log(`[intro-expiration] Resizing workspace ${workspace.name} to standard free tier`);
+                await provisioner.resize(workspace.id, {
+                    name: 'small',
+                    cpuCores: 2,
+                    cpuKind: 'shared',
+                    memoryMb: 2048,
+                    maxAgents: 2,
+                }, true); // skipRestart = true for graceful resize
+                results.push({
+                    userId,
+                    workspaceId: workspace.id,
+                    workspaceName: workspace.name,
+                    action: 'resized',
+                    reason: 'Intro period expired, downsized to standard free tier (applies on next restart)',
+                });
+            }
+            catch (err) {
+                console.error(`[intro-expiration] Failed to process workspace ${workspace.id}:`, err);
+                results.push({
+                    userId,
+                    workspaceId: workspace.id,
+                    workspaceName: workspace.name,
+                    action: 'error',
+                    reason: err instanceof Error ? err.message : 'Unknown error',
+                });
+            }
+        }
+        return results;
+    }
+}
+// Singleton instance
+let _service = null;
+export function getIntroExpirationService() {
+    if (!_service) {
+        _service = new IntroExpirationService();
+    }
+    return _service;
+}
+export function startIntroExpirationService() {
+    getIntroExpirationService().start();
+}
+export function stopIntroExpirationService() {
+    if (_service) {
+        _service.stop();
+    }
+}
+//# sourceMappingURL=intro-expiration.js.map

package/dist/services/intro-expiration.js.map

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

package/dist/services/mention-handler.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Mention Handler Service
+ *
+ * Handles @mentions of agents in GitHub issues and PR comments.
+ * Routes mentions to appropriate agents for response.
+ *
+ * Flow:
+ * 1. App posts acknowledgment comment
+ * 2. Finds a linked daemon for the repository
+ * 3. Queues spawn command for the daemon
+ * 4. Agent works and posts response comment
+ */
+import { CommentMention, IssueAssignment } from '../db/index.js';
+/**
+ * Known agent types that can be mentioned
+ */
+export declare const KNOWN_AGENTS: {
+    readonly 'agent-relay': "General purpose agent for any task";
+    readonly lead: "Lead agent for coordination and delegation";
+    readonly developer: "Developer agent for coding tasks";
+    readonly reviewer: "Code review agent";
+    readonly 'ci-fix': "CI failure fixing agent";
+    readonly debugger: "Bug investigation and fixing agent";
+    readonly docs: "Documentation agent";
+    readonly test: "Test writing agent";
+    readonly refactor: "Code refactoring agent";
+};
+export type KnownAgentType = keyof typeof KNOWN_AGENTS;
+/**
+ * Check if a mention is for a known agent type
+ */
+export declare function isKnownAgent(mention: string): mention is KnownAgentType;
+/**
+ * Handle a mention record
+ *
+ * This function:
+ * 1. Validates the mention is for a known agent
+ * 2. Posts an acknowledgment comment
+ * 3. Finds a linked daemon
+ * 4. Queues a spawn command for the agent
+ */
+export declare function handleMention(mention: CommentMention): Promise<void>;
+/**
+ * Handle an issue assignment
+ *
+ * Called when an issue should be assigned to an agent
+ */
+export declare function handleIssueAssignment(assignment: IssueAssignment): Promise<void>;
+/**
+ * Get pending mentions for processing
+ */
+export declare function getPendingMentions(limit?: number): Promise<CommentMention[]>;
+/**
+ * Get pending issue assignments for processing
+ */
+export declare function getPendingIssueAssignments(limit?: number): Promise<IssueAssignment[]>;
+/**
+ * Process all pending mentions (background job)
+ */
+export declare function processPendingMentions(): Promise<number>;
+/**
+ * Process all pending issue assignments (background job)
+ */
+export declare function processPendingIssueAssignments(): Promise<number>;
+//# sourceMappingURL=mention-handler.d.ts.map

package/dist/services/mention-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-handler.d.ts","sourceRoot":"","sources":["../../src/services/mention-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAM,cAAc,EAAE,eAAe,EAAc,MAAM,gBAAgB,CAAC;AAGjF;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;CAaf,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,YAAY,CAAC;AAEvD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,cAAc,CAEvE;AA0GD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA8E1E;AAyED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAyEtF;AA4DD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAE9E;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAEvF;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAc9D;AAED;;GAEG;AACH,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,MAAM,CAAC,CActE"}