aiwg/dist/src/cli/handlers/ralph.d.ts

Deployment tool and support utility for AI context. Copies agents, skills, commands, rules, and behaviors into the paths each AI platform reads (Claude Code, Codex, Copilot, Cursor, Warp, OpenClaw, and 6 more) so one source of truth works across 10 platfo

/**
 * Ralph Command Handlers
 *
 * CLI command handlers for Ralph iterative execution loop.
 * Uses external Ralph supervisor for crash-resilient background execution.
 * Falls back to internal scripts when --internal flag is used.
 *
 * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
 * @implements @.aiwg/working/issue-ralph-external-completion.md
 * @tests @test/unit/cli/handlers/ralph.test.ts
 * @issue #33, #275
 */
import { CommandHandler, HandlerContext, HandlerResult } from './types.js';
/**
 * Agent Loop Handler
 *
 * Executes iterative task loops with automatic completion detection.
 * By default, launches as a detached background process that survives terminal closure.
 * Use --internal flag for the legacy foreground execution.
 */
export declare class RalphHandler implements CommandHandler {
    id: string;
    name: string;
    description: string;
    category: "ralph";
    aliases: string[];
    execute(ctx: HandlerContext): Promise<HandlerResult>;
    private getHelpText;
}
/**
 * Ralph Status Handler
 *
 * Shows current Agent loop status and iteration history.
 * Works across terminal sessions by reading from the loop registry.
 */
export declare class RalphStatusHandler implements CommandHandler {
    id: string;
    name: string;
    description: string;
    category: "ralph";
    aliases: string[];
    execute(ctx: HandlerContext): Promise<HandlerResult>;
}
/**
 * Ralph Abort Handler
 *
 * Aborts currently running Agent loop by killing the background process.
 * Works across terminal sessions.
 */
export declare class RalphAbortHandler implements CommandHandler {
    id: string;
    name: string;
    description: string;
    category: "ralph";
    aliases: string[];
    execute(ctx: HandlerContext): Promise<HandlerResult>;
}
/**
 * Ralph Resume Handler
 *
 * Resumes previously interrupted Agent loop as a new background process.
 * Works across terminal sessions.
 */
export declare class RalphResumeHandler implements CommandHandler {
    id: string;
    name: string;
    description: string;
    category: "ralph";
    aliases: string[];
    execute(ctx: HandlerContext): Promise<HandlerResult>;
}
/**
 * Create Ralph handler instance
 */
export declare function createRalphHandler(): CommandHandler;
/**
 * Create Ralph Status handler instance
 */
export declare function createRalphStatusHandler(): CommandHandler;
/**
 * Create Ralph Abort handler instance
 */
export declare function createRalphAbortHandler(): CommandHandler;
/**
 * Create Ralph Resume handler instance
 */
export declare function createRalphResumeHandler(): CommandHandler;
/**
 * Ralph External handler
 *
 * Crash-resilient external loop with full state persistence.
 * Equivalent to `ralph` with crash-recovery enabled by default.
 */
export declare const ralphExternalHandler: CommandHandler;
/**
 * Ralph Memory handler
 *
 * Manage semantic memory entries for Agent loop learning.
 */
export declare const ralphMemoryHandler: CommandHandler;
/**
 * Ralph Config handler
 *
 * View and set Agent loop configuration values.
 */
export declare const ralphConfigHandler: CommandHandler;
/**
 * Ralph Attach Handler
 *
 * Re-attaches to a running Agent loop's live output stream.
 * Press Ctrl+C to detach — loop continues running in background.
 */
export declare class RalphAttachHandler implements CommandHandler {
    id: string;
    name: string;
    description: string;
    category: "ralph";
    aliases: string[];
    execute(ctx: HandlerContext): Promise<HandlerResult>;
}
/**
 * Export handler instances
 */
export declare const ralphHandler: RalphHandler;
export declare const ralphStatusHandler: RalphStatusHandler;
export declare const ralphAbortHandler: RalphAbortHandler;
export declare const ralphResumeHandler: RalphResumeHandler;
export declare const ralphAttachHandler: RalphAttachHandler;
/**
 * Export all Ralph handlers as array for easy registration
 */
export declare const ralphHandlers: CommandHandler[];
//# sourceMappingURL=ralph.d.ts.map