agentenkit 0.3.0 → 0.5.0

package/dist/core/hitl.d.ts

@@ -8,6 +8,14 @@ export declare const HITL_TTL_MS: number;
  *  user's verdict (or the timeout denial) instead. */
 export declare const HITL_PARKED = "__hitl_parked__";
 export declare const hitlKey: (toolCallId: string) => string;
+/** A park's expiry row on the queue, so an answer can withdraw it. */
+export declare const expiryJobKey: (toolCallId: string) => string;
+/** A park's resume row on the queue: one per answer, so the queue itself
+ *  refuses a second resume for the same call. */
+export declare const resumeJobKey: (toolCallId: string) => string;
+/** Keeps an approved tool's output until its result is saved (§2.5), so a
+ *  retry lands the same output instead of running the tool again. */
+export declare const hitlDoneKey: (toolCallId: string) => string;
 export interface HitlResponse {
     approved: boolean;
     payload?: unknown;
@@ -56,6 +64,11 @@ export declare class ToolParkedError extends Error {
     readonly request: ParkRequest;
     constructor(request: ParkRequest);
 }
+/** A tool call cut off by a user stop (§2.1). Unlike any other tool error it
+ *  is not handed to the model: a stop tears the whole run down. */
+export declare class RunStoppedError extends Error {
+    constructor(cause: unknown);
+}
 export declare function parkForInput(request?: ParkRequest): ToolParkedError;
 export interface ParkInput {
     threadId: string;
@@ -75,6 +88,22 @@ export interface ParkInput {
     /** Dispatch ticket persisted in the INPUT_REQUIRED payload (§2.5) */
     resume: ResumeInfo;
 }
+/** Holds the parks a segment raised until the step that raised them is saved
+ *  (§2.5). A tool call parks in the middle of a model step, before the step's
+ *  messages exist. Writing the park then would let the answer, a failed step
+ *  or a stop act on a tool call the history does not have yet. So the wrapper
+ *  only records the park here; the main loop commits the box once its step is
+ *  saved, and a failed step simply drops it. Nested runs share their parent's
+ *  box, so a park raised any depth down waits for the main agent's step too. */
+export declare class ParkBox {
+    private parks;
+    add(p: ParkInput): void;
+    take(): ParkInput[];
+}
+/** Write every park the box holds: WAITING_FOR_INPUT, the INPUT_REQUIRED
+ *  request and its expiry job (see parkForApproval). Called once the step that
+ *  raised them is durable. */
+export declare function commitParks(deps: RuntimePorts, box: ParkBox | undefined): Promise<void>;
 /** Wrap every tool so a call can park (§2.5) instead of blocking. A marked
  *  tool parks BEFORE it runs: the request is persisted as INPUT_REQUIRED and
  *  the wrapper returns the park sentinel; the real tool runs when a human
@@ -90,6 +119,12 @@ export declare function withHitl(deps: RuntimePorts, threadId: string, tools: Re
     agentId?: string | null;
     frames?: HitlFrame[];
     nested?: NestedDescriptor;
+    /** Where parks wait for their step to be saved (see ParkBox). Absent
+     *  parks at once. */
+    parks?: ParkBox;
+    /** Calls whose tool failed, by id, with the message: their live chunk
+     *  names the error (see chunkPayload). */
+    toolErrors?: Map<string, string>;
 }): Record<string, any>;
 /** The §2.5 suspension as a durable state transition — NO process waits.
  *  Flips WAITING_FOR_INPUT on both homes and appends INPUT_REQUIRED to the
@@ -125,6 +160,14 @@ export interface PendingHitl {
     expiresAt?: number;
     /** REASON_APPROVAL, or the self-parking tool's word (§2.5). */
     reason?: string;
