agent-relay 1.1.0 → 1.2.0

package/dist/cloud/services/capacity-manager.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Capacity Manager
+ *
+ * Tracks workspace capacity across the fleet and provides:
+ * - Real-time capacity metrics
+ * - Optimal agent placement recommendations
+ * - Load balancing decisions
+ * - Capacity forecasting based on trends
+ *
+ * Works with AutoScaler to determine when to provision new instances
+ * and with Coordinator to place agents optimally.
+ */
+import { EventEmitter } from 'events';
+import { WorkspaceMetrics } from './scaling-policy.js';
+export interface WorkspaceCapacity {
+    workspaceId: string;
+    userId: string;
+    provider: string;
+    region: string;
+    currentAgents: number;
+    maxAgents: number;
+    memoryUsedBytes: number;
+    memoryLimitBytes: number;
+    cpuPercent: number;
+    agentCapacityPercent: number;
+    memoryCapacityPercent: number;
+    overallHealthScore: number;
+    lastHeartbeat: Date;
+    lastMetricsUpdate: Date;
+}
+export interface PlacementRecommendation {
+    workspaceId: string;
+    score: number;
+    reason: string;
+    estimatedCapacityAfter: number;
+}
+export interface CapacitySnapshot {
+    userId: string;
+    totalWorkspaces: number;
+    totalAgents: number;
+    totalMaxAgents: number;
+    totalMemoryBytes: number;
+    totalMemoryLimitBytes: number;
+    averageHealthScore: number;
+    workspaces: WorkspaceCapacity[];
+    timestamp: Date;
+}
+export interface CapacityForecast {
+    userId: string;
+    currentAgents: number;
+    projectedAgents15Min: number;
+    projectedAgents60Min: number;
+    memoryTrendPerMinute: number;
+    willExceedCapacity: boolean;
+    timeToCapacityExhaustion?: number;
+    recommendation: 'none' | 'scale_soon' | 'scale_now' | 'critical';
+}
+export interface CapacityManagerConfig {
+    healthCheckIntervalMs: number;
+    staleThresholdMs: number;
+    memoryWeightFactor: number;
+    agentWeightFactor: number;
+    cpuWeightFactor: number;
+    redisKeyPrefix: string;
+}
+export declare class CapacityManager extends EventEmitter {
+    private config;
+    private redis;
+    private subscriber;
+    private capacityMap;
+    private userWorkspaces;
+    private trendHistory;
+    private healthCheckTimer;
+    constructor(config?: Partial<CapacityManagerConfig>);
+    /**
+     * Initialize with Redis for cross-server sync
+     */
+    initialize(redisUrl: string): Promise<void>;
+    /**
+     * Load capacity data from Redis
+     */
+    private loadFromRedis;
+    /**
+     * Update local capacity map
+     */
+    private updateLocalCapacity;
+    /**
+     * Update trend history for forecasting
+     */
+    private updateTrendHistory;
+    /**
+     * Report capacity from a workspace
+     */
+    reportCapacity(workspaceId: string, userId: string, metrics: Partial<WorkspaceCapacity>): Promise<void>;
+    /**
+     * Calculate health score for a workspace (lower is healthier/better for placement)
+     */
+    private calculateHealthScore;
+    /**
+     * Get best workspace for placing a new agent
+     */
+    recommendPlacement(userId: string, agentCount?: number): PlacementRecommendation[];
+    /**
+     * Generate human-readable placement reason
+     */
+    private getPlacementReason;
+    /**
+     * Get capacity snapshot for a user
+     */
+    getCapacitySnapshot(userId: string): CapacitySnapshot | null;
+    /**
+     * Forecast capacity needs based on trends
+     */
+    getCapacityForecast(userId: string): CapacityForecast | null;
+    /**
+     * Convert workspace metrics to capacity format
+     */
+    fromWorkspaceMetrics(userId: string, metrics: WorkspaceMetrics): Partial<WorkspaceCapacity>;
+    /**
+     * Health check loop - detect stale workspaces
+     */
+    private startHealthCheckLoop;
+    /**
+     * Remove a workspace from tracking
+     */
+    removeWorkspace(workspaceId: string): Promise<void>;
+    /**
+     * Get all workspaces for a user
+     */
+    getUserWorkspaces(userId: string): WorkspaceCapacity[];
+    /**
+     * Get global capacity metrics
+     */
+    getGlobalMetrics(): {
+        totalWorkspaces: number;
+        totalAgents: number;
+        totalMaxAgents: number;
+        averageUtilization: number;
+        staleWorkspaces: number;
+    };
+    /**
+     * Clean shutdown
+     */
+    shutdown(): Promise<void>;
+}
+export declare function getCapacityManager(): CapacityManager;
+export declare function createCapacityManager(config?: Partial<CapacityManagerConfig>): CapacityManager;
+//# sourceMappingURL=capacity-manager.d.ts.map

