ghcralph 0.1.0

package/dist/core/loop-engine.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Loop Engine
+ *
+ * The core engine that runs the autonomous coding loop.
+ * Implements the Ralph pattern: parse → execute → verify → feedback.
+ */
+import type { Task } from '../types/index.js';
+import type { CopilotAgent } from '../integrations/index.js';
+import { type TokenUsage } from '../integrations/index.js';
+import { LoopEventEmitter } from './loop-events.js';
+import { type FullLoopState } from './loop-state.js';
+import { type ContextBuilderConfig } from './context-builder.js';
+import { type ActionExecutorConfig } from './action-executor.js';
+import { type VerificationConfig } from './verification-hooks.js';
+import { type FeedbackBuilderConfig } from './feedback-builder.js';
+/**
+ * Loop engine configuration
+ */
+export interface LoopEngineConfig {
+    /** Maximum number of iterations */
+    maxIterations: number;
+    /** Maximum token budget */
+    maxTokens: number;
+    /** Maximum duration in minutes (0 = no limit) */
+    maxDurationMinutes: number;
+    /** Delay between iterations in ms */
+    iterationDelayMs: number;
+    /** Warning threshold percentage (default: 0.8 = 80%) */
+    warningThreshold: number;
+    /** Maximum consecutive failures before pausing */
+    maxConsecutiveFailures: number;
+    /** Whether unlimited iterations are allowed */
+    allowUnlimited: boolean;
+    /** Context builder configuration */
+    contextConfig?: Partial<ContextBuilderConfig>;
+    /** Action executor configuration */
+    actionExecutorConfig?: Partial<ActionExecutorConfig>;
+    /** Verification manager configuration */
+    verificationConfig?: Partial<VerificationConfig>;
+    /** Feedback builder configuration */
+    feedbackConfig?: Partial<FeedbackBuilderConfig>;
+    /** Working directory for file operations */
+    cwd?: string;
+    /** Whether to run verification hooks */
+    runVerification?: boolean;
+    /** Whether to execute actions (false = dry run) */
+    executeActions?: boolean;
+}
+/**
+ * Loop completion reason
+ */
+export type LoopCompletionReason = 'task-complete' | 'max-iterations' | 'max-tokens' | 'max-duration' | 'circuit-breaker' | 'stopped' | 'paused' | 'error';
+/**
+ * LoopEngine class - the heart of Ralph CLI
+ *
+ * Implements the Ralph pattern:
+ * 1. Send prompt to AI
+ * 2. Parse structured response for actions
+ * 3. Execute actions (CREATE, EDIT, DELETE, EXECUTE)
+ * 4. Run verification hooks (tests, build)
+ * 5. Build feedback for next iteration
+ * 6. Stop when COMPLETE action received AND verification passes
+ */
+export declare class LoopEngine {
+    private config;
+    private agent;
+    private events;
+    private contextBuilder;
+    private actionExecutor;
+    private verificationManager;
+    private feedbackBuilder;
+    private state;
+    private pauseRequested;
+    private stopRequested;
+    private consecutiveFailures;
+    private iterationWarningShown;
+    private tokenWarningShown;
+    private lastFeedback;
+    constructor(agent: CopilotAgent, config?: Partial<LoopEngineConfig>);
+    /**
+     * Get the event emitter for subscribing to loop events
+     */
+    getEvents(): LoopEventEmitter;
+    /**
+     * Get the current loop state
+     */
+    getState(): FullLoopState | null;
+    /**
+     * Start the loop for a task
+     */
+    start(task: Task): Promise<FullLoopState>;
+    /**
+     * Pause the current loop
+     */
+    pause(): void;
+    /**
+     * Resume a paused loop
+     */
+    resume(): Promise<FullLoopState | null>;
+    /**
+     * Stop the current loop
+     */
+    stop(): void;
+    /**
+     * The main loop execution
+     */
+    private runLoop;
+    /**
+     * Check if the loop should continue
+     */
+    private shouldContinue;
+    /**
+     * Check thresholds and emit warnings
+     */
+    private checkThresholds;
+    /**
+     * Run a single iteration (Ralph pattern)
+     */
+    private runIteration;
+    /**
+     * Extract a summary from the response
+     */
+    private extractSummary;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Get token usage summary
+     */
+    getTokenUsage(): TokenUsage;
+}
+//# sourceMappingURL=loop-engine.d.ts.map