+    /** The dispatch ticket, when the park recorded one. */
+    resume?: ResumeInfo;
+    /** Marks a park whose own call already has its result in the history, but
+     *  whose unwind stopped part way (§2.7): a worker died, or a child failed,
+     *  between one level and the next. Nothing is left to answer; the unwind
+     *  carries on from `resumeFrame`, the first frame still waiting. */
+    landed?: boolean;
+    resumeFrame?: number;
 }
 /** When a park stops being answerable, epoch ms. */
 export declare function hitlDeadline(p: PendingHitl, config: {

package/dist/core/hitl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hitl.d.ts","sourceRoot":"","sources":["../../src/core/hitl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAc,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK3E,eAAO,MAAM,WAAW,QAAc,CAAC;AAEvC;;;sDAGsD;AACtD,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAE7C,eAAO,MAAM,OAAO,GAAI,YAAY,MAAM,WAA+B,CAAC;AAE1E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;sCAGsC;AACtC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB;8DAC0D;IAC1D,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;4DAC4D;AAC5D,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C;;;;mEAImE;AACnE,MAAM,WAAW,WAAW;IAC1B;;6CAEyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;4CACwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;gFAC4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;sDAQsD;AACtD,qBAAa,eAAgB,SAAQ,KAAK;aACZ,OAAO,EAAE,WAAW;gBAApB,OAAO,EAAE,WAAW;CAIjD;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,WAAgB,GAAG,eAAe,CAEvE;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;sEACkE;IAClE,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,qEAAqE;IACrE,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;;;;;;;;sEASsE;AACtE,wBAAgB,QAAQ,CACtB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,GAAG,EAAE;IACH,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GACA,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAmDrB;AAED;;;;;;;;;;;;;;wCAcwC;AACxC,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDrF;AAED;gCACgC;AAChC,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,mEAAmE;IACnE,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB;gFAC4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAElF;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,OAAO,CAEtE;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAI7B;AA4BD;;;;;;gFAMgF;AAChF,wBAAsB,aAAa,CACjC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAqBxB;AAED;;;;yBAIyB;AACzB,wBAAsB,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAmE7F"}
+{"version":3,"file":"hitl.d.ts","sourceRoot":"","sources":["../../src/core/hitl.ts"],"names":[],"mappings":"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"}

package/dist/core/hitl.js

@@ -1,7 +1,9 @@
 import { randomUUID } from 'node:crypto';
-import { publish, setThreadState } from './publish.js';
+import { publish, runStatePayload, transition } from './publish.js';
 import { currentRunId } from './keys.js';
 import { reclaimIfOrphaned } from './reclaim.js';
+import { enqueueJob } from './lease.js';
+import { DuplicateJobError, PRIORITY_LOW } from '../ports/queue.js';
 export const HITL_TTL_MS = 15 * 60_000;
 /** Result value a parked `requiresConfirmation` tool returns (§2.5). The
  *  engine scans a step's tool results for this marker to end the run segment;
@@ -9,6 +11,14 @@ export const HITL_TTL_MS = 15 * 60_000;
  *  user's verdict (or the timeout denial) instead. */
 export const HITL_PARKED = '__hitl_parked__';
 export const hitlKey = (toolCallId) => `agent:hitl:${toolCallId}`;
+/** A park's expiry row on the queue, so an answer can withdraw it. */
+export const expiryJobKey = (toolCallId) => `hitl-expiry:${toolCallId}`;
+/** A park's resume row on the queue: one per answer, so the queue itself
+ *  refuses a second resume for the same call. */
+export const resumeJobKey = (toolCallId) => `hitl-resume:${toolCallId}`;
+/** Keeps an approved tool's output until its result is saved (§2.5), so a
+ *  retry lands the same output instead of running the tool again. */
+export const hitlDoneKey = (toolCallId) => `agent:hitl-done:${toolCallId}`;
 /** Marks a park raised by a `requiresConfirmation` tool: a human decides.
  *  Any other reason is a tool that parked itself (§2.5). */
 export const REASON_APPROVAL = 'approval';
@@ -29,9 +39,44 @@ export class ToolParkedError extends Error {
         this.name = 'ToolParkedError';
     }
 }
+/** A tool call cut off by a user stop (§2.1). Unlike any other tool error it
+ *  is not handed to the model: a stop tears the whole run down. */
+export class RunStoppedError extends Error {
+    constructor(cause) {
+        super(cause instanceof Error ? cause.message : String(cause));
+        this.name = 'RunStoppedError';
+    }
+}
 export function parkForInput(request = {}) {
     return new ToolParkedError(request);
 }
+/** Holds the parks a segment raised until the step that raised them is saved
+ *  (§2.5). A tool call parks in the middle of a model step, before the step's
+ *  messages exist. Writing the park then would let the answer, a failed step
+ *  or a stop act on a tool call the history does not have yet. So the wrapper
+ *  only records the park here; the main loop commits the box once its step is
+ *  saved, and a failed step simply drops it. Nested runs share their parent's
+ *  box, so a park raised any depth down waits for the main agent's step too. */
+export class ParkBox {
+    parks = [];
+    add(p) {
+        this.parks.push(p);
+    }
+    take() {
+        const out = this.parks;
+        this.parks = [];
+        return out;
+    }
+}
+/** Write every park the box holds: WAITING_FOR_INPUT, the INPUT_REQUIRED
+ *  request and its expiry job (see parkForApproval). Called once the step that
+ *  raised them is durable. */
+export async function commitParks(deps, box) {
+    if (!box)
+        return;
+    for (const p of box.take())
+        await parkForApproval(deps, p);
+}
 /** Wrap every tool so a call can park (§2.5) instead of blocking. A marked
  *  tool parks BEFORE it runs: the request is persisted as INPUT_REQUIRED and
  *  the wrapper returns the park sentinel; the real tool runs when a human
@@ -46,7 +91,7 @@ export function withHitl(deps, threadId, tools, ctx) {
     const out = {};
     for (const [name, t] of Object.entries(tools)) {
         const park = async (toolCallId, args, request) => {
-            await parkForApproval(deps, {
+            const p = {
                 threadId,
                 toolCallId,
                 toolName: name,
@@ -57,7 +102,12 @@ export function withHitl(deps, threadId, tools, ctx) {
                 resume: ctx.resume,
                 ...(request.reason ? { reason: request.reason } : {}),
                 ...(request.ttlMs !== undefined ? { ttlMs: request.ttlMs } : {}),
-            });
+            };
+            // Written once the step is saved; with no box, at once.
+            if (ctx.parks)
+                ctx.parks.add(p);
+            else
+                await parkForApproval(deps, p);
             return { [HITL_PARKED]: toolCallId };
         };
         if (t?.requiresConfirmation) {
@@ -79,8 +129,21 @@ export function withHitl(deps, threadId, tools, ctx) {
                     return await execute(args, opts);
                 }
                 catch (err) {
-                    if (!(err instanceof ToolParkedError))
-                        throw err;
+                    // A tool that fails is news for the model, not the end of the run:
+                    // the error goes back as the call's result, worded exactly as the
+                    // Go runtime words it, and the model decides what to do next.
+                    // Thrown instead, the SDK would fail the whole step and spend a
+                    // retry on what may be a plain bad input.
+                    if (!(err instanceof ToolParkedError)) {
+                        // A stop is not the tool's failure: it ends the run, as it does
+                        // in Go, where the cancelled step never reaches the model.
+                        if (err instanceof RunStoppedError || opts?.abortSignal?.aborted)
+                            throw err;
+                        const message = err instanceof Error ? err.message : String(err);
+                        if (opts?.toolCallId)
+                            ctx.toolErrors?.set(opts.toolCallId, message);
+                        return `error: ${message}`;
+                    }
                     // A resumed call that parks again has nowhere to go: the verdict
                     // for this call is being consumed right now.
                     if (opts?.approval) {
@@ -111,8 +174,18 @@ export function withHitl(deps, threadId, tools, ctx) {
 export async function parkForApproval(deps, i) {
     const ttlMs = i.ttlMs && i.ttlMs > 0 ? i.ttlMs : deps.config.hitlTtlMs;
     const expiresAt = new Date(Date.now() + ttlMs).toISOString();
-    await deps.kv.set(`agent:state:${i.threadId}`, 'WAITING_FOR_INPUT');
-    await setThreadState(deps, i.threadId, 'WAITING_FOR_INPUT', i.resume.model);
+    // Only while the run still owns a going thread (§3.4). A step can park
+    // several calls, so the thread may already be WAITING. A run that was
+    // stopped meanwhile parks nothing: the stop has ended it, and a later prompt
+    // repairs the call it left without a result.
+    const parked = await transition(deps, i.threadId, {
+        from: ['RUNNING', 'WAITING_FOR_INPUT'],
+        to: 'WAITING_FOR_INPUT',
+        runId: i.resume.runId,
+        model: i.resume.model,
+    });
+    if (!parked)
+        return;
     await publish(deps, i.threadId, 'INPUT_REQUIRED', {
         toolCallId: i.toolCallId,
         toolName: i.toolName,
@@ -129,18 +202,24 @@ export async function parkForApproval(deps, i) {
         reason: i.reason ?? REASON_APPROVAL,
         expiresAt,
     });
-    await publish(deps, i.threadId, 'STATE_CHANGE', { state: 'WAITING_FOR_INPUT' });
+    // The park names its run and when the run started, like every other
+    // STATE_CHANGE, so a client keeps its timer without refetching history.
+    const runId = await currentRunId(deps, i.threadId);
+    await publish(deps, i.threadId, 'STATE_CHANGE', await runStatePayload(deps, 'WAITING_FOR_INPUT', runId));
     // Best-effort, and deliberately last. The park is ALREADY durable by this
     // point — state flipped on both homes, INPUT_REQUIRED on the event log — so
     // a queue that cannot schedule must not be allowed to throw back through the
     // tool call and fail the run. Reclamation (§2.5) covers the thread instead.
     //
     // Arriving early is equally harmless: an unexpired, unanswered request
-    // resolves to nothing and the job is a no-op (see resumePendingHitl).
+    // resolves to nothing and the job is a no-op (see resumePendingHitl). The
+    // row is keyed so an answer can withdraw it, and it queues behind every user
+    // message: an expiry that came due is never urgent.
     try {
-        await deps.queue.enqueue({
+        await enqueueJob(deps, {
+            kind: 'expiry',
             threadId: i.threadId,
-            runId: await currentRunId(deps, i.threadId),
+            runId,
             model: i.resume.model,
             agent: i.resume.agent,
             ...(i.resume.tokenBudget !== undefined ? { tokenBudget: i.resume.tokenBudget } : {}),
@@ -149,10 +228,18 @@ export async function parkForApproval(deps, i) {
                 : {}),
             ...(i.resume.providerOptions ? { providerOptions: i.resume.providerOptions } : {}),
             ...(i.resume.state ? { state: i.resume.state } : {}),
-        }, { delaySeconds: Math.ceil((ttlMs + deps.config.reclaimGraceMs) / 1000) });
+            ...(i.resume.maxSteps ? { maxSteps: i.resume.maxSteps } : {}),
+            ...(i.resume.dispatchedAt ? { dispatchedAt: i.resume.dispatchedAt } : {}),
+        }, {
+            delaySeconds: Math.ceil((ttlMs + deps.config.reclaimGraceMs) / 1000),
+            key: expiryJobKey(i.toolCallId), priority: PRIORITY_LOW,
+        });
     }
-    catch {
+    catch (err) {
         // No expiry scheduled — the thread still heals on first touch (§2.5).
+        if (!(err instanceof DuplicateJobError)) {
+            (deps.log ?? console).warn?.('park expiry not scheduled; reclamation covers the thread', { threadId: i.threadId, toolCallId: i.toolCallId, err });
+        }
     }
 }
 /** When a park stops being answerable, epoch ms. */
@@ -183,6 +270,7 @@ function fromInputRequired(pending) {
         requestedAt: new Date(pending.createdAt).getTime(),
         ...(Number.isFinite(expiresAt) ? { expiresAt } : {}),
         ...(p.reason ? { reason: p.reason } : {}),
+        ...(p.resume ? { resume: p.resume } : {}),
     };
 }
 /** Every approval on the thread that is still open (§2.7).
@@ -207,9 +295,25 @@ export async function loadOpenHitls(deps, threadId) {
                 answered.add(id);
         }
     }
-    return requested
-        .map((e) => fromInputRequired(e))
-        .filter((p) => !answered.has(p.toolCallId) && !expired.has(p.toolCallId));
+    // Only the current run's parks. One an earlier run left behind can never be
+    // answered: the run failed, or an edit cut its turns out of the history,
+    // and its tool call may not even exist any more.
+    const current = await currentRunId(deps, threadId);
+    const open = [];
+    for (const e of requested) {
+        const p = fromInputRequired(e);
+        if (current && p.resume?.runId && p.resume.runId !== current)
+            continue;
+        if (!answered.has(p.toolCallId) && !expired.has(p.toolCallId)) {
+            open.push(p);
+            continue;
+        }
+        // Settled at its own level; is anything above still waiting?
+        const waiting = p.frames.findIndex((f) => !answered.has(f.toolCallId));
+        if (waiting >= 0)
+            open.push({ ...p, landed: true, resumeFrame: waiting });
+    }
+    return open;
 }
 /** The §5.4 behavior: heal orphans first (§2.5), then record the answer in
  *  the handoff key and resume the run segment via the queue (§2.8) — the
@@ -223,7 +327,7 @@ export async function respond(deps, input) {
     // step can park several nested runs at once, and each is answered on its
     // own. The run resumes when the last of them is settled.
     const open = await loadOpenHitls(deps, input.threadId);
-    const match = open.find((p) => p.toolCallId === input.toolCallId);
+    const match = open.find((p) => p.toolCallId === input.toolCallId && !p.landed);
     if (thread?.state !== 'WAITING_FOR_INPUT' || !match) {
         return { delivered: false, error: 'No matching pending input request' };
     }
@@ -231,7 +335,12 @@ export async function respond(deps, input) {
     // key vanishing is what makes the resumed segment treat the request as
     // unanswered (§2.5)
     const remainingSec = Math.max(60, Math.floor((hitlDeadline(match, deps.config) - Date.now()) / 1000));
-    await deps.kv.set(hitlKey(input.toolCallId), JSON.stringify({ approved: input.approved, payload: input.payload }), { exSeconds: remainingSec });
+    // The first answer wins. A repeat, from a second tab or a retry, must not
+    // overwrite it: an approval that can be rewritten after it was taken is a
+    // suggestion, not an approval.
+    const written = await deps.kv.set(hitlKey(input.toolCallId), JSON.stringify({ approved: input.approved, payload: input.payload }), { exSeconds: remainingSec, onlyIfNotExists: true });
+    if (!written)
+        return { delivered: false, error: 'This request was already answered' };
     // Bus-only fast-path notice (seq 0 = never persisted) for live UIs (§2.5)
     await deps.bus.publish(input.threadId, {
         threadId: input.threadId,
@@ -250,23 +359,42 @@ export async function respond(deps, input) {
     // park's expiry job are the same run, and the lock must be able to tell
     // that. Bumping here would let both run and reply twice (§2.5).
     const runId = await currentRunId(deps, input.threadId);
-    await deps.queue.enqueue({
-        threadId: input.threadId,
-        runId,
-        model: resume?.model ?? thread.model,
-        ...(resume
-            ? {
-                agent: resume.agent,
-                ...(resume.tokenBudget !== undefined ? { tokenBudget: resume.tokenBudget } : {}),
-                ...(resume.costBudgetMicros !== undefined
-                    ? { costBudgetMicros: resume.costBudgetMicros }
-                    : {}),
-                ...(resume.providerOptions ? { providerOptions: resume.providerOptions } : {}),
-                // The answer resumes the SAME run, so it must scope storage the same
-                // way the parked segment did (§2.10).
-                ...(resume.state ? { state: resume.state } : {}),
-            }
-            : {}),
+    try {
+        await enqueueJob(deps, {
+            kind: 'resume',
+            threadId: input.threadId,
+            runId,
+            model: resume?.model ?? thread.model,
+            ...(resume
+                ? {
+                    agent: resume.agent,
+                    ...(resume.tokenBudget !== undefined ? { tokenBudget: resume.tokenBudget } : {}),
+                    ...(resume.costBudgetMicros !== undefined
+                        ? { costBudgetMicros: resume.costBudgetMicros }
+                        : {}),
+                    ...(resume.providerOptions ? { providerOptions: resume.providerOptions } : {}),
+                    // The answer resumes the SAME run, so it must scope storage the same
+                    // way the parked segment did (§2.10).
+                    ...(resume.state ? { state: resume.state } : {}),
+                    ...(resume.maxSteps ? { maxSteps: resume.maxSteps } : {}),
+                    ...(resume.dispatchedAt ? { dispatchedAt: resume.dispatchedAt } : {}),
+                }
+                : {}),
+            // One resume row per answer, keyed on the call: a second enqueue for the
+            // same answer is refused by the queue itself.
+        }, { key: resumeJobKey(input.toolCallId) });
+    }
+    catch (err) {
+        if (err instanceof DuplicateJobError)
+            return { delivered: false, error: 'This request was already answered' };
+        // The answer is withdrawn so a retry of the request can land it.
+        await deps.kv.del(hitlKey(input.toolCallId)).catch(() => undefined);
+        throw new Error(`resume dispatch: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // The park's own deadline is answered for: its row is withdrawn rather than
+    // left to be delivered as a no-op. Best-effort, like the row itself.
+    await deps.queue.cancel(expiryJobKey(input.toolCallId)).catch((err) => {
+        (deps.log ?? console).warn?.('park expiry row not withdrawn', { threadId: input.threadId, toolCallId: input.toolCallId, err });
     });
     return { delivered: true };
 }

package/dist/core/hitl.js.map

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

package/dist/core/keys.d.ts

@@ -9,10 +9,28 @@ import type { RuntimePorts } from '../ports/runtime.js';
  *  This key only moves forward. A worker whose id no longer matches knows it
  *  has been replaced, whatever the state key says. */
 export declare const runIdKey: (threadId: string) => string;
