@namzu/sdk 2.0.0 → 3.0.0

package/dist/runtime/query/iteration/phases/context-measurement.test.js

@@ -0,0 +1,161 @@
+/**
+ * What the compaction trigger believes the context costs.
+ *
+ * Two omissions pointed the same way — under-count — so the threshold did
+ * not jitter around the mark, it sat systematically late:
+ *
+ *   1. The provider's prompt measurement describes the request as it was
+ *      SENT. Everything the turn appended afterwards — the assistant
+ *      message and every one of its tool results — fell outside it, and
+ *      the reading was taken verbatim. The staleness is largest on exactly
+ *      the turns that add the most.
+ *   2. The tool catalogue is assembled separately from the message array
+ *      and never entered the fallback estimate at all. A 30-tool registry
+ *      is easily 10-20k tokens of JSON Schema.
+ *
+ * Each case is written so the pre-fix reading lands BELOW the trigger and
+ * the corrected one lands above: compaction either fires or it does not,
+ * which is a sharper signal than a number in a log line.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { WorkingStateManager } from '../../../../compaction/manager.js';
+import { CompactionConfigSchema } from '../../../../config/runtime.js';
+import { createAssistantMessage, createSystemMessage, createUserMessage, } from '../../../../types/message/index.js';
+import { runCompactionCheck } from './compaction.js';
+function makeLogger() {
+    const self = {
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+    };
+    self.child = vi.fn(() => self);
+    return self;
+}
+/** The one log line that reports what the trigger measured. */
+function compactionLog(log) {
+    const calls = log.info.mock.calls;
+    const hit = calls.find((call) => String(call[0]).includes('Compaction threshold reached'));
+    return hit?.[1];
+}
+const WINDOW = 2_500;
+function makeCtx(opts) {
+    const config = CompactionConfigSchema.parse({
+        strategy: 'structured',
+        llmVerification: false,
+        contextWindowTokens: WINDOW,
+        triggerThreshold: 0.7,
+    });
+    const manager = new WorkingStateManager(config);
+    manager.addDecision('kept going');
+    const log = makeLogger();
+    const ctx = {
+        runConfig: { tokenBudget: 0 },
+        compactionConfig: config,
+        workingStateManager: manager,
+        log,
+        tools: { toLLMTools: () => opts.tools ?? [] },
+        runMgr: {
+            id: 'run_1',
+            currentIteration: 3,
+            messages: opts.messages,
+            lastPromptTokens: opts.lastPromptTokens,
+            lastPromptMessageCount: opts.lastPromptMessageCount,
+            clearLastPromptTokens: () => { },
+            accumulateUsage: () => { },
+        },
+        emitEvent: async () => { },
+    };
+    return { ctx, log };
+}
+/** ~`tokens` worth of text under the chars/4 ratio. */
+const bulk = (tokens) => 'x'.repeat(tokens * 4);
+describe('the tail appended after the measurement', () => {
+    it('counts toward the trigger', async () => {
+        // Measured at 1,200 of a 2,500 window — 48%, comfortably under the
+        // 70% trigger. The turn then appended ~1,000 tokens of tool output,
+        // putting the real context at ~88%. Reading the measurement verbatim
+        // meant not compacting on the turn that grew the context the most.
+        const measured = [
+            createSystemMessage('system'),
+            createUserMessage('go'),
+            createAssistantMessage('working'),
+        ];
+        const messages = [...measured, createAssistantMessage(bulk(1_000))];
+        const { ctx, log } = makeCtx({
+            messages,
+            lastPromptTokens: 1_200,
+            lastPromptMessageCount: measured.length,
+        });
+        await runCompactionCheck(ctx);
+        const entry = compactionLog(log);
+        expect(entry).toBeDefined();
+        expect(entry?.measuredBy).toBe('provider');
+        // The measurement is kept whole and the tail added to it — not
+        // re-estimated from scratch, which would throw away the one real
+        // number available.
+        expect(entry?.contextTokens).toBeGreaterThanOrEqual(2_200);
+    });
+    it('leaves the measurement alone when nothing was appended', async () => {
+        const messages = [createUserMessage('go'), createAssistantMessage('done')];
+        const { ctx, log } = makeCtx({
+            messages,
+            lastPromptTokens: 2_000,
+            lastPromptMessageCount: messages.length,
+        });
+        await runCompactionCheck(ctx);
+        expect(compactionLog(log)?.contextTokens).toBe(2_000);
+    });
+    it('falls back to the measurement verbatim when no watermark was recorded', async () => {
+        // A resumed run, or a persistence layer that predates the watermark.
+        // Adding an unbounded tail there would double-count the whole
+        // history, which is a worse error than the staleness.
+        const messages = [createUserMessage('go'), createAssistantMessage(bulk(5_000))];
+        const { ctx, log } = makeCtx({ messages, lastPromptTokens: 2_000 });
+        await runCompactionCheck(ctx);
+        expect(compactionLog(log)?.contextTokens).toBe(2_000);
+    });
+});
+describe('the tool catalogue', () => {
+    it('counts toward the estimate when no provider number exists yet', async () => {
+        // Iteration 1: nothing has been measured. The messages are trivial,
+        // but the schemas shipped with every request are not.
+        const messages = [createUserMessage('go')];
+        const tools = Array.from({ length: 30 }, (_, i) => ({
+            type: 'function',
+            function: {
+                name: `tool_${i}`,
+                description: 'x'.repeat(120),
+                parameters: { type: 'object', properties: { arg: { type: 'string' } } },
+            },
+        }));
+        const { ctx, log } = makeCtx({ messages, tools });
+        await runCompactionCheck(ctx);
+        const entry = compactionLog(log);
+        expect(entry?.measuredBy).toBe('estimate');
+        expect(entry?.contextTokens).toBeGreaterThan(WINDOW * 0.7);
+    });
+    it('does not fire on a small catalogue and a small history', async () => {
+        // The counterpart: the fix must not make the trigger hair-sensitive.
+        const { ctx, log } = makeCtx({
+            messages: [createUserMessage('go')],
+            tools: [{ type: 'function', function: { name: 't', parameters: {} } }],
+        });
+        await runCompactionCheck(ctx);
+        expect(compactionLog(log)).toBeUndefined();
+    });
+    it('survives a registry that cannot render its catalogue', async () => {
+        // The catalogue sharpens the estimate; it is not a precondition for
+        // compacting. Throwing here would take down a run for a reason the
+        // model call reports far better.
+        const { ctx, log } = makeCtx({ messages: [createUserMessage(bulk(2_000))] });
+        ctx.tools = {
+            toLLMTools: () => {
+                throw new Error('registry unavailable');
+            },
+        };
+        await expect(runCompactionCheck(ctx)).resolves.toBeUndefined();
+        expect(compactionLog(log)).toBeDefined();
+    });
+});
+//# sourceMappingURL=context-measurement.test.js.map

