@yolk-sdk/vercel-workflows 0.1.0-canary.100

package/dist/workflow-loop.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-loop.mjs","names":[],"sources":["../src/workflow-loop.ts"],"sourcesContent":["import { Data, Predicate } from 'effect'\n\nexport 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  /** Updated cumulative usage when tools run nested model work such as subagents. */\n  readonly usage?: unknown\n  readonly awaitingInput?: VercelAgentWorkflowAwaitingInput\n  readonly eventSequence?: number\n  /**\n   * A plain wire-safe failure captured after partial progress. Returning it instead of rejecting\n   * lets orchestration retain usage and event sequencing from completed sibling tools.\n   */\n  readonly failure?: unknown\n}\n\nexport type WorkflowStepResult<A> = Data.TaggedEnum<{\n  Success: {\n    readonly value: A\n  }\n  Failure: {\n    readonly error: unknown\n  }\n}>\n\ninterface WorkflowStepResultDefinition extends Data.TaggedEnum.WithGenerics<1> {\n  readonly taggedEnum: WorkflowStepResult<this['A']>\n}\n\nexport const WorkflowStepResult = Data.taggedEnum<WorkflowStepResultDefinition>()\n\nexport type VercelAgentWorkflowStepRetryPolicy = {\n  readonly maxAttempts: number\n}\n\nexport type VercelAgentWorkflowRunResult = Data.TaggedEnum<{\n  Completed: {\n    readonly turns: number\n    readonly state: SerializableWorkflowState\n  }\n  ModelStepFailed: {\n    readonly turn: number\n    readonly error: unknown\n    readonly state: SerializableWorkflowState\n  }\n  ToolBatchStepFailed: {\n    readonly turn: number\n    readonly error: unknown\n    readonly state: SerializableWorkflowState\n  }\n  AwaitInputFailed: {\n    readonly turn: number\n    readonly error: unknown\n    readonly awaitingInput: VercelAgentWorkflowAwaitingInput\n    readonly state: SerializableWorkflowState\n  }\n  CloseStreamFailed: {\n    readonly turns: number\n    readonly error: unknown\n    readonly state: SerializableWorkflowState\n  }\n  MaxTurnsExceeded: {\n    readonly maxTurns: number\n    readonly error: Error\n    readonly state: SerializableWorkflowState\n  }\n}>\n\nexport const VercelAgentWorkflowRunResult = Data.taggedEnum<VercelAgentWorkflowRunResult>()\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\n\nexport const noWorkflowStepRetry: VercelAgentWorkflowStepRetryPolicy = { maxAttempts: 1 }\n\nexport const settleWorkflowStep = <A>(promise: Promise<A>): Promise<WorkflowStepResult<A>> =>\n  promise.then(\n    value => WorkflowStepResult.Success<A>({ value }),\n    error => WorkflowStepResult.Failure<A>({ 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\nconst maxWorkflowTurns = (configured: number | undefined) => {\n  if (configured === undefined || !Number.isFinite(configured)) {\n    return defaultMaxWorkflowTurns\n  }\n\n  return Math.max(1, Math.floor(configured))\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\n  let state: SerializableWorkflowState = {\n    request: input.request,\n    createdMessages: [],\n    turn: 1,\n    eventSequence: 0\n  }\n\n  const maxTurns = maxWorkflowTurns(configuredMaxTurns)\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 (Predicate.isTagged(modelResult, 'Failure')) {\n      await writeErrorSafely(writeError, modelResult.error)\n\n      return VercelAgentWorkflowRunResult.ModelStepFailed({\n        turn: state.turn,\n        error: modelResult.error,\n        state\n      })\n    }\n\n    if (modelResult.value.done) {\n      const terminalState: SerializableWorkflowState = {\n        request: input.request,\n        messages: modelResult.value.messages,\n        createdMessages: modelResult.value.createdMessages,\n        usage: modelResult.value.usage,\n        turn: modelResult.value.turn,\n        eventSequence: modelResult.value.eventSequence ?? state.eventSequence\n      }\n\n      const closeResult = await settleWorkflowStep(retryWorkflowStep(closeStream, closeStreamRetry))\n\n      if (Predicate.isTagged(closeResult, 'Failure')) {\n        await writeErrorSafely(writeError, closeResult.error)\n\n        return VercelAgentWorkflowRunResult.CloseStreamFailed({\n          turns: modelResult.value.turn,\n          error: closeResult.error,\n          state: terminalState\n        })\n      }\n\n      return VercelAgentWorkflowRunResult.Completed({\n        turns: modelResult.value.turn,\n        state: terminalState\n      })\n    }\n\n    if (modelResult.value.toolCalls.length === 0) {\n      state = {\n        request: input.request,\n        messages: modelResult.value.messages,\n        createdMessages: modelResult.value.createdMessages,\n        usage: modelResult.value.usage,\n        turn: modelResult.value.turn + 1,\n        eventSequence: modelResult.value.eventSequence ?? state.eventSequence\n      }\n      continue\n    }\n\n    let completedToolsResult: VercelAgentWorkflowToolBatchStepResult | undefined\n    const toolHitlResponses: Array<unknown> = []\n    let cumulativeUsage = modelResult.value.usage\n    let toolEventSequence = modelResult.value.eventSequence ?? state.eventSequence\n\n    const currentTurnState = (\n      toolResult?: VercelAgentWorkflowToolBatchStepResult\n    ): SerializableWorkflowState => ({\n      request: input.request,\n      messages:\n        toolResult === undefined\n          ? modelResult.value.messages\n          : [...modelResult.value.messages, ...toolResult.messages],\n      createdMessages: toolResult?.createdMessages ?? modelResult.value.createdMessages,\n      usage: cumulativeUsage,\n      turn: modelResult.value.turn,\n      eventSequence: toolEventSequence\n    })\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.slice(),\n              usage: cumulativeUsage,\n              turn: modelResult.value.turn,\n              eventSequence: toolEventSequence\n            }),\n          toolBatchStepRetry\n        )\n      )\n\n      if (Predicate.isTagged(toolsResult, 'Failure')) {\n        await writeErrorSafely(writeError, toolsResult.error)\n\n        return VercelAgentWorkflowRunResult.ToolBatchStepFailed({\n          turn: modelResult.value.turn,\n          error: toolsResult.error,\n          state: currentTurnState()\n        })\n      }\n\n      cumulativeUsage = toolsResult.value.usage ?? cumulativeUsage\n      toolEventSequence = toolsResult.value.eventSequence ?? toolEventSequence\n\n      if (toolsResult.value.failure !== undefined) {\n        await writeErrorSafely(writeError, toolsResult.value.failure)\n\n        return VercelAgentWorkflowRunResult.ToolBatchStepFailed({\n          turn: modelResult.value.turn,\n          error: toolsResult.value.failure,\n          state: currentTurnState(toolsResult.value)\n        })\n      }\n\n      if (toolsResult.value.awaitingInput === undefined) {\n        completedToolsResult = toolsResult.value\n        break\n      }\n\n      const awaitingInput = toolsResult.value.awaitingInput\n      cumulativeUsage = toolsResult.value.usage ?? awaitingInput.usage ?? cumulativeUsage\n      toolEventSequence = awaitingInput.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 (Predicate.isTagged(hitlResponse, 'Failure')) {\n        await writeErrorSafely(writeError, hitlResponse.error)\n\n        return VercelAgentWorkflowRunResult.AwaitInputFailed({\n          turn: modelResult.value.turn,\n          error: hitlResponse.error,\n          awaitingInput,\n          state: currentTurnState(toolsResult.value)\n        })\n      }\n\n      toolHitlResponses.push(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 VercelAgentWorkflowRunResult.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: completedToolsResult.usage ?? cumulativeUsage,\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 VercelAgentWorkflowRunResult.MaxTurnsExceeded({\n    maxTurns,\n    error,\n    state\n  })\n}\n"],"mappings":"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"}