-/** Re-dispatch counter for a job that keeps finding the run lock held by an
- *  OLDER run (§2.8). Separate from `agent:attempts:` — a blocked job has not
- *  failed, it simply has not started yet. */
-export declare const redriveKey: (threadId: string) => string;
+/** Counts §2.8 failure retries of ONE run. Keyed by the run, so a new run on
+ *  the thread starts with a full budget by construction and nothing an older
+ *  run banked can reach it. A legacy job without a run id keys it by the
+ *  thread instead; see `counterScope`. */
+export declare const attemptsKey: (scope: string) => string;
+/** Re-dispatch counter for a job that keeps finding the run lock held (§2.8).
+ *  Separate from the attempts key — a blocked job has not failed, it simply
+ *  has not started yet. Keyed by the run, like `attemptsKey`. */
+export declare const redriveKey: (scope: string) => string;
+/** What the retry counters are keyed by: the run id, or the thread id for a
+ *  legacy dispatch that has none. */
+export declare const counterScope: (threadId: string, runId?: string) => string;
+/** How long a retry counter lives when nothing clears it: long past any retry
+ *  backoff, short enough that a counter a crash left behind does not sit in
+ *  the kv for ever. */
+export declare const COUNTER_TTL_SECONDS: number;
+/** How long a thread's hot keys (state, current run, event seq) live after
+ *  they were last written. The durable row is the truth; these only save a
+ *  read, so a thread idle past this simply reads storage again, and its seq
+ *  counter carries on from the stored events (see nextSeq). Without an
+ *  expiry, every thread ever run keeps three keys in the kv for ever. */
+export declare const THREAD_KEY_TTL_SECONDS: number;
 /** The run that owns the thread right now, or null on a thread that predates
  *  run ids. Resuming a parked run (§2.5) REUSES this — a resume is the same
  *  run continuing, not a new one, so it must never bump the id. */

