@yolk-sdk/vercel-workflows 0.1.0-canary.48 → 0.1.0-canary.49

package/README.md

@@ -60,7 +60,7 @@ queues, hooks, or stream storage.
 - tool batch result: return one ordered tool-result message per host call, including failed `isError` results
 - awaiting-input state: carry pending HITL hook data, wait through `awaitInput`, then rerun the
   same tool batch with accumulated responses
-- close step: flush/close output stream
+- close step: flush/close output stream after a successful final model step
 - terminal status: completed, step failure, await-input failure, close failure, or max turns exceeded
 
 Continuation state stays plain serializable data for Workflow persistence.
@@ -71,30 +71,23 @@ Host apps keep concrete Workflow directives local and pass them into the package
 
 ```ts
 import { createHook } from 'workflow'
-import { Effect } from 'effect'
 import { runVercelAgentWorkflow } from '@yolk-sdk/vercel-workflows'
 
-const workflowStep = <A>(body: () => Promise<A>) =>
-  Effect.tryPromise({ try: body, catch: error => error })
-
 export async function runAgentWorkflow(input: { request: unknown; context: unknown }) {
   'use workflow'
 
-  return await Effect.runPromise(
-    runVercelAgentWorkflow({
-      input,
-      runModelStep: input => workflowStep(() => runModelStep(input)),
-      runToolBatchStep: input => workflowStep(() => runToolBatchStep(input)),
-      closeStream: workflowStep(closeStream),
-      writeError: error => workflowStep(() => writeError(error)),
-      awaitInput: awaitingInput =>
-        workflowStep(async () => {
-          using hook = createHook<unknown>({ token: awaitingInput.hookToken })
-
-          return await hook
-        })
-    })
-  )
+  return await runVercelAgentWorkflow({
+    input,
+    runModelStep,
+    runToolBatchStep,
+    closeStream,
+    writeError,
+    awaitInput: async awaitingInput => {
+      using hook = createHook<unknown>({ token: awaitingInput.hookToken })
+
+      return await hook
+    }
+  })
 }
 ```
 
@@ -118,6 +111,8 @@ tokens that the resume side can reconstruct or store.
 
 Default retry policy is `noWorkflowStepRetry` (`maxAttempts: 1`). Retries are opt-in because
 streamed retries can duplicate chunks unless host/client de-dupe is ready.
+Finite `maxAttempts` values are floored and clamped to at least one; non-finite values normalize to
+one. Retries have no built-in backoff.
 
 ## Durable stream events
 
@@ -129,7 +124,9 @@ Use `writeDurableAgentEvent` to assign deterministic ids and write NDJSON:
 
 ```ts
 const state = makeDurableAgentEventSequencerState(eventSequence)
-const sequenced = yield* writeDurableAgentEvent({
+const sequenced =
+  yield *
+  writeDurableAgentEvent({
   writer,
   event,
   streamId: `workflow:${runId}`,
@@ -149,12 +146,23 @@ active-run locking, stale-run guards, and cancellation behavior.
 
 ## Terminal barriers
 
-For durable host streams, terminal events are commit barriers. Emit live/progress events first,
-commit canonical host state, then write the terminal event. The surrounding workflow loop owns the
-single final stream close:
+For durable host streams, protocol terminal events are commit barriers. Emit live/progress events
+first, commit canonical host state, then write the event.
+
+“Terminal” in `isTerminalAgentEvent` means a logical client-consumption boundary, not necessarily a
+final Workflow state. Final callback ownership is:
+
+```txt
+AgentEnd: durable completion commit -> AgentEnd -> closeStream
+AgentError: failure commit/mapping -> AgentError -> writeError-owned close
+```
+
+`AgentAwaitingInput` is terminal for the current client consumption window but resumable for the
+Workflow run. Persist pending HITL state and write it without finalizing the durable stream solely
+because `isTerminalAgentEvent` returns true:
 
 ```txt
-live events -> host durable commit -> terminal event -> workflow-owned close
+persist pending HITL -> AgentAwaitingInput -> release writer lock (do not close) -> await hook -> continue
 ```
 
 This lets clients stop consuming at a protocol-terminal event and immediately revalidate or reconnect
@@ -165,7 +173,9 @@ Use `commitThenWriteTerminalEvent` when a step must commit host state before wri
 event:
 
 ```ts
