pulseed 0.1.4 → 0.2.0

package/dist/orchestrator/loop/core-loop.js

@@ -0,0 +1,353 @@
+import { sleep } from "../../base/utils/sleep.js";
+import { IterationBudget } from "./iteration-budget.js";
+import { saveLoopCheckpoint, restoreLoopCheckpoint } from "./checkpoint-manager-loop.js";
+import { runPostLoopHooks } from "./post-loop-hooks.js";
+import { generateLoopReport } from "./loop-report-helper.js";
+import { makeEmptyIterationResult } from "./core-loop-types.js";
+import { runTreeIteration as runTreeIterationImpl, runMultiGoalIteration as runMultiGoalIterationImpl, } from "./tree-loop-runner.js";
+import { loadGoalWithAggregation, observeAndReload, calculateGapOrComplete, scoreDrivesAndCheckKnowledge, phaseAutoDecompose, } from "./core-loop-phases.js";
+import { checkCompletionAndMilestones, detectStallsAndRebalance, checkDependencyBlock, runTaskCycleWithContext, } from "./core-loop-phases-b.js";
+import { runStateDiffCheck, tryParallelExecution, } from "./core-loop-phases-c.js";
+import { handleCapabilityAcquisition } from "./core-loop-capability.js";
+import { CoreLoopLearning } from "./core-loop-learning.js";
+export { buildDriveContext, makeEmptyIterationResult } from "./core-loop-types.js";
+const DEFAULT_CONFIG = {
+    maxIterations: 100,
+    maxConsecutiveErrors: 3,
+    delayBetweenLoopsMs: 1000,
+    adapterType: "openai_codex_cli",
+    treeMode: false,
+    multiGoalMode: false,
+    goalIds: [],
+    minIterations: 1,
+    autoArchive: false,
+    dryRun: false,
+    maxConsecutiveSkips: 5,
+    autoDecompose: true,
+};
+// ─── CoreLoop ───
+/**
+ * CoreLoop is the heart of PulSeed — it orchestrates one full iteration of the
+ * task discovery loop: observe → gap → score → completion check → stall check → task → report.
+ *
+ * It runs multiple iterations until the goal is complete (SatisficingJudge),
+ * max iterations reached, stall escalation occurs, or an external stop signal.
+ */
+export class CoreLoop {
+    deps;
+    /** Mutable config — may be updated mid-run (e.g. treeMode enabled after decomposition). */
+    config;
+    logger;
+    stopped = false;
+    learning = new CoreLoopLearning();
+    /** Optional StateDiffCalculator for loop-skip optimization. */
+    stateDiff;
+    stateDiffState = new Map();
+    /** Tracks goals that have already been through auto-decompose this run. */
+    decomposedGoals = new Set();
+    constructor(deps, config, stateDiff) {
+        this.deps = deps;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.logger = deps.logger;
+        this.stateDiff = stateDiff;
+        // Wire optional StrategyTemplateRegistry into StrategyManager for auto-templating
+        if (deps.strategyTemplateRegistry) {
+            deps.strategyManager.setStrategyTemplateRegistry(deps.strategyTemplateRegistry);
+        }
+    }
+    // ─── Public API ───
+    /**
+     * Run the full loop until completion or stop condition.
+     * @param options.maxIterations - Override config.maxIterations for this run only (e.g. per-cycle budget from DaemonRunner).
+     */
+    async run(goalId, options) {
+        const startedAt = new Date().toISOString();
+        this.stopped = false;
+        // Reset state diff tracking for each run (snapshots are in-memory only)
+        this.stateDiffState.clear();
+        // Reset auto-decompose tracking for each run
+        this.decomposedGoals.clear();
+        // Load and validate goal
+        const goal = await this.deps.stateManager.loadGoal(goalId);
+        if (!goal) {
+            return {
+                goalId,
+                totalIterations: 0,
+                finalStatus: "error",
+                iterations: [],
+                startedAt,
+                completedAt: new Date().toISOString(),
+            };
+        }
+        if (goal.status !== "active" && goal.status !== "waiting") {
+            const msg = `Goal "${goalId}" cannot be run: status is "${goal.status}" (expected "active" or "waiting")`;
+            this.logger?.error(msg);
+            return {
+                goalId,
+                totalIterations: 0,
+                finalStatus: "error",
+                errorMessage: msg,
+                iterations: [],
+                startedAt,
+                completedAt: new Date().toISOString(),
+            };
+        }
+        // Reset stall escalation state at the beginning of each run so prior
+        // run's escalation does not immediately poison a fresh start.
+        for (const dim of goal.dimensions) {
+            await this.deps.stallDetector.resetEscalation(goalId, dim.name);
+        }
+        // Restore dimension/trust state from checkpoint if present (§4.8).
+        const startLoopIndex = await restoreLoopCheckpoint(this.deps.stateManager, goalId, this.config.adapterType, this.deps.trustManager);
+        const iterations = [];
+        let consecutiveErrors = 0;
+        let consecutiveDenied = 0;
+        let consecutiveEscalations = 0;
+        let finalStatus = "max_iterations";
+        // Effective maxIterations: runtime override takes precedence over config.
+        const effectiveMaxIterations = options?.maxIterations ?? this.config.maxIterations;
+        // Use the provided iterationBudget if set; otherwise create a local one.
+        const budget = this.config.iterationBudget
+            ?? new IterationBudget(effectiveMaxIterations);
+        // Per-node iteration tracking for tree mode.
+        const nodeConsumedMap = new Map();
+        for (let loopIndex = startLoopIndex; loopIndex < startLoopIndex + effectiveMaxIterations; loopIndex++) {
+            if (this.stopped) {
+                finalStatus = "stopped";
+                break;
+            }
+            if (budget.exhausted) {
+                this.logger?.info("Iteration budget exhausted, stopping loop");
+                break;
+            }
+            void this.deps.hookManager?.emit("LoopCycleStart", { goal_id: goalId, data: { loopIndex } });
+            let iterationResult;
+            try {
+                iterationResult = this.config.treeMode && this.deps.treeLoopOrchestrator
+                    ? await this.runTreeIteration(goalId, loopIndex, nodeConsumedMap)
+                    : await this.runOneIteration(goalId, loopIndex, loopIndex === startLoopIndex);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                this.logger?.error(`[CoreLoop] unexpected error in iteration ${loopIndex}: ${msg}`);
+                consecutiveErrors++;
+                if (consecutiveErrors >= this.config.maxConsecutiveErrors) {
+                    finalStatus = "error";
+                    break;
+                }
+                continue;
+            }
+            // Carry forward gapAggregate from the previous iteration when this one was skipped.
+            if (iterationResult.skipped && iterations.length >= 1) {
+                iterationResult.gapAggregate = iterations[iterations.length - 1].gapAggregate;
+            }
+            // Only consume budget for non-skipped iterations.
+            if (!iterationResult.skipped) {
+                const { allowed, warnings } = budget.consume();
+                for (const w of warnings) {
+                    this.logger?.warn(w);
+                }
+                if (!allowed) {
+                    this.logger?.info("Iteration budget exhausted, stopping loop");
+                    break;
+                }
+            }
+            void this.deps.hookManager?.emit("LoopCycleEnd", { goal_id: goalId, data: { loopIndex, status: iterationResult.error ? "error" : "ok" } });
+            iterations.push(iterationResult);
+            // Save checkpoint after each successful verify step (§4.8)
+            if (!this.config.dryRun && iterationResult.error === null && iterationResult.taskResult !== null) {
+                await saveLoopCheckpoint(this.deps.stateManager, goalId, loopIndex, iterationResult, this.config.adapterType, this.deps.trustManager, this.logger);
+            }
+            // Check completion (R1-2: must complete at least minIterations before exiting)
+            if (iterationResult.completionJudgment.is_complete &&
+                loopIndex >= (this.config.minIterations ?? 1) - 1) {
+                finalStatus = "completed";
+                void this.deps.hookManager?.emit("GoalStateChange", { goal_id: goalId, data: { newStatus: "completed" } });
+                break;
+            }
+            // Check errors
+            if (iterationResult.error !== null) {
+                consecutiveErrors++;
+                if (consecutiveErrors >= this.config.maxConsecutiveErrors) {
+                    finalStatus = "error";
+                    break;
+                }
+            }
+            else {
+                consecutiveErrors = 0;
+            }
+            // Check approval_denied and escalate counters
+            const taskAction = iterationResult.taskResult?.action ?? null;
+            if (taskAction === "approval_denied") {
+                consecutiveDenied++;
+                if (consecutiveDenied >= 3) {
+                    finalStatus = "stopped";
+                    break;
+                }
+            }
+            else {
+                consecutiveDenied = 0;
+            }
+            if (taskAction === "escalate") {
+                consecutiveEscalations++;
+                if (consecutiveEscalations >= 3) {
+                    finalStatus = "stalled";
+                    break;
+                }
+            }
+            else {
+                consecutiveEscalations = 0;
+            }
+            // Check stall escalation (escalation_level >= 3 means max escalation)
+            if (iterationResult.stallDetected &&
+                iterationResult.stallReport &&
+                iterationResult.stallReport.escalation_level >= 3) {
+                finalStatus = "stalled";
+                void this.deps.hookManager?.emit("GoalStateChange", { goal_id: goalId, data: { newStatus: "stalled" } });
+                break;
+            }
+            if (this.stopped) {
+                finalStatus = "stopped";
+                break;
+            }
+            // Periodic learning review
+            await this.learning.checkPeriodicReview(goalId, this.deps, this.logger);
+            // Delay between loops (skip on last iteration)
+            if (loopIndex < startLoopIndex + effectiveMaxIterations - 1 && this.config.delayBetweenLoopsMs > 0) {
+                await sleep(this.config.delayBetweenLoopsMs);
+            }
+        }
+        // Run post-loop hooks (curiosity, memory lifecycle, archive, final report)
+        await runPostLoopHooks({
+            goalId,
+            finalStatus,
+            iterations,
+            deps: this.deps,
+            config: this.config,
+            logger: this.logger,
+            tryGenerateReport: (id, idx, r, g) => generateLoopReport(id, idx, r, g, this.deps.reportingEngine, this.logger),
+        });
+        if (finalStatus === "completed") {
+            await this.learning.onGoalCompleted(goalId, this.deps, this.logger);
+        }
+        return {
+            goalId,
+            totalIterations: iterations.length,
+            finalStatus,
+            iterations,
+            startedAt,
+            completedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Run a single iteration of the loop.
+     */
+    async runOneIteration(goalId, loopIndex, isFirstIteration) {
+        const startTime = Date.now();
+        const ctx = { deps: this.deps, config: this.config, logger: this.logger, toolExecutor: this.deps.toolExecutor };
+        // Default result (filled in progressively)
+        const result = makeEmptyIterationResult(goalId, loopIndex);
+        this.logger?.info(`[CoreLoop] iteration ${loopIndex + 1} starting`, { goalId, loopIndex });
+        // 1. Load goal + tree aggregation
+        const loadedGoal = await loadGoalWithAggregation(ctx, goalId, result, startTime);
+        if (!loadedGoal)
+            return result;
+        let goal = loadedGoal;
+        await phaseAutoDecompose(goalId, goal, this.deps, this.config, this.logger, this.decomposedGoals, isFirstIteration);
+        // After decomposition: if children were created, reload and switch to tree mode.
+        if (!goal.children_ids.length) {
+            const reloadedAfterDecompose = await this.deps.stateManager.loadGoal(goalId);
+            if (reloadedAfterDecompose && reloadedAfterDecompose.children_ids.length > 0) {
+                goal = reloadedAfterDecompose;
+                if (this.deps.treeLoopOrchestrator) {
+                    this.config = { ...this.config, treeMode: true };
+                    this.logger?.info("[CoreLoop] treeMode enabled after auto-decomposition", { goalId, childrenCount: goal.children_ids.length });
+                }
+            }
+        }
+        // 2. Observe + reload
+        goal = await observeAndReload(ctx, goalId, goal, loopIndex);
+        // 2b. State diff check (Pillar 2: State Diff + Loop Skip)
+        if (this.stateDiff) {
+            const { shouldSkip } = await runStateDiffCheck(this.stateDiff, this.stateDiffState, goalId, goal, loopIndex, this.config, this.deps, result, startTime, this.logger);
+            if (shouldSkip)
+                return result;
+        }
+        // 3. Gap calculate + zero check
+        const gapResult = await calculateGapOrComplete(ctx, goalId, goal, loopIndex, result, startTime);
+        if (!gapResult)
+            return result;
+        const { gapVector, gapAggregate, skipTaskGeneration } = gapResult;
+        this.logger?.info(`[iter ${loopIndex}] gap: ${gapAggregate.toFixed(2)} | ${(gapVector.gaps ?? []).map((g) => `${g.dimension_name}=${g.normalized_weighted_gap.toFixed(2)}`).join(', ')}`);
+        // 4. Drive scoring + knowledge gap check (skip when gap=0 — no task needed)
+        let driveScores = [];
+        let highDissatisfactionDimensions = [];
+        if (!skipTaskGeneration) {
+            const driveResult = await scoreDrivesAndCheckKnowledge(ctx, goalId, goal, gapVector, loopIndex, result, startTime, (id, idx, r, g) => generateLoopReport(id, idx, r, g, this.deps.reportingEngine, this.logger));
+            if (!driveResult)
+                return result;
+            driveScores = driveResult.driveScores;
+            highDissatisfactionDimensions = driveResult.highDissatisfactionDimensions;
+        }
+        // 5. Completion check + milestones
+        await checkCompletionAndMilestones(ctx, goalId, goal, result, startTime);
+        if (result.error)
+            return result;
+        // 6. Stall detection + rebalance
+        await detectStallsAndRebalance(ctx, goalId, goal, result);
+        if (result.stallDetected && result.stallReport) {
+            this.logger?.warn(`[iter ${loopIndex}] stall detected: ${result.stallReport.stall_type}`, { escalation: result.stallReport.escalation_level });
+        }
+        if (skipTaskGeneration) {
+            await generateLoopReport(goalId, loopIndex, result, goal, this.deps.reportingEngine, this.logger);
+            result.elapsedMs = Date.now() - startTime;
+            return result;
+        }
+        // 6b. Dependency block check
+        if (checkDependencyBlock(ctx, goalId, result))
+            return result;
+        // 6c. TaskGroup detection and routing (M15 Phase 2)
+        const tookParallelPath = await tryParallelExecution(goalId, goal, gapAggregate, result, startTime, this.deps, loopIndex, this.logger);
+        if (tookParallelPath)
+            return result;
+        // 7. Task cycle with context
+        const loopCallbacks = {
+            handleCapabilityAcquisition: (task, gId, adapter) => handleCapabilityAcquisition(task, gId, adapter, this.deps.capabilityDetector, this.learning.getCapabilityFailures(), this.logger),
+            incrementTransferCounter: () => this.learning.incrementTransferCounter(),
+            tryGenerateReport: (id, idx, r, g) => generateLoopReport(id, idx, r, g, this.deps.reportingEngine, this.logger),
+        };
+        const taskCycleOk = await runTaskCycleWithContext(ctx, goalId, goal, gapVector, driveScores, highDissatisfactionDimensions, loopIndex, result, startTime, loopCallbacks);
+        if (!taskCycleOk)
+            return result;
+        // 8. Report
+        await generateLoopReport(goalId, loopIndex, result, goal, this.deps.reportingEngine, this.logger);
+        result.elapsedMs = Date.now() - startTime;
+        return result;
+    }
+    /**
+     * Tree-mode iteration: select one node via TreeLoopOrchestrator, run a
+     * normal observe→gap→score→task cycle on that node, then aggregate upward.
+     */
+    async runTreeIteration(rootId, loopIndex, nodeConsumedMap) {
+        return runTreeIterationImpl(rootId, loopIndex, this.deps, this.config, this.logger, (id, idx) => this.runOneIteration(id, idx), nodeConsumedMap);
+    }
+    /**
+     * Run one iteration of the multi-goal loop.
+     */
+    async runMultiGoalIteration(loopIndex) {
+        return runMultiGoalIterationImpl(loopIndex, this.deps, this.config, (id, idx) => this.runOneIteration(id, idx));
+    }
+    /**
+     * Stop the loop externally (e.g., on SIGTERM).
+     */
+    stop() {
+        this.stopped = true;
+    }
+    /**
+     * Check if the loop has been stopped.
+     */
+    isStopped() {
+        return this.stopped;
+    }
+}
+//# sourceMappingURL=core-loop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-loop.js","sourceRoot":"","sources":["../../../src/orchestrator/loop/core-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAQhE,OAAO,EACL,gBAAgB,IAAI,oBAAoB,EACxC,qBAAqB,IAAI,yBAAyB,GACnD,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,EAC5B,kBAAkB,GAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,GAErB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgB3D,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,MAAM,cAAc,GAAkD;IACpE,aAAa,EAAE,GAAG;IAClB,oBAAoB,EAAE,CAAC;IACvB,mBAAmB,EAAE,IAAI;IACzB,WAAW,EAAE,kBAAkB;IAC/B,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,KAAK;IACpB,OAAO,EAAE,EAAE;IACX,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,KAAK;IAClB,MAAM,EAAE,KAAK;IACb,mBAAmB,EAAE,CAAC;IACtB,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF,mBAAmB;AAEnB;;;;;;GAMG;AACH,MAAM,OAAO,QAAQ;IACF,IAAI,CAAe;IACpC,2FAA2F;IACnF,MAAM,CAAqB;IAClB,MAAM,CAAU;IACzB,OAAO,GAAG,KAAK,CAAC;IACP,QAAQ,GAAqB,IAAI,gBAAgB,EAAE,CAAC;IACrE,+DAA+D;IAC9C,SAAS,CAAuB;IACzC,cAAc,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC3D,2EAA2E;IACnE,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE5C,YAAY,IAAkB,EAAE,MAAmB,EAAE,SAA+B;QAClF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,kFAAkF;QAClF,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAClC,IAAI,CAAC,eAAe,CAAC,2BAA2B,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,qBAAqB;IAErB;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,OAAoC;QAC5D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,wEAAwE;QACxE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,6CAA6C;QAC7C,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAE7B,yBAAyB;QACzB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,MAAM;gBACN,eAAe,EAAE,CAAC;gBAClB,WAAW,EAAE,OAAO;gBACpB,UAAU,EAAE,EAAE;gBACd,SAAS;gBACT,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1D,MAAM,GAAG,GAAG,SAAS,MAAM,+BAA+B,IAAI,CAAC,MAAM,oCAAoC,CAAC;YAC1G,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YACxB,OAAO;gBACL,MAAM;gBACN,eAAe,EAAE,CAAC;gBAClB,WAAW,EAAE,OAAO;gBACpB,YAAY,EAAE,GAAG;gBACjB,UAAU,EAAE,EAAE;gBACd,SAAS;gBACT,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;QACJ,CAAC;QAED,qEAAqE;QACrE,8DAA8D;QAC9D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAClE,CAAC;QAED,mEAAmE;QACnE,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAChD,IAAI,CAAC,IAAI,CAAC,YAAY,EACtB,MAAM,EACN,IAAI,CAAC,MAAM,CAAC,WAAW,EACvB,IAAI,CAAC,IAAI,CAAC,YAAY,CACvB,CAAC;QAEF,MAAM,UAAU,GAA0B,EAAE,CAAC;QAC7C,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,sBAAsB,GAAG,CAAC,CAAC;QAC/B,IAAI,WAAW,GAA8B,gBAAgB,CAAC;QAE9D,0EAA0E;QAC1E,MAAM,sBAAsB,GAAG,OAAO,EAAE,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QAEnF,yEAAyE;QACzE,MAAM,MAAM,GAAoB,IAAI,CAAC,MAAM,CAAC,eAAe;eACtD,IAAI,eAAe,CAAC,sBAAsB,CAAC,CAAC;QAEjD,6CAA6C;QAC7C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;QAElD,KAAK,IAAI,SAAS,GAAG,cAAc,EAAE,SAAS,GAAG,cAAc,GAAG,sBAAsB,EAAE,SAAS,EAAE,EAAE,CAAC;YACtG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,WAAW,GAAG,SAAS,CAAC;gBACxB,MAAM;YACR,CAAC;YAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,2CAA2C,CAAC,CAAC;gBAC/D,MAAM;YACR,CAAC;YAED,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YAE7F,IAAI,eAAoC,CAAC;YACzC,IAAI,CAAC;gBACH,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,oBAAoB;oBACtE,CAAC,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC;oBACjE,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,cAAc,CAAC,CAAC;YAClF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,4CAA4C,SAAS,KAAK,GAAG,EAAE,CAAC,CAAC;gBACpF,iBAAiB,EAAE,CAAC;gBACpB,IAAI,iBAAiB,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;oBAC1D,WAAW,GAAG,OAAO,CAAC;oBACtB,MAAM;gBACR,CAAC;gBACD,SAAS;YACX,CAAC;YAED,oFAAoF;YACpF,IAAI,eAAe,CAAC,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtD,eAAe,CAAC,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,YAAY,CAAC;YACjF,CAAC;YAED,kDAAkD;YAClD,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;gBAC7B,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC/C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAC,CAAC;gBACnD,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,2CAA2C,CAAC,CAAC;oBAC/D,MAAM;gBACR,CAAC;YACH,CAAC;YACD,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAE3I,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAEjC,2DAA2D;YAC3D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC,KAAK,KAAK,IAAI,IAAI,eAAe,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;gBACjG,MAAM,kBAAkB,CACtB,IAAI,CAAC,IAAI,CAAC,YAAY,EACtB,MAAM,EACN,SAAS,EACT,eAAe,EACf,IAAI,CAAC,MAAM,CAAC,WAAW,EACvB,IAAI,CAAC,IAAI,CAAC,YAAY,EACtB,IAAI,CAAC,MAAM,CACZ,CAAC;YACJ,CAAC;YAED,+EAA+E;YAC/E,IAAI,eAAe,CAAC,kBAAkB,CAAC,WAAW;gBAC9C,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtD,WAAW,GAAG,WAAW,CAAC;gBAC1B,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;gBAC3G,MAAM;YACR,CAAC;YAED,eAAe;YACf,IAAI,eAAe,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnC,iBAAiB,EAAE,CAAC;gBACpB,IAAI,iBAAiB,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;oBAC1D,WAAW,GAAG,OAAO,CAAC;oBACtB,MAAM;gBACR,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,iBAAiB,GAAG,CAAC,CAAC;YACxB,CAAC;YAED,8CAA8C;YAC9C,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,EAAE,MAAM,IAAI,IAAI,CAAC;YAE9D,IAAI,UAAU,KAAK,iBAAiB,EAAE,CAAC;gBACrC,iBAAiB,EAAE,CAAC;gBACpB,IAAI,iBAAiB,IAAI,CAAC,EAAE,CAAC;oBAC3B,WAAW,GAAG,SAAS,CAAC;oBACxB,MAAM;gBACR,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,iBAAiB,GAAG,CAAC,CAAC;YACxB,CAAC;YAED,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC9B,sBAAsB,EAAE,CAAC;gBACzB,IAAI,sBAAsB,IAAI,CAAC,EAAE,CAAC;oBAChC,WAAW,GAAG,SAAS,CAAC;oBACxB,MAAM;gBACR,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,sBAAsB,GAAG,CAAC,CAAC;YAC7B,CAAC;YAED,sEAAsE;YACtE,IACE,eAAe,CAAC,aAAa;gBAC7B,eAAe,CAAC,WAAW;gBAC3B,eAAe,CAAC,WAAW,CAAC,gBAAgB,IAAI,CAAC,EACjD,CAAC;gBACD,WAAW,GAAG,SAAS,CAAC;gBACxB,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;gBACzG,MAAM;YACR,CAAC;YAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,WAAW,GAAG,SAAS,CAAC;gBACxB,MAAM;YACR,CAAC;YAED,2BAA2B;YAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAExE,+CAA+C;YAC/C,IAAI,SAAS,GAAG,cAAc,GAAG,sBAAsB,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC;gBACnG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,2EAA2E;QAC3E,MAAM,gBAAgB,CAAC;YACrB,MAAM;YACN,WAAW;YACX,UAAU;YACV,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,iBAAiB,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC;SAChH,CAAC,CAAC;QAEH,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACtE,CAAC;QAED,OAAO;YACL,MAAM;YACN,eAAe,EAAE,UAAU,CAAC,MAAM;YAClC,WAAW;YACX,UAAU;YACV,SAAS;YACT,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CACnB,MAAc,EACd,SAAiB,EACjB,gBAA0B;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAa,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1H,2CAA2C;QAC3C,MAAM,MAAM,GAAwB,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAEhF,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,wBAAwB,SAAS,GAAG,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAE3F,kCAAkC;QAClC,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QACjF,IAAI,CAAC,UAAU;YAAE,OAAO,MAAM,CAAC;QAC/B,IAAI,IAAI,GAAG,UAAU,CAAC;QAEtB,MAAM,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;QAEpH,iFAAiF;QACjF,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,sBAAsB,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC7E,IAAI,sBAAsB,IAAI,sBAAsB,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7E,IAAI,GAAG,sBAAsB,CAAC;gBAC9B,IAAI,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;oBACnC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;oBACjD,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,sDAAsD,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;gBACjI,CAAC;YACH,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,IAAI,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAE5D,0DAA0D;QAC1D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,iBAAiB,CAC5C,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EACjD,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAClE,CAAC;YACF,IAAI,UAAU;gBAAE,OAAO,MAAM,CAAC;QAChC,CAAC;QAED,gCAAgC;QAChC,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAChG,IAAI,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC;QAC9B,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,GAAG,SAAS,CAAC;QAElE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,SAAS,UAAU,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE/L,4EAA4E;QAC5E,IAAI,WAAW,GAAqD,EAAE,CAAC;QACvE,IAAI,6BAA6B,GAAa,EAAE,CAAC;QACjD,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,MAAM,WAAW,GAAG,MAAM,4BAA4B,CACpD,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAC1D,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAC7F,CAAC;YACF,IAAI,CAAC,WAAW;gBAAE,OAAO,MAAM,CAAC;YAChC,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC;YACtC,6BAA6B,GAAG,WAAW,CAAC,6BAA6B,CAAC;QAC5E,CAAC;QAED,mCAAmC;QACnC,MAAM,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QACzE,IAAI,MAAM,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC;QAEhC,iCAAiC;QACjC,MAAM,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAE1D,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC/C,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,SAAS,qBAAqB,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACjJ,CAAC;QAED,IAAI,kBAAkB,EAAE,CAAC;YACvB,MAAM,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAClG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAC1C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,6BAA6B;QAC7B,IAAI,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAE7D,oDAAoD;QACpD,MAAM,gBAAgB,GAAG,MAAM,oBAAoB,CACjD,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CACjF,CAAC;QACF,IAAI,gBAAgB;YAAE,OAAO,MAAM,CAAC;QAEpC,6BAA6B;QAC7B,MAAM,aAAa,GAAkB;YACnC,2BAA2B,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,2BAA2B,CAC9E,IAAyD,EACzD,GAAG,EACH,OAA4D,EAC5D,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAC5B,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE,EACrC,IAAI,CAAC,MAAM,CACZ;YACD,wBAAwB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,wBAAwB,EAAE;YACxE,iBAAiB,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC;SAChH,CAAC;QACF,MAAM,WAAW,GAAG,MAAM,uBAAuB,CAC/C,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EACtG,aAAa,CACd,CAAC;QACF,IAAI,CAAC,WAAW;YAAE,OAAO,MAAM,CAAC;QAEhC,YAAY;QACZ,MAAM,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAElG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,SAAiB,EAAE,eAAoC;QAC5F,OAAO,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAChF,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,eAAe,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,SAAiB;QAC3C,OAAO,yBAAyB,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAChE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CAEF"}

package/dist/orchestrator/loop/iteration-budget.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export declare const IterationBudgetSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    consumed: z.ZodNumber;
+    per_node_limit: z.ZodOptional<z.ZodNumber>;
+    warning_thresholds: z.ZodDefault<z.ZodArray<z.ZodNumber, "many">>;
+}, "strip", z.ZodTypeAny, {
+    total: number;
+    consumed: number;
+    warning_thresholds: number[];
+    per_node_limit?: number | undefined;
+}, {
+    total: number;
+    consumed: number;
+    per_node_limit?: number | undefined;
+    warning_thresholds?: number[] | undefined;
+}>;
+export type IterationBudgetData = z.infer<typeof IterationBudgetSchema>;
+export declare class IterationBudget {
+    private _total;
+    private _consumed;
+    private _perNodeLimit;
+    private _warningThresholds;
+    private _emittedWarnings;
+    constructor(total: number, perNodeLimit?: number);
+    get total(): number;
+    get consumed(): number;
+    get remaining(): number;
+    get perNodeLimit(): number | undefined;
+    get exhausted(): boolean;
+    get utilizationRatio(): number;
+    consume(count?: number): {
+        allowed: boolean;
+        warnings: string[];
+    };
+    toJSON(): IterationBudgetData;
+    static fromJSON(data: IterationBudgetData): IterationBudget;
+}
+//# sourceMappingURL=iteration-budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iteration-budget.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/loop/iteration-budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAExE,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,kBAAkB,CAAW;IACrC,OAAO,CAAC,gBAAgB,CAA0B;gBAEtC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAOhD,IAAI,KAAK,IAAI,MAAM,CAAwB;IAC3C,IAAI,QAAQ,IAAI,MAAM,CAA2B;IACjD,IAAI,SAAS,IAAI,MAAM,CAAyC;IAChE,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAA+B;IACrE,IAAI,SAAS,IAAI,OAAO,CAA0C;IAClE,IAAI,gBAAgB,IAAI,MAAM,CAAyC;IAEvE,OAAO,CAAC,KAAK,GAAE,MAAU,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAiBpE,MAAM,IAAI,mBAAmB;IAS7B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe;CAM5D"}

package/dist/orchestrator/loop/iteration-budget.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+export const IterationBudgetSchema = z.object({
+    total: z.number().int().positive(),
+    consumed: z.number().int().min(0),
+    per_node_limit: z.number().int().positive().optional(),
+    warning_thresholds: z.array(z.number().min(0).max(1)).default([0.7, 0.9]),
+});
+export class IterationBudget {
+    _total;
+    _consumed;
+    _perNodeLimit;
+    _warningThresholds;
+    _emittedWarnings = new Set();
+    constructor(total, perNodeLimit) {
+        this._total = total;
+        this._consumed = 0;
+        this._perNodeLimit = perNodeLimit;
+        this._warningThresholds = [0.7, 0.9];
+    }
+    get total() { return this._total; }
+    get consumed() { return this._consumed; }
+    get remaining() { return this._total - this._consumed; }
+    get perNodeLimit() { return this._perNodeLimit; }
+    get exhausted() { return this._consumed >= this._total; }
+    get utilizationRatio() { return this._consumed / this._total; }
+    consume(count = 1) {
+        const warnings = [];
+        if (this._consumed + count > this._total) {
+            return { allowed: false, warnings: [`Budget exhausted: ${this._consumed}/${this._total} iterations consumed`] };
+        }
+        this._consumed += count;
+        if (this._emittedWarnings.size < this._warningThresholds.length) {
+            for (const threshold of this._warningThresholds) {
+                if (this.utilizationRatio >= threshold && !this._emittedWarnings.has(threshold)) {
+                    this._emittedWarnings.add(threshold);
+                    warnings.push(`Budget warning: ${Math.round(this.utilizationRatio * 100)}% consumed (${this._consumed}/${this._total})`);
+                }
+            }
+        }
+        return { allowed: true, warnings };
+    }
+    toJSON() {
+        return {
+            total: this._total,
+            consumed: this._consumed,
+            per_node_limit: this._perNodeLimit,
+            warning_thresholds: this._warningThresholds,
+        };
+    }
+    static fromJSON(data) {
+        const budget = new IterationBudget(data.total, data.per_node_limit);
+        budget._consumed = data.consumed;
+        budget._warningThresholds = data.warning_thresholds;
+        return budget;
+    }
+}
+//# sourceMappingURL=iteration-budget.js.map

package/dist/orchestrator/loop/iteration-budget.js.map

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

package/dist/orchestrator/loop/loop-report-helper.d.ts

@@ -0,0 +1,14 @@
+/**
+ * loop-report-helper.ts
+ *
+ * Helper to generate and save a per-iteration execution report inside CoreLoop.
+ */
+import type { Goal } from "../../base/types/goal.js";
+import type { ReportingEngine, LoopIterationResult } from "./core-loop-types.js";
+import type { Logger } from "../../runtime/logger.js";
+/**
+ * Generate and save an execution summary report for one iteration.
+ * Non-fatal: report generation failures are logged and swallowed.
+ */
+export declare function generateLoopReport(goalId: string, loopIndex: number, iterationResult: LoopIterationResult, goal: Goal, reportingEngine: ReportingEngine, logger: Logger | undefined): Promise<void>;
+//# sourceMappingURL=loop-report-helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loop-report-helper.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/loop/loop-report-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,mBAAmB,EACpC,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/orchestrator/loop/loop-report-helper.js

@@ -0,0 +1,57 @@
+/**
+ * loop-report-helper.ts
+ *
+ * Helper to generate and save a per-iteration execution report inside CoreLoop.
+ */
+import { dimensionProgress } from "../../platform/drive/gap-calculator.js";
+/**
+ * Generate and save an execution summary report for one iteration.
+ * Non-fatal: report generation failures are logged and swallowed.
+ */
+export async function generateLoopReport(goalId, loopIndex, iterationResult, goal, reportingEngine, logger) {
+    try {
+        const observation = goal.dimensions.map((d) => {
+            const prog = dimensionProgress(d.current_value, d.threshold);
+            let progress;
+            if (prog !== null) {
+                progress = prog;
+            }
+            else if (typeof d.current_value === "number") {
+                progress = d.current_value;
+            }
+            else {
+                progress = 0;
+            }
+            return {
+                dimensionName: d.name,
+                progress,
+                confidence: d.confidence,
+            };
+        });
+        const taskResult = iterationResult.taskResult !== null
+            ? {
+                taskId: iterationResult.taskResult.task.id,
+                action: iterationResult.taskResult.action,
+                dimension: iterationResult.taskResult.task.primary_dimension,
+            }
+            : null;
+        const report = reportingEngine.generateExecutionSummary({
+            goalId,
+            loopIndex,
+            observation,
+            gapAggregate: iterationResult.gapAggregate,
+            taskResult,
+            stallDetected: iterationResult.stallDetected,
+            pivotOccurred: iterationResult.pivotOccurred,
+            elapsedMs: iterationResult.elapsedMs,
+        });
+        await reportingEngine.saveReport(report);
+    }
+    catch (err) {
+        logger?.warn("CoreLoop: report generation failed", {
+            goalId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=loop-report-helper.js.map

package/dist/orchestrator/loop/loop-report-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-report-helper.js","sourceRoot":"","sources":["../../../src/orchestrator/loop/loop-report-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,SAAiB,EACjB,eAAoC,EACpC,IAAU,EACV,eAAgC,EAChC,MAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5C,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;YAC7D,IAAI,QAAgB,CAAC;YACrB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;iBAAM,IAAI,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;gBAC/C,QAAQ,GAAG,CAAC,CAAC,aAAa,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,CAAC,CAAC;YACf,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,CAAC,CAAC,IAAI;gBACrB,QAAQ;gBACR,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,UAAU,GACd,eAAe,CAAC,UAAU,KAAK,IAAI;YACjC,CAAC,CAAC;gBACE,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;gBAC1C,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,MAAM;gBACzC,SAAS,EAAE,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,iBAAiB;aAC7D;YACH,CAAC,CAAC,IAAI,CAAC;QAEX,MAAM,MAAM,GAAG,eAAe,CAAC,wBAAwB,CAAC;YACtD,MAAM;YACN,SAAS;YACT,WAAW;YACX,YAAY,EAAE,eAAe,CAAC,YAAY;YAC1C,UAAU;YACV,aAAa,EAAE,eAAe,CAAC,aAAa;YAC5C,aAAa,EAAE,eAAe,CAAC,aAAa;YAC5C,SAAS,EAAE,eAAe,CAAC,SAAS;SACrC,CAAC,CAAC;QACH,MAAM,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,CAAC,oCAAoC,EAAE;YACjD,MAAM;YACN,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/orchestrator/loop/parallel-dispatch.d.ts

@@ -0,0 +1,16 @@
+/**
+ * parallel-dispatch.ts
+ *
+ * Attempt TaskGroup decomposition and parallel execution.
+ *
+ * Returns a ParallelExecutionResult when the parallel path ran successfully,
+ * or null when the caller should fall through to the normal single-task cycle.
+ * Updates result.taskResult with a synthetic entry reflecting the parallel outcome.
+ */
+import type { Goal } from "../../base/types/goal.js";
+import type { CoreLoopDeps } from "./core-loop-types.js";
+import type { LoopIterationResult } from "./core-loop-types.js";
+import type { ParallelExecutionResult } from "../execution/parallel-executor.js";
+import type { Logger } from "../../runtime/logger.js";
+export declare function tryRunParallel(goalId: string, goal: Goal, gapAggregate: number, result: LoopIterationResult, startTime: number, deps: CoreLoopDeps, logger: Logger | undefined): Promise<ParallelExecutionResult | null>;
+//# sourceMappingURL=parallel-dispatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-dispatch.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/loop/parallel-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAoGzC"}