package/dist/core/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/core/keys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;sDAQsD;AACtD,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,WAA4B,CAAC;AAEtE;;6CAE6C;AAC7C,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,WAAgC,CAAC;AAE5E;;mEAEmE;AACnE,wBAAsB,YAAY,CAChC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE7B;AAED;;;;qCAIqC;AACrC,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIpF"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/core/keys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;sDAQsD;AACtD,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,WAA4B,CAAC;AAEtE;;;0CAG0C;AAC1C,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,WAA8B,CAAC;AAExE;;iEAEiE;AACjE,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,WAA6B,CAAC;AAEtE;qCACqC;AACrC,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,EAAE,QAAQ,MAAM,WAAsB,CAAC;AAEpF;;uBAEuB;AACvB,eAAO,MAAM,mBAAmB,QAAc,CAAC;AAE/C;;;;yEAIyE;AACzE,eAAO,MAAM,sBAAsB,QAAoB,CAAC;AAExD;;mEAEmE;AACnE,wBAAsB,YAAY,CAChC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE7B;AAED;;;;qCAIqC;AACrC,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIpF"}

package/dist/core/keys.js

@@ -9,10 +9,28 @@ import { randomUUID } from 'node:crypto';
  *  This key only moves forward. A worker whose id no longer matches knows it
  *  has been replaced, whatever the state key says. */
 export const runIdKey = (threadId) => `agent:run:${threadId}`;