package/dist/core/loop-engine.d.ts.map

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

package/dist/core/loop-engine.js

@@ -0,0 +1,420 @@
+/**
+ * Loop Engine
+ *
+ * The core engine that runs the autonomous coding loop.
+ * Implements the Ralph pattern: parse → execute → verify → feedback.
+ */
+import { debug, info, error as logError, warn } from '../utils/index.js';
+import { LoopEventEmitter } from './loop-events.js';
+import { createInitialState, createIterationRecord, completeIteration, } from './loop-state.js';
+import { ContextBuilder } from './context-builder.js';
+import { parseResponse, getCompleteAction } from './response-parser.js';
+import { createActionExecutor } from './action-executor.js';
+import { createVerificationManager } from './verification-hooks.js';
+import { createFeedbackBuilder } from './feedback-builder.js';
+/**
+ * Default engine configuration
+ */
+const DEFAULT_CONFIG = {
+    maxIterations: 10,
+    maxTokens: 100000,
+    maxDurationMinutes: 0,
+    iterationDelayMs: 500,
+    warningThreshold: 0.8,
+    maxConsecutiveFailures: 3,
+    allowUnlimited: false,
+    runVerification: true,
+    executeActions: true,
+};
+/**
+ * LoopEngine class - the heart of Ralph CLI
+ *
+ * Implements the Ralph pattern:
+ * 1. Send prompt to AI
+ * 2. Parse structured response for actions
+ * 3. Execute actions (CREATE, EDIT, DELETE, EXECUTE)
+ * 4. Run verification hooks (tests, build)
+ * 5. Build feedback for next iteration
+ * 6. Stop when COMPLETE action received AND verification passes
+ */
+export class LoopEngine {
+    config;
+    agent;
+    events;
+    contextBuilder;
+    actionExecutor;
+    verificationManager;
+    feedbackBuilder;
+    state = null;
+    pauseRequested = false;
+    stopRequested = false;
+    consecutiveFailures = 0;
+    iterationWarningShown = false;
+    tokenWarningShown = false;
+    lastFeedback = '';
+    constructor(agent, config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.agent = agent;
+        this.events = new LoopEventEmitter();
+        const cwd = config.cwd ?? process.cwd();
+        this.contextBuilder = new ContextBuilder(config.contextConfig, cwd);
+        this.actionExecutor = createActionExecutor({
+            cwd,
+            execute: this.config.executeActions !== false,
+            ...config.actionExecutorConfig,
+        });
+        this.verificationManager = createVerificationManager({
+            cwd,
+            ...config.verificationConfig,
+        });
+        this.feedbackBuilder = createFeedbackBuilder({
+            cwd,
+            ...config.feedbackConfig,
+        });
+    }
+    /**
+     * Get the event emitter for subscribing to loop events
+     */
+    getEvents() {
+        return this.events;
+    }
+    /**
+     * Get the current loop state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Start the loop for a task
+     */
+    async start(task) {
+        if (this.state?.status === 'running') {
+            throw new Error('Loop is already running');
+        }
+        // Initialize state
+        this.state = createInitialState(task);
+        this.state.task.status = 'in-progress';
+        this.pauseRequested = false;
+        this.stopRequested = false;
+        debug(`Starting loop for task: ${task.title}`);
+        this.events.emit('start', task);
+        try {
+            // Ensure agent is initialized
+            if (!this.agent.isInitialized()) {
+                const initialized = await this.agent.initialize();
+                if (!initialized) {
+                    throw new Error('Failed to initialize Copilot agent');
+                }
+            }
+            // Run the loop
+            await this.runLoop();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.state.status = 'failed';
+            this.state.endedAt = new Date();
+            this.events.emit('error', error, this.state);
+            logError(`Loop failed: ${error.message}`);
+        }
+        return this.state;
+    }
+    /**
+     * Pause the current loop
+     */
+    pause() {
+        if (this.state?.status !== 'running') {
+            warn('No running loop to pause');
+            return;
+        }
+        info('Pause requested...');
+        this.pauseRequested = true;
+    }
+    /**
+     * Resume a paused loop
+     */
+    async resume() {
+        if (this.state?.status !== 'paused') {
+            warn('No paused loop to resume');
+            return null;
+        }
+        info('Resuming loop...');
+        this.pauseRequested = false;
+        this.state.status = 'running';
+        this.events.emit('resume', this.state);
+        try {
+            await this.runLoop();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.state.status = 'failed';
+            this.state.endedAt = new Date();
+            this.events.emit('error', error, this.state);
+        }
+        return this.state;
+    }
+    /**
+     * Stop the current loop
+     */
+    stop() {
+        if (!this.state || this.state.status === 'completed' || this.state.status === 'stopped') {
+            warn('No active loop to stop');
+            return;
+        }
+        info('Stop requested...');
+        this.stopRequested = true;
+    }
+    /**
+     * The main loop execution
+     */
+    async runLoop() {
+        if (!this.state)
+            return;
+        while (this.shouldContinue()) {
+            // Check for pause request
+            if (this.pauseRequested) {
+                this.state.status = 'paused';
+                this.events.emit('pause', this.state);
+                debug('Loop paused');
+                return;
+            }
+            // Check for stop request
+            if (this.stopRequested) {
+                this.state.status = 'stopped';
+                this.state.endedAt = new Date();
+                this.events.emit('stop', this.state);
+                debug('Loop stopped');
+                return;
+            }
+            // Run iteration
+            await this.runIteration();
+            // Brief delay between iterations
+            if (this.shouldContinue()) {
+                await this.sleep(this.config.iterationDelayMs);
+            }
+        }
+        // Loop completed
+        this.state.status = 'completed';
+        this.state.endedAt = new Date();
+        this.state.task.status = 'completed';
+        this.events.emit('complete', this.state);
+    }
+    /**
+     * Check if the loop should continue
+     */
+    shouldContinue() {
+        if (!this.state)
+            return false;
+        // Check iteration limit
+        if (this.state.iteration >= this.config.maxIterations) {
+            debug(`Max iterations reached (${this.config.maxIterations})`);
+            return false;
+        }
+        // Check for unlimited iterations (>50 requires explicit flag)
+        if (this.config.maxIterations > 50 && !this.config.allowUnlimited) {
+            debug('More than 50 iterations requires --unlimited flag');
+            return false;
+        }
+        // Check token limit
+        if (this.state.tokensUsed >= this.config.maxTokens) {
+            debug(`Max tokens reached (${this.config.maxTokens})`);
+            return false;
+        }
+        // Check duration limit
+        if (this.config.maxDurationMinutes > 0) {
+            const elapsed = Date.now() - this.state.startedAt.getTime();
+            const maxDurationMs = this.config.maxDurationMinutes * 60 * 1000;
+            if (elapsed >= maxDurationMs) {
+                debug(`Max duration reached (${this.config.maxDurationMinutes} minutes)`);
+                return false;
+            }
+        }
+        // Check circuit breaker
+        if (this.consecutiveFailures >= this.config.maxConsecutiveFailures) {
+            debug(`Circuit breaker triggered after ${this.consecutiveFailures} consecutive failures`);
+            this.events.emit('warning', 'circuit-breaker', `${this.consecutiveFailures} consecutive iterations produced no changes. Pausing for review.`, this.state);
+            return false;
+        }
+        // Check task status
+        if (this.state.task.status === 'completed') {
+            debug('Task marked as complete');
+            return false;
+        }
+        // Emit threshold warnings
+        this.checkThresholds();
+        return true;
+    }
+    /**
+     * Check thresholds and emit warnings
+     */
+    checkThresholds() {
+        if (!this.state)
+            return;
+        const { iteration, tokensUsed, startedAt } = this.state;
+        const { maxIterations, maxTokens, maxDurationMinutes, warningThreshold } = this.config;
+        // Iteration threshold warning
+        const iterationRatio = iteration / maxIterations;
+        if (iterationRatio >= warningThreshold && !this.iterationWarningShown) {
+            this.iterationWarningShown = true;
+            this.events.emit('warning', 'iteration-threshold', `${iteration}/${maxIterations} iterations used (${Math.round(iterationRatio * 100)}%)`, this.state);
+        }
+        // Token threshold warning
+        const tokenRatio = tokensUsed / maxTokens;
+        if (tokenRatio >= warningThreshold && !this.tokenWarningShown) {
+            this.tokenWarningShown = true;
+            this.events.emit('warning', 'token-threshold', `Token usage at ${Math.round(tokenRatio * 100)}% of budget (${tokensUsed.toLocaleString()}/${maxTokens.toLocaleString()})`, this.state);
+        }
+        // Duration threshold warning
+        if (maxDurationMinutes > 0) {
+            const elapsed = Date.now() - startedAt.getTime();
+            const maxDurationMs = maxDurationMinutes * 60 * 1000;
+            const durationRatio = elapsed / maxDurationMs;
+            if (durationRatio >= warningThreshold) {
+                this.events.emit('warning', 'duration-threshold', `Duration at ${Math.round(durationRatio * 100)}% of limit`, this.state);
+            }
+        }
+    }
+    /**
+     * Run a single iteration (Ralph pattern)
+     */
+    async runIteration() {
+        if (!this.state)
+            return;
+        this.state.iteration++;
+        const record = createIterationRecord(this.state.iteration);
+        debug(`Starting iteration ${this.state.iteration}`);
+        this.events.emit('iterationStart', this.state.iteration, this.state);
+        try {
+            // Build context/prompt using the context builder
+            // Include feedback from previous iteration if available
+            const builtContext = await this.contextBuilder.buildContext(this.state.task, this.state.iteration, this.config.maxIterations, this.state.tokensUsed, this.config.maxTokens, this.state.iterations, this.lastFeedback || undefined);
+            if (builtContext.truncated) {
+                warn('Context was truncated to fit within token limits');
+            }
+            debug(`Context includes ${builtContext.filesIncluded.length} files, ~${builtContext.estimatedTokens} tokens`);
+            // Execute via agent
+            const result = await this.agent.execute(builtContext.prompt);
+            if (result.success && result.tokenUsage) {
+                // Reset consecutive failures counter on success
+                this.consecutiveFailures = 0;
+                // Update token usage
+                this.state.tokensUsed += result.tokenUsage.totalTokens;
+                // Emit token usage event
+                this.events.emit('tokenUsage', result.tokenUsage, this.agent.getTokenUsage());
+                const responseContent = result.content ?? '';
+                // === RALPH PATTERN: Parse → Execute → Verify → Feedback ===
+                // 1. Parse the AI response for structured actions
+                const parseResult = parseResponse(responseContent);
+                debug(`Parsed ${parseResult.actions.length} actions from response`);
+                // 2. Execute the actions
+                let executionResult = null;
+                if (parseResult.actions.length > 0 && this.config.executeActions) {
+                    info(`Executing ${parseResult.actions.length} action(s)...`);
+                    executionResult = await this.actionExecutor.executeAll(parseResult);
+                    for (const actionResult of executionResult.results) {
+                        const icon = actionResult.success ? '✓' : '✗';
+                        debug(`  ${icon} ${actionResult.message}`);
+                    }
+                }
+                // 3. Check for COMPLETE action
+                const completeAction = getCompleteAction(parseResult);
+                let taskVerifiedComplete = false;
+                if (completeAction) {
+                    info(`AI marked task complete: ${completeAction.reason}`);
+                    // 4. Run verification hooks if enabled
+                    if (this.config.runVerification) {
+                        info('Running verification hooks...');
+                        const verificationResults = await this.verificationManager.runAll();
+                        const allPassed = this.verificationManager.allRequiredPassed(verificationResults);
+                        for (const vr of verificationResults) {
+                            const icon = vr.passed ? '✓' : '✗';
+                            debug(`  ${icon} ${vr.hookType}: ${vr.message}`);
+                        }
+                        if (allPassed) {
+                            info('✓ All verification hooks passed - task complete!');
+                            taskVerifiedComplete = true;
+                            this.state.task.status = 'completed';
+                        }
+                        else {
+                            warn('✗ Verification failed - continuing loop');
+                            // Build feedback about verification failure
+                            const feedback = await this.feedbackBuilder.buildComplete(executionResult, verificationResults, { suggestion: 'The AI marked the task complete, but verification failed. Review the test output and fix the issues.' });
+                            this.lastFeedback = feedback.formatted;
+                        }
+                    }
+                    else {
+                        // No verification - trust the COMPLETE action
+                        taskVerifiedComplete = true;
+                        this.state.task.status = 'completed';
+                    }
+                }
+                else if (executionResult) {
+                    // 5. Build feedback for next iteration
+                    const verificationResults = this.config.runVerification
+                        ? await this.verificationManager.runAll()
+                        : [];
+                    const feedback = await this.feedbackBuilder.buildComplete(executionResult, verificationResults);
+                    this.lastFeedback = feedback.formatted;
+                }
+                else {
+                    // No actions parsed - AI returned prose instead of structured output
+                    // Provide feedback to encourage structured output
+                    this.lastFeedback = `## Feedback from Previous Iteration
+
+The AI response did not contain structured ACTION blocks.
+
+Please respond using the ACTION format:
+- [ACTION:CREATE] to create files
+- [ACTION:EDIT] to modify files
+- [ACTION:EXECUTE] to run commands
+- [ACTION:COMPLETE] when done
+
+Do not write prose explanations. Use only ACTION blocks.`;
+                }
+                // Complete the iteration record
+                const summary = taskVerifiedComplete
+                    ? `Task complete: ${completeAction?.reason ?? 'verified'}`
+                    : this.extractSummary(responseContent);
+                const completedRecord = completeIteration(record, true, result.tokenUsage.totalTokens, summary);
+                this.state.iterations.push(completedRecord);
+                this.events.emit('iterationEnd', completedRecord, this.state);
+            }
+            else {
+                // Track consecutive failures
+                this.consecutiveFailures++;
+                // Failed iteration
+                const completedRecord = completeIteration(record, false, 0, undefined, result.error ?? 'Unknown error');
+                this.state.iterations.push(completedRecord);
+                this.events.emit('iterationEnd', completedRecord, this.state);
+            }
+        }
+        catch (err) {
+            // Track consecutive failures
+            this.consecutiveFailures++;
+            const error = err instanceof Error ? err : new Error(String(err));
+            const completedRecord = completeIteration(record, false, 0, undefined, error.message);
+            this.state.iterations.push(completedRecord);
+            this.events.emit('iterationEnd', completedRecord, this.state);
+        }
+    }
+    /**
+     * Extract a summary from the response
+     */
+    extractSummary(content) {
+        // Simple extraction - first 100 chars
+        const firstLine = content.split('\n')[0] ?? '';
+        return firstLine.length > 100 ? firstLine.substring(0, 100) + '...' : firstLine;
+    }
+    /**
+     * Sleep utility
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Get token usage summary
+     */
+    getTokenUsage() {
+        return this.agent.getTokenUsage();
+    }
+}
+//# sourceMappingURL=loop-engine.js.map