package/dist/cloud/services/capacity-manager.d.ts.map

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

package/dist/cloud/services/capacity-manager.js

@@ -0,0 +1,449 @@
+/**
+ * Capacity Manager
+ *
+ * Tracks workspace capacity across the fleet and provides:
+ * - Real-time capacity metrics
+ * - Optimal agent placement recommendations
+ * - Load balancing decisions
+ * - Capacity forecasting based on trends
+ *
+ * Works with AutoScaler to determine when to provision new instances
+ * and with Coordinator to place agents optimally.
+ */
+import { EventEmitter } from 'events';
+import { createClient } from 'redis';
+const DEFAULT_CONFIG = {
+    healthCheckIntervalMs: 15000, // 15 seconds
+    staleThresholdMs: 60000, // 1 minute
+    memoryWeightFactor: 0.4,
+    agentWeightFactor: 0.4,
+    cpuWeightFactor: 0.2,
+    redisKeyPrefix: 'capacity:',
+};
+// Redis channels
+const CHANNELS = {
+    CAPACITY_UPDATE: 'capacity:update',
+    PLACEMENT_REQUEST: 'capacity:placement',
+};
+export class CapacityManager extends EventEmitter {
+    config;
+    redis = null;
+    subscriber = null;
+    capacityMap = new Map();
+    userWorkspaces = new Map(); // userId -> workspaceIds
+    trendHistory = new Map();
+    healthCheckTimer = null;
+    constructor(config = {}) {
+        super();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Initialize with Redis for cross-server sync
+     */
+    async initialize(redisUrl) {
+        try {
+            this.redis = createClient({ url: redisUrl });
+            this.redis.on('error', (err) => this.emit('error', { context: 'redis', error: err }));
+            this.subscriber = createClient({ url: redisUrl });
+            this.subscriber.on('error', (err) => this.emit('error', { context: 'subscriber', error: err }));
+            await Promise.all([this.redis.connect(), this.subscriber.connect()]);
+            // Subscribe to capacity updates
+            await this.subscriber.subscribe(CHANNELS.CAPACITY_UPDATE, (message) => {
+                try {
+                    const capacity = JSON.parse(message);
+                    capacity.lastHeartbeat = new Date(capacity.lastHeartbeat);
+                    capacity.lastMetricsUpdate = new Date(capacity.lastMetricsUpdate);
+                    this.updateLocalCapacity(capacity);
+                }
+                catch (error) {
+                    this.emit('error', { context: 'capacity_parse', error });
+                }
+            });
+            // Load existing capacity from Redis
+            await this.loadFromRedis();
+            // Start health check loop
+            this.startHealthCheckLoop();
+            this.emit('initialized');
+        }
+        catch (error) {
+            this.emit('error', error);
+            throw error;
+        }
+    }
+    /**
+     * Load capacity data from Redis
+     */
+    async loadFromRedis() {
+        if (!this.redis)
+            return;
+        const keys = await this.redis.keys(`${this.config.redisKeyPrefix}workspace:*`);
+        for (const key of keys) {
+            const data = await this.redis.get(key);
+            if (data) {
+                try {
+                    const capacity = JSON.parse(data);
+                    capacity.lastHeartbeat = new Date(capacity.lastHeartbeat);
+                    capacity.lastMetricsUpdate = new Date(capacity.lastMetricsUpdate);
+                    this.updateLocalCapacity(capacity);
+                }
+                catch {
+                    // Skip invalid entries
+                }
+            }
+        }
+    }
+    /**
+     * Update local capacity map
+     */
+    updateLocalCapacity(capacity) {
+        this.capacityMap.set(capacity.workspaceId, capacity);
+        // Track user -> workspace mapping
+        let userWorkspaceSet = this.userWorkspaces.get(capacity.userId);
+        if (!userWorkspaceSet) {
+            userWorkspaceSet = new Set();
+            this.userWorkspaces.set(capacity.userId, userWorkspaceSet);
+        }
+        userWorkspaceSet.add(capacity.workspaceId);
+        // Update trend history
+        this.updateTrendHistory(capacity);
+        this.emit('capacity_updated', capacity);
+    }
+    /**
+     * Update trend history for forecasting
+     */
+    updateTrendHistory(capacity) {
+        const key = capacity.workspaceId;
+        let history = this.trendHistory.get(key) || [];
+        history.push({
+            timestamp: new Date(),
+            agents: capacity.currentAgents,
+            memory: capacity.memoryUsedBytes,
+        });
+        // Keep only last 30 minutes of history
+        const cutoff = Date.now() - 30 * 60 * 1000;
+        history = history.filter((h) => h.timestamp.getTime() > cutoff);
+        this.trendHistory.set(key, history);
+    }
+    /**
+     * Report capacity from a workspace
+     */
+    async reportCapacity(workspaceId, userId, metrics) {
+        const existing = this.capacityMap.get(workspaceId);
+        const capacity = {
+            workspaceId,
+            userId,
+            provider: metrics.provider || existing?.provider || 'unknown',
+            region: metrics.region || existing?.region || 'unknown',
+            currentAgents: metrics.currentAgents ?? existing?.currentAgents ?? 0,
+            maxAgents: metrics.maxAgents ?? existing?.maxAgents ?? 10,
+            memoryUsedBytes: metrics.memoryUsedBytes ?? existing?.memoryUsedBytes ?? 0,
+            memoryLimitBytes: metrics.memoryLimitBytes ?? existing?.memoryLimitBytes ?? 512 * 1024 * 1024,
+            cpuPercent: metrics.cpuPercent ?? existing?.cpuPercent ?? 0,
+            agentCapacityPercent: 0,
+            memoryCapacityPercent: 0,
+            overallHealthScore: 0,
+            lastHeartbeat: new Date(),
+            lastMetricsUpdate: new Date(),
+        };
+        // Calculate derived metrics
+        capacity.agentCapacityPercent = (capacity.currentAgents / capacity.maxAgents) * 100;
+        capacity.memoryCapacityPercent = (capacity.memoryUsedBytes / capacity.memoryLimitBytes) * 100;
+        capacity.overallHealthScore = this.calculateHealthScore(capacity);
+        // Update local map
+        this.updateLocalCapacity(capacity);
+        // Persist to Redis and broadcast
+        if (this.redis) {
+            const key = `${this.config.redisKeyPrefix}workspace:${workspaceId}`;
+            await this.redis.set(key, JSON.stringify(capacity), { EX: 300 }); // 5 min TTL
+            await this.redis.publish(CHANNELS.CAPACITY_UPDATE, JSON.stringify(capacity));
+        }
+    }
+    /**
+     * Calculate health score for a workspace (lower is healthier/better for placement)
+     */
+    calculateHealthScore(capacity) {
+        const memoryScore = capacity.memoryCapacityPercent * this.config.memoryWeightFactor;
+        const agentScore = capacity.agentCapacityPercent * this.config.agentWeightFactor;
+        const cpuScore = capacity.cpuPercent * this.config.cpuWeightFactor;
+        return memoryScore + agentScore + cpuScore;
+    }
+    /**
+     * Get best workspace for placing a new agent
+     */
+    recommendPlacement(userId, agentCount = 1) {
+        const userWorkspaceIds = this.userWorkspaces.get(userId);
+        if (!userWorkspaceIds || userWorkspaceIds.size === 0) {
+            return [];
+        }
+        const recommendations = [];
+        for (const workspaceId of userWorkspaceIds) {
+            const capacity = this.capacityMap.get(workspaceId);
+            if (!capacity)
+                continue;
+            // Skip stale workspaces
+            if (Date.now() - capacity.lastHeartbeat.getTime() > this.config.staleThresholdMs) {
+                continue;
+            }
+            // Check if workspace can accommodate new agents
+            const availableSlots = capacity.maxAgents - capacity.currentAgents;
+            if (availableSlots < agentCount) {
+                continue;
+            }
+            // Calculate estimated capacity after placement
+            const newAgentCount = capacity.currentAgents + agentCount;
+            const estimatedCapacityAfter = (newAgentCount / capacity.maxAgents) * 100;
+            // Calculate placement score (lower is better)
+            let score = capacity.overallHealthScore;
+            // Penalize workspaces that would be over 80% after placement
+            if (estimatedCapacityAfter > 80) {
+                score += (estimatedCapacityAfter - 80) * 2;
+            }
+            // Bonus for workspaces with room to grow
+            if (estimatedCapacityAfter < 50) {
+                score -= (50 - estimatedCapacityAfter) * 0.5;
+            }
+            const reason = this.getPlacementReason(capacity, estimatedCapacityAfter);
+            recommendations.push({
+                workspaceId,
+                score: Math.max(0, score),
+                reason,
+                estimatedCapacityAfter,
+            });
+        }
+        // Sort by score (lower is better)
+        return recommendations.sort((a, b) => a.score - b.score);
+    }
+    /**
+     * Generate human-readable placement reason
+     */
+    getPlacementReason(capacity, estimatedAfter) {
+        if (capacity.overallHealthScore < 30) {
+            return 'Workspace is healthy with low utilization';
+        }
+        else if (capacity.overallHealthScore < 50) {
+            return 'Workspace has moderate load, good for placement';
+        }
+        else if (capacity.overallHealthScore < 70) {
+            return 'Workspace under load but can accommodate';
+        }
+        else {
+            return `Workspace at ${Math.round(estimatedAfter)}% capacity after placement`;
+        }
+    }
+    /**
+     * Get capacity snapshot for a user
+     */
+    getCapacitySnapshot(userId) {
+        const userWorkspaceIds = this.userWorkspaces.get(userId);
+        if (!userWorkspaceIds || userWorkspaceIds.size === 0) {
+            return null;
+        }
+        const workspaces = [];
+        let totalAgents = 0;
+        let totalMaxAgents = 0;
+        let totalMemory = 0;
+        let totalMemoryLimit = 0;
+        let healthScoreSum = 0;
+        for (const workspaceId of userWorkspaceIds) {
+            const capacity = this.capacityMap.get(workspaceId);
+            if (capacity) {
+                workspaces.push(capacity);
+                totalAgents += capacity.currentAgents;
+                totalMaxAgents += capacity.maxAgents;
+                totalMemory += capacity.memoryUsedBytes;
+                totalMemoryLimit += capacity.memoryLimitBytes;
+                healthScoreSum += capacity.overallHealthScore;
+            }
+        }
+        return {
+            userId,
+            totalWorkspaces: workspaces.length,
+            totalAgents,
+            totalMaxAgents,
+            totalMemoryBytes: totalMemory,
+            totalMemoryLimitBytes: totalMemoryLimit,
+            averageHealthScore: workspaces.length > 0 ? healthScoreSum / workspaces.length : 0,
+            workspaces,
+            timestamp: new Date(),
+        };
+    }
+    /**
+     * Forecast capacity needs based on trends
+     */
+    getCapacityForecast(userId) {
+        const snapshot = this.getCapacitySnapshot(userId);
+        if (!snapshot)
+            return null;
+        // Calculate aggregate trends
+        let totalAgentTrend = 0;
+        let totalMemoryTrend = 0;
+        let trendSamples = 0;
+        for (const workspace of snapshot.workspaces) {
+            const history = this.trendHistory.get(workspace.workspaceId);
+            if (!history || history.length < 2)
+                continue;
+            const oldest = history[0];
+            const newest = history[history.length - 1];
+            const timeSpanMinutes = (newest.timestamp.getTime() - oldest.timestamp.getTime()) / (1000 * 60);
+            if (timeSpanMinutes > 0) {
+                totalAgentTrend += (newest.agents - oldest.agents) / timeSpanMinutes;
+                totalMemoryTrend += (newest.memory - oldest.memory) / timeSpanMinutes;
+                trendSamples++;
+            }
+        }
+        // Average trends
+        const avgAgentTrend = trendSamples > 0 ? totalAgentTrend / trendSamples : 0;
+        const avgMemoryTrend = trendSamples > 0 ? totalMemoryTrend / trendSamples : 0;
+        // Project future state
+        const projectedAgents15Min = Math.max(0, snapshot.totalAgents + avgAgentTrend * 15);
+        const projectedAgents60Min = Math.max(0, snapshot.totalAgents + avgAgentTrend * 60);
+        // Check if we'll exceed capacity
+        const willExceedCapacity = projectedAgents60Min >= snapshot.totalMaxAgents * 0.9;
+        // Calculate time to capacity exhaustion
+        let timeToExhaustion;
+        if (avgAgentTrend > 0) {
+            const remainingSlots = snapshot.totalMaxAgents - snapshot.totalAgents;
+            timeToExhaustion = remainingSlots / avgAgentTrend;
+        }
+        // Generate recommendation
+        let recommendation = 'none';
+        if (snapshot.totalAgents >= snapshot.totalMaxAgents * 0.95) {
+            recommendation = 'critical';
+        }
+        else if (snapshot.totalAgents >= snapshot.totalMaxAgents * 0.85) {
+            recommendation = 'scale_now';
+        }
+        else if (willExceedCapacity || projectedAgents15Min >= snapshot.totalMaxAgents * 0.8) {
+            recommendation = 'scale_soon';
+        }
+        return {
+            userId,
+            currentAgents: snapshot.totalAgents,
+            projectedAgents15Min: Math.round(projectedAgents15Min),
+            projectedAgents60Min: Math.round(projectedAgents60Min),
+            memoryTrendPerMinute: avgMemoryTrend,
+            willExceedCapacity,
+            timeToCapacityExhaustion: timeToExhaustion,
+            recommendation,
+        };
+    }
+    /**
+     * Convert workspace metrics to capacity format
+     */
+    fromWorkspaceMetrics(userId, metrics) {
+        return {
+            workspaceId: metrics.workspaceId,
+            userId,
+            currentAgents: metrics.agentCount,
+            memoryUsedBytes: metrics.totalMemoryBytes,
+            cpuPercent: metrics.cpuPercent,
+        };
+    }
+    /**
+     * Health check loop - detect stale workspaces
+     */
+    startHealthCheckLoop() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+        }
+        this.healthCheckTimer = setInterval(() => {
+            const now = Date.now();
+            for (const [workspaceId, capacity] of this.capacityMap) {
+                if (now - capacity.lastHeartbeat.getTime() > this.config.staleThresholdMs) {
+                    this.emit('workspace_stale', { workspaceId, lastHeartbeat: capacity.lastHeartbeat });
+                }
+            }
+        }, this.config.healthCheckIntervalMs);
+    }
+    /**
+     * Remove a workspace from tracking
+     */
+    async removeWorkspace(workspaceId) {
+        const capacity = this.capacityMap.get(workspaceId);
+        if (capacity) {
+            this.capacityMap.delete(workspaceId);
+            this.trendHistory.delete(workspaceId);
+            const userWorkspaceSet = this.userWorkspaces.get(capacity.userId);
+            if (userWorkspaceSet) {
+                userWorkspaceSet.delete(workspaceId);
+            }
+            if (this.redis) {
+                await this.redis.del(`${this.config.redisKeyPrefix}workspace:${workspaceId}`);
+            }
+            this.emit('workspace_removed', workspaceId);
+        }
+    }
+    /**
+     * Get all workspaces for a user
+     */
+    getUserWorkspaces(userId) {
+        const workspaceIds = this.userWorkspaces.get(userId);
+        if (!workspaceIds)
+            return [];
+        const workspaces = [];
+        for (const id of workspaceIds) {
+            const capacity = this.capacityMap.get(id);
+            if (capacity) {
+                workspaces.push(capacity);
+            }
+        }
+        return workspaces;
+    }
+    /**
+     * Get global capacity metrics
+     */
+    getGlobalMetrics() {
+        let totalAgents = 0;
+        let totalMaxAgents = 0;
+        let utilizationSum = 0;
+        let staleCount = 0;
+        const now = Date.now();
+        for (const capacity of this.capacityMap.values()) {
+            totalAgents += capacity.currentAgents;
+            totalMaxAgents += capacity.maxAgents;
+            utilizationSum += capacity.overallHealthScore;
+            if (now - capacity.lastHeartbeat.getTime() > this.config.staleThresholdMs) {
+                staleCount++;
+            }
+        }
+        return {
+            totalWorkspaces: this.capacityMap.size,
+            totalAgents,
+            totalMaxAgents,
+            averageUtilization: this.capacityMap.size > 0 ? utilizationSum / this.capacityMap.size : 0,
+            staleWorkspaces: staleCount,
+        };
+    }
+    /**
+     * Clean shutdown
+     */
+    async shutdown() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = null;
+        }
+        if (this.subscriber) {
+            await this.subscriber.unsubscribe();
+            await this.subscriber.quit();
+            this.subscriber = null;
+        }
+        if (this.redis) {
+            await this.redis.quit();
+            this.redis = null;
+        }
+        this.emit('shutdown');
+    }
+}
+// Singleton instance
+let _capacityManager = null;
+export function getCapacityManager() {
+    if (!_capacityManager) {
+        _capacityManager = new CapacityManager();
+    }
+    return _capacityManager;
+}
+export function createCapacityManager(config = {}) {
+    _capacityManager = new CapacityManager(config);
+    return _capacityManager;
+}
+//# sourceMappingURL=capacity-manager.js.map