-/** Re-dispatch counter for a job that keeps finding the run lock held by an
- *  OLDER run (§2.8). Separate from `agent:attempts:` — a blocked job has not
- *  failed, it simply has not started yet. */
-export const redriveKey = (threadId) => `agent:redrive:${threadId}`;
+/** Counts §2.8 failure retries of ONE run. Keyed by the run, so a new run on
+ *  the thread starts with a full budget by construction and nothing an older
+ *  run banked can reach it. A legacy job without a run id keys it by the
+ *  thread instead; see `counterScope`. */
+export const attemptsKey = (scope) => `agent:attempts:${scope}`;
+/** Re-dispatch counter for a job that keeps finding the run lock held (§2.8).
+ *  Separate from the attempts key — a blocked job has not failed, it simply
+ *  has not started yet. Keyed by the run, like `attemptsKey`. */
+export const redriveKey = (scope) => `agent:redrive:${scope}`;
+/** What the retry counters are keyed by: the run id, or the thread id for a
+ *  legacy dispatch that has none. */
+export const counterScope = (threadId, runId) => runId || threadId;
+/** How long a retry counter lives when nothing clears it: long past any retry
+ *  backoff, short enough that a counter a crash left behind does not sit in
+ *  the kv for ever. */
+export const COUNTER_TTL_SECONDS = 6 * 60 * 60;
+/** How long a thread's hot keys (state, current run, event seq) live after
+ *  they were last written. The durable row is the truth; these only save a
+ *  read, so a thread idle past this simply reads storage again, and its seq
+ *  counter carries on from the stored events (see nextSeq). Without an
+ *  expiry, every thread ever run keeps three keys in the kv for ever. */
+export const THREAD_KEY_TTL_SECONDS = 30 * 24 * 60 * 60;
 /** The run that owns the thread right now, or null on a thread that predates
  *  run ids. Resuming a parked run (§2.5) REUSES this — a resume is the same
  *  run continuing, not a new one, so it must never bump the id. */
