@kvman/kvcoder 0.1.5 → 0.1.7

package/dist/turns/settle-calls.js

@@ -1,11 +1,11 @@
-import { startChild } from "../connectors/delegate.js";
-import { dropRun, launchRun } from "../delegate/runs.js";
+import { dropRun } from "../delegate/runs.js";
+import { startPending } from "../delegate/start-pending.js";
 import { firePoint } from "../registry/session-points.js";
 import { now } from "../sessions/session-lookup.js";
 import { records, txRecords } from "../store/collections.js";
-import { endTurn } from "./end-turn.js";
 import { appendMessage, appendQueued } from "./history.js";
-import { queueStep } from "./start-turn.js";
+import { liveStep, settleStep } from "./step-intents.js";
+import { advanceStep, dispatchNext } from "./step-next.js";
 // A result's details without a second copy of its output (ADR 0034, 7): the output stays only where it differs from the
 // text the model gets, which is a shell line's and a binary's.
 function storedDetails(held) {
@@ -24,22 +24,6 @@ export function appendResults(store, session, turnId, calls, results) {
         appendMessage(store, session, { kind: 'toolResult', content: held.details === null ? content : { ...content, details: storedDetails(held) }, turnId });
     }
 }
-/** The running turn inside a transaction, if `turnId` still is it. */
-export function liveTurn(store, sessionId, turnId) {
-    const session = store.sessions.get(sessionId);
-    const turn = store.turns.get(turnId);
-    if (session?.turnId !== turnId || turn === undefined || turn.outcome !== null)
-        return undefined;
-    return { session, turn };
-}
-/** Queues the next step, or ends the turn at `kvcoder.maxSteps` (ADR 0009, 102). */
-export async function continueTurn(ctx, sessionId, turnId, maxSteps) {
-    const turn = await records(ctx.store).turns.get(turnId);
-    if (turn !== undefined && maxSteps !== null && turn.steps >= maxSteps)
-        await endTurn(ctx, sessionId, turnId, 'maxSteps', 'step', { code: 'MAX_STEPS', params: { steps: maxSteps } });
-    else
-        await queueStep(ctx, sessionId, turnId, true);
-}
 function pendingOf(store, sessionId, rootSessionId, turnId, toolCallId, outcome) {
     if (outcome.kind === 'subagent')
         return { toolCallId, kind: 'subagent', questionId: null, question: null, childSessionId: outcome.childSessionId, runId: null };
@@ -49,31 +33,34 @@ function pendingOf(store, sessionId, rootSessionId, turnId, toolCallId, outcome)
     const shown = outcome.questionKind === 'approval' ? outcome.question : { kind: outcome.questionKind, ...outcome.question };
     return { toolCallId, kind: outcome.questionKind === 'approval' ? 'approval' : 'question', questionId: question.id, question: shown, childSessionId: null, runId: null };
 }
