@vibes.diy/api-svc 14.0.20 → 14.0.22

package/intern/agent-session.js

@@ -0,0 +1,180 @@
+import { Result, exception2Result } from "@adviser/cement";
+import { LLMMessage } from "@vibes.diy/call-ai-v2";
+import { type } from "arktype";
+import { agentFileChange } from "@vibes.diy/api-types";
+const sessionInput = type({ id: "string", messages: LLMMessage.array() });
+const sessionHandle = type({
+    id: "string",
+    state: "'queued' | 'dispatching' | 'running' | 'settled'",
+    "promptId?": "string",
+    "input?": "unknown",
+    "result?": "string",
+    "deadlineAt?": "number",
+    "kind?": "'commit'",
+    "resultHandleId?": "string",
+});
+export const agentSessionSnapshot = type({
+    version: "1",
+    status: "'running' | 'idle'",
+    messages: LLMMessage.array(),
+    inbox: sessionInput.array(),
+    handles: sessionHandle.array(),
+    acceptedIds: "string[]",
+    "draft?": agentFileChange.array(),
+    "activePromptId?": "string",
+});
+export const AGENT_SESSION_IDLE = "agent-session-idle";
+export function createAgentSession(args) {
+    let state = args.snapshot ?? {
+        version: 1,
+        status: "running",
+        messages: [],
+        inbox: [],
+        handles: [],
+        acceptedIds: [],
+    };
+    let serial = Promise.resolve(Result.Ok());
+    let notify;
+    let stopped = false;
+    let accepting = true;
+    let failure;
+    let takenInputs = new Set();
+    let takenHandles = new Set();
+    function update(change, admit) {
+        const operation = serial.then(async () => {
+            if (failure !== undefined)
+                return Result.Err(failure);
+            if (admit !== undefined && admit() === false)
+                return Result.Err(AGENT_SESSION_IDLE);
+            const next = change(state);
+            const saved = await exception2Result(() => args.save(next));
+            if (saved.isErr())
+                return Result.Err(saved.Err());
+            state = next;
+            notify?.();
+            return Result.Ok();
+        });
+        serial = operation;
+        return operation;
+    }
+    return {
+        messages: () => [...state.messages],
+        snapshot: () => structuredClone(state),
+        takenResults: () => structuredClone(state.handles.filter((handle) => takenHandles.has(handle.id))),
+        stage(change) {
+            return update((previous) => ({
+                ...previous,
+                draft: [...(previous.draft ?? []).filter((file) => file.path !== change.path), change],
+            }));
+        },
+        queueDraft(id) {
+            return update((previous) => ({
+                ...previous,
+                draft: [],
+                handles: [...previous.handles, { id, kind: "commit", state: "queued", input: { changes: previous.draft ?? [] } }],
+            }));
+        },
+        deliver(input) {
+            return update((previous) => previous.acceptedIds.includes(input.id)
+                ? previous
+                : {
+                    ...previous,
+                    status: "running",
+                    inbox: [...previous.inbox, input],
+                    acceptedIds: [...previous.acceptedIds, input.id],
+                }, () => accepting && stopped === false);
+        },
+        register(handle) {
+            return update((previous) => ({
+                ...previous,
+                status: "running",
+                handles: [...previous.handles.filter((entry) => entry.id !== handle.id), handle],
+            }));
+        },
+        settle(id, result, resultHandleId) {
+            return update((previous) => ({
+                ...previous,
+                handles: previous.handles.map((handle) => handle.id === id
+                    ? { ...handle, state: "settled", result, ...(resultHandleId === undefined ? {} : { resultHandleId }) }
+                    : handle),
+            }));
+        },
+        async checkpoint(messages) {
+            const inputs = takenInputs;
+            const handles = takenHandles;
+            const saved = await update((previous) => ({
+                ...previous,
+                messages: [...messages],
+                inbox: previous.inbox.filter((input) => inputs.has(input.id) === false),
+                handles: previous.handles.filter((handle) => handles.has(handle.id) === false),
+            }));
+            if (saved.isOk()) {
+                takenInputs = new Set();
+                takenHandles = new Set();
+            }
+            return saved;
+        },
+        async next() {
+            while (stopped === false) {
+                let wake;
+                const changed = new Promise((resolve) => {
+                    wake = resolve;
+                });
+                notify = wake;
+                const saved = await serial;
+                if (failure !== undefined)
+                    return Result.Err(failure);
+                if (saved.isErr())
+                    return Result.Err(saved.Err());
+                const ready = state.handles.filter((handle) => handle.state === "settled");
+                if (state.inbox.length > 0 || ready.length > 0) {
+                    takenInputs = new Set(state.inbox.map((input) => input.id));
+                    takenHandles = new Set(ready.map((handle) => handle.id));
+                    notify = undefined;
+                    return Result.Ok([
+                        ...state.inbox.flatMap((input) => input.messages),
+                        ...ready.map((handle) => ({
+                            role: "user",
+                            content: [{ type: "text", text: handle.result ?? "[tool result] No result was recorded." }],
+                        })),
+                    ]);
+                }
+                if (state.handles.length > 0) {
+                    await changed;
+                    continue;
+                }
+                let timer;
+                const idle = new Promise((resolve) => {
+                    timer = setTimeout(() => resolve("idle"), args.idleMs);
+                });
+                const winner = await Promise.race([changed, idle]);
+                if (timer !== undefined)
+                    clearTimeout(timer);
+                if (winner !== "idle")
+                    continue;
+                const result = await update((previous) => {
+                    if (previous.inbox.length > 0 || previous.handles.length > 0)
+                        return previous;
+                    accepting = false;
+                    return { ...previous, status: "idle" };
+                });
+                if (result.isErr())
+                    return Result.Err(result.Err());
+                if (state.status === "idle")
+                    return Result.Ok(undefined);
+            }
+            return failure === undefined ? Result.Ok(undefined) : Result.Err(failure);
+        },
+        fail(error) {
+            failure = error;
+            stopped = true;
+            accepting = false;
+            notify?.();
+        },
+        stop() {
+            stopped = true;
+            notify?.();
+        },
+    };
+}
+//# sourceMappingURL=agent-session.js.map