@@ -26,7 +44,7 @@ export async function currentRunId(deps, threadId) {
  *  new run is about to overwrite. */
 export async function claimRun(deps, threadId) {
     const runId = randomUUID();
-    await deps.kv.set(runIdKey(threadId), runId);
+    await deps.kv.set(runIdKey(threadId), runId, { exSeconds: THREAD_KEY_TTL_SECONDS });
     return runId;
 }
 //# sourceMappingURL=keys.js.map

package/dist/core/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/core/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;;;sDAQsD;AACtD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,aAAa,QAAQ,EAAE,CAAC;AAEtE;;6CAE6C;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,iBAAiB,QAAQ,EAAE,CAAC;AAE5E;;mEAEmE;AACnE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAkB,EAClB,QAAgB;IAEhB,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAC9D,CAAC;AAED;;;;qCAIqC;AACrC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB,EAAE,QAAgB;IACjE,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/core/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;;;sDAQsD;AACtD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,aAAa,QAAQ,EAAE,CAAC;AAEtE;;;0CAG0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,kBAAkB,KAAK,EAAE,CAAC;AAExE;;iEAEiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,iBAAiB,KAAK,EAAE,CAAC;AAEtE;qCACqC;AACrC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,KAAc,EAAE,EAAE,CAAC,KAAK,IAAI,QAAQ,CAAC;AAEpF;;uBAEuB;AACvB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;AAE/C;;;;yEAIyE;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAExD;;mEAEmE;AACnE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAkB,EAClB,QAAgB;IAEhB,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAC9D,CAAC;AAED;;;;qCAIqC;AACrC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB,EAAE,QAAgB;IACjE,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACpF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/lease.d.ts

@@ -0,0 +1,46 @@
+import type { RuntimePorts } from '../ports/runtime.js';
+import type { EnqueueOptions } from '../ports/queue.js';
+import type { RunJob } from './types.js';
+/** The one way the platform puts a job on the queue: it stamps the job with a
+ *  fresh `dispatchId`, so every enqueue is a delivery of its own and only the
+ *  queue's own redelivery repeats one (§3.4). */
+export declare function enqueueJob(deps: RuntimePorts, job: RunJob, opts?: EnqueueOptions): Promise<void>;
+/** The per-thread run lock (§3.4). */
+export declare const runLockKey: (threadId: string) => string;
+export declare function parseLockValue(value: string | null): {
+    runId: string | null;
+    dispatchId: string | null;
+};
+/** Thrown out of a loop whose lease was lost between steps: another worker
+ *  may own the thread, so this one must not write another step to it. */
+export declare class RunLockLostError extends Error {
+    constructor();
+}
+/** One holder's grip on a thread's run lock. */
+export declare class Lease {
+    private readonly deps;
+    private readonly key;
+    private readonly value;
+    private lostFlag;
+    private timer?;
+    private released;
+    private constructor();
+    /** Take the thread's run lock for a run and one delivery of it; null when
+     *  someone else holds it. */
+    static acquire(deps: RuntimePorts, threadId: string, runId: string | undefined, dispatchId: string | undefined): Promise<Lease | null>;
+    /** The lease could not be kept. Another worker may own the thread by now,
+     *  so the holder must stop writing to it. */
+    get lost(): boolean;
+    /** Renew in the background until `release`, the way a queue renews a job
+     *  lease: an expired lock then means a dead worker and nothing else.
+     *  `onLost` runs once, when the lease cannot be kept — the key is gone or
+     *  holds another holder's value, or no renewal has landed for two thirds of
+     *  the lease (it is then close to lapsing, and another worker may take it
+     *  before the next try). */
+    keep(onLost?: () => void): void;
+    /** Stop renewing and free the lock, only while it is still this holder's.
+     *  Safe to call more than once. */
+    release(): Promise<void>;
+    private stop;
+}
+//# sourceMappingURL=lease.d.ts.map

package/dist/core/lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease.d.ts","sourceRoot":"","sources":["../../src/core/lease.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;iDAEiD;AACjD,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG;AAED,sCAAsC;AACtC,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,WAA6B,CAAC;AAiBzE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAKxG;AAED;yEACyE;AACzE,qBAAa,gBAAiB,SAAQ,KAAK;;CAK1C;AAED,gDAAgD;AAChD,qBAAa,KAAK;IAMd,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAPxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAC,CAAiC;IAC/C,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO;IAMP;iCAC6B;WAChB,OAAO,CAClB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAUxB;iDAC6C;IAC7C,IAAI,IAAI,IAAI,OAAO,CAElB;IAED;;;;;gCAK4B;IAC5B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAwD/B;uCACmC;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,OAAO,CAAC,IAAI;CAIb"}