package/dist/core/loop-engine.js.map

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

package/dist/core/loop-events.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Loop Events
+ *
+ * Event emitter for loop lifecycle events
+ */
+import { EventEmitter } from 'node:events';
+import type { Task } from '../types/index.js';
+import type { FullLoopState, IterationRecord } from './loop-state.js';
+import type { TokenUsage } from '../integrations/index.js';
+/**
+ * Warning type for threshold warnings
+ */
+export type WarningType = 'iteration-threshold' | 'token-threshold' | 'duration-threshold' | 'circuit-breaker';
+/**
+ * Loop lifecycle events
+ */
+export interface LoopEvents {
+    /** Emitted when the loop starts */
+    start: [task: Task];
+    /** Emitted at the beginning of each iteration */
+    iterationStart: [iteration: number, state: FullLoopState];
+    /** Emitted at the end of each iteration */
+    iterationEnd: [record: IterationRecord, state: FullLoopState];
+    /** Emitted when the loop pauses */
+    pause: [state: FullLoopState];
+    /** Emitted when the loop resumes */
+    resume: [state: FullLoopState];
+    /** Emitted when the loop completes successfully */
+    complete: [state: FullLoopState];
+    /** Emitted when the loop fails */
+    error: [error: Error, state: FullLoopState];
+    /** Emitted when the loop is stopped */
+    stop: [state: FullLoopState];
+    /** Emitted when tokens are consumed */
+    tokenUsage: [usage: TokenUsage, totalUsage: TokenUsage];
+    /** Emitted when a warning threshold is reached */
+    warning: [type: WarningType, message: string, state: FullLoopState];
+}
+/**
+ * Type-safe event emitter for loop events
+ */
+export declare class LoopEventEmitter extends EventEmitter {
+    emit<K extends keyof LoopEvents>(event: K, ...args: LoopEvents[K]): boolean;
+    on<K extends keyof LoopEvents>(event: K, listener: (...args: LoopEvents[K]) => void): this;
+    once<K extends keyof LoopEvents>(event: K, listener: (...args: LoopEvents[K]) => void): this;
+    off<K extends keyof LoopEvents>(event: K, listener: (...args: LoopEvents[K]) => void): this;
+}
+//# sourceMappingURL=loop-events.d.ts.map

