buildhive-agent 1.0.0-beta.1

package/dist/api/jobStatusApi.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Job Status API Client - REST API integration for job status updates
+ *
+ * Provides methods for updating job status, streaming logs, and reporting
+ * job completion to the BuildHive server via REST API.
+ *
+ * Requirements: MVP.4.2.2 - Job status updates
+ */
+export interface JobStatusUpdate {
+    status?: 'QUEUED' | 'ASSIGNED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'FALLBACK';
+    agentId?: string;
+    startedAt?: Date;
+    completedAt?: Date;
+    exitCode?: number;
+    logs?: string;
+    errorMessage?: string;
+    artifactUrls?: string[];
+    actualDuration?: number;
+}
+export interface JobCompletionResult {
+    exitCode: number;
+    logs: string;
+    artifactUrls?: string[];
+    actualDuration: number;
+    errorMessage?: string;
+}
+export declare class JobStatusApi {
+    private client;
+    private serverUrl;
+    private apiKey;
+    private logBuffer;
+    private logBufferTimestamps;
+    private static readonly LOG_BUFFER_TTL_MS;
+    private static readonly MAX_LOG_BUFFERS;
+    constructor(serverUrl: string, apiKey: string);
+    /**
+     * Update job status with any combination of fields
+     */
+    updateJobStatus(jobId: string, update: JobStatusUpdate): Promise<void>;
+    /**
+     * Mark job as RUNNING with start timestamp
+     */
+    markJobRunning(jobId: string): Promise<void>;
+    /**
+     * Evict expired or excess log buffer entries to prevent unbounded memory growth.
+     */
+    private evictStaleLogBuffers;
+    /**
+     * Update job logs (accumulative - replaces all logs)
+     */
+    updateJobLogs(jobId: string, logs: string): Promise<void>;
+    /**
+     * Append logs to existing buffer and send update
+     */
+    appendJobLogs(jobId: string, newLogs: string): Promise<void>;
+    /**
+     * Mark job as COMPLETED with results
+     */
+    markJobCompleted(jobId: string, result: JobCompletionResult): Promise<void>;
+    /**
+     * Mark job as FAILED with error details
+     */
+    markJobFailed(jobId: string, errorMessage: string, logs?: string): Promise<void>;
+    /**
+     * Update job progress (sends status update without changing status)
+     */
+    updateJobProgress(jobId: string, progress: {
+        percentage: number;
+        currentStep: string;
+    }): Promise<void>;
+    /**
+     * Get current logs from buffer
+     */
+    getCurrentLogs(jobId: string): string;
+    /**
+     * Clear log buffer for a job
+     */
+    clearLogBuffer(jobId: string): void;
+    /**
+     * Handle API errors with detailed logging
+     */
+    private handleApiError;
+    /**
+     * Cleanup resources
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=jobStatusApi.d.ts.map

package/dist/api/jobStatusApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobStatusApi.d.ts","sourceRoot":"","sources":["../../src/api/jobStatusApi.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAkB;IAC3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAO;gBAElC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAgD7C;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5E;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB/D;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCjF;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IActF;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE;QAC/C,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAA;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjB;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/dist/api/jobStatusApi.js

@@ -0,0 +1,240 @@
+/**
+ * Job Status API Client - REST API integration for job status updates
+ *
+ * Provides methods for updating job status, streaming logs, and reporting
+ * job completion to the BuildHive server via REST API.
+ *
+ * Requirements: MVP.4.2.2 - Job status updates
+ */
+import axios from 'axios';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('jobStatusApi');
+export class JobStatusApi {
+    client;
+    serverUrl;
+    apiKey;
+    logBuffer = new Map();
+    logBufferTimestamps = new Map();
+    static LOG_BUFFER_TTL_MS = 60 * 60 * 1000; // 1 hour
+    static MAX_LOG_BUFFERS = 100;
+    constructor(serverUrl, apiKey) {
+        this.serverUrl = serverUrl;
+        this.apiKey = apiKey;
+        // Create axios instance with default config
+        this.client = axios.create({
+            baseURL: serverUrl,
+            timeout: 30000, // 30 second timeout
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`
+            }
+        });
+        // Add request interceptor for logging
+        this.client.interceptors.request.use((config) => {
+            logger.debug('API request', {
+                method: config.method,
+                url: config.url,
+                dataSize: JSON.stringify(config.data || {}).length
+            });
+            return config;
+        }, (error) => {
+            logger.error('Request interceptor error', error);
+            return Promise.reject(error);
+        });
+        // Add response interceptor for error handling
+        this.client.interceptors.response.use((response) => {
+            logger.debug('API response', {
+                status: response.status,
+                url: response.config.url
+            });
+            return response;
+        }, (error) => {
+            this.handleApiError(error);
+            return Promise.reject(error);
+        });
+        logger.info('JobStatusApi initialized', { serverUrl });
+    }
+    /**
+     * Update job status with any combination of fields
+     */
+    async updateJobStatus(jobId, update) {
+        try {
+            logger.info('Updating job status', {
+                jobId,
+                status: update.status,
+                hasLogs: !!update.logs,
+                logsSize: update.logs?.length || 0
+            });
+            await this.client.put(`/api/jobs/${jobId}/status`, update);
+            logger.info('Job status updated successfully', { jobId, status: update.status });
+        }
+        catch (error) {
+            logger.error(`Failed to update job status for ${jobId}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Mark job as RUNNING with start timestamp
+     */
+    async markJobRunning(jobId) {
+        logger.info(`Marking job ${jobId} as RUNNING`);
+        await this.updateJobStatus(jobId, {
+            status: 'RUNNING',
+            startedAt: new Date()
+        });
+    }
+    /**
+     * Evict expired or excess log buffer entries to prevent unbounded memory growth.
+     */
+    evictStaleLogBuffers() {
+        const now = Date.now();
+        for (const [jobId, ts] of this.logBufferTimestamps) {
+            if (now - ts > JobStatusApi.LOG_BUFFER_TTL_MS) {
+                this.logBuffer.delete(jobId);
+                this.logBufferTimestamps.delete(jobId);
+            }
+        }
+        // Hard cap: if still too many, remove oldest
+        if (this.logBuffer.size > JobStatusApi.MAX_LOG_BUFFERS) {
+            const sorted = [...this.logBufferTimestamps.entries()].sort((a, b) => a[1] - b[1]);
+            const toRemove = sorted.slice(0, this.logBuffer.size - JobStatusApi.MAX_LOG_BUFFERS);
+            for (const [jobId] of toRemove) {
+                this.logBuffer.delete(jobId);
+                this.logBufferTimestamps.delete(jobId);
+            }
+        }
+    }
+    /**
+     * Update job logs (accumulative - replaces all logs)
+     */
+    async updateJobLogs(jobId, logs) {
+        try {
+            // Store logs in buffer for this job
+            this.logBuffer.set(jobId, logs);
+            this.logBufferTimestamps.set(jobId, Date.now());
+            this.evictStaleLogBuffers();
+            logger.debug('Updating job logs', {
+                jobId,
+                logsSize: logs.length,
+                logLines: logs.split('\n').length
+            });
+            await this.updateJobStatus(jobId, { logs });
+            logger.debug('Job logs updated', { jobId });
+        }
+        catch (error) {
+            logger.error(`Failed to update logs for job ${jobId}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Append logs to existing buffer and send update
+     */
+    async appendJobLogs(jobId, newLogs) {
+        const existingLogs = this.logBuffer.get(jobId) || '';
+        const updatedLogs = existingLogs + newLogs;
+        await this.updateJobLogs(jobId, updatedLogs);
+    }
+    /**
+     * Mark job as COMPLETED with results
+     */
+    async markJobCompleted(jobId, result) {
+        logger.info(`Marking job ${jobId} as ${result.exitCode === 0 ? 'COMPLETED' : 'FAILED'}`, {
+            exitCode: result.exitCode,
+            duration: result.actualDuration,
+            hasArtifacts: !!result.artifactUrls?.length
+        });
+        const status = {
+            status: result.exitCode === 0 ? 'COMPLETED' : 'FAILED',
+            completedAt: new Date(),
+            exitCode: result.exitCode,
+            logs: result.logs,
+            actualDuration: result.actualDuration
+        };
+        if (result.artifactUrls && result.artifactUrls.length > 0) {
+            status.artifactUrls = result.artifactUrls;
+        }
+        if (result.errorMessage) {
+            status.errorMessage = result.errorMessage;
+        }
+        await this.updateJobStatus(jobId, status);
+        // Clean up log buffer
+        this.logBuffer.delete(jobId);
+        this.logBufferTimestamps.delete(jobId);
+        logger.info('Job completion reported', {
+            jobId,
+            status: status.status,
+            exitCode: result.exitCode
+        });
+    }
+    /**
+     * Mark job as FAILED with error details
+     */
+    async markJobFailed(jobId, errorMessage, logs) {
+        logger.error(`Marking job ${jobId} as FAILED`, { errorMessage });
+        await this.updateJobStatus(jobId, {
+            status: 'FAILED',
+            completedAt: new Date(),
+            errorMessage,
+            logs: logs || this.logBuffer.get(jobId)
+        });
+        // Clean up log buffer
+        this.logBuffer.delete(jobId);
+        this.logBufferTimestamps.delete(jobId);
+    }
+    /**
+     * Update job progress (sends status update without changing status)
+     */
+    async updateJobProgress(jobId, progress) {
+        // Progress updates can be sent via logs
+        const progressLog = `[PROGRESS] ${progress.percentage}% - ${progress.currentStep}\n`;
+        await this.appendJobLogs(jobId, progressLog);
+    }
+    /**
+     * Get current logs from buffer
+     */
+    getCurrentLogs(jobId) {
+        return this.logBuffer.get(jobId) || '';
+    }
+    /**
+     * Clear log buffer for a job
+     */
+    clearLogBuffer(jobId) {
+        this.logBuffer.delete(jobId);
+        this.logBufferTimestamps.delete(jobId);
+    }
+    /**
+     * Handle API errors with detailed logging
+     */
+    handleApiError(error) {
+        if (error.response) {
+            // Server responded with error status
+            logger.error('API error response', {
+                status: error.response.status,
+                statusText: error.response.statusText,
+                data: error.response.data,
+                url: error.config?.url
+            });
+        }
+        else if (error.request) {
+            // Request made but no response
+            logger.error('API no response', {
+                url: error.config?.url,
+                message: error.message
+            });
+        }
+        else {
+            // Error setting up request
+            logger.error('API request setup error', {
+                message: error.message
+            });
+        }
+    }
+    /**
+     * Cleanup resources
+     */
+    cleanup() {
+        this.logBuffer.clear();
+        logger.info('JobStatusApi cleaned up');
+    }
+}
+//# sourceMappingURL=jobStatusApi.js.map

package/dist/api/jobStatusApi.js.map

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

package/dist/autoUpdater.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Auto-Updater Module
+ *
+ * Handles automatic updates for the BuildHive agent including:
+ * - Version checking
+ * - Secure download and verification
+ * - Graceful update process
+ * - Rollback capabilities
+ *
+ * Requirements: 6.1
+ */
+import { EventEmitter } from 'events';
+export interface UpdateManifest {
+    version: string;
+    releaseDate: string;
+    critical: boolean;
+    downloadUrl: string;
+    checksumSha256: string;
+    size: number;
+    releaseNotes: string;
+    minimumVersion?: string;
+    rollbackSupported: boolean;
+}
+export interface UpdateProgress {
+    phase: 'checking' | 'downloading' | 'verifying' | 'installing' | 'complete' | 'error';
+    progress: number;
+    message: string;
+    error?: Error;
+}
+export interface UpdateOptions {
+    updateServerUrl: string;
+    checkInterval: number;
+    autoInstall: boolean;
+    allowPrerelease: boolean;
+    backupEnabled: boolean;
+    maxRetries: number;
+}
+export declare class AutoUpdater extends EventEmitter {
+    private options;
+    private currentVersion;
+    private checkInterval;
+    private isUpdating;
+    private updateInProgress;
+    constructor(currentVersion: string, options?: Partial<UpdateOptions>);
+    /**
+     * Start the auto-updater
+     */
+    start(): void;
+    /**
+     * Stop the auto-updater
+     */
+    stop(): void;
+    /**
+     * Check for available updates
+     */
+    checkForUpdates(): Promise<UpdateManifest | null>;
+    /**
+     * Install an update
+     */
+    installUpdate(manifest: UpdateManifest): Promise<void>;
+    /**
+     * Rollback to previous version
+     */
+    rollbackUpdate(): Promise<void>;
+    /**
+     * Get current version
+     */
+    getCurrentVersion(): string;
+    /**
+     * Check if update is in progress
+     */
+    isUpdateInProgress(): boolean;
+    /**
+     * Fetch update manifest from server
+     */
+    private fetchUpdateManifest;
+    /**
+     * Download update file
+     */
+    private downloadUpdate;
+    /**
+     * Verify downloaded file
+     */
+    private verifyDownload;
+    /**
+     * Create backup of current version
+     */
+    private createBackup;
+    /**
+     * Perform the actual installation
+     */
+    private performInstallation;
+    /**
+     * Compare version strings
+     */
+    private compareVersions;
+    /**
+     * Get current executable path
+     */
+    private getCurrentExecutablePath;
+    /**
+     * Get backup file path
+     */
+    private getBackupPath;
+    /**
+     * Get temporary directory
+     */
+    private getTempDir;
+    /**
+     * Format bytes for display
+     */
+    private formatBytes;
+}
+/**
+ * Startup version check (Task 2.1.3).
+ *
+ * Called once when the agent starts. Compares the local package version against
+ * the npm registry. If a newer version is available:
+ *   - Always logs a warning with the upgrade command.
+ *   - If `autoUpdate` is true, runs `npm install -g <package>` after draining
+ *     active jobs and then exits so the process manager can restart with the new
+ *     binary (graceful restart pattern).
+ *
+ * @param packageName  npm package name (default: "@buildhive/agent")
+ * @param localVersion current version string from package.json
+ * @param autoUpdate   whether to auto-install the update (default: false)
+ * @param isIdle       predicate returning true when no jobs are active (for graceful drain)
+ */
+export declare function checkStartupVersion(options: {
+    packageName?: string;
+    localVersion: string;
+    autoUpdate?: boolean;
+    isIdle?: () => boolean;
+}): Promise<void>;
+//# sourceMappingURL=autoUpdater.d.ts.map

package/dist/autoUpdater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoUpdater.d.ts","sourceRoot":"","sources":["../src/autoUpdater.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,cAAc,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM;IAexE;;OAEG;IACH,KAAK,IAAI,IAAI;IA2Bb;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAuDvD;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoF5D;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBrC;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;YACW,mBAAmB;IA8BjC;;OAEG;YACW,cAAc;IAkD5B;;OAEG;YACW,cAAc;IAkB5B;;OAEG;YACW,YAAY;IAc1B;;OAEG;YACW,mBAAmB;IAkBjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAIhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,WAAW;CASpB;AAmDD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDhB"}