package/dist/workflow.d.mts

@@ -0,0 +1,4 @@
+import { SerializableWorkflowState, VercelAgentWorkflowAwaitingInput, VercelAgentWorkflowInput, VercelAgentWorkflowLoopConfig, VercelAgentWorkflowModelStepInput, VercelAgentWorkflowModelStepResult, VercelAgentWorkflowRunResult, VercelAgentWorkflowStepRetryPolicy, VercelAgentWorkflowToolBatchStepInput, VercelAgentWorkflowToolBatchStepResult, WorkflowStepResult, defaultMaxWorkflowTurns, noWorkflowStepRetry, retryWorkflowStep, runVercelAgentWorkflow, settleWorkflowStep } from "./workflow-loop.mjs";
+import { CommitThenWriteTerminalEventInput, CommitThenWriteTerminalEventResult, DurableAgentEvent, DurableAgentEventIdInput, DurableAgentEventSequencerState, SequenceDurableAgentEventInput, SequencedDurableAgentEvent, WriteDurableAgentEventInput, commitThenWriteTerminalEvent, durableAgentEventId, makeDurableAgentEventSequencerState, sequenceDurableAgentEvent, writeDurableAgentEvent } from "./workflow-events.mjs";
+import { awaitWorkflowChild, orchestrateWorkflowToolBatch } from "./workflow-children.mjs";
+export { type CommitThenWriteTerminalEventInput, type CommitThenWriteTerminalEventResult, type DurableAgentEvent, type DurableAgentEventIdInput, type DurableAgentEventSequencerState, type SequenceDurableAgentEventInput, type SequencedDurableAgentEvent, type SerializableWorkflowState, type VercelAgentWorkflowAwaitingInput, type VercelAgentWorkflowInput, type VercelAgentWorkflowLoopConfig, type VercelAgentWorkflowModelStepInput, type VercelAgentWorkflowModelStepResult, VercelAgentWorkflowRunResult, type VercelAgentWorkflowStepRetryPolicy, type VercelAgentWorkflowToolBatchStepInput, type VercelAgentWorkflowToolBatchStepResult, WorkflowStepResult, type WriteDurableAgentEventInput, awaitWorkflowChild, commitThenWriteTerminalEvent, defaultMaxWorkflowTurns, durableAgentEventId, makeDurableAgentEventSequencerState, noWorkflowStepRetry, orchestrateWorkflowToolBatch, retryWorkflowStep, runVercelAgentWorkflow, sequenceDurableAgentEvent, settleWorkflowStep, writeDurableAgentEvent };