package/dist/cloud/services/capacity-manager.js.map

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

package/dist/cloud/services/ci-agent-spawner.d.ts

@@ -0,0 +1,49 @@
+/**
+ * CI Agent Spawner Service
+ *
+ * Spawns agents to fix CI failures automatically.
+ * Called by the webhook handler when CI checks fail on PRs.
+ *
+ * Flow:
+ * 1. App posts acknowledgment comment on the PR
+ * 2. Finds a linked daemon for the repository
+ * 3. Queues spawn command for the daemon
+ * 4. Agent works and posts response comment
+ */
+import { CIFailureEvent } from '../db/index.js';
+/**
+ * Spawn an agent to fix CI failures
+ *
+ * This function:
+ * 1. Finds the workspace for the repository
+ * 2. Posts acknowledgment comment
+ * 3. Creates a fix attempt record
+ * 4. Queues spawn command for a linked daemon
+ *
+ * @param failureEvent - The CI failure event from the database
+ */
+export declare function spawnCIFixAgent(failureEvent: CIFailureEvent): Promise<void>;
+/**
+ * Notify an existing agent about a CI failure
+ *
+ * Used when an agent is already working on a PR and a new failure occurs.
+ *
+ * @param agentId - The ID of the existing agent
+ * @param failureEvent - The new CI failure event
+ */
+export declare function notifyAgentOfCIFailure(agentId: string, failureEvent: CIFailureEvent): Promise<void>;
+/**
+ * Mark a fix attempt as complete
+ *
+ * Called when an agent reports completion (success or failure)
+ */
+export declare function completeFixAttempt(fixAttemptId: string, success: boolean, commitSha?: string, errorMessage?: string): Promise<void>;
+/**
+ * Get failure history for a repository
+ */
+export declare function getFailureHistory(repository: string, limit?: number): Promise<CIFailureEvent[]>;
+/**
+ * Get failure history for a specific PR
+ */
+export declare function getPRFailureHistory(repository: string, prNumber: number): Promise<CIFailureEvent[]>;
+//# sourceMappingURL=ci-agent-spawner.d.ts.map

package/dist/cloud/services/ci-agent-spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-agent-spawner.d.ts","sourceRoot":"","sources":["../../../src/cloud/services/ci-agent-spawner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAM,cAAc,EAA4B,MAAM,gBAAgB,CAAC;AAgK9E;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA4GjF;AA0ED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,cAAc,GAC3B,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,KAAK,SAAK,GACT,OAAO,CAAC,cAAc,EAAE,CAAC,CAE3B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CAE3B"}