package/dist/runtime/query/iteration/phases/context-measurement.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-measurement.test.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/context-measurement.test.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/iteration/phases/context.d.ts

@@ -7,10 +7,12 @@ import type { RunPersistence } from '../../../../manager/run/persistence.js';
 import type { ActivityStore } from '../../../../store/activity/memory.js';
 import type { TaskGateway } from '../../../../types/agent/gateway.js';
 import type { WorkingMemoryProvider } from '../../../../types/agent/working-memory.js';
-import type { HITLResumeDecision, ResumeHandler } from '../../../../types/hitl/index.js';
+import type { HITLResumeDecision, IterationCheckpoint, ResumeHandler } from '../../../../types/hitl/index.js';
 import type { TaskId } from '../../../../types/ids/index.js';
 import type { LLMProvider } from '../../../../types/provider/index.js';
-import type { AgentRunConfig, RunEvent } from '../../../../types/run/index.js';
+import type { ReviewAnswer } from '../../../../types/run/answer-review.js';
+import type { AgentRunConfig, PrepareStepChain, RunEvent, StepResult, StopCondition } from '../../../../types/run/index.js';
+import type { StructuredOutputConfig } from '../../../../types/structured-output/index.js';
 import type { TaskStore } from '../../../../types/task/index.js';
 import type { ToolRegistryContract } from '../../../../types/tool/index.js';
 import type { Logger } from '../../../../utils/logger.js';