package/dist/workflow.mjs

@@ -0,0 +1,4 @@
+import { VercelAgentWorkflowRunResult, WorkflowStepResult, defaultMaxWorkflowTurns, noWorkflowStepRetry, retryWorkflowStep, runVercelAgentWorkflow, settleWorkflowStep } from "./workflow-loop.mjs";
+import { commitThenWriteTerminalEvent, durableAgentEventId, makeDurableAgentEventSequencerState, sequenceDurableAgentEvent, writeDurableAgentEvent } from "./workflow-events.mjs";
+import { awaitWorkflowChild, orchestrateWorkflowToolBatch } from "./workflow-children.mjs";
+export { VercelAgentWorkflowRunResult, WorkflowStepResult, awaitWorkflowChild, commitThenWriteTerminalEvent, defaultMaxWorkflowTurns, durableAgentEventId, makeDurableAgentEventSequencerState, noWorkflowStepRetry, orchestrateWorkflowToolBatch, retryWorkflowStep, runVercelAgentWorkflow, sequenceDurableAgentEvent, settleWorkflowStep, writeDurableAgentEvent };

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@yolk-sdk/vercel-workflows",
+  "version": "0.1.0-canary.100",
+  "description": "Vercel Workflow orchestration primitives for Yolk agent loops.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/magoz/yolk-sdk.git",
+    "directory": "packages/vercel-workflows"
+  },
+  "bugs": {
+    "url": "https://github.com/magoz/yolk-sdk/issues"
+  },
+  "homepage": "https://github.com/magoz/yolk-sdk#readme",
+  "keywords": [
+    "vercel",
+    "workflow",
+    "agents",
+    "runtime",
+    "effect"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./workflow": {
+      "types": "./dist/workflow.d.mts",
+      "import": "./dist/workflow.mjs",
+      "default": "./dist/workflow.mjs"
+    },
+    "./effect": {
+      "types": "./dist/effect.d.mts",
+      "import": "./dist/effect.mjs",
+      "default": "./dist/effect.mjs"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.mts",
+      "import": "./dist/testing/index.mjs",
+      "default": "./dist/testing/index.mjs"
+    }
+  },
+  "files": [
+    "src/**/*.ts",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "dist/**/*",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "effect": "4.0.0",
+    "workflow": "^5.0.0-beta.42"
+  },
+  "devDependencies": {
+    "@effect/vitest": "4.0.0",
+    "@workflow/vitest": "^5.0.0-beta.42",
+    "vitest": "^5.0.1"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:workflow": "vitest run --config vitest.workflow.config.ts",
+    "test:run": "vitest run --passWithNoTests"
+  }
+}

