@namzu/sdk 0.1.1

package/dist/runtime/query/iteration/index.js

@@ -0,0 +1,340 @@
+import { SpanStatusCode } from "@opentelemetry/api";
+import { getTracer } from "../../../provider/telemetry/setup.js";
+import { GENAI, NAMZU, agentIterationSpanName, } from "../../../telemetry/attributes.js";
+import { createAssistantMessage, createUserMessage, } from "../../../types/message/index.js";
+import { toErrorMessage } from "../../../utils/error.js";
+import { runIterationCheckpoint } from "./phases/checkpoint.js";
+import { runPlanGate } from "./phases/plan.js";
+import { runToolReview } from "./phases/tool-review.js";
+export class IterationOrchestrator {
+    ctx;
+    constructor(config, sessionMgr, toolExecutor, guard, activityStore, emitEvent, drainPending, abortController, log, resumeHandler, checkpointMgr, planManager) {
+        this.ctx = {
+            provider: config.provider,
+            sessionConfig: config.sessionConfig,
+            tools: config.tools,
+            allowedTools: config.allowedTools,
+            sessionMgr,
+            toolExecutor,
+            guard,
+            activityStore,
+            emitEvent,
+            drainPending,
+            abortController,
+            log,
+            resumeHandler,
+            checkpointMgr,
+            planManager,
+            taskGateway: config.taskGateway,
+            taskStore: config.taskStore,
+            pendingNotifications: [],
+            launchedTasks: config.launchedTasks ?? new Map(),
+        };
+    }
+    async *runLoop() {
+        const { sessionConfig, sessionMgr } = this.ctx;
+        const { model } = sessionConfig;
+        const tracer = getTracer();
+        let unsubscribeTaskListener;
+        if (this.ctx.taskGateway) {
+            unsubscribeTaskListener = this.ctx.taskGateway.onTaskCompleted((handle) => {
+                this.ctx.pendingNotifications.push(handle);
+                this.ctx.log.debug('Task completion queued for notification', {
+                    taskId: handle.taskId,
+                    agentId: handle.agentId,
+                    state: handle.state,
+                });
+            });
+        }
+        try {
+            const planSignal = yield* runPlanGate(this.ctx);
+            if (planSignal === "stop")
+                return;
+            while (true) {
+                const guardResult = this.ctx.guard.beforeIteration(sessionMgr, this.ctx.abortController.signal);
+                if (guardResult.shouldStop) {
+                    if (guardResult.isCancelled) {
+                        this.ctx.log.info('Run cancelled by signal', { runId: sessionMgr.id });
+                        sessionMgr.setStopReason("cancelled");
+                        sessionMgr.markCancelled();
+                        break;
+                    }
+                    this.ctx.log.info('Guard enforcing stop', {
+                        runId: sessionMgr.id,
+                        stopReason: guardResult.stopReason,
+                        iteration: sessionMgr.currentIteration,
+                        inputTokens: sessionMgr.tokenUsage.promptTokens,
+                        outputTokens: sessionMgr.tokenUsage.completionTokens,
+                    });
+                    await this.requestFinalResponse(model, guardResult.stopReason);
+                    yield* this.ctx.drainPending();
+                    sessionMgr.setStopReason(guardResult.stopReason);
+                    break;
+                }
+                const forceFinalize = guardResult.forceFinalize;
+                const iterationNum = sessionMgr.incrementIteration();
+                this.ctx.log.debug('Iteration started', {
+                    runId: sessionMgr.id,
+                    iteration: iterationNum,
+                    model,
+                    forceFinalize,
+                    messageCount: sessionMgr.messages.length,
+                });
+                const iterationActivity = this.ctx.activityStore.create({
+                    type: "llm_turn",
+                    description: `LLM iteration ${iterationNum}`,
+                });
+                if (iterationActivity) {
+                    this.ctx.activityStore.start(iterationActivity.id);
+                }
+                const iterSpan = tracer.startSpan(agentIterationSpanName(iterationNum));
+                iterSpan.setAttributes({
+                    [NAMZU.ITERATION]: iterationNum,
+                    [NAMZU.SESSION_ID]: sessionMgr.id,
+                    [GENAI.REQUEST_MODEL]: model,
+                });
+                await this.ctx.emitEvent({
+                    type: "iteration_started",
+                    runId: sessionMgr.id,
+                    iteration: iterationNum,
+                });
+                yield* this.ctx.drainPending();
+                try {
+                    if (this.ctx.pendingNotifications.length > 0) {
+                        yield* this.injectOneTaskNotification();
+                    }
+                    const openAITools = forceFinalize
+                        ? undefined
+                        : this.ctx.tools.toLLMTools(this.ctx.allowedTools);
+                    const messages = forceFinalize
+                        ? [
+                            ...sessionMgr.messages,
+                            createUserMessage("[SYSTEM] You are approaching your resource limits. Provide your final, comprehensive response now based on everything you have gathered so far. Do not request any more tool calls."),
+                        ]
+                        : sessionMgr.messages;
+                    const response = await this.ctx.provider.chat({
+                        model,
+                        messages,
+                        tools: openAITools && openAITools.length > 0 ? openAITools : undefined,
+                        temperature: sessionConfig.temperature,
+                        maxTokens: sessionConfig.maxResponseTokens,
+                    });
+                    sessionMgr.accumulateUsage(response.usage);
+                    this.ctx.log.debug('LLM response received', {
+                        runId: sessionMgr.id,
+                        iteration: iterationNum,
+                        finishReason: response.finishReason,
+                        hasContent: response.message.content !== null && response.message.content.length > 0,
+                        toolCallCount: response.message.toolCalls?.length ?? 0,
+                        promptTokens: response.usage.promptTokens,
+                        completionTokens: response.usage.completionTokens,
+                        totalTokens: sessionMgr.tokenUsage.totalTokens,
+                        totalCost: sessionMgr.costInfo.totalCost,
+                    });
+                    await this.ctx.emitEvent({
+                        type: "token_usage_updated",
+                        runId: sessionMgr.id,
+                        usage: sessionMgr.tokenUsage,
+                        cost: sessionMgr.costInfo,
+                    });
+                    const assistantMsg = createAssistantMessage(response.message.content, forceFinalize ? undefined : response.message.toolCalls);
+                    sessionMgr.pushMessage(assistantMsg);
+                    await this.ctx.emitEvent({
+                        type: "llm_response",
+                        runId: sessionMgr.id,
+                        content: response.message.content,
+                        hasToolCalls: forceFinalize
+                            ? false
+                            : !!response.message.toolCalls?.length,
+                    });
+                    yield* this.ctx.drainPending();
+                    iterSpan.setAttributes({
+                        [GENAI.USAGE_INPUT_TOKENS]: response.usage.promptTokens,
+                        [GENAI.USAGE_OUTPUT_TOKENS]: response.usage.completionTokens,
+                    });
+                    iterSpan.setStatus({ code: SpanStatusCode.OK });
+                    if (iterationActivity) {
+                        this.ctx.activityStore.complete(iterationActivity.id, {
+                            content: response.message.content,
+                            hasToolCalls: forceFinalize
+                                ? false
+                                : !!response.message.toolCalls?.length,
+                        });
+                    }
+                    if (forceFinalize ||
+                        response.finishReason === "stop" ||
+                        !response.message.toolCalls ||
+                        response.message.toolCalls.length === 0) {
+                        const hasRunningTasks = this.hasRunningAgentTasks();
+                        const hasPendingNotifications = this.ctx.pendingNotifications.length > 0;
+                        if (!forceFinalize && (hasRunningTasks || hasPendingNotifications)) {
+                            this.ctx.log.info('LLM ended turn but agent tasks still running — waiting for notifications', {
+                                runId: sessionMgr.id,
+                                runningTasks: hasRunningTasks,
+                                pendingNotifications: hasPendingNotifications,
+                            });
+                            await this.ctx.emitEvent({
+                                type: "iteration_completed",
+                                runId: sessionMgr.id,
+                                iteration: iterationNum,
+                                hasToolCalls: false,
+                            });
+                            yield* this.ctx.drainPending();
+                            iterSpan.end();
+                            yield* this.waitAndInjectNotifications();
+                            continue;
+                        }
+                        const hasContent = response.message.content !== null &&
+                            response.message.content.length > 0;
+                        if (!hasContent && !forceFinalize) {
+                            this.ctx.log.warn("Empty completion detected — requesting final summary", {
+                                iteration: iterationNum,
+                                finishReason: response.finishReason,
+                            });
+                            await this.requestFinalResponse(model, "end_turn");
+                            yield* this.ctx.drainPending();
+                        }
+                        await this.ctx.emitEvent({
+                            type: "iteration_completed",
+                            runId: sessionMgr.id,
+                            iteration: iterationNum,
+                            hasToolCalls: false,
+                        });
+                        yield* this.ctx.drainPending();
+                        sessionMgr.setStopReason("end_turn");
+                        iterSpan.end();
+                        break;
+                    }
+                    const reviewOutcome = yield* runToolReview(this.ctx, response, iterationNum);
+                    if (reviewOutcome === "stop") {
+                        iterSpan.end();
+                        return;
+                    }
+                    if (reviewOutcome === "rejected") {
+                        iterSpan.end();
+                        continue;
+                    }
+                    const checkpointSignal = yield* runIterationCheckpoint(this.ctx, iterationNum);
+                    if (checkpointSignal === "stop") {
+                        iterSpan.end();
+                        return;
+                    }
+                    await this.ctx.emitEvent({
+                        type: "iteration_completed",
+                        runId: sessionMgr.id,
+                        iteration: iterationNum,
+                        hasToolCalls: true,
+                    });
+                    yield* this.ctx.drainPending();
+                    iterSpan.end();
+                }
+                catch (err) {
+                    if (iterationActivity) {
+                        this.ctx.activityStore.fail(iterationActivity.id, toErrorMessage(err));
+                    }
+                    iterSpan.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: toErrorMessage(err),
+                    });
+                    iterSpan.recordException(err instanceof Error ? err : new Error(String(err)));
+                    iterSpan.end();
+                    throw err;
+                }
+            }
+        }
+        finally {
+            unsubscribeTaskListener?.();
+        }
+    }
+    hasRunningAgentTasks() {
+        if (!this.ctx.taskGateway)
+            return false;
+        return this.ctx.taskGateway.listTasks().some((t) => t.state !== 'completed' && t.state !== 'failed' && t.state !== 'canceled');
+    }
+    async *waitAndInjectNotifications() {
+        const deadline = Date.now() + (this.ctx.sessionConfig.timeoutMs ?? 120_000);
+        while (this.ctx.pendingNotifications.length === 0 &&
+            Date.now() < deadline &&
+            !this.ctx.abortController.signal.aborted) {
+            await new Promise((r) => setTimeout(r, 250));
+        }
+        yield* this.injectOneTaskNotification();
+    }
+    async *injectOneTaskNotification() {
+        if (this.ctx.pendingNotifications.length === 0)
+            return;
+        const handle = this.ctx.pendingNotifications.shift();
+        const meta = this.ctx.launchedTasks.get(handle.taskId);
+        const resultText = handle.result?.result
+            ?? handle.result?.lastError
+            ?? `Task finished with state: ${handle.state}`;
+        if (meta?.planTaskId && this.ctx.taskStore) {
+            const success = handle.state === 'completed';
+            await this.ctx.taskStore.update(meta.planTaskId, {
+                status: 'completed',
+                description: success ? undefined : `Failed: ${resultText.substring(0, 200)}`,
+            });
+        }
+        this.ctx.launchedTasks.delete(handle.taskId);
+        const remainingTasks = this.ctx.launchedTasks.size;
+        const notification = [
+            '<task-notification>',
+            `  <task-id>${handle.taskId}</task-id>`,
+            `  <agent-id>${handle.agentId}</agent-id>`,
+            `  <status>${handle.state}</status>`,
+            `  <description>${meta?.description ?? 'agent task'}</description>`,
+            `  <result>${resultText}</result>`,
+            `  <remaining-tasks>${remainingTasks}</remaining-tasks>`,
+            '</task-notification>',
+        ].join('\n');
+        this.ctx.sessionMgr.pushMessage(createUserMessage(notification));
+        this.ctx.log.info('Task notification injected', {
+            taskId: handle.taskId,
+            agentId: handle.agentId,
+            state: handle.state,
+            planTaskId: meta?.planTaskId,
+            remainingTasks,
+            remainingNotifications: this.ctx.pendingNotifications.length,
+        });
+    }
+    async requestFinalResponse(model, reason) {
+        const lastAssistant = [...this.ctx.sessionMgr.messages]
+            .reverse()
+            .find((m) => m.role === "assistant");
+        const hasResult = lastAssistant?.content !== null &&
+            lastAssistant?.content !== undefined &&
+            lastAssistant.content.length > 0;
+        if (hasResult)
+            return;
+        this.ctx.log.info("Requesting final response before limit enforcement", {
+            reason,
+        });
+        try {
+            const finalMessages = [
+                ...this.ctx.sessionMgr.messages,
+                createUserMessage(`[SYSTEM] Session is ending due to ${reason}. You MUST provide a final response now summarizing all your findings and work so far. Do not use any tools.`),
+            ];
+            const response = await this.ctx.provider.chat({
+                model,
+                messages: finalMessages,
+                temperature: this.ctx.sessionConfig.temperature,
+                maxTokens: this.ctx.sessionConfig.maxResponseTokens,
+            });
+            this.ctx.sessionMgr.accumulateUsage(response.usage);
+            const assistantMsg = createAssistantMessage(response.message.content);
+            this.ctx.sessionMgr.pushMessage(assistantMsg);
+            await this.ctx.emitEvent({
+                type: "llm_response",
+                runId: this.ctx.sessionMgr.id,
+                content: response.message.content,
+                hasToolCalls: false,
+            });
+        }
+        catch (err) {
+            this.ctx.log.error("Failed to get final response", {
+                error: toErrorMessage(err),
+            });
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/query/iteration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/query/iteration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAGjE,OAAO,EACN,KAAK,EACL,KAAK,EACL,sBAAsB,GACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACN,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,iCAAiC,CAAC;AAOzC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAMzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAgBxD,MAAM,OAAO,qBAAqB;IACzB,GAAG,CAAmB;IAE9B,YACC,MAAuB,EACvB,UAA0B,EAC1B,YAA0B,EAC1B,KAAuB,EACvB,aAA4B,EAC5B,SAAoB,EACpB,YAAuC,EACvC,eAAgC,EAChC,GAAW,EACX,aAA4B,EAC5B,aAAgC,EAChC,WAAwB;QAExB,IAAI,CAAC,GAAG,GAAG;YACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU;YACV,YAAY;YACZ,KAAK;YACL,aAAa;YACb,SAAS;YACT,YAAY;YACZ,eAAe;YACf,GAAG;YACH,aAAa;YACb,aAAa;YACb,WAAW;YACX,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,oBAAoB,EAAE,EAAE;YACxB,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI,GAAG,EAAE;SAChD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,OAAO;QACb,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QAC/C,MAAM,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC;QAChC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,IAAI,uBAAiD,CAAC;QACtD,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAC1B,uBAAuB,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,EAAE;gBACzE,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,yCAAyC,EAAE;oBAC7D,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;iBACnB,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACL,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,UAAU,KAAK,MAAM;gBAAE,OAAO;YAElC,OAAO,IAAI,EAAE,CAAC;gBACb,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,CACjD,UAAU,EACV,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAC/B,CAAC;gBAEF,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;oBAC5B,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;wBAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;wBACvE,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;wBACtC,UAAU,CAAC,aAAa,EAAE,CAAC;wBAC3B,MAAM;oBACP,CAAC;oBAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE;wBACzC,KAAK,EAAE,UAAU,CAAC,EAAE;wBACpB,UAAU,EAAE,WAAW,CAAC,UAAU;wBAClC,SAAS,EAAE,UAAU,CAAC,gBAAgB;wBACtC,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,YAAY;wBAC/C,YAAY,EAAE,UAAU,CAAC,UAAU,CAAC,gBAAgB;qBACpD,CAAC,CAAC;oBACH,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,WAAW,CAAC,UAAW,CAAC,CAAC;oBAChE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;oBAC/B,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,UAAW,CAAC,CAAC;oBAClD,MAAM;gBACP,CAAC;gBAED,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,CAAC;gBAChD,MAAM,YAAY,GAAG,UAAU,CAAC,kBAAkB,EAAE,CAAC;gBACrD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE;oBACvC,KAAK,EAAE,UAAU,CAAC,EAAE;oBACpB,SAAS,EAAE,YAAY;oBACvB,KAAK;oBACL,aAAa;oBACb,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM;iBACxC,CAAC,CAAC;gBAEH,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC;oBACvD,IAAI,EAAE,UAAU;oBAChB,WAAW,EAAE,iBAAiB,YAAY,EAAE;iBAC5C,CAAC,CAAC;gBACH,IAAI,iBAAiB,EAAE,CAAC;oBACvB,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;gBACpD,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC;gBACxE,QAAQ,CAAC,aAAa,CAAC;oBACtB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,YAAY;oBAC/B,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,EAAE;oBACjC,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,KAAK;iBAC5B,CAAC,CAAC;gBAEH,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;oBACxB,IAAI,EAAE,mBAAmB;oBACzB,KAAK,EAAE,UAAU,CAAC,EAAE;oBACpB,SAAS,EAAE,YAAY;iBACvB,CAAC,CAAC;gBACH,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;gBAE/B,IAAI,CAAC;oBACJ,IAAI,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC9C,KAAK,CAAC,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC;oBACzC,CAAC;oBAED,MAAM,WAAW,GAAG,aAAa;wBAChC,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;oBAEpD,MAAM,QAAQ,GAAG,aAAa;wBAC7B,CAAC,CAAC;4BACA,GAAG,UAAU,CAAC,QAAQ;4BACtB,iBAAiB,CAChB,qLAAqL,CACrL;yBACD;wBACF,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;oBAEvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;wBAC7C,KAAK;wBACL,QAAQ;wBACR,KAAK,EACJ,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;wBAChE,WAAW,EAAE,aAAa,CAAC,WAAW;wBACtC,SAAS,EAAE,aAAa,CAAC,iBAAiB;qBAC1C,CAAC,CAAC;oBAEH,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBAE3C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE;wBAC3C,KAAK,EAAE,UAAU,CAAC,EAAE;wBACpB,SAAS,EAAE,YAAY;wBACvB,YAAY,EAAE,QAAQ,CAAC,YAAY;wBACnC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;wBACpF,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;wBACtD,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;wBACzC,gBAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,gBAAgB;wBACjD,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,WAAW;wBAC9C,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,SAAS;qBACxC,CAAC,CAAC;oBAEH,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;wBACxB,IAAI,EAAE,qBAAqB;wBAC3B,KAAK,EAAE,UAAU,CAAC,EAAE;wBACpB,KAAK,EAAE,UAAU,CAAC,UAAU;wBAC5B,IAAI,EAAE,UAAU,CAAC,QAAQ;qBACzB,CAAC,CAAC;oBAEH,MAAM,YAAY,GAAG,sBAAsB,CAC1C,QAAQ,CAAC,OAAO,CAAC,OAAO,EACxB,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CACtD,CAAC;oBACF,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;oBAErC,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;wBACxB,IAAI,EAAE,cAAc;wBACpB,KAAK,EAAE,UAAU,CAAC,EAAE;wBACpB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO;wBACjC,YAAY,EAAE,aAAa;4BAC1B,CAAC,CAAC,KAAK;4BACP,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM;qBACvC,CAAC,CAAC;oBAEH,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;oBAE/B,QAAQ,CAAC,aAAa,CAAC;wBACtB,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;wBACvD,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,gBAAgB;qBAC5D,CAAC,CAAC;oBACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;oBAEhD,IAAI,iBAAiB,EAAE,CAAC;wBACvB,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,EAAE;4BACrD,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO;4BACjC,YAAY,EAAE,aAAa;gCAC1B,CAAC,CAAC,KAAK;gCACP,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM;yBACvC,CAAC,CAAC;oBACJ,CAAC;oBAED,IACC,aAAa;wBACb,QAAQ,CAAC,YAAY,KAAK,MAAM;wBAChC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS;wBAC3B,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EACtC,CAAC;wBACF,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;wBACpD,MAAM,uBAAuB,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,CAAC;wBAEzE,IAAI,CAAC,aAAa,IAAI,CAAC,eAAe,IAAI,uBAAuB,CAAC,EAAE,CAAC;4BACpE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,0EAA0E,EAAE;gCAC7F,KAAK,EAAE,UAAU,CAAC,EAAE;gCACpB,YAAY,EAAE,eAAe;gCAC7B,oBAAoB,EAAE,uBAAuB;6BAC7C,CAAC,CAAC;4BAEH,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;gCACxB,IAAI,EAAE,qBAAqB;gCAC3B,KAAK,EAAE,UAAU,CAAC,EAAE;gCACpB,SAAS,EAAE,YAAY;gCACvB,YAAY,EAAE,KAAK;6BACnB,CAAC,CAAC;4BACH,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;4BAC/B,QAAQ,CAAC,GAAG,EAAE,CAAC;4BAEf,KAAK,CAAC,CAAC,IAAI,CAAC,0BAA0B,EAAE,CAAC;4BACzC,SAAS;wBACV,CAAC;wBAED,MAAM,UAAU,GACf,QAAQ,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI;4BACjC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;wBAErC,IAAI,CAAC,UAAU,IAAI,CAAC,aAAa,EAAE,CAAC;4BACnC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAChB,sDAAsD,EACtD;gCACC,SAAS,EAAE,YAAY;gCACvB,YAAY,EAAE,QAAQ,CAAC,YAAY;6BACnC,CACD,CAAC;4BACF,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;4BACnD,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;wBAChC,CAAC;wBAED,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;4BACxB,IAAI,EAAE,qBAAqB;4BAC3B,KAAK,EAAE,UAAU,CAAC,EAAE;4BACpB,SAAS,EAAE,YAAY;4BACvB,YAAY,EAAE,KAAK;yBACnB,CAAC,CAAC;wBACH,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;wBAC/B,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;wBACrC,QAAQ,CAAC,GAAG,EAAE,CAAC;wBACf,MAAM;oBACP,CAAC;oBAED,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,aAAa,CACzC,IAAI,CAAC,GAAG,EACR,QAAQ,EACR,YAAY,CACZ,CAAC;oBAEF,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;wBAC9B,QAAQ,CAAC,GAAG,EAAE,CAAC;wBACf,OAAO;oBACR,CAAC;oBAED,IAAI,aAAa,KAAK,UAAU,EAAE,CAAC;wBAClC,QAAQ,CAAC,GAAG,EAAE,CAAC;wBACf,SAAS;oBACV,CAAC;oBAED,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,sBAAsB,CACrD,IAAI,CAAC,GAAG,EACR,YAAY,CACZ,CAAC;oBACF,IAAI,gBAAgB,KAAK,MAAM,EAAE,CAAC;wBACjC,QAAQ,CAAC,GAAG,EAAE,CAAC;wBACf,OAAO;oBACR,CAAC;oBAED,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;wBACxB,IAAI,EAAE,qBAAqB;wBAC3B,KAAK,EAAE,UAAU,CAAC,EAAE;wBACpB,SAAS,EAAE,YAAY;wBACvB,YAAY,EAAE,IAAI;qBAClB,CAAC,CAAC;oBACH,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;oBAC/B,QAAQ,CAAC,GAAG,EAAE,CAAC;gBAChB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,IAAI,iBAAiB,EAAE,CAAC;wBACvB,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;oBACxE,CAAC;oBAED,QAAQ,CAAC,SAAS,CAAC;wBAClB,IAAI,EAAE,cAAc,CAAC,KAAK;wBAC1B,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC;qBAC5B,CAAC,CAAC;oBACH,QAAQ,CAAC,eAAe,CACvB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CACnD,CAAC;oBACF,QAAQ,CAAC,GAAG,EAAE,CAAC;oBACf,MAAM,GAAG,CAAC;gBACX,CAAC;YACF,CAAC;QAED,CAAC;gBAAS,CAAC;YACV,uBAAuB,EAAE,EAAE,CAAC;QAC7B,CAAC;IACF,CAAC;IAEO,oBAAoB;QAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,UAAU,CAChF,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,CAAC,0BAA0B;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC;QAC5E,OACC,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,KAAK,CAAC;YAC1C,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ;YACrB,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,EACvC,CAAC;YACF,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,CAAC,yBAAyB;QACvC,IAAI,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEvD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,KAAK,EAAG,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM;eACpC,MAAM,CAAC,MAAM,EAAE,SAAS;eACxB,6BAA6B,MAAM,CAAC,KAAK,EAAE,CAAC;QAEhD,IAAI,IAAI,EAAE,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,KAAK,WAAW,CAAC;YAC7C,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,UAA8B,EAAE;gBACpE,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;aAC5E,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC;QAEnD,MAAM,YAAY,GAAG;YACpB,qBAAqB;YACrB,cAAc,MAAM,CAAC,MAAM,YAAY;YACvC,eAAe,MAAM,CAAC,OAAO,aAAa;YAC1C,aAAa,MAAM,CAAC,KAAK,WAAW;YACpC,kBAAkB,IAAI,EAAE,WAAW,IAAI,YAAY,gBAAgB;YACnE,aAAa,UAAU,WAAW;YAClC,sBAAsB,cAAc,oBAAoB;YACxD,sBAAsB;SACtB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;QAEjE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE;YAC/C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,IAAI,EAAE,UAAU;YAC5B,cAAc;YACd,sBAAsB,EAAE,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM;SAC5D,CAAC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,oBAAoB,CACjC,KAAa,EACb,MAAkB;QAElB,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;aACrD,OAAO,EAAE;aACT,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QAEtC,MAAM,SAAS,GACd,aAAa,EAAE,OAAO,KAAK,IAAI;YAC/B,aAAa,EAAE,OAAO,KAAK,SAAS;YACpC,aAAa,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAElC,IAAI,SAAS;YAAE,OAAO;QAEtB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,oDAAoD,EAAE;YACvE,MAAM;SACN,CAAC,CAAC;QAEH,IAAI,CAAC;YACJ,MAAM,aAAa,GAAG;gBACrB,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ;gBAC/B,iBAAiB,CAChB,qCAAqC,MAAM,8GAA8G,CACzJ;aACD,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAC7C,KAAK;gBACL,QAAQ,EAAE,aAAa;gBACvB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,WAAW;gBAC/C,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,iBAAiB;aACnD,CAAC,CAAC;YAEH,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEpD,MAAM,YAAY,GAAG,sBAAsB,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACtE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAE9C,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;gBACxB,IAAI,EAAE,cAAc;gBACpB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;gBAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO;gBACjC,YAAY,EAAE,KAAK;aACnB,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,8BAA8B,EAAE;gBAClD,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC;aAC1B,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;CACD"}

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

@@ -0,0 +1,4 @@
+import type { RunEvent } from "../../../../types/run/index.js";
+import type { IterationContext, PhaseSignal } from "./context.js";
+export declare function runIterationCheckpoint(ctx: IterationContext, iterationNum: number): AsyncGenerator<RunEvent, PhaseSignal>;
+//# sourceMappingURL=checkpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGlE,wBAAuB,sBAAsB,CAC5C,GAAG,EAAE,gBAAgB,EACrB,YAAY,EAAE,MAAM,GAClB,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CA4BvC"}

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

@@ -0,0 +1,21 @@
+import { CheckpointManager } from "../../checkpoint.js";
+import { handleHITLDecision } from "./context.js";
+export async function* runIterationCheckpoint(ctx, iterationNum) {
+    const iterCheckpoint = await ctx.checkpointMgr.create(ctx.sessionMgr, iterationNum);
+    await ctx.emitEvent({
+        type: "checkpoint_created",
+        runId: ctx.sessionMgr.id,
+        checkpointId: iterCheckpoint.id,
+        iteration: iterationNum,
+    });
+    yield* ctx.drainPending();
+    const summary = CheckpointManager.buildSummary(ctx.sessionMgr, iterationNum);
+    const iterDecision = await ctx.resumeHandler({
+        type: "iteration_checkpoint",
+        runId: ctx.sessionMgr.id,
+        checkpointId: iterCheckpoint.id,
+        summary,
+    });
+    return yield* handleHITLDecision(ctx, iterDecision, iterCheckpoint.id, "iteration_checkpoint");
+}
+//# sourceMappingURL=checkpoint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/checkpoint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,sBAAsB,CAC5C,GAAqB,EACrB,YAAoB;IAEpB,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,MAAM,CACpD,GAAG,CAAC,UAAU,EACd,YAAY,CACZ,CAAC;IAEF,MAAM,GAAG,CAAC,SAAS,CAAC;QACnB,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;QACxB,YAAY,EAAE,cAAc,CAAC,EAAE;QAC/B,SAAS,EAAE,YAAY;KACvB,CAAC,CAAC;IACH,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;IAE1B,MAAM,OAAO,GAAG,iBAAiB,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC7E,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC;QAC5C,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;QACxB,YAAY,EAAE,cAAc,CAAC,EAAE;QAC/B,OAAO;KACP,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,CAAC,kBAAkB,CAC/B,GAAG,EACH,YAAY,EACZ,cAAc,CAAC,EAAE,EACjB,sBAAsB,CACtB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { PlanManager } from "../../../../manager/plan/lifecycle.js";
+import type { RunPersistence } from "../../../../manager/run/persistence.js";
+import type { ToolRegistry } from "../../../../registry/tool/execute.js";
+import type { ActivityStore } from "../../../../store/activity/memory.js";
+import type { TaskGateway, TaskHandle } from "../../../../types/agent/gateway.js";
+import type { HITLResumeDecision, ResumeHandler } from "../../../../types/hitl/index.js";
+import type { TaskId } from "../../../../types/ids/index.js";
+import type { TaskStore } from "../../../../types/task/index.js";
+import type { LLMProvider } from "../../../../types/provider/index.js";
+import type { AgentRunConfig, RunEvent } from "../../../../types/run/index.js";
+import type { Logger } from "../../../../utils/logger.js";
+import type { CheckpointManager } from "../../checkpoint.js";
+import type { EmitEvent } from "../../events.js";
+import type { ToolExecutor } from "../../executor.js";
+import type { GuardCoordinator } from "../../guard.js";
+export interface LaunchedTaskMeta {
+    readonly agentId: string;
+    readonly description: string;
+    readonly planTaskId?: string;
+}
+export interface IterationContext {
+    readonly provider: LLMProvider;
+    readonly sessionConfig: AgentRunConfig;
+    readonly tools: ToolRegistry;
+    readonly allowedTools?: string[];
+    readonly sessionMgr: RunPersistence;
+    readonly toolExecutor: ToolExecutor;
+    readonly guard: GuardCoordinator;
+    readonly activityStore: ActivityStore;
+    readonly emitEvent: EmitEvent;
+    readonly drainPending: () => Generator<RunEvent>;
+    readonly abortController: AbortController;
+    readonly log: Logger;
+    readonly resumeHandler: ResumeHandler;
+    readonly checkpointMgr: CheckpointManager;
+    readonly planManager: PlanManager;
+    readonly taskGateway?: TaskGateway;
+    readonly taskStore?: TaskStore;
+    readonly pendingNotifications: TaskHandle[];
+    readonly launchedTasks: Map<TaskId, LaunchedTaskMeta>;
+}
+export type PhaseSignal = "continue" | "stop";
+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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,KAAK,EACX,kBAAkB,EAClB,aAAa,EACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,EACX,cAAc,EACd,QAAQ,EAER,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAEnC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAE/B,QAAQ,CAAC,oBAAoB,EAAE,UAAU,EAAE,CAAC;IAE5C,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9C,wBAAuB,kBAAkB,CACxC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,kBAAkB,EAC5B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACb,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAsDvC"}

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

@@ -0,0 +1,54 @@
+export async function* handleHITLDecision(ctx, decision, checkpointId, context) {
+    switch (decision.action) {
+        case "pause": {
+            await ctx.emitEvent({
+                type: "run_paused",
+                runId: ctx.sessionMgr.id,
+                checkpointId: checkpointId,
+                reason: decision.reason,
+            });
+            yield* ctx.drainPending();
+            ctx.sessionMgr.setStopReason("paused");
+            ctx.log.info(`Session paused at ${context}`, {
+                sessionId: ctx.sessionMgr.id,
+                reason: decision.reason,
+            });
+            return "stop";
+        }
+        case "abort": {
+            ctx.sessionMgr.setStopReason("cancelled");
+            ctx.sessionMgr.markCancelled();
+            ctx.log.info(`Session aborted at ${context}`, {
+                sessionId: ctx.sessionMgr.id,
+                reason: decision.reason,
+            });
+            return "stop";
+        }
+        case "reject_plan": {
+            ctx.sessionMgr.setStopReason("plan_rejected");
+            ctx.log.info("Plan rejected by user", {
+                sessionId: ctx.sessionMgr.id,
+                feedback: decision.feedback,
+            });
+            return "stop";
+        }
+        case "approve_plan": {
+            if (ctx.planManager.active) {
+                ctx.planManager.approve();
+                ctx.planManager.startExecution();
+            }
+            ctx.log.info("Plan approved by user", { sessionId: ctx.sessionMgr.id });
+            return "continue";
+        }
+        case "continue":
+        case "approve_tools":
+        case "modify_tools":
+        case "reject_tools":
+            return "continue";
+        default: {
+            const _exhaustive = decision;
+            throw new Error(`Unhandled HITL decision: ${_exhaustive.action}`);
+        }
+    }
+}
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/context.ts"],"names":[],"mappings":"AAyDA,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,UAAU,CAAC,EAAE;gBACxB,YAAY,EAAE,YAA8B;gBAC5C,MAAM,EAAE,QAAQ,CAAC,MAAM;aACvB,CAAC,CAAC;YACH,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC1B,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YACvC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,EAAE;gBAC5C,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;gBAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM;aACvB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QACf,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACd,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;YAC1C,GAAG,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;YAC/B,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,OAAO,EAAE,EAAE;gBAC7C,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;gBAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM;aACvB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QACf,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACpB,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;YAC9C,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE;gBACrC,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;gBAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC3B,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QACf,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACrB,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBAC5B,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBAC1B,GAAG,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;YAClC,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;YACxE,OAAO,UAAU,CAAC;QACnB,CAAC;QACD,KAAK,UAAU,CAAC;QAChB,KAAK,eAAe,CAAC;QACrB,KAAK,cAAc,CAAC;QACpB,KAAK,cAAc;YAClB,OAAO,UAAU,CAAC;QACnB,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,QAAQ,CAAC;YACpC,MAAM,IAAI,KAAK,CACd,4BAA6B,WAAkC,CAAC,MAAM,EAAE,CACxE,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,7 @@
+export type { IterationContext, PhaseSignal } from "./context.js";
+export { handleHITLDecision } from "./context.js";
+export { runPlanGate } from "./plan.js";
+export { runToolReview } from "./tool-review.js";
+export type { ToolReviewOutcome } from "./tool-review.js";
+export { runIterationCheckpoint } from "./checkpoint.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,5 @@
+export { handleHITLDecision } from "./context.js";
+export { runPlanGate } from "./plan.js";
+export { runToolReview } from "./tool-review.js";
+export { runIterationCheckpoint } from "./checkpoint.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { RunEvent } from "../../../../types/run/index.js";
+import type { IterationContext, PhaseSignal } from "./context.js";
+export declare function runPlanGate(ctx: IterationContext): AsyncGenerator<RunEvent, PhaseSignal>;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +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,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGlE,wBAAuB,WAAW,CACjC,GAAG,EAAE,gBAAgB,GACnB,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAwCvC"}

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

@@ -0,0 +1,34 @@
+import { handleHITLDecision } from "./context.js";
+export async function* runPlanGate(ctx) {
+    if (!ctx.planManager.active || ctx.planManager.active.status !== "ready") {
+        return "continue";
+    }
+    const planCheckpoint = await ctx.checkpointMgr.create(ctx.sessionMgr, 0);
+    await ctx.emitEvent({
+        type: "checkpoint_created",
+        runId: ctx.sessionMgr.id,
+        checkpointId: planCheckpoint.id,
+        iteration: 0,
+    });
+    yield* ctx.drainPending();
+    const plan = ctx.planManager.active;
+    const planDecision = await ctx.resumeHandler({
+        type: "plan_approval",
+        runId: ctx.sessionMgr.id,
+        checkpointId: planCheckpoint.id,
+        plan: {
+            planId: plan.id,
+            title: plan.title,
+            steps: plan.steps.map((s) => ({
+                id: s.id,
+                description: s.description,
+                toolName: s.toolName,
+                dependsOn: s.dependsOn,
+                order: s.order,
+            })),
+            summary: plan.summary,
+        },
+    });
+    return yield* handleHITLDecision(ctx, planDecision, planCheckpoint.id, "plan_gate");
+}
+//# sourceMappingURL=plan.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../../../src/runtime/query/iteration/phases/plan.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CACjC,GAAqB;IAErB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC1E,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAEzE,MAAM,GAAG,CAAC,SAAS,CAAC;QACnB,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;QACxB,YAAY,EAAE,cAAc,CAAC,EAAE;QAC/B,SAAS,EAAE,CAAC;KACZ,CAAC,CAAC;IACH,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;IAE1B,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC;IACpC,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC;QAC5C,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;QACxB,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,CAAC;IAEH,OAAO,KAAK,CAAC,CAAC,kBAAkB,CAC/B,GAAG,EACH,YAAY,EACZ,cAAc,CAAC,EAAE,EACjB,WAAW,CACX,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { ChatCompletionResponse } from "../../../../types/provider/index.js";
+import type { RunEvent } from "../../../../types/run/index.js";
+import type { IterationContext } from "./context.js";
+export type ToolReviewOutcome = "executed" | "rejected" | "stop";
+export declare function runToolReview(ctx: IterationContext, response: ChatCompletionResponse, iterationNum: number): AsyncGenerator<RunEvent, ToolReviewOutcome>;
+//# sourceMappingURL=tool-review.d.ts.map

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

@@ -0,0 +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,CAAC;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjE,wBAAuB,aAAa,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,sBAAsB,EAChC,YAAY,EAAE,MAAM,GAClB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAqK7C"}