package/intern/agent-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.js","sourceRoot":"","sources":["../../jsr/intern/agent-session.ts"],"names":[],"mappings":"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"}

package/intern/agent-turn.d.ts

@@ -3,11 +3,13 @@ import type { LLMRequest, SseStreamMsg } from "@vibes.diy/call-ai-v2";
 import { VibesApiSQLCtx } from "../types.js";
 import type { AgentActor } from "./agent-actor.js";
 import { type AgentBelt, type AgentBeltArgs } from "./agent-belt.js";
-import { type LlmToolLoopBudget } from "./llm-tool-loop.js";
+import { createLlmToolLoopStream, type LlmToolLoopBudget, type LlmToolLoopPending } from "./llm-tool-loop.js";
 export declare const AGENT_TOTAL_BUDGET_MS = 900000;
 export declare function agentTotalBudgetMs(vctx: VibesApiSQLCtx): number;
 export declare const AGENT_MAX_TOOL_ROUNDS = 6;
 export declare const AGENT_MAX_TOOL_CALLS = 16;
+export declare const AGENT_SESSION_MAX_TOOL_ROUNDS = 32;
+export declare const AGENT_SESSION_MAX_TOOL_CALLS = 96;
 export declare const AGENT_MAX_PROVIDER_ATTEMPTS: number;
 export interface AgentTurnDispatch {
     readonly chatId: string;
@@ -33,6 +35,9 @@ export interface AgentTurnStreamArgs {
         readonly abort?: AbortController;
     }>>;
     readonly onDispatch?: (dispatched: AgentTurnDispatch) => void;
+    readonly pending?: LlmToolLoopPending;
+    readonly session?: Parameters<typeof createLlmToolLoopStream>[0]["session"];
+    readonly onToolEvidence?: Parameters<typeof createLlmToolLoopStream>[0]["onToolEvidence"];
     readonly onError?: (error: string) => void;
     readonly now?: () => number;
 }

package/intern/agent-turn.js

@@ -1,6 +1,6 @@
 import { Result } from "@adviser/cement";
 import { createAgentBelt } from "./agent-belt.js";