package/src/effect.ts

@@ -0,0 +1,232 @@
+import { Context, Data, Effect, Layer } from 'effect'
+import {
+  getRun as workflowGetRun,
+  resumeHook as workflowResumeHook,
+  start as workflowStart,
+  type WorkflowReadableStream,
+  type WorkflowReadableStreamOptions,
+  type WorkflowRun
+} from 'workflow/api'
+
+export type VercelWorkflowsOperation =
+  | 'start'
+  | 'getRun'
+  | 'getReadable'
+  | 'tailIndex'
+  | 'resumeHook'
+  | 'cancel'
+  | 'status'
+  | 'returnValue'
+
+export class VercelWorkflowsError extends Data.TaggedError('VercelWorkflowsError')<{
+  readonly operation: VercelWorkflowsOperation
+  readonly message: string
+  readonly cause: unknown
+}> {}
+
+export type VercelWorkflowFunction<TArgs extends unknown[], TResult> = (
+  ...args: TArgs
+) => Promise<TResult>
+
+export type VercelWorkflowReadableOptions = WorkflowReadableStreamOptions
+
+export type VercelWorkflowReadableStream<Chunk> = WorkflowReadableStream<Chunk>
+
+export type VercelWorkflowRunStatus = WorkflowRun['status']
+
+export type VercelWorkflowsSdkRun<TResult> = {
+  readonly runId: string
+  readonly getReadable: <Chunk>(
+    options?: VercelWorkflowReadableOptions
+  ) => VercelWorkflowReadableStream<Chunk>
+  readonly cancel: () => Promise<void>
+  readonly status: Promise<VercelWorkflowRunStatus>
+  readonly returnValue: Promise<TResult>
+}
+
+export type VercelWorkflowsSdkClient = {
+  readonly start: <TArgs extends unknown[], TResult>(
+    workflow: VercelWorkflowFunction<TArgs, TResult>,
+    args: TArgs
+  ) => Promise<VercelWorkflowsSdkRun<TResult>>
+  readonly getRun: <TResult>(runId: string) => VercelWorkflowsSdkRun<TResult>
+  readonly resumeHook: (token: string, payload: unknown) => Promise<void>
+}
+
+export type VercelWorkflowRun<TResult> = {
+  readonly runId: string
+  readonly getReadable: <Chunk>(
+    options?: VercelWorkflowReadableOptions
+  ) => Effect.Effect<VercelWorkflowReadableStream<Chunk>, VercelWorkflowsError>
+  readonly cancel: Effect.Effect<void, VercelWorkflowsError>
+  readonly status: Effect.Effect<VercelWorkflowRunStatus, VercelWorkflowsError>
+  readonly returnValue: Effect.Effect<TResult, VercelWorkflowsError>
+}
+
+export type VercelWorkflowsClient = {
+  readonly start: <TArgs extends unknown[], TResult>(
+    workflow: VercelWorkflowFunction<TArgs, TResult>,
+    args: TArgs
+  ) => Effect.Effect<VercelWorkflowRun<TResult>, VercelWorkflowsError>
+  readonly getRun: <TResult>(
+    runId: string
+  ) => Effect.Effect<VercelWorkflowRun<TResult>, VercelWorkflowsError>
+  readonly getReadable: <Chunk>(
+    runId: string,
+    options?: VercelWorkflowReadableOptions
+  ) => Effect.Effect<VercelWorkflowReadableStream<Chunk>, VercelWorkflowsError>
+  readonly tailIndex: (runId: string) => Effect.Effect<number, VercelWorkflowsError>
+  readonly resumeHook: (
+    token: string,
+    payload: unknown
+  ) => Effect.Effect<void, VercelWorkflowsError>
+  readonly cancel: (runId: string) => Effect.Effect<void, VercelWorkflowsError>
+}
+
+export class VercelWorkflowsSdk extends Context.Service<
+  VercelWorkflowsSdk,
+  VercelWorkflowsSdkClient
+>()('@yolk-sdk/vercel-workflows/VercelWorkflowsSdk') {}
+
+const workflowsError = (operation: VercelWorkflowsOperation, cause: unknown) =>
+  new VercelWorkflowsError({
+    operation,
+    message: `Vercel Workflow ${operation} failed`,
+    cause
+  })
+
+const spanAttributes = (runId: string) => ({ 'workflow.run.id': runId })
+
+const trySdkPromise = <A>(body: () => Promise<A>) =>
+  Effect.tryPromise({
+    try: body,
+    catch: error => error
+  })
+
+const mapSdkError =
+  (operation: VercelWorkflowsOperation) =>
+  <A>(effect: Effect.Effect<A, unknown>) =>
+    effect.pipe(Effect.mapError(cause => workflowsError(operation, cause)))
+
+const makeWorkflowRun = <TResult>(
+  run: VercelWorkflowsSdkRun<TResult>
+): VercelWorkflowRun<TResult> => ({
+  runId: run.runId,
+  getReadable: <Chunk>(options?: VercelWorkflowReadableOptions) =>
+    Effect.try({
+      try: () => run.getReadable<Chunk>(options),
+      catch: cause => workflowsError('getReadable', cause)
+    }).pipe(
+      Effect.withSpan('VercelWorkflows.run.getReadable', {
+        attributes: spanAttributes(run.runId)
+      })
+    ),
+  cancel: trySdkPromise(() => run.cancel()).pipe(
+    mapSdkError('cancel'),
+    Effect.withSpan('VercelWorkflows.run.cancel', {
+      attributes: spanAttributes(run.runId)
+    })
+  ),
+  status: trySdkPromise(() => run.status).pipe(
+    mapSdkError('status'),
+    Effect.withSpan('VercelWorkflows.run.status', {
+      attributes: spanAttributes(run.runId)
+    })
+  ),
+  returnValue: trySdkPromise(() => run.returnValue).pipe(
+    mapSdkError('returnValue'),
+    Effect.withSpan('VercelWorkflows.run.returnValue', {
+      attributes: spanAttributes(run.runId)
+    })
+  )
+})
+
+const VercelWorkflowsSdkLive = Layer.succeed(VercelWorkflowsSdk, {
+  start: <TArgs extends unknown[], TResult>(
+    workflow: VercelWorkflowFunction<TArgs, TResult>,
+    args: TArgs
+  ) => workflowStart(workflow, args),
+  getRun: <TResult>(runId: string) => workflowGetRun<TResult>(runId),
+  resumeHook: async (token: string, payload: unknown) => {
+    await workflowResumeHook<unknown>(token, payload)
+  }
+})
+
+export class VercelWorkflows extends Context.Service<VercelWorkflows, VercelWorkflowsClient>()(
+  '@yolk-sdk/vercel-workflows/VercelWorkflows',
+  {
+    make: Effect.gen(function* () {
+      const sdk = yield* VercelWorkflowsSdk
+
+      const getRun = <TResult>(
+        runId: string
+      ): Effect.Effect<VercelWorkflowRun<TResult>, VercelWorkflowsError> =>
+        Effect.try({
+          try: () => sdk.getRun<TResult>(runId),
+          catch: error => error
+        }).pipe(
+          mapSdkError('getRun'),
+          Effect.map(makeWorkflowRun),
+          Effect.withSpan('VercelWorkflows.getRun', {
+            attributes: spanAttributes(runId)
+          })
+        )
+
+      return {
+        start: <TArgs extends unknown[], TResult>(
+          workflow: VercelWorkflowFunction<TArgs, TResult>,
+          args: TArgs
+        ): Effect.Effect<VercelWorkflowRun<TResult>, VercelWorkflowsError> =>
+          trySdkPromise(() => sdk.start(workflow, args)).pipe(
+            mapSdkError('start'),
+            Effect.map(makeWorkflowRun),
+            Effect.withSpan('VercelWorkflows.start')
+          ),
+
+        getRun,
+
+        getReadable: <Chunk>(
+          runId: string,
+          options?: VercelWorkflowReadableOptions
+        ): Effect.Effect<VercelWorkflowReadableStream<Chunk>, VercelWorkflowsError> =>
+          getRun<unknown>(runId).pipe(
+            Effect.flatMap(run => run.getReadable<Chunk>(options)),
+            Effect.withSpan('VercelWorkflows.getReadable', {
+              attributes: spanAttributes(runId)
+            })
+          ),
+
+        tailIndex: (runId: string): Effect.Effect<number, VercelWorkflowsError> =>
+          getRun<unknown>(runId).pipe(
+            Effect.flatMap(run => run.getReadable<unknown>({ startIndex: -1 })),
+            Effect.flatMap(readable =>
+              Effect.tryPromise({
+                try: () => readable.getTailIndex(),
+                catch: cause => workflowsError('tailIndex', cause)
+              })
+            ),
+            Effect.withSpan('VercelWorkflows.tailIndex', {
+              attributes: spanAttributes(runId)
+            })
+          ),
+
+        resumeHook: (token: string, payload: unknown): Effect.Effect<void, VercelWorkflowsError> =>
+          trySdkPromise(() => sdk.resumeHook(token, payload)).pipe(
+            mapSdkError('resumeHook'),
+            Effect.withSpan('VercelWorkflows.resumeHook')
+          ),
+
+        cancel: (runId: string): Effect.Effect<void, VercelWorkflowsError> =>
+          getRun<unknown>(runId).pipe(
+            Effect.flatMap(run => run.cancel),
+            Effect.withSpan('VercelWorkflows.cancel', {
+              attributes: spanAttributes(runId)
+            })
+          )
+      }
+    })
+  }
+) {
+  static layer = Layer.effect(this, this.make).pipe(Layer.provide(VercelWorkflowsSdkLive))
+  static layerFromSdk = Layer.effect(this, this.make)
+}

