andMap

Compose a new object from workflow data, input, context, or step outputs.

Quick Start

import { createWorkflowChain, andMap, andThen } from "@voltagent/core";
import { z } from "zod";

const workflow = createWorkflowChain({
  id: "compose-result",
  input: z.object({ userId: z.string() }),
})
  .andThen({
    id: "fetch-user",
    execute: async ({ data }) => ({ name: "Ada", id: data.userId }),
  })
  .andMap({
    id: "shape-output",
    map: {
      userId: { source: "data", path: "userId" },
      name: { source: "step", stepId: "fetch-user", path: "name" },
      region: { source: "context", key: "region" },
      constant: { source: "value", value: "ok" },
    },
  });

Function Signature

.andMap({
  id: string,
  map: {
    [key: string]:
      | { source: "value", value: any }
      | { source: "data", path?: string }
      | { source: "input", path?: string }
      | { source: "context", key: string, path?: string }
      | { source: "step", stepId: string, path?: string }
      | { source: "fn", fn: (ctx) => any }
  },
  retries?: number,
  name?: string,
  purpose?: string
})

Notes

• data refers to the current step input.
• input refers to the original workflow input.
• context reads from WorkflowRunOptions.context.