@moxxy/sdk 0.26.0 → 0.28.0

package/dist/mode/react-loop.js

@@ -0,0 +1,480 @@
+import { isContextOverflowError, runCompactionIfNeeded } from '../compactor-helpers.js';
+import { runElisionIfNeeded } from '../elision-helpers.js';
+import { asPluginId } from '../ids.js';
+import { usageEventFields } from '../token-accounting.js';
+import { emitRequestsAndDetectStuck, emitRequestsAndNudgeOnStuck, executeToolUses, } from '../tool-dispatch.js';
+import { nextBackoffMs, sleepWithAbort } from './abort-backoff.js';
+import { collectProviderStream } from './collect-stream.js';
+import { buildSystemPromptWithSkills, projectMessages } from './project-messages.js';
+import { createStuckLoopDetector } from './stuck-loop.js';
+/**
+ * The shared ReAct loop core every tool-calling mode runs on. One hardened
+ * copy of the plumbing that used to be duplicated per mode (default / goal /
+ * collab-agent): provider retry with bounded exponential back-off, reactive
+ * compaction on context overflow, turn-boundary elision, stuck-loop
+ * detection, abort handling on every await — plus the turn-end checkpoint
+ * gate ({@link TurnCheckpoint}) that lets a mode verify a completion claim
+ * (run lints, spawn a reviewer agent) before the turn is allowed to end.
+ *
+ * Modes express their POLICY through {@link ReactLoopOptions}: hooks fire at
+ * fixed points (iteration start, provider success, tool batch end, iteration
+ * cap) and checkpoints fire at the turn-end candidate. Hooks emit their own
+ * events via `ctx.emit` — the live event channel is the log subscription
+ * (`runTurn` discards the yielded stream), so emit order is what channels
+ * and tests observe.
+ */
+/** Bounded back-off for retryable provider errors — see the field docs. */
+export const MAX_CONSECUTIVE_RETRIES = 6;
+const RETRY_BACKOFF_BASE_MS = 500;
+const RETRY_BACKOFF_CAP_MS = 30_000;
+const DEFAULT_MAX_ITERATIONS = 500;
+const MAX_REACTIVE_COMPACTIONS = 2;
+const DEFAULT_MAX_INJECTIONS = 3;
+const DEFAULT_MAX_INJECT_CHARS = 16_384;
+const DEFAULT_CHECKPOINT_TIMEOUT_MS = 120_000;
+const CHECKPOINT_EVENT_PLUGIN_ID = asPluginId('react-loop');
+// Abort-aware sleep, injectable for tests so back-off paths run instantly and
+// deterministically. Production delegates to sleepWithAbort: a real timer that
+// clears (and drops its abort listener) when the signal fires, so a pending
+// back-off never outlives a cancelled turn.
+let sleepImpl = (ms, signal) => sleepWithAbort(ms, signal);
+/**
+ * Override the retry back-off sleep (test seam). Returns a restore fn that
+ * callers MUST invoke (in a `finally`) — `sleepImpl` is a module-scoped
+ * singleton shared process-wide, so a leaked override bleeds the fake sleep
+ * into every other turn/test running in the same worker (parallel subagent
+ * fan-out, multiple Sessions in one host). Test-only; never call from prod.
+ */
+export function __setRetrySleepForTests(fn) {
+    const prev = sleepImpl;
+    sleepImpl = fn;
+    return () => {
+        sleepImpl = prev;
+    };
+}
+export async function* runReactLoop(ctx, opts) {
+    if (opts.preflightAbortReason && ctx.signal.aborted) {
+        yield await emitAbort(ctx, opts.preflightAbortReason);
+        return;
+    }
+    // Coerce a caller/config-supplied bound to a positive integer; a degenerate
+    // value (0, negative, NaN, fractional) would otherwise make the loop never
+    // run and emit a misleading "exceeded maxIterations" fatal. The config
+    // schema validates this, but programmatic callers (subagents/workflows)
+    // bypass that schema.
+    const requestedMaxIterations = ctx.maxIterations;
+    const maxIterations = typeof requestedMaxIterations === 'number' && Number.isFinite(requestedMaxIterations)
+        ? Math.max(1, Math.floor(requestedMaxIterations))
+        : (opts.defaultMaxIterations ?? DEFAULT_MAX_ITERATIONS);
+    const detector = createStuckLoopDetector(ctx.loopGuard);
+    const stuckReport = buildStuckReport(opts);
+    const prefix = opts.errorPrefix ?? '';
+    // Recursion backstop: a checkpoint that spawns a child running a
+    // checkpoint-bearing mode would gate the child's turn-end, spawn a
+    // grandchild, and so on forever. Checkpoint authors should spawn children
+    // as `mode: 'default'`; this disarm means a mistake degrades to an ungated
+    // child instead of unbounded recursion.
+    const checkpoints = ctx.isSubagent ? [] : (opts.checkpoints ?? []);
+    const injectionBudget = Math.max(0, Math.floor(opts.maxInjections ?? DEFAULT_MAX_INJECTIONS));
+    const maxInjectChars = Math.max(1024, Math.floor(opts.maxInjectChars ?? DEFAULT_MAX_INJECT_CHARS));
+    let injectionsUsed = 0;
+    let consecutiveIdle = 0;
+    // A volatile injection from the previous round's checkpoint (goal's nudge),
+    // consumed by the next provider call only.
+    let pendingVolatileText;
+    // Reactive-compaction budget per overflow episode and consecutive
+    // retryable-error count; both reset on any clean provider call so a long
+    // turn can recover from multiple transient episodes.
+    let reactiveCompactions = 0;
+    let consecutiveRetries = 0;
+    for (let iteration = 1; iteration <= maxIterations; iteration++) {
+        if (ctx.signal.aborted) {
+            yield await emitAbort(ctx, 'signal aborted');
+            return;
+        }
+        yield await ctx.emit({
+            type: 'mode_iteration',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            strategy: opts.strategyName,
+            iteration,
+        });
+        // Auto-compact before composing the next provider request, then apply
+        // turn-boundary elision (context-on-demand). Both mutate the log's
+        // projection, not the loop's state.
+        await runCompactionIfNeeded(ctx);
+        await runElisionIfNeeded(ctx);
+        const hookStart = opts.onIterationStart
+            ? await opts.onIterationStart(ctx, iteration)
+            : undefined;
+        // At most ONE volatile trailing user message per call: a pending
+        // checkpoint nudge and an iteration-start note merge into it.
+        const volatileParts = [pendingVolatileText, hookStart?.volatileUserText].filter((s) => typeof s === 'string' && s.length > 0);
+        pendingVolatileText = undefined;
+        const volatileText = volatileParts.length > 0 ? volatileParts.join('\n\n') : undefined;
+        // onIterationStart may block for a long time (collab's cooperative-pause
+        // poll idles here until the human resumes) — re-check the signal so an
+        // abort during the hook ends the turn cleanly instead of burning a
+        // provider call that is already cancelled.
+        if (ctx.signal.aborted) {
+            yield await emitAbort(ctx, 'signal aborted');
+            return;
+        }
+        const systemPrompt = buildSystemPromptWithSkills(ctx.systemPrompt, ctx.skills.list());
+        const { messages, stablePrefixIndex } = projectMessages(ctx, {
+            ...(systemPrompt ? { systemPrompt } : {}),
+            ...(volatileText ? { trailingUserText: volatileText } : {}),
+        });
+        yield await ctx.emit({
+            type: 'provider_request',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            provider: ctx.provider.name,
+            model: ctx.model,
+        });
+        const { text, toolUses, stopReason, error, usage, reasoning } = await collectProviderStream(ctx, messages, {
+            iteration,
+            stablePrefixIndex,
+            // Volatile text is injected for this call only, never appended to the
+            // log — the cache strategy must keep its rolling tail breakpoint
+            // BEFORE it, or every such call caches a prefix ending in a message
+            // that won't exist at that position next call: a guaranteed-wasted
+            // cache write.
+            ...(volatileText ? { volatileTailCount: 1 } : {}),
+        });
+        // A user cancellation WHILE the provider stream was being consumed
+        // surfaces as a non-retryable provider `error` ("The operation was
+        // aborted") rather than a clean abort — collectProviderStream catches the
+        // fetch AbortError and classifies it as fatal. Treat it as the
+        // cancellation it is so channels render a 'stopped' turn, not a failed one.
+        if (ctx.signal.aborted) {
+            yield await emitAbort(ctx, 'signal aborted during provider stream');
+            return;
+        }
+        yield await ctx.emit({
+            type: 'provider_response',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            provider: ctx.provider.name,
+            model: ctx.model,
+            ...usageEventFields(usage),
+        });
+        if (error) {
+            const overflow = isContextOverflowError(error.message);
+            // The request was too big for the model's window: our token estimate
+            // lagged the provider's real tokenizer, so the proactive compactor
+            // didn't fire. Force a compaction and retry rather than dying.
+            if (overflow && reactiveCompactions < MAX_REACTIVE_COMPACTIONS) {
+                const compacted = await runCompactionIfNeeded(ctx, { force: true });
+                if (compacted) {
+                    // Only count an attempt that actually compacted against the budget —
+                    // a no-op (overflow lives in the un-compactable recent tail) must
+                    // not deny a later, genuinely compactable overflow its retry.
+                    reactiveCompactions += 1;
+                    yield await emitError(ctx, 'retryable', 'context window exceeded — compacted older turns, retrying');
+                    continue;
+                }
+            }
+            // A context overflow that can't be compacted further is fatal regardless
+            // of the provider's `retryable` flag: some providers mark "reduce the
+            // length" errors retryable, but the prompt cannot shrink, so a retry
+            // just re-sends the identical over-budget request and overflows again.
+            if (!error.retryable || overflow) {
+                yield await emitError(ctx, 'fatal', `${prefix}${error.message}`);
+                return;
+            }
+            // Retryable: surface it, then back off before retrying. A persistent
+            // retryable condition (sustained 429 / outage) must NOT busy-loop the
+            // provider — give up with a fatal error after the bounded retry count.
+            consecutiveRetries += 1;
+            yield await emitError(ctx, 'retryable', `${prefix}${error.message}`);
+            if (consecutiveRetries >= MAX_CONSECUTIVE_RETRIES) {
+                yield await emitError(ctx, 'fatal', `${prefix}provider kept returning a retryable error ${consecutiveRetries} times in a row ` +
+                    `(last: ${error.message}); giving up rather than hammering the provider.`);
+                return;
+            }
+            await sleepImpl(nextBackoffMs(consecutiveRetries, RETRY_BACKOFF_BASE_MS, RETRY_BACKOFF_CAP_MS), ctx.signal);
+            if (ctx.signal.aborted) {
+                yield await emitAbort(ctx, 'signal aborted during retry back-off');
+                return;
+            }
+            continue;
+        }
+        // Clean provider call — reset the overflow-recovery + retry budgets.
+        reactiveCompactions = 0;
+        consecutiveRetries = 0;
+        // Finalize the reasoning summary for THIS call BEFORE any exit decision or
+        // tool/assistant emits, so the log order is reasoning → tool_use → text
+        // (projection attaches the signed thinking block as content[0] of the
+        // same assistant turn) and every exit path logs it consistently.
+        if (reasoning) {
+            yield await ctx.emit({
+                type: 'reasoning_message',
+                sessionId: ctx.sessionId,
+                turnId: ctx.turnId,
+                source: 'model',
+                content: reasoning.text,
+                ...(reasoning.signature ? { signature: reasoning.signature } : {}),
+                ...(reasoning.redacted ? { redacted: true } : {}),
+                ...(reasoning.encrypted ? { encrypted: reasoning.encrypted } : {}),
+            });
+        }
+        if (opts.onProviderSuccess) {
+            const directive = await opts.onProviderSuccess(ctx, {
+                text,
+                stopReason,
+                toolUses,
+                ...(usage ? { usage } : {}),
+                iteration,
+            });
+            if (directive?.action === 'stop')
+                return;
+        }
+        if (opts.stuck?.action === 'nudge') {
+            const trip = yield* emitRequestsAndNudgeOnStuck(ctx, toolUses, detector, {
+                nearHint: stuckReport.nearHint,
+                warnMessage: (info) => `${opts.strategyName} loop noticed a repetitive pattern: tool "${info.toolName}" called ` +
+                    `${info.count} times ${info.how} — steering the model to change approach (the run continues).`,
+                ...(stuckReport.extraOnStuck ? { extraOnStuck: stuckReport.extraOnStuck } : {}),
+            });
+            if (trip) {
+                const nudge = opts.stuck.nudgeText?.(trip) ?? defaultStuckNudge(trip);
+                // Ride the NEXT provider call; merge with anything already pending.
+                pendingVolatileText = pendingVolatileText ? `${pendingVolatileText}\n\n${nudge}` : nudge;
+            }
+        }
+        else {
+            const stuck = yield* emitRequestsAndDetectStuck(ctx, toolUses, detector, stuckReport);
+            // A stuck trip kills the turn — it never reaches the checkpoint gate;
+            // gating a turn that is being aborted would just burn a checker run.
+            if (stuck)
+                return;
+        }
+        if (text || stopReason === 'end_turn' || toolUses.length === 0) {
+            // A completion with no text, no tool uses, and a non-natural stop (e.g.
+            // 'max_tokens' truncated to nothing) yields a blank assistant bubble
+            // that silently swallows the truncation signal. Surface a retryable
+            // note so the user sees why, alongside the (preserved) empty
+            // assistant_message.
+            if (!text && toolUses.length === 0 && stopReason !== 'end_turn') {
+                yield await emitError(ctx, 'retryable', `provider returned an empty completion (stopReason: ${stopReason ?? 'unknown'})`);
+            }
+            yield await ctx.emit({
+                type: 'assistant_message',
+                sessionId: ctx.sessionId,
+                turnId: ctx.turnId,
+                source: 'model',
+                content: text,
+                stopReason,
+            });
+        }
+        if (toolUses.length === 0) {
+            // ── The turn-end candidate: the model stopped calling tools. ──
+            consecutiveIdle += 1;
+            const verdict = yield* runCheckpointGate(ctx, checkpoints, {
+                candidateText: text,
+                stopReason,
+                iteration,
+                consecutiveIdle,
+                injectionsUsed,
+                injectionBudget,
+                maxInjectChars,
+            });
+            if (verdict.kind === 'end')
+                return;
+            injectionsUsed += 1;
+            if (verdict.volatileText !== undefined)
+                pendingVolatileText = verdict.volatileText;
+            continue;
+        }
+        consecutiveIdle = 0;
+        // The injection budget is per idle-EPISODE, not per turn: it exists to
+        // stop a permanently-failing gate from looping a turn that makes no
+        // progress. Once the model does real tool work again the episode is over —
+        // without this reset, a long unattended run died on its Nth *spread-out*
+        // idle round ("checkpoint budget exhausted") even though every earlier
+        // nudge had successfully put the model back to work.
+        injectionsUsed = 0;
+        // Execute whenever the model requested tools, regardless of stopReason.
+        // Providers vary in how reliably they report `stopReason: 'tool_use'`;
+        // trusting only stopReason silently dropped tool calls on providers that
+        // mis-map it, leaving orphaned tool_call_requested events.
+        const exited = yield* executeToolUses(ctx, toolUses, iteration);
+        if (exited)
+            return;
+        if (opts.onToolBatchEnd) {
+            const directive = await opts.onToolBatchEnd(ctx, { toolUses, iteration });
+            if (directive?.action === 'stop')
+                return;
+        }
+    }
+    if (opts.onMaxIterations) {
+        await opts.onMaxIterations(ctx, maxIterations);
+        return;
+    }
+    yield await emitError(ctx, 'fatal', `${opts.strategyName} mode loop exceeded maxIterations (${maxIterations})`);
+}
+async function* runCheckpointGate(ctx, checkpoints, round) {
+    // Natural completions face every checkpoint; truncated/errored candidates
+    // only face the idle-tolerant ones — reviewing a half-sentence as if it
+    // were a completion claim wastes a checker run and confuses the model.
+    const eligible = checkpoints.filter((cp) => round.stopReason === 'end_turn' || (cp.gateOn ?? 'end_turn') === 'idle');
+    if (eligible.length === 0)
+        return { kind: 'end' };
+    // Budget exhausted → the answer ships as-is, but LOUDLY: silent
+    // degradation would let the user believe a gated answer passed its gates.
+    if (round.injectionsUsed >= round.injectionBudget) {
+        yield await emitError(ctx, 'retryable', `checkpoint budget exhausted (${round.injectionBudget} rounds) — ` +
+            `ending the turn with unresolved checkpoint feedback; verify the result manually.`);
+        return { kind: 'end' };
+    }
+    for (const cp of eligible) {
+        // User cancelled mid-gate: end the turn WITHOUT retracting the
+        // already-logged answer — an abort must never un-say what was said.
+        if (ctx.signal.aborted)
+            return { kind: 'end' };
+        yield await emitCheckpointEvent(ctx, 'checkpoint_started', {
+            name: cp.name,
+            iteration: round.iteration,
+        });
+        const timeoutMs = Math.max(1_000, cp.timeoutMs ?? DEFAULT_CHECKPOINT_TIMEOUT_MS);
+        const timeoutCtl = new AbortController();
+        const timer = setTimeout(() => timeoutCtl.abort(), timeoutMs);
+        timer.unref?.();
+        let result;
+        try {
+            result = await cp.run({
+                candidateText: round.candidateText,
+                stopReason: round.stopReason,
+                iteration: round.iteration,
+                consecutiveIdle: round.consecutiveIdle,
+                injectionsUsed: round.injectionsUsed,
+                injectionBudget: round.injectionBudget,
+                signal: AbortSignal.any([ctx.signal, timeoutCtl.signal]),
+            }, ctx);
+        }
+        catch (err) {
+            if (ctx.signal.aborted)
+                return { kind: 'end' };
+            // Fail OPEN, visibly. A crashed or timed-out checker downgrades the
+            // gate to a warning — it must never wedge the turn (fail-closed is a
+            // turn that can never end) and never crash it (the answer is already
+            // logged).
+            const why = timeoutCtl.signal.aborted
+                ? `timed out after ${timeoutMs}ms`
+                : `failed: ${err instanceof Error ? err.message : String(err)}`;
+            yield await emitError(ctx, 'retryable', `checkpoint "${cp.name}" ${why} — proceeding unchecked`);
+            continue;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        switch (result.action) {
+            case 'pass': {
+                yield await emitCheckpointEvent(ctx, 'checkpoint_passed', { name: cp.name });
+                continue;
+            }
+            case 'stop': {
+                // The checkpoint already emitted its own wrap-up events.
+                yield await emitCheckpointEvent(ctx, 'checkpoint_stopped', { name: cp.name });
+                return { kind: 'end' };
+            }
+            case 'retry': {
+                yield await emitCheckpointEvent(ctx, 'checkpoint_retry', { name: cp.name });
+                return { kind: 'loop' };
+            }
+            case 'inject': {
+                // Guard the guard: an inject with blank text would loop the turn
+                // with no new signal for the model — a checker bug; fail open.
+                const feedback = result.text?.trim();
+                if (!feedback) {
+                    yield await emitError(ctx, 'retryable', `checkpoint "${cp.name}" injected empty feedback — ignored`);
+                    continue;
+                }
+                const clamped = clampChars(feedback, round.maxInjectChars);
+                if (result.volatile) {
+                    yield await emitCheckpointEvent(ctx, 'checkpoint_injected', {
+                        name: cp.name,
+                        volatile: true,
+                    });
+                    return { kind: 'loop', volatileText: clamped };
+                }
+                // Persistent: a checkpoint-origin user prompt. Projected as a
+                // user-role message by the existing projection case, marked via the
+                // same `origin` machinery trigger prompts use, cache-safe because it
+                // is an ordinary append at the log tail.
+                yield await ctx.emit({
+                    type: 'user_prompt',
+                    sessionId: ctx.sessionId,
+                    turnId: ctx.turnId,
+                    source: 'system',
+                    text: clamped,
+                    origin: { kind: 'checkpoint', name: cp.name },
+                });
+                yield await emitCheckpointEvent(ctx, 'checkpoint_injected', {
+                    name: cp.name,
+                    volatile: false,
+                });
+                return { kind: 'loop' };
+            }
+        }
+    }
+    return { kind: 'end' };
+}
+function defaultStuckNudge(trip) {
+    return (`You have called the tool \`${trip.toolName}\` ${trip.count} times ${trip.how}. ` +
+        `Repeating the same call will not produce a different result. Step back, reassess what ` +
+        `you learned from the previous attempts, and take a DIFFERENT next action or approach.`);
+}
+function buildStuckReport(opts) {
+    const name = opts.strategyName;
+    return {
+        abortedResultMessage: opts.stuck?.abortedResultMessage ??
+            `${name} mode loop aborted (stuck pattern) before this call ran`,
+        nearHint: opts.stuck?.nearHint ?? 'against the same target (only volatile args like maxBytes varied)',
+        fatalMessage: opts.stuck?.fatalMessage ??
+            (({ toolName, count, how }) => `${name} mode loop aborted — detected stuck pattern: tool "${toolName}" called ` +
+                `${count} times ${how}. The model is likely looping on the same call; ` +
+                `reset or rephrase.`),
+        ...(opts.stuck?.extraOnStuck ? { extraOnStuck: opts.stuck.extraOnStuck } : {}),
+    };
+}
+function clampChars(text, max) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max)}\n…[checkpoint feedback truncated: ${text.length - max} chars dropped]`;
+}
+async function emitAbort(ctx, reason) {
+    return ctx.emit({
+        type: 'abort',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'system',
+        reason,
+    });
+}
+async function emitError(ctx, kind, message) {
+    return ctx.emit({
+        type: 'error',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'system',
+        kind,
+        message,
+    });
+}
+async function emitCheckpointEvent(ctx, subtype, payload) {
+    return ctx.emit({
+        type: 'plugin_event',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'system',
+        pluginId: CHECKPOINT_EVENT_PLUGIN_ID,
+        subtype,
+        payload,
+    });
+}
+//# sourceMappingURL=react-loop.js.map

package/dist/mode/react-loop.js.map

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

package/dist/mode/stuck-loop.d.ts

@@ -29,6 +29,13 @@ export interface StuckLoopDetector {
     readonly repeatThreshold: number;
     /** Record the call and report whether the loop guard should trip. */
     record(toolName: string, input: unknown): StuckSignal;
+    /**
+     * Clear both sliding windows. Used by the nudge (steer-don't-stop) stuck
+     * policy: after a trip is surfaced to the model, the detector starts a fresh
+     * episode — otherwise every subsequent call inside the still-full window
+     * would re-trip and re-nudge on each iteration.
+     */
+    reset(): void;
 }
 /**
  * User-tunable loop-guard settings (config `context.loopGuard`). All optional —

package/dist/mode/stuck-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stuck-loop.d.ts","sourceRoot":"","sources":["../../src/mode/stuck-loop.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,qEAAqE;IACrE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC;CACvD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;iDAIiD;AACjD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAgB/C,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,iBAAsB,GAAG,iBAAiB,CAkCvF"}
+{"version":3,"file":"stuck-loop.d.ts","sourceRoot":"","sources":["../../src/mode/stuck-loop.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,qEAAqE;IACrE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC;IACtD;;;;;OAKG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;iDAIiD;AACjD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAgB/C,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,iBAAsB,GAAG,iBAAiB,CAsCvF"}

package/dist/mode/stuck-loop.js

@@ -57,6 +57,10 @@ export function createStuckLoopDetector(opts = {}) {
             }
             return { stuck: false, count: Math.max(exactCount, nearCount), kind: 'exact' };
         },
+        reset() {
+            recent.length = 0;
+            recentNear.length = 0;
+        },
     };
 }
 //# sourceMappingURL=stuck-loop.js.map

package/dist/mode/stuck-loop.js.map

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

package/dist/mode-helpers.d.ts

@@ -9,6 +9,8 @@
  *  - `./mode/single-shot.ts`      — single-shot (no-tools) provider turn
  *  - `./mode/stuck-loop.ts`       — sliding-window stuck-tool-call detector
  *  - `./mode/stable-hash.ts`      — key-order-canonical input hash util
+ *  - `./mode/react-loop.ts`       — the shared ReAct loop core (+ checkpoint gate)
+ *  - `./mode/checkpoint.ts`       — turn-end checkpoint contract
  */
 export { ELISION_SYSTEM_NOTE, buildSystemPromptWithSkills, projectMessagesFromLog, projectMessages, type ProjectMessagesOptions, type ProjectedMessages, } from './mode/project-messages.js';
 export { collectProviderStream, type CollectedToolUse, type StreamResult, } from './mode/collect-stream.js';
@@ -16,4 +18,6 @@ export { runSingleShotTurn } from './mode/single-shot.js';
 export { sleepWithAbort, nextBackoffMs } from './mode/abort-backoff.js';
 export { createStuckLoopDetector, type StuckLoopDetector, type StuckSignal, type LoopGuardSettings, } from './mode/stuck-loop.js';
 export { stableHash } from './mode/stable-hash.js';
+export { runReactLoop, MAX_CONSECUTIVE_RETRIES, __setRetrySleepForTests, type ReactLoopOptions, type ProviderSuccessInfo, type ToolBatchInfo, type StopDirective, } from './mode/react-loop.js';
+export type { CheckpointContext, CheckpointResult, TurnCheckpoint, } from './mode/checkpoint.js';
 //# sourceMappingURL=mode-helpers.d.ts.map

package/dist/mode-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mode-helpers.d.ts","sourceRoot":"","sources":["../src/mode-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"mode-helpers.d.ts","sourceRoot":"","sources":["../src/mode-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/dist/mode-helpers.js

@@ -9,6 +9,8 @@
  *  - `./mode/single-shot.ts`      — single-shot (no-tools) provider turn
  *  - `./mode/stuck-loop.ts`       — sliding-window stuck-tool-call detector
  *  - `./mode/stable-hash.ts`      — key-order-canonical input hash util
+ *  - `./mode/react-loop.ts`       — the shared ReAct loop core (+ checkpoint gate)
+ *  - `./mode/checkpoint.ts`       — turn-end checkpoint contract
  */
 export { ELISION_SYSTEM_NOTE, buildSystemPromptWithSkills, projectMessagesFromLog, projectMessages, } from './mode/project-messages.js';
 export { collectProviderStream, } from './mode/collect-stream.js';
@@ -16,4 +18,5 @@ export { runSingleShotTurn } from './mode/single-shot.js';
 export { sleepWithAbort, nextBackoffMs } from './mode/abort-backoff.js';
 export { createStuckLoopDetector, } from './mode/stuck-loop.js';
 export { stableHash } from './mode/stable-hash.js';
+export { runReactLoop, MAX_CONSECUTIVE_RETRIES, __setRetrySleepForTests, } from './mode/react-loop.js';
 //# sourceMappingURL=mode-helpers.js.map

package/dist/mode-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"mode-helpers.js","sourceRoot":"","sources":["../src/mode-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,GAGhB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,GAGtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EACL,uBAAuB,GAIxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"mode-helpers.js","sourceRoot":"","sources":["../src/mode-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,GAGhB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,GAGtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EACL,uBAAuB,GAIxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,GAKxB,MAAM,sBAAsB,CAAC"}