-export async function settleCalls(ctx, sessionId, turnId, calls, outcomes, maxSteps) {
+export async function settleCalls(ctx, lease, calls, outcomes, maxSteps) {
+    const { sessionId, turnId } = lease;
     const order = calls.map((call) => ({ toolCallId: call.id, toolName: call.name }));
     const held = outcomes.flatMap((outcome) => (outcome.kind === 'result' ? [outcome.held] : []));
     if (held.length === outcomes.length) {
-        const live = await ctx.store.transaction((tx) => {
+        const next = await ctx.store.transaction((tx) => {
             const store = txRecords(tx);
-            const found = liveTurn(store, sessionId, turnId);
+            const found = liveStep(store, lease, lease.jobId);
             if (found === undefined)
-                return false;
+                return undefined;
             appendResults(store, found.session, turnId, order, held);
             appendQueued(store, found.session, turnId);
-            return true;
+            return advanceStep(store, lease, maxSteps);
         });
-        if (live)
-            await continueTurn(ctx, sessionId, turnId, maxSteps);
+        await dispatchNext(ctx, next);
         return;
     }
     const rootSessionId = (await rootOf(ctx, sessionId)) ?? sessionId;
     const pending = await ctx.store.transaction((tx) => {
         const store = txRecords(tx);
-        if (liveTurn(store, sessionId, turnId) === undefined)
+        if (liveStep(store, lease, lease.jobId) === undefined)
             return undefined;
-        const items = outcomes.flatMap((outcome, index) => (outcome.kind === 'result' ? [] : [pendingOf(store, sessionId, rootSessionId, turnId, calls[index]?.id ?? '', outcome)]));
-        store.turns.update(turnId, { calls: order, pending: items, results: held });
-        store.sessions.update(sessionId, { status: 'waiting', stepJobId: null, updatedAt: now() });
+        const items = outcomes.flatMap((outcome, index) => (outcome.kind === 'result' || outcome.kind === 'deferred' ? [] : [pendingOf(store, sessionId, rootSessionId, turnId, calls[index]?.id ?? '', outcome)]));
+        // Effects held back behind an approval wait with the turn, and run in the model's order when it resumes (ADR 0046).
+        const deferredCalls = outcomes.flatMap((outcome, index) => (outcome.kind === 'deferred' ? [{ toolCallId: calls[index]?.id ?? '', call: outcome.call }] : []));
+        store.turns.update(turnId, { calls: order, pending: items, results: held, deferredCalls });
+        settleStep(store, lease, lease.jobId);
+        store.sessions.update(sessionId, { status: 'waiting', stepJobId: null, stepIntentId: null, updatedAt: now() });
         return items;
     });
     if (pending === undefined) {
@@ -81,12 +68,16 @@ export async function settleCalls(ctx, sessionId, turnId, calls, outcomes, maxSt
         return;
     }
     for (const item of pending) {
+        const current = await ctx.store.transaction(tx => {
+            const store = txRecords(tx);
+            return store.sessions.get(sessionId)?.turnId === turnId && store.turns.get(turnId)?.pending.some(saved => saved.toolCallId === item.toolCallId);
+        });
+        if (!current)
+            continue;
         if (item.questionId !== null)
             ctx.job.progress({ type: 'component', component: 'kvcoder.question', props: { questionId: item.questionId, sessionId, pending: item } });
-        if (item.childSessionId !== null)
-            await startChild(ctx, item.childSessionId);
-        if (item.runId !== null)
-            await launchRun(ctx, item.runId);
+        if (item.childSessionId !== null || item.runId !== null)
+            await startPending(ctx, { sessionId, turnId, pending: item });
     }
     for (const kind of new Set(pending.map((item) => item.kind)))
         await firePoint(ctx, 'kvcoder.session.waiting', { sessionId, kind });

package/dist/turns/settle-calls.js.map

@@ -1 +1 @@
-{"version":3,"file":"settle-calls.js","sourceRoot":"","sources":["../../src/turns/settle-calls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,OAAO,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAkB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQ5C,wHAAwH;AACxH,+DAA+D;AAC/D,SAAS,aAAa,CAAC,IAAgB;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC;IACjI,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,KAAgB,EAAE,OAA2B,EAAE,MAAc,EAAE,KAAY,EAAE,OAA8B;IACvI,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC;QACnF,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACjC,MAAM,OAAO,GAA8B,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACpN,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACzJ,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,KAAgB,EAAE,SAAiB,EAAE,MAAc;IAC1E,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,OAAO,EAAE,MAAM,KAAK,MAAM,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAChG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAQ,EAAE,SAAiB,EAAE,MAAc,EAAE,QAAuB;IACrG,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,IAAI,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ;QAAE,MAAM,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;;QAChL,MAAM,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,KAAgB,EAAE,SAAiB,EAAE,aAAqB,EAAE,MAAc,EAAE,UAAkB,EAAE,OAAiD;IAClK,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAChK,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;IACnJ,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClJ,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC3H,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC1K,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAQ,EAAE,SAAiB,EAAE,MAAc,EAAE,KAA0B,EAAE,QAAgC,EAAE,QAAuB;IAClK,MAAM,KAAK,GAAU,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9F,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;YAC5B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACtC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACzD,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,IAAI;YAAE,MAAM,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IACD,MAAM,aAAa,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,IAAI,SAAS,CAAC;IAClE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7K,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC3F,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACvK,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI;YAAE,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;YAAE,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAE,MAAM,SAAS,CAAC,GAAG,EAAE,yBAAyB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACrI,CAAC;AAED,iEAAiE;AACjE,KAAK,UAAU,WAAW,CAAC,GAAQ,EAAE,QAAgC;IACnE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrG,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,GAAQ,EAAE,SAAiB;IAC/C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjE,OAAO,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;AACnC,CAAC"}
+{"version":3,"file":"settle-calls.js","sourceRoot":"","sources":["../../src/turns/settle-calls.ts"],"names":[],"mappings":"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"}

package/dist/turns/start-turn.d.ts

@@ -1,88 +1,13 @@
 import type { Ctx, Stored } from '@kvman/sdk';
 import type { SessionDoc } from '../schemas/records.ts';
 import { type TxRecords } from '../store/collections.ts';
-/** Opens a turn on an idle session inside a transaction, and marks the session running. */
+import { type StepIdentity } from './step-intents.ts';
+/** Opens a turn and prepares its first intent in the same transaction (ADR0041). */
 export declare function openTurn(tx: TxRecords, session: Stored<SessionDoc>): string;
-/** Queues the turn's next step and records it as the session's step; `follow` sends the follow chunk. */
-export declare function queueStep(ctx: Ctx, sessionId: string, turnId: string, follow: boolean): Promise<string>;
-/** Starts a turn that `openTurn` opened: the `turn.started` point, then the first step. */
-export declare function beginTurn(ctx: Ctx, sessionId: string, turnId: string, follow: boolean): Promise<string>;
-/** The session's turn, when it is still the running one. */
-export declare function currentTurn(ctx: Ctx, sessionId: string, turnId: string): Promise<{
-    session: Stored<{
-        title: string;
-        autoTitle: boolean;
-        status: "idle" | "running" | "waiting";
-        parentId: string | null;
-        worker: {
-            name: string;
-            instructions: string;
-        } | null;
-        model: string | null;
-        thinking: "off" | "minimal" | "low" | "medium" | "high";
-        stepJobId: string | null;
-        turnId: string | null;
-        endedTurns: number;
-        nextSeq: number;
-        usage: {
-            input: number;
-            output: number;
-            cacheRead: number;
-            cacheWrite: number;
-            cost: number;
-        };
-        durationMs: number;
-        checks: {
-            name: string;
-            passed: boolean;
-        }[] | null;
-        connectors: string[] | null;
-        optedIn: string[];
-        createdAt: string;
-        updatedAt: string;
-    }>;
-    turn: Stored<{
-        sessionId: string;
-        startedAt: string;
-        endedAt: string | null;
-        durationMs: number;
-        steps: number;
-        lost: number;
-        usage: {
-            input: number;
-            output: number;
-            cacheRead: number;
-            cacheWrite: number;
-            cost: number;
-        };
-        outcome: "done" | "cancelled" | "failed" | "interrupted" | "maxSteps" | null;
-        calls: {
-            toolCallId: string;
-            toolName: string;
-        }[];
-        pending: {
-            toolCallId: string;
-            kind: "subagent" | "worker" | "question" | "approval";
-            questionId: string | null;
-            question: import("zod").JSONType;
-            childSessionId: string | null;
-            runId: string | null;
-        }[];
-        results: {
-            toolCallId: string;
-            text: string;
-            details: import("zod").JSONType;
-            isError: boolean;
-            run: {
-                description: string;
-                connector: string;
-                command: string;
-                payload: Record<string, import("zod").JSONType>;
-            } | {
-                command: string;
-                timeoutMs: number;
-            } | null;
-        }[];
-    }>;
-} | undefined>;
+/** Enqueues outside SQLite, then publishes only this exact identity; a losing candidate is cancelled. */
+export declare function dispatchStep(ctx: Ctx, identity: StepIdentity, follow: boolean): Promise<string | null>;
+/** Dispatches an already prepared transition; it never prepares a successor after the fact. */
+export declare function queueStep(ctx: Ctx, sessionId: string, turnId: string, follow: boolean): Promise<string | null>;
+/** Starts a committed turn: its point then its prepared first step, rechecked after the point. */
+export declare function beginTurn(ctx: Ctx, sessionId: string, turnId: string, follow: boolean): Promise<string | null>;
 //# sourceMappingURL=start-turn.d.ts.map

package/dist/turns/start-turn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-turn.d.ts","sourceRoot":"","sources":["../../src/turns/start-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAM7E,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAI3E;AAED,yGAAyG;AACzG,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAS7G;AAED,2FAA2F;AAC3F,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7G;AAED,4DAA4D;AAC5D,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAM5E"}
+{"version":3,"file":"start-turn.d.ts","sourceRoot":"","sources":["../../src/turns/start-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAA0C,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE9F,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAK3E;AAED,yGAAyG;AACzG,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsB5G;AAED,+FAA+F;AAC/F,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGpH;AAED,kGAAkG;AAClG,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGpH"}

package/dist/turns/start-turn.js

@@ -1,40 +1,51 @@
 import { firePoint } from "../registry/session-points.js";
 import { now } from "../sessions/session-lookup.js";
-import { records, txRecords } from "../store/collections.js";
+import { txRecords } from "../store/collections.js";
 import { noUsage } from "./history.js";
-// Starting a turn and chaining its steps (plan 08 §8.1): each step is an async job; the session records the running
-// step's job id, and the step that queues the next one sends `{ type: 'follow', jobId }` so the UI streams on.
-/** Opens a turn on an idle session inside a transaction, and marks the session running. */
+import { preparedStep, prepareStep, publishStep } from "./step-intents.js";
+/** Opens a turn and prepares its first intent in the same transaction (ADR0041). */
 export function openTurn(tx, session) {
-    const turn = tx.turns.insert({ sessionId: session.id, startedAt: now(), endedAt: null, durationMs: 0, steps: 0, lost: 0, usage: noUsage(), outcome: null, calls: [], pending: [], results: [] });
+    const turn = tx.turns.insert({ sessionId: session.id, startedAt: now(), endedAt: null, durationMs: 0, steps: 0, lost: 0, incomplete: 0, usage: noUsage(), outcome: null, calls: [], pending: [], results: [], deferredCalls: [] });
     tx.sessions.update(session.id, { status: 'running', turnId: turn.id, stepJobId: null, updatedAt: now() });
+    prepareStep(tx, session.id, turn.id);
     return turn.id;
 }
-/** Queues the turn's next step and records it as the session's step; `follow` sends the follow chunk. */
-export async function queueStep(ctx, sessionId, turnId, follow) {
-    const jobId = await ctx.execAsync('kvcoder.turn.step', { sessionId, turnId });
+/** Enqueues outside SQLite, then publishes only this exact identity; a losing candidate is cancelled. */
+export async function dispatchStep(ctx, identity, follow) {
+    ctx.job.signal.throwIfAborted();
+    const current = await ctx.store.transaction(tx => {
+        const found = preparedStep(txRecords(tx), identity.sessionId, identity.turnId);
+        return found?.intentId === identity.intentId && found.generation === identity.generation;
+    });
+    if (!current)
+        return null;
+    const jobId = await ctx.execAsync('kvcoder.turn.step', identity);
+    const publication = await ctx.store.transaction(tx => {
+        const store = txRecords(tx);
+        if (publishStep(store, identity, jobId))
+            return 'current';
+        const intent = store.stepIntents.get(identity.intentId);
+        // A canonical job can settle before its publisher returns. Its post-commit work is not a losing candidate.
+        return intent?.sessionId === identity.sessionId && intent.turnId === identity.turnId && intent.generation === identity.generation && intent.phase === 'settled' && intent.jobId === jobId ? 'settled' : 'lost';
+    });
+    if (publication !== 'current') {
+        if (publication === 'lost')
+            await ctx.cancel(jobId);
+        return null;
+    }
+    // A follow chunk is only a hint. Publication must win before it is emitted (ADR0041).
     if (follow)
         ctx.job.progress({ type: 'follow', jobId });
-    await ctx.store.transaction((tx) => {
-        const { sessions } = txRecords(tx);
-        const session = sessions.get(sessionId);
-        if (session?.turnId === turnId && session.status === 'running')
-            sessions.update(sessionId, { stepJobId: jobId });
-    });
     return jobId;
 }
-/** Starts a turn that `openTurn` opened: the `turn.started` point, then the first step. */
+/** Dispatches an already prepared transition; it never prepares a successor after the fact. */
+export async function queueStep(ctx, sessionId, turnId, follow) {
+    const identity = await ctx.store.transaction(tx => preparedStep(txRecords(tx), sessionId, turnId));
+    return identity === undefined ? null : dispatchStep(ctx, identity, follow);
+}
+/** Starts a committed turn: its point then its prepared first step, rechecked after the point. */
 export async function beginTurn(ctx, sessionId, turnId, follow) {
     await firePoint(ctx, 'kvcoder.turn.started', { sessionId, turnId });
     return queueStep(ctx, sessionId, turnId, follow);
 }
-/** The session's turn, when it is still the running one. */
-export async function currentTurn(ctx, sessionId, turnId) {
-    const store = records(ctx.store);
-    const session = await store.sessions.get(sessionId);
-    if (session?.turnId !== turnId)
-        return undefined;
-    const turn = await store.turns.get(turnId);
-    return turn === undefined || turn.outcome !== null ? undefined : { session, turn };
-}
 //# sourceMappingURL=start-turn.js.map

package/dist/turns/start-turn.js.map

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

package/dist/turns/step-claim.d.ts

@@ -0,0 +1,39 @@
+import { z, type Ctx, type Job } from '@kvman/sdk';
+import { type StepIdentity } from './step-intents.ts';
+declare const legacyStepInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+}, z.core.$strict>;
+/** Private command input only: old jobs retain their actual two-field input, without defaults. */
+export declare const stepInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    intentId: z.ZodString;
+    generation: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+}, z.core.$strict>]>;
+export type StepInput = z.output<typeof stepInputSchema>;
+type LegacyStepInput = z.output<typeof legacyStepInputSchema>;
+/** Internal execution authority, not a change to any public session/turn DTO. */
+export type StepLease = StepIdentity & {
+    jobId: string;
+};
+/**
+ * Conservative compatibility proof for a currently executing old job. The kernel increments attempts
+ * before invoking the handler; old stepOptions used retries: 0. Attempt 1 therefore excludes an earlier
+ * kernel invocation, assuming immutable job name/workspace/input and no out-of-kernel execution.
+ * This does not certify effects of missing, terminal, requeued or merely default-generation records.
+ */
+export declare function isLegacyStepJob(job: Job, input: LegacyStepInput, currentJobId: string, workspaceId: string): boolean;
+/** Recheck authority after async preparation and immediately before effects; writes still recheck in their own tx. */
+export declare function currentStep(ctx: Ctx, lease: StepLease): Promise<{
+    session: import("@kvman/sdk").Stored<import("../schemas/records.ts").SessionDoc>;
+    turn: import("@kvman/sdk").Stored<import("../schemas/records.ts").TurnDoc>;
+    intent: import("@kvman/sdk").Stored<import("../schemas/records.ts").StepIntentDoc>;
+} | undefined>;
+/** Claim before any approval, model or tool effects; no enqueue/cancel/effects in this transaction. */
+export declare function claimStepInput(ctx: Ctx, input: StepInput): Promise<StepLease | undefined>;
+export {};
+//# sourceMappingURL=step-claim.d.ts.map

package/dist/turns/step-claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-claim.d.ts","sourceRoot":"","sources":["../../src/turns/step-claim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,CAAC,EAAE,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAExF,QAAA,MAAM,qBAAqB;;;kBAAgE,CAAC;AAQ5F,kGAAkG;AAClG,eAAO,MAAM,eAAe;;;;;;;;oBAA0D,CAAC;AACvF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AACzD,KAAK,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE9D,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAIpH;AAED,sHAAsH;AACtH,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS;;;;eAO3D;AAED,uGAAuG;AACvG,wBAAsB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAkC/F"}

package/dist/turns/step-claim.js

@@ -0,0 +1,72 @@
+import { ProblemError, z } from '@kvman/sdk';
+import { txRecords } from "../store/collections.js";
+import { claimStep, liveStep, prepareStep } from "./step-intents.js";
+const legacyStepInputSchema = z.strictObject({ sessionId: z.string(), turnId: z.string() });
+const modernStepInputSchema = z.strictObject({
+    sessionId: z.string(),
+    turnId: z.string(),
+    intentId: z.string(),
+    generation: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+});
+/** Private command input only: old jobs retain their actual two-field input, without defaults. */
+export const stepInputSchema = z.union([modernStepInputSchema, legacyStepInputSchema]);
+/**
+ * Conservative compatibility proof for a currently executing old job. The kernel increments attempts
+ * before invoking the handler; old stepOptions used retries: 0. Attempt 1 therefore excludes an earlier
+ * kernel invocation, assuming immutable job name/workspace/input and no out-of-kernel execution.
+ * This does not certify effects of missing, terminal, requeued or merely default-generation records.
+ */
+export function isLegacyStepJob(job, input, currentJobId, workspaceId) {
+    if (job.id !== currentJobId || job.name !== 'kvcoder.turn.step' || job.workspaceId !== workspaceId || job.status !== 'running' || job.attempts !== 1 || job.retries !== 0)
+        return false;
+    const saved = legacyStepInputSchema.safeParse(job.input);
+    return saved.success && saved.data.sessionId === input.sessionId && saved.data.turnId === input.turnId;
+}
+/** Recheck authority after async preparation and immediately before effects; writes still recheck in their own tx. */
+export async function currentStep(ctx, lease) {
+    ctx.job.signal.throwIfAborted();
+    if (ctx.job.id !== lease.jobId)
+        return undefined;
+    return ctx.store.transaction(tx => {
+        ctx.job.signal.throwIfAborted();
+        return liveStep(txRecords(tx), lease, lease.jobId);
+    });
+}
+/** Claim before any approval, model or tool effects; no enqueue/cancel/effects in this transaction. */
+export async function claimStepInput(ctx, input) {
+    const { id: jobId, signal, workspace } = ctx.job;
+    signal.throwIfAborted();
+    if ('intentId' in input) {
+        return ctx.store.transaction(tx => {
+            signal.throwIfAborted();
+            return claimStep(txRecords(tx), input, jobId) === undefined ? undefined : { ...input, jobId };
+        });
+    }
+    // jobs.get is cross-workspace. Never substitute the session's saved id for this executing job's id.
+    let job;
+    try {
+        job = await ctx.exec('kernel.jobs.get', { id: jobId });
+    }
+    catch (error) {
+        signal.throwIfAborted();
+        if (error instanceof ProblemError && error.problem.code === 'NOT_FOUND')
+            return undefined;
+        throw error;
+    }
+    signal.throwIfAborted();
+    if (!isLegacyStepJob(job, input, jobId, workspace.id))
+        return undefined;
+    return ctx.store.transaction(tx => {
+        signal.throwIfAborted();
+        const store = txRecords(tx);
+        const session = store.sessions.get(input.sessionId);
+        const turn = store.turns.get(input.turnId);
+        if (session?.status !== 'running' || session.turnId !== input.turnId || session.stepJobId !== jobId || session.stepIntentId !== null || turn?.sessionId !== input.sessionId || turn.outcome !== null || turn.endedAt !== null || turn.pending.length !== 0)
+            return undefined;
+        // A legacy read's generation 0/null defaults are not permission: the saved job binding and
+        // first-invocation metadata above are required, and all mutable state is checked in this same tx.
+        const identity = prepareStep(store, input.sessionId, input.turnId, jobId);
+        return claimStep(store, identity, jobId) === undefined ? undefined : { ...identity, jobId };
+    });
+}
+//# sourceMappingURL=step-claim.js.map

package/dist/turns/step-claim.js.map

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

package/dist/turns/step-intents.d.ts

@@ -0,0 +1,31 @@
+import type { Stored } from '@kvman/sdk';
+import type { SessionDoc, StepIntentDoc, TurnDoc } from '../schemas/records.ts';
+import type { TxRecords } from '../store/collections.ts';
+/** The private identity of one scheduled step (ADR0041); never a public session DTO. */
+export type StepIdentity = {
+    sessionId: string;
+    turnId: string;
+    intentId: string;
+    generation: number;
+};
+type LiveIntent = {
+    session: Stored<SessionDoc>;
+    turn: Stored<TurnDoc>;
+    intent: Stored<StepIntentDoc>;
+};
+/** Reads only the current runnable prepared identity, never manufactures an intent outside its state transition. */
+export declare function preparedStep(store: TxRecords, sessionId: string, turnId: string): StepIdentity | undefined;
+/** Prepares a new intent in the transaction that makes its turn runnable. No enqueue occurs here. */
+export declare function prepareStep(store: TxRecords, sessionId: string, turnId: string, legacyJobId?: string | null): StepIdentity;
+/** Binds the one winner before model, approval or ordinary tool effects. Repeated claims lose. */
+export declare function claimStep(store: TxRecords, expected: StepIdentity, jobId: string): LiveIntent | undefined;
+/** Selects a published candidate, or confirms the already claimed winner; never replaces another. */
+export declare function publishStep(store: TxRecords, expected: StepIdentity, jobId: string): boolean;
+/** A step-derived write needs the current identity and its canonical job, not merely the same turn. */
+export declare function liveStep(store: TxRecords, expected: StepIdentity, jobId: string): LiveIntent | undefined;
+/** Use in the SAME transaction as results and waiting/end/successor state, never as a separate settlement. */
+export declare function settleStep(store: TxRecords, expected: StepIdentity, jobId: string): boolean;
+/** Invalidates only the expected identity; step-derived callers also validate their canonical job in this transaction. */
+export declare function invalidateStep(store: TxRecords, expected: StepIdentity, reason: 'CANCEL_REQUESTED' | 'TURN_ENDED'): string | null;
+export {};
+//# sourceMappingURL=step-intents.d.ts.map

package/dist/turns/step-intents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-intents.d.ts","sourceRoot":"","sources":["../../src/turns/step-intents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,wFAAwF;AACxF,MAAM,MAAM,YAAY,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvG,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAA;CAAE,CAAC;AAaxG,oHAAoH;AACpH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAM1G;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAE,MAAM,GAAG,IAAW,GAAG,YAAY,CAahI;AAED,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAUzG;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAW5F;AAED,uGAAuG;AACvG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAGxG;AAED,8GAA8G;AAC9G,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAK3F;AAED,0HAA0H;AAC1H,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,CAOjI"}

package/dist/turns/step-intents.js

@@ -0,0 +1,101 @@
+import { invalid } from "../problems.js";
+import { now } from "../sessions/session-lookup.js";
+import { deletingInTx, executionRootInTx } from "../sessions/execution-root.js";
+/** All identity checks happen again in the transaction that writes state. */
+function liveIntent(store, expected, teardown = false) {
+    const session = store.sessions.get(expected.sessionId);
+    if (session?.turnId !== expected.turnId || session.status !== 'running' || session.stepIntentId !== expected.intentId || session.stepGeneration !== expected.generation)
+        return undefined;
+    if (!teardown && deletingInTx(store, expected.sessionId))
+        return undefined;
+    const turn = store.turns.get(expected.turnId);
+    const intent = store.stepIntents.get(expected.intentId);
+    if (turn?.sessionId !== expected.sessionId || turn.outcome !== null || turn.endedAt !== null || intent?.sessionId !== expected.sessionId || intent.turnId !== expected.turnId || intent.generation !== expected.generation)
+        return undefined;
+    return { session, turn, intent };
+}
+/** Reads only the current runnable prepared identity, never manufactures an intent outside its state transition. */
+export function preparedStep(store, sessionId, turnId) {
+    const session = store.sessions.get(sessionId);
+    if (session?.stepIntentId === null || session === undefined)
+        return undefined;
+    const identity = { sessionId, turnId, intentId: session.stepIntentId, generation: session.stepGeneration };
+    const live = liveIntent(store, identity);
+    return live?.intent.phase === 'prepared' && live.turn.pending.length === 0 ? identity : undefined;
+}
+/** Prepares a new intent in the transaction that makes its turn runnable. No enqueue occurs here. */
+export function prepareStep(store, sessionId, turnId, legacyJobId = null) {
+    const session = store.sessions.get(sessionId);
+    const turn = store.turns.get(turnId);
+    if (session?.turnId !== turnId || session.status !== 'running' || turn?.sessionId !== sessionId || turn.outcome !== null || turn.endedAt !== null || turn.pending.length > 0)
+        throw invalid('A step needs its current runnable turn.');
+    // A saved legacy reference can still be retained and immediately invalidated by terminal cleanup.
+    if (legacyJobId === null && executionRootInTx(store, sessionId) === undefined)
+        throw invalid('A step needs its current runnable turn.');
+    if (session.stepIntentId !== null)
+        throw invalid('The current step intent must be settled or invalidated before preparing its successor.');
+    const generation = session.stepGeneration + 1;
+    if (!Number.isSafeInteger(generation))
+        throw invalid('The next step generation exceeds the safe integer range.');
+    const timestamp = now();
+    const intent = store.stepIntents.insert({ sessionId, turnId, generation, phase: 'prepared', jobId: null, legacyJobId, reason: null, createdAt: timestamp, updatedAt: timestamp });
+    store.sessions.update(sessionId, { stepGeneration: generation, stepIntentId: intent.id, stepJobId: null, updatedAt: timestamp });
+    return { sessionId, turnId, intentId: intent.id, generation };
+}
+/** Binds the one winner before model, approval or ordinary tool effects. Repeated claims lose. */
+export function claimStep(store, expected, jobId) {
+    const live = liveIntent(store, expected);
+    if (live === undefined || live.intent.phase !== 'prepared' || live.turn.pending.length > 0)
+        return undefined;
+    // A published candidate is already selected; before publication the first valid claimant may win.
+    if (live.intent.jobId !== null && live.intent.jobId !== jobId)
+        return undefined;
+    if (live.intent.legacyJobId !== null && live.intent.legacyJobId !== jobId)
+        return undefined;
+    const updatedAt = now();
+    const intent = store.stepIntents.update(expected.intentId, { phase: 'claimed', jobId, updatedAt });
+    const session = store.sessions.update(expected.sessionId, { stepJobId: jobId, updatedAt });
+    return { session, turn: live.turn, intent };
+}
+/** Selects a published candidate, or confirms the already claimed winner; never replaces another. */
+export function publishStep(store, expected, jobId) {
+    const live = liveIntent(store, expected);
+    if (live === undefined)
+        return false;
+    if (live.intent.phase === 'claimed')
+        return live.intent.jobId === jobId && live.session.stepJobId === jobId;
+    if (live.intent.phase !== 'prepared' || live.turn.pending.length > 0)
+        return false;
+    if (live.intent.legacyJobId !== null && live.intent.legacyJobId !== jobId)
+        return false;
+    if (live.intent.jobId !== null)
+        return live.intent.jobId === jobId && live.session.stepJobId === jobId;
+    const updatedAt = now();
+    store.stepIntents.update(expected.intentId, { jobId, updatedAt });
+    store.sessions.update(expected.sessionId, { stepJobId: jobId, updatedAt });
+    return true;
+}
+/** A step-derived write needs the current identity and its canonical job, not merely the same turn. */
+export function liveStep(store, expected, jobId) {
+    const live = liveIntent(store, expected);
+    return live?.intent.phase === 'claimed' && live.intent.jobId === jobId && live.session.stepJobId === jobId ? live : undefined;
+}
+/** Use in the SAME transaction as results and waiting/end/successor state, never as a separate settlement. */
+export function settleStep(store, expected, jobId) {
+    if (liveStep(store, expected, jobId) === undefined)
+        return false;
+    store.stepIntents.update(expected.intentId, { phase: 'settled', updatedAt: now() });
+    store.sessions.update(expected.sessionId, { stepIntentId: null, stepJobId: null });
+    return true;
+}
+/** Invalidates only the expected identity; step-derived callers also validate their canonical job in this transaction. */
+export function invalidateStep(store, expected, reason) {
+    const live = liveIntent(store, expected, true);
+    if (live === undefined || (live.intent.phase !== 'prepared' && live.intent.phase !== 'claimed'))
+        return null;
+    store.stepIntents.update(expected.intentId, { phase: 'invalidated', reason, updatedAt: now() });
+    store.sessions.update(expected.sessionId, { stepIntentId: null, stepJobId: null });
+    // A verified legacy job is known even when publication and claim have not happened yet.
+    return live.intent.jobId ?? live.intent.legacyJobId;
+}
+//# sourceMappingURL=step-intents.js.map