-const result = yield* commitThenWriteTerminalEvent({
+const result =
+  yield *
+  commitThenWriteTerminalEvent({
   terminal,
   commit: persistState,
   write: event => writeDurableAgentEvent({ writer, event, streamId, turn, state }),
@@ -175,8 +185,14 @@ const result = yield* commitThenWriteTerminalEvent({
 ```
 
 The helper never writes the success terminal before `commit` succeeds. If `commit` fails, it writes
-the host-provided terminal error event instead. The helper does not close writers; close once in the
-surrounding workflow loop or stream owner after terminal handling settles.
+the host-provided terminal error event instead. It can protect either a final event or an
+`AgentAwaitingInput` persistence barrier; it never decides closure from `_tag` and never closes
+writers.
+
+`runVercelAgentWorkflow` calls `closeStream` only after `runModelStep` returns `done: true`. On model,
+tool, await-input, or max-turn failure it calls `writeError` best-effort and returns without calling
+`closeStream`; `writeError` must write a safe run-final error and attempt to close that failure path.
+Never close on resumable `AgentAwaitingInput`.
 
 ## Host responsibilities
 
@@ -188,6 +204,8 @@ surrounding workflow loop or stream owner after terminal handling settles.
 - Emit replay-safe event ids for durable streams; scope stream ids per independent run and de-dupe
   by `eventId` client-side.
 - Write durable terminal events only after host persistence has settled.
+- Implement `closeStream` for successful final closure and `writeError` for safe final error write
+  plus failure closure. Release, but do not close, the writer after `AgentAwaitingInput`.
 - Test directive behavior with `@workflow/vitest` when changing package-owned Workflow files.
 
 ## Boundaries

package/dist/workflow-loop.d.mts

@@ -93,9 +93,14 @@ type VercelAgentWorkflowLoopConfig = {
   readonly input: VercelAgentWorkflowInput;
   readonly maxTurns?: number;
   readonly runModelStep: (input: VercelAgentWorkflowModelStepInput) => Promise<VercelAgentWorkflowModelStepResult>;
-  readonly runToolBatchStep: (input: VercelAgentWorkflowToolBatchStepInput) => Promise<VercelAgentWorkflowToolBatchStepResult>;
+  readonly runToolBatchStep: (input: VercelAgentWorkflowToolBatchStepInput) => Promise<VercelAgentWorkflowToolBatchStepResult>; /** Called only after a model step returns `done: true`. */
   readonly closeStream: () => Promise<void>;
-  readonly writeError: (error: unknown) => Promise<void>;
+  /**
+   * Best-effort final failure handler. It must write a safe final error and
+   * close the failure stream; rejection is suppressed in favor of the
+   * original structured run result.
+   */
+  readonly writeError: (error: unknown) => Promise<void>; /** A successful await suspends/resumes without invoking either finalizer. */
   readonly awaitInput?: (input: VercelAgentWorkflowAwaitingInput) => Promise<unknown>;
   readonly modelStepRetry?: VercelAgentWorkflowStepRetryPolicy;
   readonly toolBatchStepRetry?: VercelAgentWorkflowStepRetryPolicy;

package/dist/workflow-loop.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-loop.d.mts","names":[],"sources":["../src/workflow-loop.ts"],"mappings":"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"}
+{"version":3,"file":"workflow-loop.d.mts","names":[],"sources":["../src/workflow-loop.ts"],"mappings":"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"}

package/dist/workflow-loop.mjs

@@ -11,7 +11,10 @@ const settleWorkflowStep = (promise) => promise.then((value) => ({
 const workflowMaxTurnsError = (maxTurns) => /* @__PURE__ */ new Error(`Vercel agent workflow exceeded max turns: ${maxTurns}`);
 const writeErrorSafely = (writeError, error) => writeError(error).catch(() => void 0);
 const missingAwaitInputHandlerError = () => /* @__PURE__ */ new Error("Vercel agent workflow awaiting input requested but no awaitInput handler is configured");
-const maxRetryAttempts = (policy) => Math.max(1, Math.floor(policy?.maxAttempts ?? noWorkflowStepRetry.maxAttempts));
+const maxRetryAttempts = (policy) => {
+	const configured = policy?.maxAttempts ?? noWorkflowStepRetry.maxAttempts;
+	return Number.isFinite(configured) ? Math.max(1, Math.floor(configured)) : 1;
+};
 async function retryWorkflowStep(runStep, policy) {
 	const maxAttempts = maxRetryAttempts(policy);
 	let attempt = 1;

package/dist/workflow-loop.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-loop.mjs","names":[],"sources":["../src/workflow-loop.ts"],"sourcesContent":["export type VercelAgentWorkflowInput = {\n  readonly request: unknown\n  readonly context: unknown\n}\n\nexport type SerializableWorkflowState = {\n  readonly request: unknown\n  readonly messages?: ReadonlyArray<unknown>\n  readonly createdMessages: ReadonlyArray<unknown>\n  readonly usage?: unknown\n  readonly turn: number\n  readonly eventSequence?: number\n}\n\nexport type VercelAgentWorkflowModelStepInput = {\n  readonly context: unknown\n  readonly state: SerializableWorkflowState\n}\n\nexport type VercelAgentWorkflowModelStepResult = {\n  readonly done: boolean\n  readonly messages: ReadonlyArray<unknown>\n  readonly createdMessages: ReadonlyArray<unknown>\n  readonly toolCalls: ReadonlyArray<unknown>\n  readonly usage: unknown\n  readonly turn: number\n  readonly eventSequence?: number\n}\n\nexport type VercelAgentWorkflowToolBatchStepInput = {\n  readonly context: unknown\n  readonly request: unknown\n  readonly calls: ReadonlyArray<unknown>\n  readonly createdMessages: ReadonlyArray<unknown>\n  readonly hitlResponses?: ReadonlyArray<unknown>\n  readonly usage?: unknown\n  readonly turn?: number\n  readonly eventSequence?: number\n}\n\nexport type VercelAgentWorkflowAwaitingInput = {\n  readonly hookToken: string\n  readonly requests: ReadonlyArray<unknown>\n  readonly messages: ReadonlyArray<unknown>\n  readonly usage: unknown\n  readonly turns: number\n  readonly eventSequence?: number\n}\n\nexport type VercelAgentWorkflowToolBatchStepResult = {\n  readonly messages: ReadonlyArray<unknown>\n  readonly createdMessages: ReadonlyArray<unknown>\n  readonly awaitingInput?: VercelAgentWorkflowAwaitingInput\n  readonly eventSequence?: number\n}\n\nexport type WorkflowStepResult<A> =\n  | {\n      readonly _tag: 'Success'\n      readonly value: A\n    }\n  | {\n      readonly _tag: 'Failure'\n      readonly error: unknown\n    }\n\nexport type VercelAgentWorkflowStepRetryPolicy = {\n  readonly maxAttempts: number\n}\n\nexport type VercelAgentWorkflowRunResult =\n  | {\n      readonly _tag: 'Completed'\n      readonly turns: number\n      readonly state: SerializableWorkflowState\n    }\n  | {\n      readonly _tag: 'ModelStepFailed'\n      readonly turn: number\n      readonly error: unknown\n      readonly state: SerializableWorkflowState\n    }\n  | {\n      readonly _tag: 'ToolBatchStepFailed'\n      readonly turn: number\n      readonly error: unknown\n      readonly state: SerializableWorkflowState\n    }\n  | {\n      readonly _tag: 'AwaitInputFailed'\n      readonly turn: number\n      readonly error: unknown\n      readonly awaitingInput: VercelAgentWorkflowAwaitingInput\n      readonly state: SerializableWorkflowState\n    }\n  | {\n      readonly _tag: 'CloseStreamFailed'\n      readonly turns: number\n      readonly error: unknown\n      readonly state: SerializableWorkflowState\n    }\n  | {\n      readonly _tag: 'MaxTurnsExceeded'\n      readonly maxTurns: number\n      readonly error: Error\n      readonly state: SerializableWorkflowState\n    }\n\nexport type VercelAgentWorkflowLoopConfig = {\n  readonly input: VercelAgentWorkflowInput\n  readonly maxTurns?: number\n  readonly runModelStep: (\n    input: VercelAgentWorkflowModelStepInput\n  ) => Promise<VercelAgentWorkflowModelStepResult>\n  readonly runToolBatchStep: (\n    input: VercelAgentWorkflowToolBatchStepInput\n  ) => Promise<VercelAgentWorkflowToolBatchStepResult>\n  readonly closeStream: () => Promise<void>\n  readonly writeError: (error: unknown) => Promise<void>\n  readonly awaitInput?: (input: VercelAgentWorkflowAwaitingInput) => Promise<unknown>\n  readonly modelStepRetry?: VercelAgentWorkflowStepRetryPolicy\n  readonly toolBatchStepRetry?: VercelAgentWorkflowStepRetryPolicy\n  readonly awaitInputRetry?: VercelAgentWorkflowStepRetryPolicy\n  readonly closeStreamRetry?: VercelAgentWorkflowStepRetryPolicy\n}\n\nexport const defaultMaxWorkflowTurns = 500\nexport const noWorkflowStepRetry: VercelAgentWorkflowStepRetryPolicy = { maxAttempts: 1 }\n\nexport const settleWorkflowStep = <A>(promise: Promise<A>): Promise<WorkflowStepResult<A>> =>\n  promise.then(\n    value => ({ _tag: 'Success', value }),\n    error => ({ _tag: 'Failure', error })\n  )\n\nconst workflowMaxTurnsError = (maxTurns: number) =>\n  new Error(`Vercel agent workflow exceeded max turns: ${maxTurns}`)\n\nconst writeErrorSafely = (writeError: (error: unknown) => Promise<void>, error: unknown) =>\n  writeError(error).catch(() => undefined)\n\nconst missingAwaitInputHandlerError = () =>\n  new Error(\n    'Vercel agent workflow awaiting input requested but no awaitInput handler is configured'\n  )\n\nconst maxRetryAttempts = (policy: VercelAgentWorkflowStepRetryPolicy | undefined) =>\n  Math.max(1, Math.floor(policy?.maxAttempts ?? noWorkflowStepRetry.maxAttempts))\n\nexport async function retryWorkflowStep<A>(\n  runStep: () => Promise<A>,\n  policy?: VercelAgentWorkflowStepRetryPolicy\n): Promise<A> {\n  const maxAttempts = maxRetryAttempts(policy)\n\n  let attempt = 1\n\n  for (;;) {\n    try {\n      return await runStep()\n    } catch (error) {\n      if (attempt >= maxAttempts) {\n        throw error\n      }\n\n      attempt += 1\n    }\n  }\n}\n\nexport async function runVercelAgentWorkflow(\n  config: VercelAgentWorkflowLoopConfig\n): Promise<VercelAgentWorkflowRunResult> {\n  const {\n    input,\n    maxTurns: configuredMaxTurns,\n    runModelStep,\n    runToolBatchStep,\n    closeStream,\n    writeError,\n    awaitInput,\n    modelStepRetry,\n    toolBatchStepRetry,\n    awaitInputRetry,\n    closeStreamRetry\n  } = config\n  let state: SerializableWorkflowState = {\n    request: input.request,\n    createdMessages: [],\n    turn: 1,\n    eventSequence: 0\n  }\n  const maxTurns = configuredMaxTurns ?? defaultMaxWorkflowTurns\n\n  for (let step = 0; step < maxTurns; step++) {\n    const modelResult = await settleWorkflowStep(\n      retryWorkflowStep(() => runModelStep({ context: input.context, state }), modelStepRetry)\n    )\n\n    if (modelResult._tag === 'Failure') {\n      await writeErrorSafely(writeError, modelResult.error)\n      return {\n        _tag: 'ModelStepFailed',\n        turn: state.turn,\n        error: modelResult.error,\n        state\n      }\n    }\n\n    if (modelResult.value.done) {\n      const closeResult = await settleWorkflowStep(retryWorkflowStep(closeStream, closeStreamRetry))\n\n      if (closeResult._tag === 'Failure') {\n        await writeErrorSafely(writeError, closeResult.error)\n\n        return {\n          _tag: 'CloseStreamFailed',\n          turns: modelResult.value.turn,\n          error: closeResult.error,\n          state\n        }\n      }\n\n      return {\n        _tag: 'Completed',\n        turns: modelResult.value.turn,\n        state\n      }\n    }\n\n    let completedToolsResult: VercelAgentWorkflowToolBatchStepResult | undefined\n    let toolHitlResponses: ReadonlyArray<unknown> = []\n    let toolEventSequence = modelResult.value.eventSequence ?? state.eventSequence\n\n    for (;;) {\n      const toolsResult = await settleWorkflowStep(\n        retryWorkflowStep(\n          () =>\n            runToolBatchStep({\n              context: input.context,\n              request: input.request,\n              calls: modelResult.value.toolCalls,\n              createdMessages: modelResult.value.createdMessages,\n              hitlResponses: toolHitlResponses,\n              usage: modelResult.value.usage,\n              turn: modelResult.value.turn,\n              eventSequence: toolEventSequence\n            }),\n          toolBatchStepRetry\n        )\n      )\n\n      if (toolsResult._tag === 'Failure') {\n        await writeErrorSafely(writeError, toolsResult.error)\n\n        return {\n          _tag: 'ToolBatchStepFailed',\n          turn: modelResult.value.turn,\n          error: toolsResult.error,\n          state\n        }\n      }\n\n      if (toolsResult.value.awaitingInput === undefined) {\n        completedToolsResult = toolsResult.value\n        break\n      }\n\n      const awaitingInput = toolsResult.value.awaitingInput\n      toolEventSequence =\n        awaitingInput.eventSequence ?? toolsResult.value.eventSequence ?? toolEventSequence\n\n      const hitlResponse = await settleWorkflowStep(\n        retryWorkflowStep(() => {\n          if (awaitInput === undefined) {\n            return Promise.reject(missingAwaitInputHandlerError())\n          }\n\n          return awaitInput(awaitingInput)\n        }, awaitInputRetry)\n      )\n\n      if (hitlResponse._tag === 'Failure') {\n        await writeErrorSafely(writeError, hitlResponse.error)\n\n        return {\n          _tag: 'AwaitInputFailed',\n          turn: modelResult.value.turn,\n          error: hitlResponse.error,\n          awaitingInput,\n          state\n        }\n      }\n\n      toolHitlResponses = [...toolHitlResponses, hitlResponse.value]\n    }\n\n    if (completedToolsResult === undefined) {\n      const error = new Error('Vercel agent workflow tool batch did not complete')\n      await writeErrorSafely(writeError, error)\n\n      return {\n        _tag: 'ToolBatchStepFailed',\n        turn: modelResult.value.turn,\n        error,\n        state\n      }\n    }\n\n    state = {\n      request: input.request,\n      messages: [...modelResult.value.messages, ...completedToolsResult.messages],\n      createdMessages: completedToolsResult.createdMessages,\n      usage: modelResult.value.usage,\n      turn: modelResult.value.turn + 1,\n      eventSequence: completedToolsResult.eventSequence ?? toolEventSequence\n    }\n  }\n\n  const error = workflowMaxTurnsError(maxTurns)\n  await writeErrorSafely(writeError, error)\n\n  return {\n    _tag: 'MaxTurnsExceeded',\n    maxTurns,\n    error,\n    state\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflow-loop.mjs","names":[],"sources":["../src/workflow-loop.ts"],"sourcesContent":["export type VercelAgentWorkflowInput = {\n  readonly request: unknown\n  readonly context: unknown\n}\n\nexport type SerializableWorkflowState = {\n  readonly request: unknown\n  readonly messages?: ReadonlyArray<unknown>\n  readonly createdMessages: ReadonlyArray<unknown>\n  readonly usage?: unknown\n  readonly turn: number\n  readonly eventSequence?: number\n}\n\nexport type VercelAgentWorkflowModelStepInput = {\n  readonly context: unknown\n  readonly state: SerializableWorkflowState\n}\n\nexport type VercelAgentWorkflowModelStepResult = {\n  readonly done: boolean\n  readonly messages: ReadonlyArray<unknown>\n  readonly createdMessages: ReadonlyArray<unknown>\n  readonly toolCalls: ReadonlyArray<unknown>\n  readonly usage: unknown\n  readonly turn: number\n  readonly eventSequence?: number\n}\n\nexport type VercelAgentWorkflowToolBatchStepInput = {\n  readonly context: unknown\n  readonly request: unknown\n  readonly calls: ReadonlyArray<unknown>\n  readonly createdMessages: ReadonlyArray<unknown>\n  readonly hitlResponses?: ReadonlyArray<unknown>\n  readonly usage?: unknown\n  readonly turn?: number\n  readonly eventSequence?: number\n}\n\nexport type VercelAgentWorkflowAwaitingInput = {\n  readonly hookToken: string\n  readonly requests: ReadonlyArray<unknown>\n  readonly messages: ReadonlyArray<unknown>\n  readonly usage: unknown\n  readonly turns: number\n  readonly eventSequence?: number\n}\n\nexport type VercelAgentWorkflowToolBatchStepResult = {\n  readonly messages: ReadonlyArray<unknown>\n  readonly createdMessages: ReadonlyArray<unknown>\n  readonly awaitingInput?: VercelAgentWorkflowAwaitingInput\n  readonly eventSequence?: number\n}\n\nexport type WorkflowStepResult<A> =\n  | {\n      readonly _tag: 'Success'\n      readonly value: A\n    }\n  | {\n      readonly _tag: 'Failure'\n      readonly error: unknown\n    }\n\nexport type VercelAgentWorkflowStepRetryPolicy = {\n  readonly maxAttempts: number\n}\n\nexport type VercelAgentWorkflowRunResult =\n  | {\n      readonly _tag: 'Completed'\n      readonly turns: number\n      readonly state: SerializableWorkflowState\n    }\n  | {\n      readonly _tag: 'ModelStepFailed'\n      readonly turn: number\n      readonly error: unknown\n      readonly state: SerializableWorkflowState\n    }\n  | {\n      readonly _tag: 'ToolBatchStepFailed'\n      readonly turn: number\n      readonly error: unknown\n      readonly state: SerializableWorkflowState\n    }\n  | {\n      readonly _tag: 'AwaitInputFailed'\n      readonly turn: number\n      readonly error: unknown\n      readonly awaitingInput: VercelAgentWorkflowAwaitingInput\n      readonly state: SerializableWorkflowState\n    }\n  | {\n      readonly _tag: 'CloseStreamFailed'\n      readonly turns: number\n      readonly error: unknown\n      readonly state: SerializableWorkflowState\n    }\n  | {\n      readonly _tag: 'MaxTurnsExceeded'\n      readonly maxTurns: number\n      readonly error: Error\n      readonly state: SerializableWorkflowState\n    }\n\nexport type VercelAgentWorkflowLoopConfig = {\n  readonly input: VercelAgentWorkflowInput\n  readonly maxTurns?: number\n  readonly runModelStep: (\n    input: VercelAgentWorkflowModelStepInput\n  ) => Promise<VercelAgentWorkflowModelStepResult>\n  readonly runToolBatchStep: (\n    input: VercelAgentWorkflowToolBatchStepInput\n  ) => Promise<VercelAgentWorkflowToolBatchStepResult>\n  /** Called only after a model step returns `done: true`. */\n  readonly closeStream: () => Promise<void>\n  /**\n   * Best-effort final failure handler. It must write a safe final error and\n   * close the failure stream; rejection is suppressed in favor of the\n   * original structured run result.\n   */\n  readonly writeError: (error: unknown) => Promise<void>\n  /** A successful await suspends/resumes without invoking either finalizer. */\n  readonly awaitInput?: (input: VercelAgentWorkflowAwaitingInput) => Promise<unknown>\n  readonly modelStepRetry?: VercelAgentWorkflowStepRetryPolicy\n  readonly toolBatchStepRetry?: VercelAgentWorkflowStepRetryPolicy\n  readonly awaitInputRetry?: VercelAgentWorkflowStepRetryPolicy\n  readonly closeStreamRetry?: VercelAgentWorkflowStepRetryPolicy\n}\n\nexport const defaultMaxWorkflowTurns = 500\nexport const noWorkflowStepRetry: VercelAgentWorkflowStepRetryPolicy = { maxAttempts: 1 }\n\nexport const settleWorkflowStep = <A>(promise: Promise<A>): Promise<WorkflowStepResult<A>> =>\n  promise.then(\n    value => ({ _tag: 'Success', value }),\n    error => ({ _tag: 'Failure', error })\n  )\n\nconst workflowMaxTurnsError = (maxTurns: number) =>\n  new Error(`Vercel agent workflow exceeded max turns: ${maxTurns}`)\n\nconst writeErrorSafely = (writeError: (error: unknown) => Promise<void>, error: unknown) =>\n  writeError(error).catch(() => undefined)\n\nconst missingAwaitInputHandlerError = () =>\n  new Error(\n    'Vercel agent workflow awaiting input requested but no awaitInput handler is configured'\n  )\n\nconst maxRetryAttempts = (policy: VercelAgentWorkflowStepRetryPolicy | undefined) => {\n  const configured = policy?.maxAttempts ?? noWorkflowStepRetry.maxAttempts\n\n  return Number.isFinite(configured) ? Math.max(1, Math.floor(configured)) : 1\n}\n\nexport async function retryWorkflowStep<A>(\n  runStep: () => Promise<A>,\n  policy?: VercelAgentWorkflowStepRetryPolicy\n): Promise<A> {\n  const maxAttempts = maxRetryAttempts(policy)\n\n  let attempt = 1\n\n  for (;;) {\n    try {\n      return await runStep()\n    } catch (error) {\n      if (attempt >= maxAttempts) {\n        throw error\n      }\n\n      attempt += 1\n    }\n  }\n}\n\nexport async function runVercelAgentWorkflow(\n  config: VercelAgentWorkflowLoopConfig\n): Promise<VercelAgentWorkflowRunResult> {\n  const {\n    input,\n    maxTurns: configuredMaxTurns,\n    runModelStep,\n    runToolBatchStep,\n    closeStream,\n    writeError,\n    awaitInput,\n    modelStepRetry,\n    toolBatchStepRetry,\n    awaitInputRetry,\n    closeStreamRetry\n  } = config\n  let state: SerializableWorkflowState = {\n    request: input.request,\n    createdMessages: [],\n    turn: 1,\n    eventSequence: 0\n  }\n  const maxTurns = configuredMaxTurns ?? defaultMaxWorkflowTurns\n\n  for (let step = 0; step < maxTurns; step++) {\n    const modelResult = await settleWorkflowStep(\n      retryWorkflowStep(() => runModelStep({ context: input.context, state }), modelStepRetry)\n    )\n\n    if (modelResult._tag === 'Failure') {\n      await writeErrorSafely(writeError, modelResult.error)\n      return {\n        _tag: 'ModelStepFailed',\n        turn: state.turn,\n        error: modelResult.error,\n        state\n      }\n    }\n\n    if (modelResult.value.done) {\n      const closeResult = await settleWorkflowStep(retryWorkflowStep(closeStream, closeStreamRetry))\n\n      if (closeResult._tag === 'Failure') {\n        await writeErrorSafely(writeError, closeResult.error)\n\n        return {\n          _tag: 'CloseStreamFailed',\n          turns: modelResult.value.turn,\n          error: closeResult.error,\n          state\n        }\n      }\n\n      return {\n        _tag: 'Completed',\n        turns: modelResult.value.turn,\n        state\n      }\n    }\n\n    let completedToolsResult: VercelAgentWorkflowToolBatchStepResult | undefined\n    let toolHitlResponses: ReadonlyArray<unknown> = []\n    let toolEventSequence = modelResult.value.eventSequence ?? state.eventSequence\n\n    for (;;) {\n      const toolsResult = await settleWorkflowStep(\n        retryWorkflowStep(\n          () =>\n            runToolBatchStep({\n              context: input.context,\n              request: input.request,\n              calls: modelResult.value.toolCalls,\n              createdMessages: modelResult.value.createdMessages,\n              hitlResponses: toolHitlResponses,\n              usage: modelResult.value.usage,\n              turn: modelResult.value.turn,\n              eventSequence: toolEventSequence\n            }),\n          toolBatchStepRetry\n        )\n      )\n\n      if (toolsResult._tag === 'Failure') {\n        await writeErrorSafely(writeError, toolsResult.error)\n\n        return {\n          _tag: 'ToolBatchStepFailed',\n          turn: modelResult.value.turn,\n          error: toolsResult.error,\n          state\n        }\n      }\n\n      if (toolsResult.value.awaitingInput === undefined) {\n        completedToolsResult = toolsResult.value\n        break\n      }\n\n      const awaitingInput = toolsResult.value.awaitingInput\n      toolEventSequence =\n        awaitingInput.eventSequence ?? toolsResult.value.eventSequence ?? toolEventSequence\n\n      const hitlResponse = await settleWorkflowStep(\n        retryWorkflowStep(() => {\n          if (awaitInput === undefined) {\n            return Promise.reject(missingAwaitInputHandlerError())\n          }\n\n          return awaitInput(awaitingInput)\n        }, awaitInputRetry)\n      )\n\n      if (hitlResponse._tag === 'Failure') {\n        await writeErrorSafely(writeError, hitlResponse.error)\n\n        return {\n          _tag: 'AwaitInputFailed',\n          turn: modelResult.value.turn,\n          error: hitlResponse.error,\n          awaitingInput,\n          state\n        }\n      }\n\n      toolHitlResponses = [...toolHitlResponses, hitlResponse.value]\n    }\n\n    if (completedToolsResult === undefined) {\n      const error = new Error('Vercel agent workflow tool batch did not complete')\n      await writeErrorSafely(writeError, error)\n\n      return {\n        _tag: 'ToolBatchStepFailed',\n        turn: modelResult.value.turn,\n        error,\n        state\n      }\n    }\n\n    state = {\n      request: input.request,\n      messages: [...modelResult.value.messages, ...completedToolsResult.messages],\n      createdMessages: completedToolsResult.createdMessages,\n      usage: modelResult.value.usage,\n      turn: modelResult.value.turn + 1,\n      eventSequence: completedToolsResult.eventSequence ?? toolEventSequence\n    }\n  }\n\n  const error = workflowMaxTurnsError(maxTurns)\n  await writeErrorSafely(writeError, error)\n\n  return {\n    _tag: 'MaxTurnsExceeded',\n    maxTurns,\n    error,\n    state\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolk-sdk/vercel-workflows",
-  "version": "0.1.0-canary.48",
+  "version": "0.1.0-canary.49",
   "description": "Vercel Workflow orchestration primitives for Yolk agent loops.",
   "license": "MIT",
   "type": "module",

package/src/workflow-loop.ts

@@ -115,8 +115,15 @@ export type VercelAgentWorkflowLoopConfig = {
   readonly runToolBatchStep: (
     input: VercelAgentWorkflowToolBatchStepInput
   ) => Promise<VercelAgentWorkflowToolBatchStepResult>
+  /** Called only after a model step returns `done: true`. */
   readonly closeStream: () => Promise<void>
+  /**
+   * Best-effort final failure handler. It must write a safe final error and
+   * close the failure stream; rejection is suppressed in favor of the
+   * original structured run result.
+   */
   readonly writeError: (error: unknown) => Promise<void>
+  /** A successful await suspends/resumes without invoking either finalizer. */
   readonly awaitInput?: (input: VercelAgentWorkflowAwaitingInput) => Promise<unknown>
   readonly modelStepRetry?: VercelAgentWorkflowStepRetryPolicy
   readonly toolBatchStepRetry?: VercelAgentWorkflowStepRetryPolicy
@@ -144,8 +151,11 @@ const missingAwaitInputHandlerError = () =>
     'Vercel agent workflow awaiting input requested but no awaitInput handler is configured'
   )
 
-const maxRetryAttempts = (policy: VercelAgentWorkflowStepRetryPolicy | undefined) =>
-  Math.max(1, Math.floor(policy?.maxAttempts ?? noWorkflowStepRetry.maxAttempts))
+const maxRetryAttempts = (policy: VercelAgentWorkflowStepRetryPolicy | undefined) => {
+  const configured = policy?.maxAttempts ?? noWorkflowStepRetry.maxAttempts
+
+  return Number.isFinite(configured) ? Math.max(1, Math.floor(configured)) : 1
+}
 
 export async function retryWorkflowStep<A>(
   runStep: () => Promise<A>,