package/dist/core/loop-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-events.d.ts","sourceRoot":"","sources":["../../src/core/loop-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,iBAAiB,CAAC;AAE/G;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpB,iDAAiD;IACjD,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IAC1D,2CAA2C;IAC3C,YAAY,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IAC9D,mCAAmC;IACnC,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC9B,oCAAoC;IACpC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IACjC,kCAAkC;IAClC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IAC5C,uCAAuC;IACvC,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC7B,uCAAuC;IACvC,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACxD,kDAAkD;IAClD,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IACvC,IAAI,CAAC,CAAC,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO;IAI3E,EAAE,CAAC,CAAC,SAAS,MAAM,UAAU,EACpC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,IAAI;IAIE,IAAI,CAAC,CAAC,SAAS,MAAM,UAAU,EACtC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,IAAI;IAIE,GAAG,CAAC,CAAC,SAAS,MAAM,UAAU,EACrC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,IAAI;CAGR"}

package/dist/core/loop-events.js

@@ -0,0 +1,24 @@
+/**
+ * Loop Events
+ *
+ * Event emitter for loop lifecycle events
+ */
+import { EventEmitter } from 'node:events';
+/**
+ * Type-safe event emitter for loop events
+ */
+export class LoopEventEmitter extends EventEmitter {
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+}
+//# sourceMappingURL=loop-events.js.map

package/dist/core/loop-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-events.js","sourceRoot":"","sources":["../../src/core/loop-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoC3C;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IACvC,IAAI,CAA6B,KAAQ,EAAE,GAAG,IAAmB;QACxE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;IAEQ,EAAE,CACT,KAAQ,EACR,QAA0C;QAE1C,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACnE,CAAC;IAEQ,IAAI,CACX,KAAQ,EACR,QAA0C;QAE1C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACrE,CAAC;IAEQ,GAAG,CACV,KAAQ,EACR,QAA0C;QAE1C,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACpE,CAAC;CACF"}