aicodeman 0.4.6 → 0.4.7

package/dist/orchestrator-loop.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @fileoverview Orchestrator Loop — phased plan execution with team agents.
+ *
+ * State machine that generates plans from user goals, executes them
+ * phase-by-phase with verification gates, and adapts on failure.
+ *
+ * States: idle → planning → approval → executing → verifying → (replanning) → completed/failed
+ *
+ * Key exports:
+ * - `OrchestratorLoop` class — main engine, extends EventEmitter
+ * - `OrchestratorLoopEvents` interface — typed event map
+ *
+ * Lifecycle: `start(goal)` → plan → approve → execute phases → verify → complete
+ *
+ * @dependencies orchestrator-planner (plan generation), orchestrator-verifier (phase verification),
+ *   session-manager (sessions), task-queue (task execution), state-store (persistence),
+ *   prompts/orchestrator (prompt templates)
+ * @consumedby web/server (orchestrator routes, SSE)
+ * @emits stateChanged, planReady, phaseStarted, phaseCompleted, phaseFailed,
+ *   taskAssigned, taskCompleted, taskFailed, verificationResult, completed, error
+ * @persistence Orchestrator state saved to `~/.codeman/state.json` (orchestrator key)
+ *
+ * @module orchestrator-loop
+ */
+import { EventEmitter } from 'node:events';
+import type { TerminalMultiplexer } from './mux-interface.js';
+import { type OrchestratorState, type OrchestratorPlan, type OrchestratorPhase, type OrchestratorTask, type OrchestratorConfig, type OrchestratorStats, type OrchestratorPersistState, type VerificationResult } from './types.js';
+export interface OrchestratorLoopEvents {
+    stateChanged: (state: OrchestratorState, prevState: OrchestratorState) => void;
+    planProgress: (phase: string, detail: string) => void;
+    planReady: (plan: OrchestratorPlan) => void;
+    phaseStarted: (phase: OrchestratorPhase) => void;
+    phaseCompleted: (phase: OrchestratorPhase) => void;
+    phaseFailed: (phase: OrchestratorPhase, reason: string) => void;
+    taskAssigned: (task: OrchestratorTask, sessionId: string) => void;
+    taskCompleted: (task: OrchestratorTask) => void;
+    taskFailed: (task: OrchestratorTask, error: string) => void;
+    verificationResult: (phase: OrchestratorPhase, result: VerificationResult) => void;
+    completed: (stats: OrchestratorStats) => void;
+    error: (error: Error) => void;
+}
+export declare class OrchestratorLoop extends EventEmitter {
+    private _state;
+    private plan;
+    private currentPhaseIndex;
+    private config;
+    private stats;
+    private startedAt;
+    private completedAt;
+    private workingDir;
+    private planner;
+    private verifier;
+    private sessionManager;
+    private taskQueue;
+    private store;
+    /** State before pause (to resume to correct state) */
+    private pausedState;
+    /** Phase poll timer for checking task completion */
+    private phasePollTimer;
+    /** Phase-level timeout timer */
+    private phaseTimeoutTimer;
+    /** Post-phase delay timer before verification */
+    private postPhaseTimer;
+    /** Session completion listener (bound for cleanup) */
+    private sessionCompletionListener;
+    /** Active sessions assigned to current phase */
+    private phaseSessionIds;
+    constructor(mux: TerminalMultiplexer, workingDir: string, config?: Partial<OrchestratorConfig>);
+    /** Start orchestration with a goal. Transitions: idle → planning */
+    start(goal: string): Promise<void>;
+    /** Approve the generated plan. Transitions: approval → executing */
+    approve(): Promise<void>;
+    /** Reject plan with feedback. Transitions: approval → planning (regenerate) */
+    reject(feedback: string): Promise<void>;
+    /** Pause execution. Saves current state. */
+    pause(): void;
+    /** Resume from pause. */
+    resume(): Promise<void>;
+    /** Stop everything and clean up. */
+    stop(): Promise<void>;
+    /** Skip a specific phase. */
+    skipPhase(phaseId: string): Promise<void>;
+    /** Retry a failed phase. */
+    retryPhase(phaseId: string): Promise<void>;
+    get state(): OrchestratorState;
+    getPlan(): OrchestratorPlan | null;
+    getCurrentPhase(): OrchestratorPhase | null;
+    getStats(): OrchestratorStats;
+    getStatus(): OrchestratorPersistState;
+    isRunning(): boolean;
+    private executeCurrentPhase;
+    private assignPhaseTasks;
+    private assignTeamPhase;
+    private assignQueuedTasksToSessions;
+    private setupTaskHandlers;
+    private cleanupTaskHandlers;
+    private handleTaskCompleted;
+    private handleTaskFailed;
+    private startPhasePoll;
+    private clearPhasePoll;
+    private pollPhaseStatus;
+    private checkPhaseCompletion;
+    private verifyCurrentPhase;
+    private handleVerificationFailure;
+    private replanPhase;
+    /** Read current state (bypasses TypeScript narrowing from guards) */
+    private currentState;
+    /** Assert state matches expected or throw */
+    private requireState;
+    private setState;
+    private advanceToNextPhase;
+    private handleCompletion;
+    private handlePhaseError;
+    private handleError;
+    private persist;
+    private restore;
+    private reset;
+    private buildTaskPrompt;
+    private getCompletedPhasesSummary;
+    private findOrchestratorTaskByQueueId;
+    /** Clean up resources when the loop is being destroyed. */
+    destroy(): void;
+}
+//# sourceMappingURL=orchestrator-loop.d.ts.map

package/dist/orchestrator-loop.d.ts.map

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