@generacy-ai/generacy 0.0.0-preview-20260304013206

package/dist/orchestrator/heartbeat.js

@@ -0,0 +1,116 @@
+/**
+ * Heartbeat manager.
+ * Handles periodic heartbeat to orchestrator.
+ */
+import { totalmem } from 'os';
+/**
+ * Manages periodic heartbeat to orchestrator
+ */
+export class HeartbeatManager {
+    client;
+    workerId;
+    interval;
+    onCommand;
+    onError;
+    timer = null;
+    status = 'idle';
+    currentJob;
+    progress;
+    startTime = Date.now();
+    lastHeartbeat;
+    constructor(options) {
+        this.client = options.client;
+        this.workerId = options.workerId;
+        this.interval = options.interval ?? 30000;
+        this.onCommand = options.onCommand;
+        this.onError = options.onError;
+    }
+    /**
+     * Start the heartbeat loop
+     */
+    start() {
+        if (this.timer) {
+            return; // Already running
+        }
+        // Send initial heartbeat
+        this.sendHeartbeat();
+        // Start periodic heartbeats
+        this.timer = setInterval(() => {
+            this.sendHeartbeat();
+        }, this.interval);
+    }
+    /**
+     * Stop the heartbeat loop
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /**
+     * Update worker status
+     */
+    setStatus(status) {
+        this.status = status;
+    }
+    /**
+     * Set current job information
+     */
+    setCurrentJob(jobId, progress) {
+        this.currentJob = jobId;
+        this.progress = progress;
+    }
+    /**
+     * Get last successful heartbeat time
+     */
+    getLastHeartbeat() {
+        return this.lastHeartbeat;
+    }
+    /**
+     * Get uptime in milliseconds
+     */
+    getUptime() {
+        return Date.now() - this.startTime;
+    }
+    /**
+     * Send a heartbeat to the orchestrator
+     */
+    async sendHeartbeat() {
+        try {
+            const heartbeat = {
+                workerId: this.workerId,
+                status: this.status,
+                currentJob: this.currentJob,
+                progress: this.progress,
+                metrics: this.collectMetrics(),
+                timestamp: new Date().toISOString(),
+            };
+            const response = await this.client.heartbeat(heartbeat);
+            this.lastHeartbeat = new Date();
+            // Process any commands from orchestrator
+            if (response.commands && response.commands.length > 0) {
+                for (const command of response.commands) {
+                    this.onCommand?.(command);
+                }
+            }
+        }
+        catch (error) {
+            this.onError?.(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Collect system metrics
+     */
+    collectMetrics() {
+        // Get memory usage
+        const memUsage = process.memoryUsage();
+        const totalMem = totalmem?.() ?? 0;
+        const memoryUsage = totalMem > 0 ? (memUsage.rss / totalMem) * 100 : 0;
+        return {
+            memoryUsage: Math.round(memoryUsage * 100) / 100,
+            uptime: this.getUptime(),
+        };
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/orchestrator/heartbeat.js.map

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

package/dist/orchestrator/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Orchestrator module exports
+ */
+export { OrchestratorClient, OrchestratorClientError } from './client.js';
+export type { OrchestratorClientOptions } from './client.js';
+export { HeartbeatManager } from './heartbeat.js';
+export type { HeartbeatManagerOptions, WorkerStatus } from './heartbeat.js';
+export { JobHandler } from './job-handler.js';
+export type { JobHandlerOptions } from './job-handler.js';
+export { WorkerRegistry } from './worker-registry.js';
+export type { RegisteredWorker, WorkerRegistryOptions, IWorkerRegistry } from './worker-registry.js';
+export { createRouter, pathToRegex, parseJsonBody, sendJson, sendError, } from './router.js';
+export type { Route, RouteMatch, PathToRegexResult, Router } from './router.js';
+export { InMemoryJobQueue } from './job-queue.js';
+export type { JobQueue } from './job-queue.js';
+export { RedisJobQueue, createJobQueue } from './redis-job-queue.js';
+export { createOrchestratorServer } from './server.js';
+export type { OrchestratorServer, OrchestratorServerOptions } from './server.js';
+export { EventBus } from './event-bus.js';
+export type { EventBusOptions } from './event-bus.js';
+export { LogBuffer, LogBufferManager } from './log-buffer.js';
+export type { LogEntry } from './log-buffer.js';
+export { AsyncEventQueue } from './async-event-queue.js';
+export type { Job, JobStatus, JobPriority, JobResult, WorkerRegistration, Heartbeat, HeartbeatResponse, PollResponse, OrchestratorError, JobEventType, JobEvent, EventFilters, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAErG,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAEjF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,YAAY,EACV,GAAG,EACH,SAAS,EACT,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/orchestrator/index.js

@@ -0,0 +1,15 @@
+/**
+ * Orchestrator module exports
+ */
+export { OrchestratorClient, OrchestratorClientError } from './client.js';
+export { HeartbeatManager } from './heartbeat.js';
+export { JobHandler } from './job-handler.js';
+export { WorkerRegistry } from './worker-registry.js';
+export { createRouter, pathToRegex, parseJsonBody, sendJson, sendError, } from './router.js';
+export { InMemoryJobQueue } from './job-queue.js';
+export { RedisJobQueue, createJobQueue } from './redis-job-queue.js';
+export { createOrchestratorServer } from './server.js';
+export { EventBus } from './event-bus.js';
+export { LogBuffer, LogBufferManager } from './log-buffer.js';
+export { AsyncEventQueue } from './async-event-queue.js';
+//# sourceMappingURL=index.js.map

package/dist/orchestrator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/orchestrator/job-handler.d.ts

@@ -0,0 +1,109 @@
+import { type HumanDecisionHandler, type Logger } from '@generacy-ai/workflow-engine';
+import type { OrchestratorClient } from './client.js';
+import type { Job, JobResult } from './types.js';
+/**
+ * Job handler options
+ */
+export interface JobHandlerOptions {
+    /** Orchestrator client */
+    client: OrchestratorClient;
+    /** Worker ID */
+    workerId: string;
+    /** Poll interval in milliseconds */
+    pollInterval?: number;
+    /** Logger instance */
+    logger: Logger;
+    /** Working directory for job execution */
+    workdir?: string;
+    /** Worker capabilities for job matching */
+    capabilities?: string[];
+    /** Callback when job starts */
+    onJobStart?: (job: Job) => void;
+    /** Callback when job completes */
+    onJobComplete?: (job: Job, result: JobResult) => void;
+    /** Callback for errors */
+    onError?: (error: Error, job?: Job) => void;
+    /** Human decision handler for real human-in-the-loop review */
+    humanDecisionHandler?: HumanDecisionHandler;
+}
+/**
+ * Handles job polling and execution
+ */
+export declare class JobHandler {
+    private readonly client;
+    private readonly workerId;
+    private readonly pollInterval;
+    private readonly logger;
+    private readonly workdir;
+    private readonly capabilities;
+    private readonly onJobStart?;
+    private readonly onJobComplete?;
+    private readonly onError?;
+    private pollTimer;
+    private currentJob;
+    private abortController;
+    private isRunning;
+    private shouldStop;
+    private readonly humanDecisionHandler?;
+    constructor(options: JobHandlerOptions);
+    /**
+     * Start the job polling loop
+     */
+    start(): void;
+    /**
+     * Stop the job polling loop
+     */
+    stop(): void;
+    /**
+     * Cancel the current job
+     */
+    cancelCurrentJob(): void;
+    /**
+     * Get the currently executing job
+     */
+    getCurrentJob(): Job | null;
+    /**
+     * Check if currently executing a job
+     */
+    isBusy(): boolean;
+    /**
+     * Poll for and process jobs
+     */
+    private poll;
+    /**
+     * Execute a job
+     */
+    private executeJob;
+    /**
+     * Resolve the working directory for a job.
+     * Uses MONITORED_REPOS env var to map owner/repo to local workspace paths.
+     * Falls back to job.workdir, then this.workdir.
+     */
+    private resolveJobWorkdir;
+    /**
+     * Resolve a workflow name or path to an absolute file path.
+     * Searches: absolute path, relative to workdir, .generacy/ directory, plugin registry.
+     *
+     * @param workflow - Workflow name or path to resolve
+     * @param jobWorkdir - Job working directory for relative resolution
+     * @param excludePath - Optional resolved path to skip (used by extends to avoid self-resolution)
+     */
+    private resolveWorkflowPath;
+    /**
+     * Resolve which phases have already been attempted based on issue labels.
+     * Recognises both `completed:*` and `failed:*` labels so that phases are
+     * not re-run on retry (failed verification still means the phase executed).
+     * Returns a set of YAML phase names to skip. Setup is never included.
+     */
+    private resolveCompletedPhases;
+    /**
+     * Add a completed:* or failed:* label to the issue after a phase finishes.
+     * Uses `completed:` prefix when the phase succeeded, `failed:` when any step errored.
+     */
+    private addPhaseLabel;
+    /**
+     * Build job result from execution result
+     */
+    private buildJobResult;
+}
+//# sourceMappingURL=job-handler.d.ts.map

package/dist/orchestrator/job-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-handler.d.ts","sourceRoot":"","sources":["../../src/orchestrator/job-handler.ts"],"names":[],"mappings":"AAOA,OAAO,EAWL,KAAK,oBAAoB,EAGzB,KAAK,MAAM,EAGZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,GAAG,EAAgB,SAAS,EAAE,MAAM,YAAY,CAAC;AAiK/D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAE3B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAEhC,kCAAkC;IAClC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAEtD,0BAA0B;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAE5C,+DAA+D;IAC/D,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAwC;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAoC;IAE7D,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAuB;gBAEjD,OAAO,EAAE,iBAAiB;IAetC;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAMxB;;OAEG;IACH,aAAa,IAAI,GAAG,GAAG,IAAI;IAI3B;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;YACW,IAAI;IA2BlB;;OAEG;YACW,UAAU;IAiOxB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;;;;OAKG;YACW,sBAAsB;IA6CpC;;;OAGG;YACW,aAAa;IAqB3B;;OAEG;IACH,OAAO,CAAC,cAAc;CAkCvB"}