@namzu/sdk 1.0.0 → 1.1.0

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

@@ -6,6 +6,7 @@ import type { PlanManager } from '../../../../manager/plan/lifecycle.js';
 import type { RunPersistence } from '../../../../manager/run/persistence.js';
 import type { ActivityStore } from '../../../../store/activity/memory.js';
 import type { TaskGateway, TaskHandle } 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 { TaskId } from '../../../../types/ids/index.js';
 import type { LLMProvider } from '../../../../types/provider/index.js';
@@ -54,11 +55,22 @@ export interface IterationContext {
     readonly launchedTasks: Map<TaskId, LaunchedTaskMeta>;
     readonly compactionConfig?: CompactionConfig;
     readonly workingStateManager?: WorkingStateManager;
+    readonly workingMemoryProvider?: WorkingMemoryProvider;
     readonly advisoryCtx?: AdvisoryContext;
     readonly agentBus?: AgentBus;
     readonly verificationGate?: import('../../../../verification/gate.js').VerificationGate;
     readonly pluginManager?: import('../../../../plugin/lifecycle.js').PluginLifecycleManager;
 }
 export type PhaseSignal = 'continue' | 'stop';
+/**
+ * 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
+ * iteration checkpoint used to do nothing until the host eventually answered
+ * (the park await was not cancellable). Racing the signal lets a Stop resolve
+ * the park immediately as an `abort` decision, which `handleHITLDecision`
+ * turns into `setStopReason('cancelled') + markCancelled + stop`. Fails closed:
+ * a resume-handler rejection also resolves to `abort` rather than hanging.
+ */
+export declare function awaitDecisionOrAbort(ctx: IterationContext, request: Parameters<ResumeHandler>[0]): Promise<HITLResumeDecision>;
 export declare function handleHITLDecision(ctx: IterationContext, decision: HITLResumeDecision, checkpointId: string, context: string): AsyncGenerator<RunEvent, PhaseSignal>;
 //# sourceMappingURL=context.d.ts.map

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,52 @@
+/**
+ * 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
+ * iteration checkpoint used to do nothing until the host eventually answered
+ * (the park await was not cancellable). Racing the signal lets a Stop resolve
+ * the park immediately as an `abort` decision, which `handleHITLDecision`
+ * turns into `setStopReason('cancelled') + markCancelled + stop`. Fails closed:
+ * a resume-handler rejection also resolves to `abort` rather than hanging.
+ */
+export async function awaitDecisionOrAbort(ctx, request) {
+    const signal = ctx.abortController?.signal;
+    // No abort signal wired (e.g. a minimal test harness) → behave exactly as a
+    // direct resumeHandler await, no race. In production RunContextFactory always
+    // provides the controller, so the race below is live.
+    if (!signal)
+        return ctx.resumeHandler(request);
+    const abortDecision = {
+        action: 'abort',
+        reason: 'run aborted while parked for HITL',
+    };
+    if (signal.aborted)
+        return abortDecision;
+    return new Promise((resolve) => {
+        let settled = false;
+        const onAbort = () => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(abortDecision);
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        Promise.resolve(ctx.resumeHandler(request)).then((decision) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener('abort', onAbort);
+            resolve(decision);
+        }, (err) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener('abort', onAbort);
+            resolve({
+                action: 'abort',
+                reason: err instanceof Error ? err.message : 'resume handler failed',
+            });
+        });
+    });
+}
 export async function* handleHITLDecision(ctx, decision, checkpointId, context) {
     switch (decision.action) {
         case 'pause': {
@@ -44,6 +93,10 @@ export async function* handleHITLDecision(ctx, decision, checkpointId, context)
         case 'approve_tools':
         case 'modify_tools':
         case 'reject_tools':
+        // 'answer_question' can only arrive misdirected at an iteration
+        // checkpoint (answers are consumed inside the ask_user_question
+        // tool's own park); treat it as a plain continue.
+        case 'answer_question':
             return 'continue';
         default: {
             const _exhaustive = decision;

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":"AA4EA,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,kBAAkB,CACxC,GAAqB,EACrB,QAA4B,EAC5B,YAAoB,EACpB,OAAe;IAEf,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzB,KAAK,OAAO,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;gBACpB,YAAY,EAAE,YAA8B;gBAC5C,MAAM,EAAE,QAAQ,CAAC,MAAM;aACvB,CAAC,CAAA;YACF,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAA;YACzB,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;YAClC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,OAAO,EAAE,EAAE;gBACxC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;gBACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;aACvB,CAAC,CAAA;YACF,OAAO,MAAM,CAAA;QACd,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACd,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAA;YACrC,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAA;YAC1B,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,OAAO,EAAE,EAAE;gBACzC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;gBACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;aACvB,CAAC,CAAA;YACF,OAAO,MAAM,CAAA;QACd,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAA;YACzC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE;gBACrC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;gBACxB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC3B,CAAC,CAAA;YACF,OAAO,MAAM,CAAA;QACd,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACrB,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBAC5B,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,CAAA;gBACzB,GAAG,CAAC,WAAW,CAAC,cAAc,EAAE,CAAA;YACjC,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAA;YACnE,OAAO,UAAU,CAAA;QAClB,CAAC;QACD,KAAK,UAAU,CAAC;QAChB,KAAK,eAAe,CAAC;QACrB,KAAK,cAAc,CAAC;QACpB,KAAK,cAAc;YAClB,OAAO,UAAU,CAAA;QAClB,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,QAAQ,CAAA;YACnC,MAAM,IAAI,KAAK,CAAC,4BAA6B,WAAkC,CAAC,MAAM,EAAE,CAAC,CAAA;QAC1F,CAAC;IACF,CAAC;AACF,CAAC"}
+{"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-abort-race.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hitl-abort-race.test.d.ts.map

package/dist/runtime/query/iteration/phases/hitl-abort-race.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitl-abort-race.test.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/hitl-abort-race.test.ts"],"names":[],"mappings":""}

package/dist/runtime/query/iteration/phases/hitl-abort-race.test.js

@@ -0,0 +1,73 @@
+import { describe, expect, it } from 'vitest';
+import { awaitDecisionOrAbort } from './context.js';
+/**
+ * C12: a Stop that arrives while the run is parked on a HITL decision must
+ * interrupt the park (resolve as `abort`) instead of hanging until the host
+ * eventually answers. `awaitDecisionOrAbort` races `resumeHandler` against
+ * `ctx.abortController.signal`.
+ */
+function ctxWith(opts) {
+    return {
+        abortController: opts.controller,
+        resumeHandler: opts.resumeHandler,
+        runMgr: { id: 'run_abort_test' },
+    };
+}
+const REVIEW_REQUEST = {
+    type: 'tool_review',
+    runId: 'run_abort_test',
+    checkpointId: 'cp_1',
+    toolCalls: [],
+};
+describe('awaitDecisionOrAbort (C12 — cancellable HITL park)', () => {
+    it('returns abort immediately when the signal is already aborted', async () => {
+        const controller = new AbortController();
+        controller.abort();
+        const ctx = ctxWith({
+            controller,
+            // A handler that never resolves — proving we did not wait on it.
+            resumeHandler: () => new Promise(() => { }),
+        });
+        const decision = await awaitDecisionOrAbort(ctx, REVIEW_REQUEST);
+        expect(decision.action).toBe('abort');
+    });
+    it('resolves as abort when the signal fires DURING the park', async () => {
+        const controller = new AbortController();
+        const ctx = ctxWith({
+            controller,
+            resumeHandler: () => new Promise(() => { }), // never answers
+        });
+        const pending = awaitDecisionOrAbort(ctx, REVIEW_REQUEST);
+        controller.abort();
+        const decision = await pending;
+        expect(decision.action).toBe('abort');
+    });
+    it('returns the real decision when the handler answers before any abort', async () => {
+        const controller = new AbortController();
+        const ctx = ctxWith({
+            controller,
+            resumeHandler: async () => ({ action: 'approve_tools' }),
+        });
+        const decision = await awaitDecisionOrAbort(ctx, REVIEW_REQUEST);
+        expect(decision.action).toBe('approve_tools');
+    });
+    it('degrades to a direct resumeHandler await when no controller is wired', async () => {
+        const ctx = ctxWith({
+            resumeHandler: async () => ({ action: 'reject_tools' }),
+        });
+        const decision = await awaitDecisionOrAbort(ctx, REVIEW_REQUEST);
+        expect(decision.action).toBe('reject_tools');
+    });
+    it('fails closed to abort when the resume handler rejects', async () => {
+        const controller = new AbortController();
+        const ctx = ctxWith({
+            controller,
+            resumeHandler: async () => {
+                throw new Error('handler boom');
+            },
+        });
+        const decision = await awaitDecisionOrAbort(ctx, REVIEW_REQUEST);
+        expect(decision.action).toBe('abort');
+    });
+});
+//# sourceMappingURL=hitl-abort-race.test.js.map

package/dist/runtime/query/iteration/phases/hitl-abort-race.test.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hitl-answer-question.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hitl-answer-question.test.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/hitl-answer-question.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,120 @@
+import { describe, expect, it } from 'vitest';
+import { autoApproveHandler } from '../../../../types/hitl/index.js';
+import { handleHITLDecision } from './context.js';
+import { runToolReview } from './tool-review.js';
+async function drainGenerator(gen) {
+    const events = [];
+    let next = await gen.next();
+    while (!next.done) {
+        events.push(next.value);
+        next = await gen.next();
+    }
+    return { events, value: next.value };
+}
+describe('autoApproveHandler user_question case', () => {
+    it('returns the non-fabricating no-answer sentinel with the questionId echoed', async () => {
+        const decision = await autoApproveHandler({
+            type: 'user_question',
+            runId: 'run_headless_test',
+            checkpointId: 'cp_question_toolu_1',
+            question: {
+                questionId: 'toolu_1',
+                question: 'Pick one?',
+                options: [
+                    { id: 'opt_1', label: 'A' },
+                    { id: 'opt_2', label: 'B' },
+                ],
+                multiSelect: false,
+                allowFreeText: true,
+            },
+        });
+        expect(decision).toEqual({
+            action: 'answer_question',
+            selectedOptionIds: [],
+            freeText: 'No user is available to answer. Proceed using your best judgment.',
+            questionId: 'toolu_1',
+        });
+    });
+});
+describe('handleHITLDecision answer_question case', () => {
+    it("treats a misdirected 'answer_question' at an iteration checkpoint as continue", async () => {
+        // The branch returns without touching the context — answers are
+        // consumed inside the ask_user_question tool's own park, so an
+        // answer arriving here can only be misdirected.
+        const ctx = {};
+        const { events, value } = await drainGenerator(handleHITLDecision(ctx, { action: 'answer_question', selectedOptionIds: ['opt_1'] }, 'cp_checkpoint_1', 'iteration checkpoint'));
+        expect(value).toBe('continue');
+        expect(events).toEqual([]);
+    });
+});
+describe('runToolReview answer_question case', () => {
+    function reviewContext(decision) {
+        const warns = [];
+        const pushed = [];
+        let batches = 0;
+        const ctx = {
+            tools: { get: () => undefined },
+            checkpointMgr: {
+                create: async () => ({ id: 'cp_review_1' }),
+            },
+            emitEvent: async () => { },
+            drainPending: () => [][Symbol.iterator](),
+            resumeHandler: async () => decision,
+            log: {
+                debug: () => { },
+                info: () => { },
+                warn: (message) => {
+                    warns.push(message);
+                },
+                error: () => { },
+            },
+            runMgr: {
+                id: 'run_tool_review_test',
+                pushMessage: (message) => {
+                    pushed.push(message);
+                },
+            },
+            toolExecutor: {
+                executeBatch: async () => {
+                    batches += 1;
+                    return { messages: [], results: [] };
+                },
+            },
+        };
+        return { ctx, warns, pushed, batchCount: () => batches };
+    }
+    const response = {
+        id: 'resp_1',
+        model: 'test-model',
+        message: {
+            role: 'assistant',
+            content: null,
+            toolCalls: [
+                {
+                    id: 'toolu_review_1',
+                    type: 'function',
+                    function: { name: 'ask_user_question', arguments: '{}' },
+                },
+            ],
+        },
+        finishReason: 'tool_calls',
+        usage: {
+            promptTokens: 0,
+            completionTokens: 0,
+            totalTokens: 0,
+            cachedTokens: 0,
+            cacheWriteTokens: 0,
+        },
+    };
+    it("warns and executes the batch on a misdirected 'answer_question' instead of stalling", async () => {
+        const { ctx, warns, batchCount } = reviewContext({
+            action: 'answer_question',
+            selectedOptionIds: [],
+        });
+        const { value } = await drainGenerator(runToolReview(ctx, response, 1));
+        expect(value).toBe('executed');
+        expect(batchCount()).toBe(1);
+        expect(warns).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=hitl-answer-question.test.js.map

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

@@ -0,0 +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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"}

package/dist/runtime/query/iteration/phases/tool-review.d.ts

@@ -1,7 +1,7 @@
 import type { ChatCompletionResponse } from '../../../../types/provider/index.js';
 import type { RunEvent } from '../../../../types/run/index.js';
 import type { VerificationGate } from '../../../../verification/index.js';
-import type { IterationContext } from './context.js';
+import { type IterationContext } from './context.js';
 interface VerificationAwareContext extends IterationContext {
     readonly verificationGate?: VerificationGate;
 }

package/dist/runtime/query/iteration/phases/tool-review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-review.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/tool-review.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,UAAU,wBAAyB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CAC5C;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAA;AAEhE,wBAAuB,aAAa,CACnC,GAAG,EAAE,wBAAwB,EAC7B,QAAQ,EAAE,sBAAsB,EAChC,YAAY,EAAE,MAAM,GAClB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CA0M7C"}
+{"version":3,"file":"tool-review.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/tool-review.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,cAAc,CAAA;AAE1E,UAAU,wBAAyB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CAC5C;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAA;AAEhE,wBAAuB,aAAa,CACnC,GAAG,EAAE,wBAAwB,EAC7B,QAAQ,EAAE,sBAAsB,EAChC,YAAY,EAAE,MAAM,GAClB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CA8M7C"}

package/dist/runtime/query/iteration/phases/tool-review.js

@@ -1,4 +1,5 @@
 import { createUserMessage } from '../../../../types/message/index.js';
+import { awaitDecisionOrAbort } from './context.js';
 export async function* runToolReview(ctx, response, iterationNum) {
     const toolCalls = response.message.toolCalls;
     if (!toolCalls || toolCalls.length === 0) {
@@ -68,7 +69,7 @@ export async function* runToolReview(ctx, response, iterationNum) {
         iteration: iterationNum,
     });
     yield* ctx.drainPending();
-    const reviewDecision = await ctx.resumeHandler({
+    const reviewDecision = await awaitDecisionOrAbort(ctx, {
         type: 'tool_review',
         runId: ctx.runMgr.id,
         checkpointId: reviewCheckpoint.id,
@@ -158,7 +159,11 @@ export async function* runToolReview(ctx, response, iterationNum) {
             return 'executed';
         }
         case 'approve_plan':
-        case 'reject_plan': {
+        case 'reject_plan':
+        // 'answer_question' belongs to an ask_user_question park, not a
+        // tool review — like the misdirected plan decisions above, warn
+        // and proceed with execution rather than stalling the run.
+        case 'answer_question': {
             ctx.log.warn('Unexpected plan decision during tool review', {
                 action: reviewDecision.action,
             });

package/dist/runtime/query/iteration/phases/tool-review.js.map

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

package/dist/runtime/query/iteration/phases/working-memory-compaction.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Regression test for the ses_055 Layer-B SDK seam (#104):
+ *
+ *   1. **Compaction FIRES** under a small `contextWindowTokens` even with the
+ *      run-level `tokenBudget = 0` (UNLIMITED) — proving the F1 fix repointed
+ *      BOTH the `<= 0` guard AND the divisor, closing the silent-no-op trap.
+ *   2. **The pinned working-memory slot SURVIVES** the compaction pass (it is a
+ *      leading system message → preserved by header identity).
+ *   3. **No premature stop** from `tokenBudget = 0` alone: with NO
+ *      `contextWindowTokens`, the same overflowing run does NOT compact (the
+ *      legacy fallback), so consumers that never set the new field are
+ *      byte-identical.
+ *
+ * The test drives `refreshWorkingMemory` (to pin the slot) then
+ * `runCompactionCheck` directly against a mock `IterationContext`, which is the
+ * exact sequence the iteration loop runs each turn.
+ */
+export {};
+//# sourceMappingURL=working-memory-compaction.test.d.ts.map

package/dist/runtime/query/iteration/phases/working-memory-compaction.test.d.ts.map

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

package/dist/runtime/query/iteration/phases/working-memory-compaction.test.js

@@ -0,0 +1,177 @@
+/**
+ * Regression test for the ses_055 Layer-B SDK seam (#104):
+ *
+ *   1. **Compaction FIRES** under a small `contextWindowTokens` even with the
+ *      run-level `tokenBudget = 0` (UNLIMITED) — proving the F1 fix repointed
+ *      BOTH the `<= 0` guard AND the divisor, closing the silent-no-op trap.
+ *   2. **The pinned working-memory slot SURVIVES** the compaction pass (it is a
+ *      leading system message → preserved by header identity).
+ *   3. **No premature stop** from `tokenBudget = 0` alone: with NO
+ *      `contextWindowTokens`, the same overflowing run does NOT compact (the
+ *      legacy fallback), so consumers that never set the new field are
+ *      byte-identical.
+ *
+ * The test drives `refreshWorkingMemory` (to pin the slot) then
+ * `runCompactionCheck` directly against a mock `IterationContext`, which is the
+ * exact sequence the iteration loop runs each turn.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { findDanglingMessages } from '../../../../compaction/dangling.js';
+import { WorkingStateManager } from '../../../../compaction/manager.js';
+import { CompactionConfigSchema } from '../../../../config/runtime.js';
+import { createAssistantMessage, createSystemMessage, createToolMessage, createUserMessage, } from '../../../../types/message/index.js';
+import { runCompactionCheck } from './compaction.js';
+import { WORKING_MEMORY_HEADER, refreshWorkingMemory } from './working-memory.js';
+function makeLogger() {
+    const self = {
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+        child: vi.fn(),
+    };
+    self.child = vi.fn(() => self);
+    return self;
+}
+/** A long string so a handful of messages overflow a small context window. */
+const FILLER = 'x'.repeat(200);
+function buildOverflowingMessages() {
+    const msgs = [createSystemMessage(`STATIC SYSTEM PROMPT ${FILLER}`, 'cache')];
+    for (let i = 0; i < 8; i++) {
+        msgs.push(createUserMessage(`user turn ${i} ${FILLER}`));
+        msgs.push(createAssistantMessage(`assistant turn ${i} ${FILLER}`));
+    }
+    return msgs;
+}
+function makeCtx(opts) {
+    const config = CompactionConfigSchema.parse({
+        strategy: 'structured',
+        llmVerification: false,
+        ...(opts.contextWindowTokens !== undefined
+            ? { contextWindowTokens: opts.contextWindowTokens }
+            : {}),
+    });
+    const manager = new WorkingStateManager(config);
+    // Seed a couple of slots so serializeState produces non-trivial output.
+    manager.addDecision('built the report as .docx');
+    return {
+        runConfig: { tokenBudget: 0 }, // UNLIMITED cumulative cost cap
+        compactionConfig: config,
+        workingStateManager: manager,
+        workingMemoryProvider: opts.workingMemoryProvider,
+        log: makeLogger(),
+        runMgr: {
+            id: 'run_1',
+            currentIteration: 3,
+            messages: opts.messages,
+        },
+    };
+}
+const WM_BLOCK = 'ARTIFACTS\n  • report.docx · Word document · 48.2 KB · imp:H\n       path: /mnt/user-data/outputs/report.docx';
+describe('Layer-B compaction seam (ses_055 #104)', () => {
+    it('FIRES on small contextWindowTokens with tokenBudget=0 AND preserves the pinned WM slot', async () => {
+        const messages = buildOverflowingMessages();
+        const ctx = makeCtx({
+            messages,
+            contextWindowTokens: 100,
+            workingMemoryProvider: () => WM_BLOCK,
+        });
+        await refreshWorkingMemory(ctx);
+        // The slot is pinned as the last leading system message (index 1).
+        expect(messages[1]?.role).toBe('system');
+        expect(messages[1]?.content?.startsWith(WORKING_MEMORY_HEADER)).toBe(true);
+        const before = messages.length;
+        await runCompactionCheck(ctx);
+        // (1) compaction fired: a [COMPACTED CONTEXT] message appeared and the
+        // transcript shrank.
+        expect(messages.length).toBeLessThan(before);
+        expect(messages.some((m) => m.content?.includes('[COMPACTED CONTEXT]'))).toBe(true);
+        // (2) the pinned working-memory slot survived by header identity.
+        const wm = messages.filter((m) => m.role === 'system' && m.content?.startsWith(WORKING_MEMORY_HEADER));
+        expect(wm).toHaveLength(1);
+        expect(wm[0]?.content).toContain('report.docx');
+    });
+    it('does NOT compact when contextWindowTokens is absent and tokenBudget=0 (byte-identical fallback)', async () => {
+        const messages = buildOverflowingMessages();
+        const ctx = makeCtx({ messages });
+        const before = messages.length;
+        await runCompactionCheck(ctx);
+        // budget = tokenBudget = 0 → guard returns; no compaction, no mutation.
+        expect(messages.length).toBe(before);
+        expect(messages.some((m) => m.content?.includes('[COMPACTED CONTEXT]'))).toBe(false);
+    });
+    it('removes the slot when the provider returns an empty block', async () => {
+        const messages = buildOverflowingMessages();
+        const ctx = makeCtx({
+            messages,
+            contextWindowTokens: 100,
+            workingMemoryProvider: () => WM_BLOCK,
+        });
+        await refreshWorkingMemory(ctx);
+        expect(messages.some((m) => m.content?.startsWith(WORKING_MEMORY_HEADER))).toBe(true);
+        // Same transcript, provider now returns blank ⇒ the slot is removed.
+        const blankCtx = makeCtx({
+            messages,
+            contextWindowTokens: 100,
+            workingMemoryProvider: () => '   ',
+        });
+        await refreshWorkingMemory(blankCtx);
+        expect(messages.some((m) => m.content?.startsWith(WORKING_MEMORY_HEADER))).toBe(false);
+    });
+    it('keeps the prior slot when the provider throws (failure-isolated)', async () => {
+        const messages = buildOverflowingMessages();
+        const ctx = makeCtx({
+            messages,
+            contextWindowTokens: 100,
+            workingMemoryProvider: () => WM_BLOCK,
+        });
+        await refreshWorkingMemory(ctx);
+        const throwingCtx = makeCtx({
+            messages,
+            contextWindowTokens: 100,
+            workingMemoryProvider: () => {
+                throw new Error('provider boom');
+            },
+        });
+        await refreshWorkingMemory(throwingCtx);
+        // Prior slot retained; run not broken.
+        expect(messages.some((m) => m.content?.startsWith(WORKING_MEMORY_HEADER))).toBe(true);
+    });
+    it('does NOT orphan a tool_result when the recent-window cut splits a tool pair (C1)', async () => {
+        // keepRecentMessages defaults to 4. Lay the transcript out so the NAIVE
+        // cut (length - 4 = index 5) lands right AFTER the assistant-with-toolCall
+        // (index 4) but BEFORE... no — exactly ON its tool result (index 5), which
+        // a naive slice would keep in the recent window while dropping the
+        // assistant into the summarized older set → an orphaned tool_result at the
+        // head of the recent window → Anthropic 400. The fix snaps keepStart
+        // forward past the complete pair.
+        const toolCall = {
+            id: 't1',
+            type: 'function',
+            function: { name: 'read', arguments: '{}' },
+        };
+        const messages = [
+            createSystemMessage(`STATIC SYSTEM PROMPT ${FILLER}`, 'cache'),
+            createUserMessage(`user 0 ${FILLER}`),
+            createAssistantMessage(`assistant 0 ${FILLER}`),
+            createUserMessage(`user 1 ${FILLER}`),
+            createAssistantMessage(`calling a tool ${FILLER}`, [toolCall]), // idx 4
+            createToolMessage(`tool result ${FILLER}`, 't1'), // idx 5 — naive recent[0]
+            createAssistantMessage(`assistant 2 ${FILLER}`),
+            createUserMessage(`user 3 ${FILLER}`),
+            createAssistantMessage(`assistant 3 ${FILLER}`),
+        ];
+        const ctx = makeCtx({ messages, contextWindowTokens: 100 });
+        await runCompactionCheck(ctx);
+        // Compaction fired.
+        expect(messages.some((m) => m.content?.includes('[COMPACTED CONTEXT]'))).toBe(true);
+        // The surviving transcript has NO dangling tool pair — the tool result
+        // whose assistant was summarized away was moved into the older set too,
+        // so no orphaned tool_result remains to 400 the next provider turn.
+        expect(findDanglingMessages(messages).isValid).toBe(true);
+        // And a `tool` message never leads the recent window.
+        const firstNonSystem = messages.find((m) => m.role !== 'system');
+        expect(firstNonSystem?.role).not.toBe('tool');
+    });
+});
+//# sourceMappingURL=working-memory-compaction.test.js.map