package/src/index.ts

@@ -0,0 +1,36 @@
+export {
+  commitThenWriteTerminalEvent,
+  durableAgentEventId,
+  defaultMaxWorkflowTurns,
+  makeDurableAgentEventSequencerState,
+  noWorkflowStepRetry,
+  retryWorkflowStep,
+  runVercelAgentWorkflow,
+  sequenceDurableAgentEvent,
+  settleWorkflowStep,
+  VercelAgentWorkflowRunResult,
+  WorkflowStepResult,
+  writeDurableAgentEvent
+} from './workflow.ts'
+
+export type {
+  CommitThenWriteTerminalEventInput,
+  CommitThenWriteTerminalEventResult,
+  DurableAgentEvent,
+  DurableAgentEventIdInput,
+  DurableAgentEventSequencerState,
+  SequenceDurableAgentEventInput,
+  SequencedDurableAgentEvent,
+  SerializableWorkflowState,
+  VercelAgentWorkflowAwaitingInput,
+  VercelAgentWorkflowInput,
+  VercelAgentWorkflowLoopConfig,
+  VercelAgentWorkflowModelStepInput,
+  VercelAgentWorkflowModelStepResult,
+  VercelAgentWorkflowStepRetryPolicy,
+  VercelAgentWorkflowToolBatchStepInput,
+  VercelAgentWorkflowToolBatchStepResult,
+  WriteDurableAgentEventInput
+} from './workflow.ts'
+
+export { awaitWorkflowChild, orchestrateWorkflowToolBatch } from './workflow-children.ts'