@@ -18,6 +20,7 @@ import type { CheckpointManager } from '../../checkpoint.js';
 import type { EmitEvent } from '../../events.js';
 import type { ToolExecutor } from '../../executor.js';
 import type { GuardCoordinator } from '../../guard.js';
+import type { ToolGrantSet } from '../../tool-grants.js';
 export interface LaunchedTaskMeta {
     readonly agentId: string;
     readonly description: string;
@@ -35,7 +38,28 @@ export interface LaunchedTaskMeta {
 }
 export interface IterationContext {
     readonly provider: LLMProvider;
+    /**
+     * The run's `invoke_agent` span, so each iteration can parent itself to
+     * it. Explicit rather than ambient because this loop is an async
+     * generator — see `parentContext` in `telemetry/attributes.ts`.
+     */
+    readonly rootSpan?: import('@opentelemetry/api').Span;
     readonly runConfig: AgentRunConfig;
+    /**
+     * Caller-supplied halt predicate, evaluated after each step's tools have
+     * run. See {@link StopCondition}.
+     */
+    readonly stopWhen?: StopCondition;
+    /**
+     * Host verdict on the answer the run is about to settle with, and how
+     * many rejections it may spend before stopping.
+     */
+    readonly reviewAnswer?: ReviewAnswer;
+    readonly maxAnswerReviews?: number;
+    /** Called with each completed step, as it completes. */
+    readonly onStepFinish?: (step: StepResult) => void;
+    /** Demand a schema-validated final answer. See QueryParams.structuredOutput. */
+    readonly structuredOutput?: StructuredOutputConfig;
     readonly tools: ToolRegistryContract;
     readonly allowedTools?: string[];
     readonly runMgr: RunPersistence;
@@ -52,6 +76,13 @@ export interface IterationContext {
     readonly taskGateway?: TaskGateway;
     readonly taskStore?: TaskStore;
     readonly launchedTasks: Map<TaskId, LaunchedTaskMeta>;
+    /**
+     * Approvals a human granted earlier in this run, at a scope they chose.
+     *
+     * Consulted before a tool-review park so an already-approved call is not
+     * asked about again. Absent on paths that do not review tools.
+     */
+    readonly toolGrants?: ToolGrantSet;
     readonly compactionConfig?: CompactionConfig;
     readonly workingStateManager?: WorkingStateManager;
     readonly workingMemoryProvider?: WorkingMemoryProvider;
@@ -59,8 +90,37 @@ export interface IterationContext {
     readonly agentBus?: AgentBus;
     readonly verificationGate?: import('../../../../verification/gate.js').VerificationGate;
     readonly pluginManager?: import('../../../../plugin/lifecycle.js').PluginLifecycleManager;
+    /**
+     * Override for {@link PARK_RECORD_DELAY_MS}. Internal; tests set `0` to
+     * observe a recorded park without waiting out the real threshold.
+     */
+    readonly parkRecordDelayMs?: number;
+    /** Host hook that shapes each step before the model call. */
+    readonly prepareStep?: PrepareStepChain;
 }
 export type PhaseSignal = 'continue' | 'stop';
+/**
+ * How long a decision may take before the park is written to the store.
+ *
+ * A park is only worth persisting if a human is actually looking at it. An
+ * `autoApproveHandler` — or any programmatic handler — answers in well
+ * under a millisecond, and the iteration gate runs on EVERY iteration by
+ * default, so recording every one unconditionally would take a long run
+ * from one full-history checkpoint write per iteration to three. This
+ * threshold buys the durability where it matters and costs nothing where
+ * it does not.
+ */
+export declare const PARK_RECORD_DELAY_MS = 250;
+/**
+ * Await a HITL decision, recording the park durably if it turns out to be
+ * a real one.
+ *
+ * The park used to exist only as a suspended `await` inside one process:
+ * kill the process and the request vanished, so a host could not rebuild
+ * an approval queue and a resumed run silently re-asked the model instead
+ * of honoring an approval a human had already granted.
+ */
+export declare function awaitDecisionDurably(ctx: IterationContext, checkpoint: IterationCheckpoint, request: Parameters<ResumeHandler>[0]): Promise<HITLResumeDecision>;
 /**
  * Await a HITL `resumeHandler` decision, but RACE it against the run's abort
  * signal. A Stop that arrives while the run is parked on a tool-review or

package/dist/runtime/query/iteration/phases/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/context.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/iteration/phases/context.js

@@ -1,3 +1,90 @@
+/**
+ * How long a decision may take before the park is written to the store.
+ *
+ * A park is only worth persisting if a human is actually looking at it. An
+ * `autoApproveHandler` — or any programmatic handler — answers in well
+ * under a millisecond, and the iteration gate runs on EVERY iteration by
+ * default, so recording every one unconditionally would take a long run
+ * from one full-history checkpoint write per iteration to three. This
+ * threshold buys the durability where it matters and costs nothing where
+ * it does not.
+ */
+export const PARK_RECORD_DELAY_MS = 250;
+/**
+ * Await a HITL decision, recording the park durably if it turns out to be
+ * a real one.
+ *
+ * The park used to exist only as a suspended `await` inside one process:
+ * kill the process and the request vanished, so a host could not rebuild
+ * an approval queue and a resumed run silently re-asked the model instead
+ * of honoring an approval a human had already granted.
+ */
+export async function awaitDecisionDurably(ctx, checkpoint, request) {
+    const delay = ctx.parkRecordDelayMs ?? PARK_RECORD_DELAY_MS;
+    const decisionPromise = awaitDecisionOrAbort(ctx, request);
+    let settled = false;
+    let recorded = false;
+    const record = async () => {
+        try {
+            await ctx.checkpointMgr.park(checkpoint, request);
+            recorded = true;
+        }
+        catch (err) {
+            // A store that cannot record the park must not take the run down
+            // with it — the in-process await is still perfectly valid, it is
+            // only the cross-process handoff that is lost. Loudly, though.
+            ctx.log.error('Failed to record a HITL park — the run is not resumable across a restart', {
+                runId: ctx.runMgr.id,
+                checkpointId: checkpoint.id,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    };
+    const recordIfSlow = (async () => {
+        await sleep(delay);
+        if (settled)
+            return;
+        await record();
+    })();
+    try {
+        const decision = await decisionPromise;
+        settled = true;
+        await recordIfSlow;
+        // `pause` is not an answer — it is "I am not answering now, hold
+        // this". It therefore ALWAYS gets recorded, even when it arrived too
+        // fast for the slow-park timer: a host that cannot block (a
+        // serverless handler, a queue worker) answers `pause` immediately
+        // and comes back in another process, which is the whole case this
+        // exists for.
+        if (decision.action === 'pause') {
+            if (!recorded)
+                await record();
+            return decision;
+        }
+        // Every other action resolves the park. Clearing it is what keeps an
+        // approval queue from re-serving a decision that was already made.
+        if (recorded) {
+            await ctx.checkpointMgr.unpark(checkpoint.id, decision).catch((err) => {
+                ctx.log.error('Failed to clear a recorded HITL park', {
+                    runId: ctx.runMgr.id,
+                    checkpointId: checkpoint.id,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                return null;
+            });
+        }
+        return decision;
+    }
+    finally {
+        settled = true;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, ms);
+        timer.unref?.();
+    });
+}
 /**
  * Await a HITL `resumeHandler` decision, but RACE it against the run's abort
  * signal. A Stop that arrives while the run is parked on a tool-review or

package/dist/runtime/query/iteration/phases/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/context.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/iteration/phases/hitl-answer-question.test.js

@@ -112,7 +112,9 @@ describe('runToolReview answer_question case', () => {
             selectedOptionIds: [],
         });
         const { value } = await drainGenerator(runToolReview(ctx, response, 1));
-        expect(value).toBe('executed');
+        // The review now returns its tool outcomes alongside the decision, so
+        // the loop can build a StepResult without re-deriving them.
+        expect(value.decision).toBe('executed');
         expect(batchCount()).toBe(1);
         expect(warns).toHaveLength(1);
     });

package/dist/runtime/query/iteration/phases/hitl-answer-question.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"hitl-answer-question.test.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/hitl-answer-question.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hitl-answer-question.test.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/hitl-answer-question.test.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/iteration/phases/overflow-escalation.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A forced compaction pass runs because the PROVIDER rejected the prompt
+ * as too long. Two things let it decline to do anything about that:
+ *
+ *   1. After clearing stale tool results it re-applied the chars/4
+ *      estimate — the very estimate the provider had just refuted — and
+ *      returned early if that said the context was fine. So relief could
+ *      report success after clearing one short result, and the retry
+ *      overflowed again.
+ *   2. Relief reported success on ANY positive shed. A one-character shed
+ *      counted, and the retry burned a whole model call to be told the
+ *      same thing.
+ */
+export {};
+//# sourceMappingURL=overflow-escalation.test.d.ts.map

package/dist/runtime/query/iteration/phases/overflow-escalation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow-escalation.test.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/overflow-escalation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/runtime/query/iteration/phases/overflow-escalation.test.js

@@ -0,0 +1,130 @@
+/**
+ * A forced compaction pass runs because the PROVIDER rejected the prompt
+ * as too long. Two things let it decline to do anything about that:
+ *
+ *   1. After clearing stale tool results it re-applied the chars/4
+ *      estimate — the very estimate the provider had just refuted — and
+ *      returned early if that said the context was fine. So relief could
+ *      report success after clearing one short result, and the retry
+ *      overflowed again.
+ *   2. Relief reported success on ANY positive shed. A one-character shed
+ *      counted, and the retry burned a whole model call to be told the
+ *      same thing.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { WorkingStateManager } from '../../../../compaction/manager.js';
+import { CompactionConfigSchema } from '../../../../config/runtime.js';
+import { createAssistantMessage, createSystemMessage, createToolMessage, createUserMessage, } from '../../../../types/message/index.js';
+import { relieveOverflow } from './compaction.js';
+function makeLogger() {
+    const self = {
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+    };
+    self.child = vi.fn(() => self);
+    return self;
+}
+const bulk = (chars) => 'x'.repeat(chars);
+function makeCtx(messages) {
+    const config = CompactionConfigSchema.parse({
+        strategy: 'structured',
+        llmVerification: false,
+        // Large on purpose: the estimate must read as COMFORTABLE, which is
+        // exactly the state in which the provider still rejected the prompt.
+        // That is the case the early return used to mishandle.
+        contextWindowTokens: 1_000_000,
+    });
+    const manager = new WorkingStateManager(config);
+    manager.addDecision('kept going');
+    const log = makeLogger();
+    const ctx = {
+        runConfig: { tokenBudget: 0 },
+        compactionConfig: config,
+        workingStateManager: manager,
+        log,
+        tools: { toLLMTools: () => [] },
+        runMgr: {
+            id: 'run_1',
+            currentIteration: 6,
+            messages,
+            lastPromptTokens: undefined,
+            lastPromptMessageCount: undefined,
+            clearLastPromptTokens: () => { },
+            accumulateUsage: () => { },
+        },
+        emitEvent: async () => { },
+    };
+    return { ctx, log };
+}
+/** A history with plenty of older turns and one huge stale tool result. */
+function overflowingHistory() {
+    const messages = [createSystemMessage('system floor')];
+    for (let i = 0; i < 8; i++) {
+        messages.push(createUserMessage(`turn ${i} ${bulk(400)}`));
+        messages.push({
+            ...createAssistantMessage(''),
+            toolCalls: [
+                { id: `t${i}`, type: 'function', function: { name: 'read', arguments: '{}' } },
+            ],
+        });
+        messages.push(createToolMessage(bulk(i === 0 ? 60_000 : 800), `t${i}`));
+    }
+    return messages;
+}
+describe('a forced pass on a context the estimate thinks is fine', () => {
+    it('does not stop after clearing one tool result', async () => {
+        const messages = overflowingHistory();
+        const { ctx } = makeCtx(messages);
+        const before = messages.length;
+        await relieveOverflow(ctx);
+        // The estimate said the context was comfortable — the provider had
+        // just said otherwise. Compaction, not the estimate, gets to decide
+        // whether a forced pass is done.
+        expect(ctx.runMgr.messages.length).toBeLessThan(before);
+    });
+    it('reports relief when it actually shed something substantial', async () => {
+        const { ctx } = makeCtx(overflowingHistory());
+        expect(await relieveOverflow(ctx)).toBe(true);
+    });
+});
+describe('what counts as relief', () => {
+    it('refuses when there is nothing at all to shed', async () => {
+        const { ctx, log } = makeCtx([
+            createSystemMessage('system floor'),
+            createUserMessage(bulk(200)),
+        ]);
+        expect(await relieveOverflow(ctx)).toBe(false);
+        expect(log.warn.mock.calls.some(([message]) => String(message).includes('irreducible'))).toBe(true);
+    });
+    it('refuses a POSITIVE shed too small to change the provider verdict', async () => {
+        // Many short turns: a forced pass genuinely sheds something, but
+        // only a few hundred characters — nowhere near enough to move a
+        // prompt the provider has already rejected. Any positive shed used
+        // to count, so the caller retried and burned a whole model call to
+        // be told the same thing.
+        const messages = [createSystemMessage('floor')];
+        for (let i = 0; i < 14; i++) {
+            messages.push(createUserMessage(`u${i} ${bulk(30)}`));
+            messages.push(createAssistantMessage(`a${i} ${bulk(30)}`));
+        }
+        const before = messages.reduce((sum, m) => sum + (typeof m.content === 'string' ? m.content.length : 0), 0);
+        const { ctx } = makeCtx(messages);
+        const relieved = await relieveOverflow(ctx);
+        const after = ctx.runMgr.messages.reduce((sum, m) => sum + (typeof m.content === 'string' ? m.content.length : 0), 0);
+        const shed = before - after;
+        // The premise of the case: something WAS shed, just not enough.
+        expect(shed).toBeGreaterThan(0);
+        expect(shed).toBeLessThan(2_000);
+        expect(relieved).toBe(false);
+    });
+    it('says how much it shed and how much was needed', async () => {
+        const { ctx, log } = makeCtx([createSystemMessage('floor'), createUserMessage(bulk(200))]);
+        await relieveOverflow(ctx);
+        const warned = log.warn.mock.calls[0];
+        expect(warned?.[1]).toMatchObject({ charsShed: expect.any(Number) });
+        expect((warned?.[1]).neededAtLeast).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=overflow-escalation.test.js.map

package/dist/runtime/query/iteration/phases/overflow-escalation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow-escalation.test.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/overflow-escalation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAEtE,OAAO,EAEN,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GACjB,MAAM,oCAAoC,CAAA;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGjD,SAAS,UAAU;IAClB,MAAM,IAAI,GAAG;QACZ,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;KACO,CACrB;IAAC,IAA4C,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IACxE,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAEjD,SAAS,OAAO,CAAC,QAAmB;IACnC,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC;QAC3C,QAAQ,EAAE,YAAY;QACtB,eAAe,EAAE,KAAK;QACtB,oEAAoE;QACpE,qEAAqE;QACrE,uDAAuD;QACvD,mBAAmB,EAAE,SAAS;KAC9B,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAC/C,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IACjC,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;IAExB,MAAM,GAAG,GAAG;QACX,SAAS,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE;QAC7B,gBAAgB,EAAE,MAAM;QACxB,mBAAmB,EAAE,OAAO;QAC5B,GAAG;QACH,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QAC/B,MAAM,EAAE;YACP,EAAE,EAAE,OAAgB;YACpB,gBAAgB,EAAE,CAAC;YACnB,QAAQ;YACR,gBAAgB,EAAE,SAAS;YAC3B,sBAAsB,EAAE,SAAS;YACjC,qBAAqB,EAAE,GAAG,EAAE,GAAE,CAAC;YAC/B,eAAe,EAAE,GAAG,EAAE,GAAE,CAAC;SACzB;QACD,SAAS,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACM,CAAA;IAEhC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;AACpB,CAAC;AAED,2EAA2E;AAC3E,SAAS,kBAAkB;IAC1B,MAAM,QAAQ,GAAc,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC,CAAA;IACjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QAC1D,QAAQ,CAAC,IAAI,CAAC;YACb,GAAG,sBAAsB,CAAC,EAAE,CAAC;YAC7B,SAAS,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,UAAmB,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;aACvF;SACU,CAAC,CAAA;QACb,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;IACxE,CAAC;IACD,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED,QAAQ,CAAC,wDAAwD,EAAE,GAAG,EAAE;IACvE,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;QACrC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;QAE9B,MAAM,eAAe,CAAC,GAAG,CAAC,CAAA;QAE1B,mEAAmE;QACnE,oEAAoE;QACpE,iCAAiC;QACjC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;YAC5B,mBAAmB,CAAC,cAAc,CAAC;YACnC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAC5B,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9C,MAAM,CACJ,GAAG,CAAC,IAAoD,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CACvF,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CACvC,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QACjF,iEAAiE;QACjE,gEAAgE;QAChE,mEAAmE;QACnE,mEAAmE;QACnE,0BAA0B;QAC1B,MAAM,QAAQ,GAAc,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAA;QAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACrD,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QAC3D,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAC7B,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EACxE,CAAC,CACD,CAAA;QAED,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;QACjC,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAA;QAE3C,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CACvC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EACxE,CAAC,CACD,CAAA;QACD,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,CAAA;QAC3B,gEAAgE;QAChE,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1F,MAAM,eAAe,CAAC,GAAG,CAAC,CAAA;QAE1B,MAAM,MAAM,GAAI,GAAG,CAAC,IAAoD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACtF,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACpE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAA+B,CAAA,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;IACpF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/runtime/query/iteration/phases/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAsB,MAAM,cAAc,CAAA;AAE1F,wBAAuB,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAmC/F"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/plan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAsB,MAAM,cAAc,CAAA;AAE1F,wBAAuB,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CA0C/F"}

package/dist/runtime/query/iteration/phases/plan.js

@@ -12,7 +12,7 @@ export async function* runPlanGate(ctx) {
     });
     yield* ctx.drainPending();
     const plan = ctx.planManager.active;
-    const planDecision = await ctx.resumeHandler({
+    const request = {
         type: 'plan_approval',
         runId: ctx.runMgr.id,
         checkpointId: planCheckpoint.id,
@@ -28,7 +28,13 @@ export async function* runPlanGate(ctx) {
             })),
             summary: plan.summary,
         },
-    });
+    };
+    // Record the park BEFORE awaiting it. A process that dies while a human
+    // is reading the plan otherwise leaves nothing behind saying the plan
+    // was ever put up for approval.
+    await ctx.checkpointMgr.park(planCheckpoint, request);
+    const planDecision = await ctx.resumeHandler(request);
+    await ctx.checkpointMgr.unpark(planCheckpoint.id, planDecision);
     return yield* handleHITLDecision(ctx, planDecision, planCheckpoint.id, 'plan_gate');
 }
 //# sourceMappingURL=plan.js.map

package/dist/runtime/query/iteration/phases/plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/plan.ts"],"names":[],"mappings":"AACA,OAAO,EAA2C,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAE1F,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAAC,GAAqB;IACvD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC1E,OAAO,UAAU,CAAA;IAClB,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAEpE,MAAM,GAAG,CAAC,SAAS,CAAC;QACnB,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;QACpB,YAAY,EAAE,cAAc,CAAC,EAAE;QAC/B,SAAS,EAAE,CAAC;KACZ,CAAC,CAAA;IACF,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAA;IAEzB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAA;IACnC,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC;QAC5C,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;QACpB,YAAY,EAAE,cAAc,CAAC,EAAE;QAC/B,IAAI,EAAE;YACL,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,KAAK,EAAE,CAAC,CAAC,KAAK;aACd,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB;KACD,CAAC,CAAA;IAEF,OAAO,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;AACpF,CAAC"}
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/plan.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2C,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAE1F,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAAC,GAAqB;IACvD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC1E,OAAO,UAAU,CAAA;IAClB,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAEpE,MAAM,GAAG,CAAC,SAAS,CAAC;QACnB,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;QACpB,YAAY,EAAE,cAAc,CAAC,EAAE;QAC/B,SAAS,EAAE,CAAC;KACZ,CAAC,CAAA;IACF,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAA;IAEzB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAA;IACnC,MAAM,OAAO,GAAwB;QACpC,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;QACpB,YAAY,EAAE,cAAc,CAAC,EAAE;QAC/B,IAAI,EAAE;YACL,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,KAAK,EAAE,CAAC,CAAC,KAAK;aACd,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB;KACD,CAAA;IAED,wEAAwE;IACxE,sEAAsE;IACtE,gCAAgC;IAChC,MAAM,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IACrD,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;IACrD,MAAM,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,YAAY,CAAC,CAAA;IAE/D,OAAO,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;AACpF,CAAC"}