-import { createLlmToolLoopBudget, createLlmToolLoopStream } from "./llm-tool-loop.js";
+import { createLlmToolLoopBudget, createLlmToolLoopStream, } from "./llm-tool-loop.js";
 import { AGENT_TURN_CEILING_MS } from "./codegen-build-lock.js";
 export const AGENT_TOTAL_BUDGET_MS = AGENT_TURN_CEILING_MS;
 export function agentTotalBudgetMs(vctx) {
@@ -14,6 +14,8 @@ export function agentTotalBudgetMs(vctx) {
 }
 export const AGENT_MAX_TOOL_ROUNDS = 6;
 export const AGENT_MAX_TOOL_CALLS = 16;
+export const AGENT_SESSION_MAX_TOOL_ROUNDS = 32;
+export const AGENT_SESSION_MAX_TOOL_CALLS = 96;
 export const AGENT_MAX_PROVIDER_ATTEMPTS = AGENT_MAX_TOOL_ROUNDS + 1;
 export function createAgentTurnStream(args) {
     const belt = args.belt ??
@@ -27,7 +29,7 @@ export function createAgentTurnStream(args) {
         });
     const budget = createLlmToolLoopBudget({
         totalBudgetMs: agentTotalBudgetMs(args.vctx),
-        maxAttempts: AGENT_MAX_PROVIDER_ATTEMPTS,
+        maxAttempts: args.session === undefined ? AGENT_MAX_PROVIDER_ATTEMPTS : AGENT_SESSION_MAX_TOOL_ROUNDS + 1,
         ...(args.now === undefined ? {} : { now: args.now }),
     });
     budget.attemptsUsed = 1;
@@ -37,8 +39,11 @@ export function createAgentTurnStream(args) {
         abort: args.abort,
         budget,
         execute: belt.executor,
-        maxToolRounds: AGENT_MAX_TOOL_ROUNDS,
-        maxToolCalls: AGENT_MAX_TOOL_CALLS,
+        ...(args.onToolEvidence === undefined ? {} : { onToolEvidence: args.onToolEvidence }),
+        maxToolRounds: args.session === undefined ? AGENT_MAX_TOOL_ROUNDS : AGENT_SESSION_MAX_TOOL_ROUNDS,
+        maxToolCalls: args.session === undefined ? AGENT_MAX_TOOL_CALLS : AGENT_SESSION_MAX_TOOL_CALLS,
+        ...(args.pending === undefined ? {} : { pending: args.pending }),
+        ...(args.session === undefined ? {} : { session: args.session }),
         dispatch: async (input) => {
             const r = await args.dispatch({ request: input.request, budget: input.budget });
             if (r.isErr())

package/intern/agent-turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-turn.js","sourceRoot":"","sources":["../../jsr/intern/agent-turn.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-turn.js","sourceRoot":"","sources":["../../jsr/intern/agent-turn.ts"],"names":[],"mappings":"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"}

package/intern/agent-wake.d.ts

@@ -1,6 +1,7 @@
 import type { DashAuthType } from "@vibes.diy/identity";
+import type { MsgBase, ReqPromptChatSection } from "@vibes.diy/api-types";
 import { VibesApiSQLCtx } from "../types.js";
-import type { AgentDispatchHandle, AgentDispatchHostCtx } from "./agent-dispatcher.js";
+import type { AgentDispatchHostCtx } from "./agent-dispatcher.js";
 export declare const AGENT_WAKE_MAX_BUDGET = 1;
 export type AgentWakeSkip = "flag-off" | "not-agent-dispatched" | "not-a-build" | "budget-spent";
 export type AgentWakeDecision = {
@@ -22,15 +23,19 @@ export interface AgentWakeOutcome {
     readonly outcome: "applied" | "no-code" | "error";
     readonly touchedPaths?: readonly string[];
 }
-export declare function renderAgentWakeNote(outcome: AgentWakeOutcome): string;
-export interface FireAgentWakeArgs {
+export declare function renderBuildSettledSentence(outcome: AgentWakeOutcome): string;
+export declare function renderAgentWakeNote(outcome: AgentWakeOutcome, session?: boolean): string;
+export interface FireAgentWakeArgs<Host extends AgentDispatchHostCtx> {
     readonly vctx: VibesApiSQLCtx;
-    readonly host: AgentDispatchHostCtx;
+    readonly host: Host;
     readonly auth: DashAuthType;
     readonly outerTid: string;
     readonly chatId: string;
     readonly note: string;
     readonly budget: number;
-    readonly handle: AgentDispatchHandle;
+    readonly handle: (ctx: Omit<Host, "validated" | "enRequest"> & {
+        readonly validated: MsgBase<ReqPromptChatSection>;
+        readonly enRequest: MsgBase<ReqPromptChatSection>;
+    }) => Promise<unknown>;
 }
-export declare function fireAgentWakeTurn(args: FireAgentWakeArgs): void;
+export declare function fireAgentWakeTurn<Host extends AgentDispatchHostCtx>(args: FireAgentWakeArgs<Host>): void;

package/intern/agent-wake.js

@@ -17,16 +17,20 @@ export function readAgentWakeBudget(raw) {
         return AGENT_WAKE_MAX_BUDGET;
     return Math.max(0, Math.min(AGENT_WAKE_MAX_BUDGET, Math.floor(raw)));
 }
-export function renderAgentWakeNote(outcome) {
+export function renderBuildSettledSentence(outcome) {
     const touched = outcome.touchedPaths ?? [];
-    const settled = outcome.outcome === "error"
-        ? "The build you dispatched did not finish — it failed."
-        : outcome.outcome === "no-code"
-            ? "The build you dispatched finished and made no changes to the app."
-            : `The build you dispatched finished and its changes are saved${touched.length === 0 ? "" : ` (${touched.join(", ")})`}.`;
+    if (outcome.outcome === "error")
+        return "The build you dispatched did not finish — it failed.";
+    if (outcome.outcome === "no-code")
+        return "The build you dispatched finished and made no changes to the app.";
+    return `The build you dispatched finished and its changes are saved${touched.length === 0 ? "" : ` (${touched.join(", ")})`}.`;
+}
+export function renderAgentWakeNote(outcome, session = false) {
+    if (session === true)
+        return `[build result] ${renderBuildSettledSentence(outcome)} Continue from this result in the same conversation.`;
     return [
         "<build-finished>",
-        settled,
+        renderBuildSettledSentence(outcome),
         "The app is free for another change now.",
         "",
         "This is the platform telling you, not the person: they have not said anything new, so do not answer them",

package/intern/agent-wake.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-wake.js","sourceRoot":"","sources":["../../jsr/intern/agent-wake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA0DnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AA+CvC,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACxE,IAAI,KAAK,CAAC,eAAe,KAAK,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;IAC1F,IAAI,KAAK,CAAC,eAAe,KAAK,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IACjF,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IACpE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;AAClD,CAAC;AAYD,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,KAAK;QAAE,OAAO,qBAAqB,CAAC;IAC5F,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAyCD,MAAM,UAAU,mBAAmB,CAAC,OAAyB;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;IAC3C,MAAM,OAAO,GACX,OAAO,CAAC,OAAO,KAAK,OAAO;QACzB,CAAC,CAAC,sDAAsD;QACxD,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;YAC7B,CAAC,CAAC,mEAAmE;YACrE,CAAC,CAAC,8DAA8D,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IAChI,OAAO;QACL,kBAAkB;QAClB,OAAO;QACP,yCAAyC;QACzC,EAAE;QACF,0GAA0G;QAC1G,sGAAsG;QACtG,4BAA4B;QAC5B,EAAE;QACF,4GAA4G;QAC5G,iFAAiF;QACjF,EAAE;QACF,2GAA2G;QAC3G,8GAA8G;QAC9G,6GAA6G;QAC7G,2GAA2G;QAC3G,oBAAoB;QACpB,mBAAmB;KACpB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAgCD,MAAM,UAAU,iBAAiB,CAAC,IAAuB;IACvD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1E,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,mCAAmC;QACzC,IAAI,EAAE,SAAS;QACf,IAAI;QACJ,MAAM;QACN,QAAQ;QAGR,SAAS,EAAE,IAAI;QACf,eAAe,EAAE,MAAM;QACvB,aAAa,EAAE,IAAI;QAInB,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;KACU,CAAC;IACrC,MAAM,GAAG,GAAkC;QACzC,GAAG,IAAI,CAAC,SAAS;QACjB,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG;QAC9B,OAAO;KACR,CAAC;IAEF,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACjG,IAAI,CAAC,CAAC,KAAK,EAAE;YAAE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtF,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IASH,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"agent-wake.js","sourceRoot":"","sources":["../../jsr/intern/agent-wake.ts"],"names":[],"mappings":"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"}

package/intern/llm-tool-loop.d.ts

@@ -1,10 +1,11 @@
 import { Result } from "@adviser/cement";
-import { type LLMRequest, type SseStreamMsg } from "@vibes.diy/call-ai-v2";
+import { type LLMMessage, type LLMRequest, type SseStreamMsg } from "@vibes.diy/call-ai-v2";
 export declare const MAX_TOOL_RESULT_CHARS = 8192;
 export declare const MAX_TOOL_CALL_ID_CHARS = 256;
 export declare const MAX_TOOL_CALL_NAME_CHARS = 256;
 export declare const MAX_TOOL_CALL_ARGUMENT_CHARS: number;
 export declare const MAX_PROVIDER_CHUNK_ERRORS = 3;
+export declare const LANDING_ROUND_RESERVE_MS = 5000;
 export type LlmToolCallField = "id" | "name" | "arguments";
 export declare class LlmToolLoopError extends Error {
     readonly field: LlmToolCallField;
@@ -54,6 +55,11 @@ export interface LlmToolLoopDispatchInput {
     readonly round: number;
 }
 export interface LlmToolLoopArgs {
+    readonly session?: {
+        checkpoint(messages: readonly LLMMessage[]): Promise<Result<void>>;
+        next(): Promise<Result<LLMMessage[] | undefined>>;
+        readonly dispatchBudgetMs: number;
+    };
     readonly request: LLMRequest;
     readonly stream: ReadableStream<SseStreamMsg>;
     readonly abort?: AbortController;
@@ -70,10 +76,25 @@ export interface LlmToolLoopArgs {
         readonly round: number;
         readonly calls: readonly LlmToolCall[];
     }) => void;
+    readonly onToolEvidence?: (event: {
+        readonly kind: "call" | "receipt";
+        readonly call: LlmToolCall;
+        readonly text: string;
+    }) => Promise<Result<void>>;
+    readonly pending?: LlmToolLoopPending;
     readonly maxToolRounds?: number;
     readonly maxToolCalls?: number;
     readonly now?: () => number;
 }
+export interface LlmToolLoopPending {
+    hasPending(): boolean;
+    waitForAny(input: {
+        readonly remainingMs: number;
+    }): Promise<string | undefined>;
+    cancelAll(): void;
+    markDelivered(): void;
+    close(): void;
+}
 export interface LlmToolLoopResult {
     readonly request: LLMRequest;
     readonly rounds: number;

package/intern/llm-tool-loop.js

@@ -7,6 +7,7 @@ export const MAX_TOOL_CALL_ID_CHARS = 256;
 export const MAX_TOOL_CALL_NAME_CHARS = 256;
 export const MAX_TOOL_CALL_ARGUMENT_CHARS = 64 * 1024;
 export const MAX_PROVIDER_CHUNK_ERRORS = 3;
+export const LANDING_ROUND_RESERVE_MS = 5_000;
 export class LlmToolLoopError extends Error {
     field;
     limit;
@@ -291,6 +292,10 @@ async function consumeProviderStream(args, stream, request, now, textState) {
             }
             if (isSseEnd(event, event.streamId)) {
                 if (sawToolCall === false) {
+                    if (args.session !== undefined || args.pending?.hasPending() === true) {
+                        completedNormally = true;
+                        return Result.Ok({ toolCalls: [], sawToolCall: false, assistantContent, withheldEnd: event });
+                    }
                     const rVisible = await args.onVisible(event);
                     if (rVisible.isErr())
                         return Result.Err(String(rVisible.Err()));
@@ -324,16 +329,17 @@ export async function runLlmToolLoop(args) {
     let currentAbort = args.abort;
     let rounds = 0;
     let calls = 0;
+    let budget = args.budget;
     const textState = { lastChar: "", separatorOwed: false };
     try {
-        if (currentRequest.tools === undefined || currentRequest.tools.length === 0) {
+        if ((currentRequest.tools === undefined || currentRequest.tools.length === 0) && args.session === undefined) {
             const rInitial = await consumeProviderStream({ ...args, abort: currentAbort }, currentStream, currentRequest, now, textState);
             if (rInitial.isErr())
                 return Result.Err(String(rInitial.Err()));
             return Result.Ok({ request: currentRequest, rounds, calls });
         }
         while (true) {
-            const rStream = await consumeProviderStream({ ...args, abort: currentAbort }, currentStream, currentRequest, now, textState);
+            const rStream = await consumeProviderStream({ ...args, budget, abort: currentAbort }, currentStream, currentRequest, now, textState);
             if (rStream.isErr()) {
                 const error = rStream.Err();
                 if (error instanceof LlmToolLoopAbandonedError &&
@@ -344,8 +350,91 @@ export async function runLlmToolLoop(args) {
                 return Result.Err(error);
             }
             const streamResult = rStream.Ok();
-            if (streamResult.sawToolCall === false)
+            if (streamResult.sawToolCall === false) {
+                if (args.session !== undefined && streamResult.withheldEnd !== undefined) {
+                    const spoken = streamResult.assistantContent === null || streamResult.assistantContent.length === 0
+                        ? []
+                        : [{ role: "assistant", content: [{ type: "text", text: streamResult.assistantContent }] }];
+                    currentRequest = { ...currentRequest, messages: [...currentRequest.messages, ...spoken] };
+                    const saved = await args.session.checkpoint(currentRequest.messages);
+                    if (saved.isErr())
+                        return Result.Err(saved.Err());
+                    const event = await args.session.next();
+                    if (event.isErr())
+                        return Result.Err(event.Err());
+                    const messages = event.Ok();
+                    if (messages === undefined) {
+                        const visible = await args.onVisible(streamResult.withheldEnd);
+                        if (visible.isErr())
+                            return Result.Err(visible.Err());
+                        return Result.Ok({ request: currentRequest, rounds, calls });
+                    }
+                    currentRequest = { ...currentRequest, messages: [...currentRequest.messages, ...messages] };
+                    const checkpoint = await args.session.checkpoint(currentRequest.messages);
+                    if (checkpoint.isErr())
+                        return Result.Err(checkpoint.Err());
+                    budget = createLlmToolLoopBudget({
+                        totalBudgetMs: args.session.dispatchBudgetMs,
+                        maxAttempts: args.budget.maxAttempts,
+                        now,
+                    });
+                    rounds = 0;
+                    calls = 0;
+                    const dispatched = await args.dispatch({ request: currentRequest, budget, round: rounds });
+                    if (dispatched.isErr())
+                        return Result.Err(dispatched.Err());
+                    currentRequest = dispatched.Ok().request;
+                    currentStream = dispatched.Ok().stream;
+                    currentAbort = dispatched.Ok().abort;
+                    if (textState.lastChar !== "" && /\s/.test(textState.lastChar) === false)
+                        textState.separatorOwed = true;
+                    continue;
+                }
+                const withheld = streamResult.withheldEnd;
+                if (withheld !== undefined) {
+                    const pending = args.pending;
+                    const waitMs = remainingBudget(args.budget, now) - LANDING_ROUND_RESERVE_MS;
+                    if (rounds >= maxToolRounds || waitMs <= 0) {
+                        pending?.close();
+                        pending?.cancelAll();
+                        const rVisible = await args.onVisible(withheld);
+                        if (rVisible.isErr())
+                            return Result.Err(String(rVisible.Err()));
+                        return Result.Ok({ request: currentRequest, rounds, calls });
+                    }
+                    const landing = await pending?.waitForAny({ remainingMs: waitMs });
+                    if (landing === undefined) {
+                        const rVisible = await args.onVisible(withheld);
+                        if (rVisible.isErr())
+                            return Result.Err(String(rVisible.Err()));
+                        return Result.Ok({ request: currentRequest, rounds, calls });
+                    }
+                    rounds++;
+                    if (textState.lastChar !== "" && /\s/.test(textState.lastChar) === false)
+                        textState.separatorOwed = true;
+                    const spoken = streamResult.assistantContent === null || streamResult.assistantContent.length === 0
+                        ? []
+                        : [{ role: "assistant", content: [{ type: "text", text: streamResult.assistantContent }] }];
+                    const withLanding = {
+                        ...currentRequest,
+                        messages: [...currentRequest.messages, ...spoken, { role: "user", content: [{ type: "text", text: landing }] }],
+                    };
+                    const rLanded = await args.dispatch({ request: withLanding, budget: args.budget, round: rounds });
+                    if (rLanded.isErr()) {
+                        const rVisible = await args.onVisible(withheld);
+                        if (rVisible.isErr())
+                            return Result.Err(String(rVisible.Err()));
+                        return Result.Err(String(rLanded.Err()));
+                    }
+                    pending?.markDelivered();
+                    const landed = rLanded.Ok();
+                    currentRequest = landed.request;
+                    currentStream = landed.stream;
+                    currentAbort = landed.abort;
+                    continue;
+                }
                 return Result.Ok({ request: currentRequest, rounds, calls });
+            }
             if (rounds >= maxToolRounds)
                 return Result.Err(`LLM tool loop exceeded ${maxToolRounds} rounds`);
             if (calls + streamResult.toolCalls.length > maxToolCalls) {
@@ -365,17 +454,49 @@ export async function runLlmToolLoop(args) {
                     function: { name: call.name, arguments: call.arguments },
                 })),
             });
+            if (args.session !== undefined) {
+                const checkpoint = await args.session.checkpoint([
+                    ...nextMessages,
+                    ...streamResult.toolCalls.map((call) => ({
+                        role: "tool",
+                        tool_call_id: call.id,
+                        content: JSON.stringify({
+                            ok: false,
+                            error: "Execution interrupted: outcome unknown. Inspect the app and pending build results before deciding whether another change is needed; do not repeat this call automatically.",
+                        }),
+                    })),
+                ]);
+                if (checkpoint.isErr())
+                    return Result.Err(checkpoint.Err());
+            }
             for (const call of streamResult.toolCalls) {
-                const rTool = await executeWithDeadline(args.execute, call, args.budget, now, currentAbort?.signal);
+                const announced = await args.onToolEvidence?.({ kind: "call", call, text: call.arguments });
+                if (announced?.isErr())
+                    return Result.Err(announced.Err());
+                const rTool = await executeWithDeadline(args.execute, call, budget, now, currentAbort?.signal);
                 if (currentAbort?.signal.aborted)
                     return Result.Err("LLM tool loop aborted by parent request");
-                nextMessages.push({ role: "tool", tool_call_id: call.id, content: toolResultContent(rTool) });
+                const content = toolResultContent(rTool);
+                const recorded = await args.onToolEvidence?.({ kind: "receipt", call, text: content });
+                if (recorded?.isErr())
+                    return Result.Err(recorded.Err());
+                nextMessages.push({ role: "tool", tool_call_id: call.id, content });
                 calls++;
             }
-            if (remainingBudget(args.budget, now) <= 0)
+            if (remainingBudget(budget, now) <= 0)
                 return Result.Err("LLM tool loop deadline exceeded before resumed dispatch");
             const nextRequest = { ...currentRequest, messages: nextMessages };
-            const rDispatch = await args.dispatch({ request: nextRequest, budget: args.budget, round: rounds });
+            if (args.session !== undefined) {
+                const checkpoint = await args.session.checkpoint(nextMessages);
+                if (checkpoint.isErr())
+                    return Result.Err(checkpoint.Err());
+                budget = createLlmToolLoopBudget({
+                    totalBudgetMs: args.session.dispatchBudgetMs,
+                    maxAttempts: args.budget.maxAttempts,
+                    now,
+                });
+            }
+            const rDispatch = await args.dispatch({ request: nextRequest, budget, round: rounds });
             if (rDispatch.isErr())
                 return Result.Err(String(rDispatch.Err()));
             const dispatch = rDispatch.Ok();
@@ -385,6 +506,8 @@ export async function runLlmToolLoop(args) {
         }
     }
     finally {
+        args.pending?.close();
+        args.pending?.cancelAll();
         args.onSpend?.({ rounds, calls });
     }
 }