@renseiai/agentfactory-cli 0.8.0

package/dist/src/lib/worker-runner.js

@@ -0,0 +1,781 @@
+/**
+ * Worker Runner — Programmatic API for the remote worker CLI.
+ *
+ * Encapsulates all global state into the runner function's closure so that
+ * multiple workers can be started from the same process (e.g. tests) without
+ * leaking state between invocations.
+ */
+import path from 'path';
+import { execSync } from 'child_process';
+import os from 'os';
+import { createOrchestrator, createLogger, } from '@renseiai/agentfactory';
+// ---------------------------------------------------------------------------
+// Helpers (stateless)
+// ---------------------------------------------------------------------------
+function getGitRoot() {
+    try {
+        return execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+const MAX_HEARTBEAT_FAILURES = 3;
+// ---------------------------------------------------------------------------
+// Runner
+// ---------------------------------------------------------------------------
+/**
+ * Run a worker that polls the coordinator for work and executes agents.
+ *
+ * All state is encapsulated in the function closure. The caller can cancel
+ * via the optional {@link AbortSignal}.
+ */
+export async function runWorker(config, signal) {
+    // Resolve config with defaults
+    const hostname = config.hostname ?? os.hostname();
+    const capacity = config.capacity ?? 3;
+    const dryRun = config.dryRun ?? false;
+    const gitRoot = config.gitRoot ?? getGitRoot();
+    const linearApiKey = config.linearApiKey ?? process.env.LINEAR_API_KEY;
+    if (!linearApiKey) {
+        throw new Error('LINEAR_API_KEY is required (pass via config.linearApiKey or set env var)');
+    }
+    // -----------------------------------------------------------------------
+    // State (formerly globals)
+    // -----------------------------------------------------------------------
+    let workerId = null;
+    let workerShortId = null;
+    let activeCount = 0;
+    let running = true;
+    let heartbeatTimer = null;
+    let shutdownInProgress = false;
+    let consecutiveHeartbeatFailures = 0;
+    let reregistrationInProgress = false;
+    let claimFailureCount = 0;
+    const activeOrchestrators = new Map();
+    // Logger — will be re-created after registration with worker context
+    let log = createLogger({}, { showTimestamp: true });
+    // Internal config object used by API helpers
+    const workerConfig = {
+        apiUrl: config.apiUrl,
+        apiKey: config.apiKey,
+        hostname,
+        capacity,
+        dryRun,
+    };
+    // -----------------------------------------------------------------------
+    // AbortSignal handling
+    // -----------------------------------------------------------------------
+    const onAbort = () => {
+        if (shutdownInProgress)
+            return;
+        shutdownInProgress = true;
+        log.warn('Shutting down (abort signal)...');
+        running = false;
+        if (heartbeatTimer)
+            clearInterval(heartbeatTimer);
+        // Fire and forget — server will clean up via heartbeat timeout
+        deregister().catch(() => { });
+    };
+    signal?.addEventListener('abort', onAbort, { once: true });
+    // -----------------------------------------------------------------------
+    // API helpers (closures over workerConfig & log)
+    // -----------------------------------------------------------------------
+    async function apiRequestWithError(apiPath, options = {}, retries = 3) {
+        const url = `${workerConfig.apiUrl}${apiPath}`;
+        for (let attempt = 1; attempt <= retries; attempt++) {
+            try {
+                const response = await fetch(url, {
+                    ...options,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Authorization: `Bearer ${workerConfig.apiKey}`,
+                        ...options.headers,
+                    },
+                });
+                if (!response.ok) {
+                    const errorBody = await response.text();
+                    if (response.status === 404 && errorBody.includes('Worker not found')) {
+                        log.warn(`Worker not found on server: ${apiPath}`, { status: response.status });
+                        return { data: null, error: { type: 'worker_not_found' } };
+                    }
+                    log.error(`API request failed: ${apiPath}`, { status: response.status, body: errorBody });
+                    return { data: null, error: { type: 'server_error', status: response.status, body: errorBody } };
+                }
+                return { data: (await response.json()), error: null };
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                const isLastAttempt = attempt === retries;
+                if (isLastAttempt) {
+                    log.error(`API request error: ${apiPath}`, { error: errorMsg, attempts: attempt });
+                    return { data: null, error: { type: 'network_error', message: errorMsg } };
+                }
+                const delay = Math.pow(2, attempt - 1) * 1000;
+                log.warn(`API request failed, retrying in ${delay}ms: ${apiPath}`, {
+                    error: errorMsg,
+                    attempt,
+                    maxRetries: retries,
+                });
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        return { data: null, error: { type: 'network_error', message: 'Max retries exceeded' } };
+    }
+    async function apiRequest(apiPath, options = {}, retries = 3) {
+        const result = await apiRequestWithError(apiPath, options, retries);
+        return result.data;
+    }
+    // -----------------------------------------------------------------------
+    // Registration
+    // -----------------------------------------------------------------------
+    async function register() {
+        log.info('Registering with coordinator', {
+            apiUrl: workerConfig.apiUrl,
+            hostname: workerConfig.hostname,
+            capacity: workerConfig.capacity,
+        });
+        const result = await apiRequest('/api/workers/register', {
+            method: 'POST',
+            body: JSON.stringify({
+                hostname: workerConfig.hostname,
+                capacity: workerConfig.capacity,
+                version: '1.0.0',
+                projects: config.projects,
+            }),
+        });
+        if (result) {
+            log.status('registered', `Worker ID: ${result.workerId.substring(0, 8)}`);
+        }
+        return result;
+    }
+    async function transferSessionOwnership(sessionId, newWorkerId, oldWorkerId) {
+        const result = await apiRequest(`/api/sessions/${sessionId}/transfer-ownership`, {
+            method: 'POST',
+            body: JSON.stringify({ newWorkerId, oldWorkerId }),
+        });
+        if (result?.transferred) {
+            log.debug('Session ownership transferred', {
+                sessionId: sessionId.substring(0, 8),
+                oldWorkerId: oldWorkerId.substring(0, 8),
+                newWorkerId: newWorkerId.substring(0, 8),
+            });
+            return true;
+        }
+        else {
+            log.warn('Failed to transfer session ownership', {
+                sessionId: sessionId.substring(0, 8),
+                reason: result?.reason,
+            });
+            return false;
+        }
+    }
+    async function attemptReregistration() {
+        if (reregistrationInProgress) {
+            log.debug('Re-registration already in progress, skipping');
+            return false;
+        }
+        reregistrationInProgress = true;
+        const oldWorkerId = workerId;
+        log.warn('Worker not found on server - attempting to re-register');
+        try {
+            const registration = await register();
+            if (registration) {
+                const newWid = registration.workerId;
+                workerId = newWid;
+                workerShortId = newWid.substring(4, 8); // Skip 'wkr_' prefix
+                consecutiveHeartbeatFailures = 0;
+                log.status('re-registered', `New Worker ID: ${workerShortId}`);
+                // Transfer ownership of active sessions to the new worker ID
+                if (oldWorkerId && activeOrchestrators.size > 0) {
+                    log.info('Transferring ownership of active sessions', {
+                        sessionCount: activeOrchestrators.size,
+                        oldWorkerId: oldWorkerId.substring(0, 8),
+                        newWorkerId: newWid.substring(0, 8),
+                    });
+                    const transferPromises = [];
+                    for (const sessionId of activeOrchestrators.keys()) {
+                        transferPromises.push(transferSessionOwnership(sessionId, newWid, oldWorkerId));
+                    }
+                    const results = await Promise.all(transferPromises);
+                    const successCount = results.filter(Boolean).length;
+                    log.info('Session ownership transfer complete', {
+                        total: results.length,
+                        succeeded: successCount,
+                        failed: results.length - successCount,
+                    });
+                    // Update worker ID in all active orchestrators' activity emitters
+                    for (const [sessionId, orchestrator] of activeOrchestrators.entries()) {
+                        orchestrator.updateWorkerId(newWid);
+                        log.debug('Updated orchestrator worker ID', {
+                            sessionId: sessionId.substring(0, 8),
+                        });
+                    }
+                }
+                return true;
+            }
+            log.error('Re-registration failed');
+            return false;
+        }
+        finally {
+            reregistrationInProgress = false;
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Heartbeat
+    // -----------------------------------------------------------------------
+    async function sendHeartbeat() {
+        if (!workerId)
+            return;
+        const result = await apiRequestWithError(`/api/workers/${workerId}/heartbeat`, {
+            method: 'POST',
+            body: JSON.stringify({
+                activeCount,
+                load: {
+                    cpu: os.loadavg()[0],
+                    memory: 1 - os.freemem() / os.totalmem(),
+                },
+            }),
+        });
+        if (result.data) {
+            consecutiveHeartbeatFailures = 0;
+            if (claimFailureCount > 0) {
+                log.info('Claim race summary since last heartbeat', { claimFailures: claimFailureCount });
+                claimFailureCount = 0;
+            }
+            log.debug('Heartbeat acknowledged', {
+                activeCount,
+                pendingWorkCount: result.data.pendingWorkCount,
+            });
+        }
+        else if (result.error?.type === 'worker_not_found') {
+            consecutiveHeartbeatFailures++;
+            await attemptReregistration();
+        }
+        else {
+            consecutiveHeartbeatFailures++;
+            log.warn('Heartbeat failed', {
+                consecutiveFailures: consecutiveHeartbeatFailures,
+                maxFailures: MAX_HEARTBEAT_FAILURES,
+                errorType: result.error?.type,
+            });
+            if (consecutiveHeartbeatFailures >= MAX_HEARTBEAT_FAILURES) {
+                log.error('Multiple heartbeat failures - checking if re-registration needed', {
+                    consecutiveFailures: consecutiveHeartbeatFailures,
+                });
+                await attemptReregistration();
+            }
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Polling & claiming
+    // -----------------------------------------------------------------------
+    async function pollForWork() {
+        if (!workerId)
+            return { work: [], pendingPrompts: {}, hasPendingPrompts: false };
+        const result = await apiRequestWithError(`/api/workers/${workerId}/poll`);
+        if (result.error?.type === 'worker_not_found') {
+            await attemptReregistration();
+            return { work: [], pendingPrompts: {}, hasPendingPrompts: false };
+        }
+        if (!result.data) {
+            return { work: [], pendingPrompts: {}, hasPendingPrompts: false };
+        }
+        const pollData = result.data;
+        if (pollData.hasPendingPrompts) {
+            const totalPrompts = Object.values(pollData.pendingPrompts).reduce((sum, prompts) => sum + prompts.length, 0);
+            log.info('Received pending prompts', {
+                sessionCount: Object.keys(pollData.pendingPrompts).length,
+                totalPrompts,
+                sessions: Object.entries(pollData.pendingPrompts).map(([sessionId, prompts]) => ({
+                    sessionId: sessionId.substring(0, 8),
+                    promptCount: prompts.length,
+                    promptIds: prompts.map((p) => p.id),
+                })),
+            });
+        }
+        return pollData;
+    }
+    async function claimWork(sessionId) {
+        if (!workerId)
+            return null;
+        return apiRequest(`/api/sessions/${sessionId}/claim`, {
+            method: 'POST',
+            body: JSON.stringify({ workerId }),
+        });
+    }
+    async function reportStatus(sessionId, status, extra) {
+        if (!workerId)
+            return;
+        await apiRequest(`/api/sessions/${sessionId}/status`, {
+            method: 'POST',
+            body: JSON.stringify({
+                workerId,
+                status,
+                ...extra,
+            }),
+        });
+        log.debug(`Reported status: ${status}`, { sessionId });
+    }
+    async function postProgress(sessionId, milestone, message) {
+        if (!workerId)
+            return;
+        const result = await apiRequest(`/api/sessions/${sessionId}/progress`, {
+            method: 'POST',
+            body: JSON.stringify({
+                workerId,
+                milestone,
+                message,
+            }),
+        });
+        if (result?.posted) {
+            log.debug(`Progress posted: ${milestone}`, { sessionId });
+        }
+        else {
+            log.warn(`Failed to post progress: ${milestone}`, { reason: result?.reason });
+        }
+    }
+    async function checkSessionOwnership(sessionId) {
+        return apiRequest(`/api/sessions/${sessionId}/status`);
+    }
+    async function checkSessionStopped(sessionId) {
+        const result = await apiRequest(`/api/sessions/${sessionId}/status`);
+        return result?.status === 'stopped';
+    }
+    async function deregister() {
+        if (!workerId)
+            return;
+        log.info('Deregistering worker');
+        const result = await apiRequest(`/api/workers/${workerId}`, {
+            method: 'DELETE',
+        });
+        if (result) {
+            log.status('stopped', `Unclaimed sessions: ${result.unclaimedSessions.length}`);
+        }
+        workerId = null;
+    }
+    // -----------------------------------------------------------------------
+    // Agent logger factory
+    // -----------------------------------------------------------------------
+    function createAgentLogger(issueIdentifier) {
+        return log.child({ issueIdentifier });
+    }
+    // -----------------------------------------------------------------------
+    // Work execution
+    // -----------------------------------------------------------------------
+    async function executeWork(work) {
+        const agentLog = createAgentLogger(work.issueIdentifier);
+        const isResume = !!work.providerSessionId;
+        agentLog.section(`${isResume ? 'Resuming' : 'Starting'} work on ${work.issueIdentifier}`);
+        agentLog.info('Work details', {
+            hasPrompt: !!work.prompt,
+            isResume,
+            workType: work.workType,
+        });
+        activeCount++;
+        // Two-phase completion: set in try/catch, read in finally
+        let finalStatus = 'failed';
+        let statusPayload;
+        // Issue lock TTL refresher
+        let lockRefresher = null;
+        try {
+            await reportStatus(work.sessionId, 'running');
+            // Start lock TTL refresher (refresh every 60s, lock TTL is 2 hours)
+            if (work.issueId) {
+                lockRefresher = setInterval(async () => {
+                    try {
+                        const response = await apiRequest(`/api/sessions/${work.sessionId}/lock-refresh`, {
+                            method: 'POST',
+                            body: JSON.stringify({ workerId, issueId: work.issueId }),
+                        });
+                        if (response?.refreshed) {
+                            agentLog.debug('Issue lock TTL refreshed');
+                        }
+                    }
+                    catch {
+                        // Non-fatal — lock has a 2hr TTL so missing one refresh is fine
+                    }
+                }, 60_000);
+            }
+            // Post initial progress
+            await postProgress(work.sessionId, isResume ? 'resumed' : 'claimed', isResume
+                ? `Resuming work on ${work.issueIdentifier}`
+                : `Worker claimed ${work.issueIdentifier}. Setting up environment...`);
+            // Create orchestrator with API activity proxy
+            const orchestrator = createOrchestrator({
+                maxConcurrent: 1,
+                worktreePath: path.resolve(gitRoot, '.worktrees'),
+                apiActivityConfig: {
+                    baseUrl: workerConfig.apiUrl,
+                    apiKey: workerConfig.apiKey,
+                    workerId: workerId,
+                },
+            }, {
+                onIssueSelected: (issue) => {
+                    agentLog.info('Issue fetched', {
+                        title: issue.title.slice(0, 50),
+                        labels: issue.labels.join(', '),
+                    });
+                },
+                onAgentStart: (agent) => {
+                    agentLog.status('running', agent.pid ? `PID: ${agent.pid}` : 'spawning');
+                    agentLog.debug('Agent details', {
+                        worktree: agent.worktreePath,
+                    });
+                    reportStatus(work.sessionId, 'running', {
+                        providerSessionId: agent.sessionId,
+                        worktreePath: agent.worktreePath,
+                    });
+                    postProgress(work.sessionId, 'started', `Agent started working on ${agent.identifier}`);
+                },
+                onAgentComplete: (agent) => {
+                    agentLog.status('completed', `Exit code: ${agent.exitCode}`);
+                },
+                onAgentError: (_agent, error) => {
+                    agentLog.error('Agent error', { error: error.message });
+                },
+                onAgentStopped: (_agent) => {
+                    agentLog.status('stopped');
+                },
+                onAgentIncomplete: (agent) => {
+                    agentLog.warn('Agent incomplete - worktree preserved', {
+                        reason: agent.incompleteReason,
+                        worktreePath: agent.worktreePath,
+                    });
+                },
+                onProviderSessionId: (_linearSessionId, providerSessionId) => {
+                    agentLog.debug('Provider session captured', { providerSessionId });
+                    reportStatus(work.sessionId, 'running', {
+                        providerSessionId,
+                    });
+                },
+            });
+            // Store orchestrator for prompt forwarding
+            activeOrchestrators.set(work.sessionId, orchestrator);
+            agentLog.debug('Orchestrator registered for session', {
+                sessionId: work.sessionId.substring(0, 8),
+            });
+            let spawnedAgent;
+            // Retry configuration for "agent already running" conflicts
+            const MAX_SPAWN_RETRIES = 3;
+            const SPAWN_RETRY_DELAY_MS = 15000;
+            if (work.providerSessionId) {
+                // Resume existing Claude session
+                agentLog.info('Resuming provider session', {
+                    providerSessionId: work.providerSessionId.substring(0, 12),
+                });
+                const prompt = work.prompt || `Continue work on ${work.issueIdentifier}`;
+                const result = await orchestrator.forwardPrompt(work.issueId, work.sessionId, prompt, work.providerSessionId, work.workType);
+                if (!result.forwarded || !result.agent) {
+                    throw new Error(`Failed to resume session: ${result.reason || 'unknown error'}`);
+                }
+                agentLog.success('Session resumed');
+                spawnedAgent = result.agent;
+            }
+            else {
+                // Fresh start with retry logic
+                agentLog.info('Spawning new agent', { workType: work.workType });
+                let lastError = null;
+                for (let attempt = 1; attempt <= MAX_SPAWN_RETRIES; attempt++) {
+                    try {
+                        spawnedAgent = await orchestrator.spawnAgentForIssue(work.issueIdentifier, work.sessionId, work.workType, work.prompt);
+                        break;
+                    }
+                    catch (err) {
+                        lastError = err instanceof Error ? err : new Error(String(err));
+                        const isAgentRunning = lastError.message.includes('Agent already running') ||
+                            lastError.message.includes('Agent is still running');
+                        const isBranchConflict = lastError.message.includes('already checked out') ||
+                            lastError.message.includes('is already checked out at');
+                        const isRetriable = isAgentRunning || isBranchConflict;
+                        if (isRetriable && attempt < MAX_SPAWN_RETRIES) {
+                            // For "agent already running" errors, check if another worker owns this session
+                            // If so, bail immediately instead of wasting retries
+                            if (isAgentRunning && !isBranchConflict) {
+                                try {
+                                    const sessionStatus = await checkSessionOwnership(work.sessionId);
+                                    if (sessionStatus?.workerId && sessionStatus.workerId !== workerId) {
+                                        agentLog.warn('Session owned by another worker, abandoning spawn', {
+                                            ownerWorkerId: sessionStatus.workerId.substring(0, 8),
+                                        });
+                                        throw new Error(`Session owned by another worker: ${sessionStatus.workerId}`);
+                                    }
+                                }
+                                catch (ownershipErr) {
+                                    // Re-throw ownership errors, swallow check failures
+                                    if (ownershipErr instanceof Error && ownershipErr.message.includes('Session owned by another worker')) {
+                                        throw ownershipErr;
+                                    }
+                                }
+                            }
+                            const reason = isBranchConflict
+                                ? 'Branch in use by another agent'
+                                : 'Agent still running';
+                            agentLog.warn(`${reason}, waiting to retry (attempt ${attempt}/${MAX_SPAWN_RETRIES})`, { retryInMs: SPAWN_RETRY_DELAY_MS });
+                            await postProgress(work.sessionId, 'waiting', `${reason}, waiting to retry (${attempt}/${MAX_SPAWN_RETRIES})...`);
+                            await new Promise((resolve) => setTimeout(resolve, SPAWN_RETRY_DELAY_MS));
+                        }
+                        else {
+                            throw lastError;
+                        }
+                    }
+                }
+                if (!spawnedAgent) {
+                    throw lastError || new Error('Failed to spawn agent after retries');
+                }
+            }
+            agentLog.info('Agent spawned', {
+                pid: spawnedAgent.pid,
+                status: spawnedAgent.status,
+            });
+            if (!spawnedAgent.pid) {
+                agentLog.warn('Agent has no PID - spawn may have failed');
+            }
+            // Start a stop signal checker
+            let stopRequested = false;
+            const stopChecker = setInterval(async () => {
+                try {
+                    if (await checkSessionStopped(work.sessionId)) {
+                        agentLog.warn('Stop signal received');
+                        stopRequested = true;
+                        clearInterval(stopChecker);
+                        await orchestrator.stopAgent(work.issueId, false);
+                    }
+                }
+                catch {
+                    // Ignore errors in stop checker
+                }
+            }, 5000);
+            // Wait for agent to complete
+            agentLog.info('Waiting for agent to complete...');
+            const results = await orchestrator.waitForAll();
+            const agent = results[0];
+            clearInterval(stopChecker);
+            // Determine final status
+            if (stopRequested || agent?.stopReason === 'user_request') {
+                finalStatus = 'stopped';
+                await reportStatus(work.sessionId, 'finalizing');
+                await postProgress(work.sessionId, 'stopped', `Work stopped by user request`);
+                agentLog.status('stopped', 'Work stopped by user request');
+            }
+            else if (agent?.stopReason === 'timeout') {
+                finalStatus = 'failed';
+                statusPayload = { error: { message: 'Agent timed out' } };
+                await reportStatus(work.sessionId, 'finalizing');
+                await postProgress(work.sessionId, 'failed', `Work timed out`);
+                agentLog.status('stopped', 'Work timed out');
+            }
+            else if (agent?.status === 'completed') {
+                finalStatus = 'completed';
+                statusPayload = {
+                    providerSessionId: agent.sessionId,
+                    worktreePath: agent.worktreePath,
+                    totalCostUsd: agent.totalCostUsd,
+                    inputTokens: agent.inputTokens,
+                    outputTokens: agent.outputTokens,
+                };
+                await reportStatus(work.sessionId, 'finalizing');
+                await postProgress(work.sessionId, 'completed', `Work completed successfully on ${work.issueIdentifier}`);
+                agentLog.success('Work completed successfully');
+            }
+            else {
+                const errorMsg = agent?.error?.message || 'Agent did not complete successfully';
+                finalStatus = 'failed';
+                statusPayload = { error: { message: errorMsg } };
+                await reportStatus(work.sessionId, 'finalizing');
+                await postProgress(work.sessionId, 'failed', `Work failed: ${errorMsg}`);
+                agentLog.error('Work failed', { error: errorMsg });
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+            agentLog.error('Work execution failed', { error: errorMsg });
+            finalStatus = 'failed';
+            statusPayload = { error: { message: errorMsg } };
+            await reportStatus(work.sessionId, 'finalizing').catch(() => { });
+            await postProgress(work.sessionId, 'failed', `Work failed: ${errorMsg}`);
+        }
+        finally {
+            if (lockRefresher)
+                clearInterval(lockRefresher);
+            activeOrchestrators.delete(work.sessionId);
+            agentLog.debug('Orchestrator unregistered for session', {
+                sessionId: work.sessionId.substring(0, 8),
+            });
+            activeCount--;
+            // Report true terminal status AFTER all cleanup
+            await reportStatus(work.sessionId, finalStatus, statusPayload).catch((err) => {
+                agentLog.error('Failed to report final status', {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Main logic
+    // -----------------------------------------------------------------------
+    try {
+        log.section('AgentFactory Worker');
+        log.info('Configuration', {
+            apiUrl: workerConfig.apiUrl,
+            hostname: workerConfig.hostname,
+            capacity: workerConfig.capacity,
+            dryRun: workerConfig.dryRun,
+            projects: config.projects?.length ? config.projects : 'all',
+        });
+        // Register with coordinator
+        const registration = await register();
+        if (!registration) {
+            throw new Error('Failed to register with coordinator');
+        }
+        workerId = registration.workerId;
+        workerShortId = registration.workerId.substring(0, 8);
+        // Update logger with worker context
+        log = createLogger({ workerId, workerShortId }, { showTimestamp: true });
+        // Auto-inherit projects from server if not explicitly configured
+        if (!config.projects?.length) {
+            try {
+                const serverConfig = await apiRequest('/api/config');
+                if (serverConfig?.projects?.length) {
+                    config.projects = serverConfig.projects;
+                    log.info('Auto-inherited projects from server', { projects: config.projects });
+                }
+            }
+            catch {
+                log.debug('Could not fetch server config, using no project filter');
+            }
+        }
+        // Set up heartbeat
+        heartbeatTimer = setInterval(() => sendHeartbeat(), registration.heartbeatInterval);
+        // Send initial heartbeat
+        await sendHeartbeat();
+        // Main poll loop
+        log.info('Starting poll loop...');
+        while (running) {
+            if (signal?.aborted)
+                break;
+            try {
+                const availableCapacity = workerConfig.capacity - activeCount;
+                const pollResult = await pollForWork();
+                // Handle new work items if we have capacity
+                if (availableCapacity > 0 && pollResult.work.length > 0) {
+                    log.info(`Found ${pollResult.work.length} work item(s)`, {
+                        activeCount,
+                        availableCapacity,
+                    });
+                    for (const item of pollResult.work.slice(0, availableCapacity)) {
+                        if (!running)
+                            break;
+                        const claimResult = await claimWork(item.sessionId);
+                        if (claimResult?.claimed) {
+                            log.status('claimed', item.issueIdentifier);
+                            if (workerConfig.dryRun) {
+                                log.info(`[DRY RUN] Would execute: ${item.issueIdentifier}`);
+                            }
+                            else {
+                                executeWork(item).catch((error) => {
+                                    log.error('Background work execution failed', {
+                                        error: error instanceof Error ? error.message : String(error),
+                                    });
+                                });
+                            }
+                        }
+                        else {
+                            claimFailureCount++;
+                            log.debug(`Failed to claim work: ${item.issueIdentifier}`);
+                        }
+                    }
+                }
+                // Handle pending prompts for active sessions
+                if (pollResult.hasPendingPrompts) {
+                    for (const [sessionId, prompts] of Object.entries(pollResult.pendingPrompts)) {
+                        for (const prompt of prompts) {
+                            log.info('Processing pending prompt', {
+                                sessionId: sessionId.substring(0, 8),
+                                promptId: prompt.id,
+                                promptLength: prompt.prompt.length,
+                                userName: prompt.userName,
+                            });
+                            const orchestrator = activeOrchestrators.get(sessionId);
+                            if (!orchestrator) {
+                                log.warn('No active orchestrator found for session', {
+                                    sessionId: sessionId.substring(0, 8),
+                                    promptId: prompt.id,
+                                });
+                                continue;
+                            }
+                            const agent = orchestrator.getAgentBySession(sessionId);
+                            const providerSessionId = agent?.providerSessionId;
+                            log.info('Forwarding prompt to provider session', {
+                                sessionId: sessionId.substring(0, 8),
+                                promptId: prompt.id,
+                                hasProviderSession: !!providerSessionId,
+                                agentStatus: agent?.status,
+                            });
+                            try {
+                                const result = await orchestrator.forwardPrompt(prompt.issueId, sessionId, prompt.prompt, providerSessionId, agent?.workType);
+                                if (result.forwarded) {
+                                    log.success(result.injected
+                                        ? 'Message injected into running session'
+                                        : 'Prompt forwarded successfully', {
+                                        sessionId: sessionId.substring(0, 8),
+                                        promptId: prompt.id,
+                                        injected: result.injected ?? false,
+                                        resumed: result.resumed,
+                                        newAgentPid: result.agent?.pid,
+                                    });
+                                    const claimResult = await apiRequest(`/api/sessions/${sessionId}/prompts`, {
+                                        method: 'POST',
+                                        body: JSON.stringify({ promptId: prompt.id }),
+                                    });
+                                    if (claimResult?.claimed) {
+                                        log.debug('Prompt claimed', { promptId: prompt.id });
+                                    }
+                                    else {
+                                        log.warn('Failed to claim prompt', { promptId: prompt.id });
+                                    }
+                                }
+                                else {
+                                    log.error('Failed to forward prompt', {
+                                        sessionId: sessionId.substring(0, 8),
+                                        promptId: prompt.id,
+                                        reason: result.reason,
+                                        error: result.error?.message,
+                                    });
+                                }
+                            }
+                            catch (error) {
+                                log.error('Error forwarding prompt', {
+                                    sessionId: sessionId.substring(0, 8),
+                                    promptId: prompt.id,
+                                    error: error instanceof Error ? error.message : String(error),
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                log.error('Poll loop error', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            // Wait before next poll
+            await new Promise((resolve) => setTimeout(resolve, registration.pollInterval));
+        }
+    }
+    finally {
+        signal?.removeEventListener('abort', onAbort);
+        // Clean up timers
+        if (heartbeatTimer)
+            clearInterval(heartbeatTimer);
+        // Deregister if we haven't already
+        if (workerId && !shutdownInProgress) {
+            await deregister().catch(() => { });
+        }
+        log.status('stopped', 'Shutdown complete');
+    }
+}