eve 0.5.4 → 0.6.0-beta.3

package/dist/src/internal/workflow/builtins.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Built-in Workflow response body steps used by Eve-owned workflow bundles.
+ *
+ * These mirror Workflow's tiny `workflow/internal/builtins` module without
+ * requiring Eve to depend on Workflow's umbrella package.
+ */
+export declare function __builtin_response_array_buffer(this: Request | Response): Promise<ArrayBuffer>;
+export declare function __builtin_response_json(this: Request | Response): Promise<unknown>;
+export declare function __builtin_response_text(this: Request | Response): Promise<string>;
+/**
+ * Step bridge for `experimental_setAttributes`.
+ *
+ * Mirrors the `__builtin_set_attributes` step from
+ * `@workflow/workflow/internal/builtins`. The workflow-body shim's
+ * `experimental_setAttributes` (in `internal/workflow-bundle/workflow-core-shim.ts`)
+ * dispatches into the workflow runtime with the step id
+ * `"__builtin_set_attributes"`; the runtime walks the deployment's step
+ * registry to resolve it, so the step has to live inside an
+ * Eve-vendored builtins module that the registry visits. The Eve bundler
+ * already pulls this file in via `resolveWorkflowModulePath("workflow/internal/builtins")`,
+ * so adding the function here is sufficient to register it.
+ *
+ * Implementation notes — kept intentionally close to the upstream:
+ * - Reads world and run id directly from the runtime's `globalThis`
+ *   symbols rather than importing `@workflow/core`. Importing the
+ *   compiled core from a step file would re-introduce the bundling
+ *   chain we want to keep out of step bodies.
+ * - Treats missing world support as a silent best-effort no-op with a
+ *   single process-wide warning, matching upstream behaviour and the
+ *   contract on `setEveAttributes`.
+ * - On any other error, retries up to `EVE_INTERNAL_ATTRIBUTES_MAX_ATTEMPTS - 1`
+ *   times via the runtime's normal step retry path, then degrades to a
+ *   `console.error` so failed attribute writes never escalate into a
+ *   `FatalError` and tear down the user's agent run.
+ */
+export declare function __builtin_set_attributes(changes: Array<{
+    key: string;
+    value: string | null;
+}>, options?: {
+    allowReservedAttributes?: boolean;
+}): Promise<void>;

package/dist/src/internal/workflow/builtins.js

@@ -0,0 +1 @@
+async function __builtin_response_array_buffer(){"use step";return await this.arrayBuffer()}async function __builtin_response_json(){"use step";return await this.json()}async function __builtin_response_text(){"use step";return await this.text()}const EVE_UNSUPPORTED_WORLD_WARNED=Symbol.for(`@workflow/setAttributes//unsupportedWorldWarned`);function formatUnknownError(e){return e instanceof Error?e.stack??`${e.name}: ${e.message}`:String(e)}async function __builtin_set_attributes(t,n){"use step";if(t.length===0)return;let r=globalThis,i=r[Symbol.for(`WORKFLOW_STEP_CONTEXT_STORAGE`)]?.getStore?.(),a=typeof i?.stepMetadata?.attempt==`number`?i.stepMetadata.attempt:3,o=r[Symbol.for(`@workflow/world//cache`)];if(typeof o?.runs?.experimentalSetAttributes!=`function`){if(r[EVE_UNSUPPORTED_WORLD_WARNED]!==!0){r[EVE_UNSUPPORTED_WORLD_WARNED]=!0;let t=o?.name===void 0?``:` (${o.name})`;console.warn(`[eve] setAttributes: the current world implementation${t} does not implement experimentalSetAttributes; this call (and any subsequent setAttributes calls in this process) is a no-op. Attributes will become available once the world adapter adds support.`)}return}try{let e=i?.workflowMetadata?.workflowRunId;if(e===void 0)throw Error(`__builtin_set_attributes: no workflow run id available in step context`);await o.runs.experimentalSetAttributes(e,t,n)}catch(e){if(a<3)throw e;console.error(`[eve] setAttributes: failed to post tags after 3 attempts; dropping the internal attribute write. ${formatUnknownError(e)}`)}}__builtin_set_attributes.maxRetries=2;export{__builtin_response_array_buffer,__builtin_response_json,__builtin_response_text,__builtin_set_attributes};

package/dist/src/internal/workflow/index.d.ts

@@ -0,0 +1,6 @@
+export * from "#compiled/@workflow/core/index.js";
+/**
+ * Workflow-safe fetch helper retained for generated or authored workflow code
+ * that imports `fetch` from the historical `workflow` package surface.
+ */
+export declare function fetch(...args: Parameters<typeof globalThis.fetch>): Promise<Response>;

package/dist/src/internal/workflow/index.js

@@ -0,0 +1 @@
+export*from"#compiled/@workflow/core/index.js";async function fetch(...e){"use step";return await globalThis.fetch(...e)}export{fetch};

package/dist/src/internal/workflow-bundle/builder-support.d.ts

@@ -0,0 +1,71 @@
+import { type WorkflowManifest } from "#internal/workflow-bundle/workflow-builders.js";
+export declare const WORKFLOW_VIRTUAL_ENTRY_ID = "\0eve-workflow-entry";
+export interface WorkflowBundleBuilderConfig {
+    readonly buildTarget: "standalone";
+    readonly dirs: readonly string[];
+    readonly externalPackages: readonly string[];
+    readonly projectRoot: string;
+    readonly watch: boolean;
+    readonly workingDir: string;
+}
+export interface WorkflowBundleDiscoveredEntries {
+    readonly discoveredSerdeFiles: string[];
+    readonly discoveredSteps: string[];
+    readonly discoveredWorkflows: string[];
+}
+export interface WorkflowBundleCreateWorkflowsBundleOptions {
+    readonly bundleFinalOutput?: boolean;
+    readonly discoveredEntries?: WorkflowBundleDiscoveredEntries;
+    readonly format?: "cjs" | "esm";
+    readonly inputFiles: readonly string[];
+    readonly keepInterimBundleContext?: boolean;
+    readonly outfile: string;
+    readonly tsconfigPath?: string;
+}
+export interface WorkflowBundleCreateWorkflowsBundleResult {
+    readonly bundleFinal?: (interimBundleResult: string) => Promise<void>;
+    readonly interimBundleCtx?: undefined;
+    readonly manifest: WorkflowManifest;
+}
+interface WorkflowRolldownPlugin {
+    readonly name: string;
+    readonly resolveId?: (source: string, importer?: string) => unknown;
+    readonly load?: (id: string) => unknown;
+    readonly transform?: (code: string, id: string) => unknown;
+}
+export declare function collectWorkflowInputFiles(root: string): Promise<string[]>;
+export declare function createWorkflowImport(filePath: string, workingDir: string): string;
+export declare function createWorkflowVirtualEntryPlugin(source: string): WorkflowRolldownPlugin;
+export declare function createWorkflowPseudoPackagePlugin(): WorkflowRolldownPlugin;
+export declare function createWorkflowRuntimeAliasPlugin(): WorkflowRolldownPlugin;
+export declare function createEvePackageImportsPlugin(workingDir: string, options?: {
+    workflowCondition?: boolean;
+}): WorkflowRolldownPlugin;
+export declare function createWorkflowTransformPlugin(input: {
+    manifest: WorkflowManifest;
+    mode?: "step" | "workflow";
+    projectRoot: string;
+    sideEffectFiles?: readonly string[];
+    workingDir: string;
+}): WorkflowRolldownPlugin;
+export declare function bundleWorkflowStepRegistrations(input: {
+    builtinsPath: string;
+    discoveredEntries: WorkflowBundleDiscoveredEntries;
+    outfile: string;
+    projectRoot: string;
+    tsconfigPath?: string;
+    workingDir: string;
+}): Promise<void>;
+export declare function createWorkflowNodeBuiltinGuardPlugin(): WorkflowRolldownPlugin;
+export declare function bundleFinalWorkflowOutput(input: {
+    bundleFinalOutput: boolean;
+    code: string;
+    format: "cjs" | "esm";
+    outfile: string;
+    workingDir: string;
+}): Promise<void>;
+export declare function convertStepsManifest(steps: WorkflowManifest["steps"]): Record<string, unknown>;
+export declare function convertWorkflowsManifest(workflows: WorkflowManifest["workflows"]): Record<string, unknown>;
+export declare function convertClassesManifest(classes: WorkflowManifest["classes"]): Record<string, unknown>;
+export declare function atomicWriteFile(targetPath: string, contents: string | Buffer | Uint8Array): Promise<void>;
+export {};

package/dist/src/internal/workflow-bundle/builder-support.js

@@ -0,0 +1,9 @@
+import{builtinModules}from"node:module";import{dirname,join,relative,resolve}from"node:path";import{mkdir,readFile,readdir,rename,writeFile}from"node:fs/promises";import{existsSync}from"node:fs";import{resolveWorkflowModulePath}from"#internal/application/package.js";import{buildWithNitroRolldown,getSingleRolldownChunk}from"#internal/bundler/nitro-rolldown.js";import{applyWorkflowTransform,getImportPath}from"#internal/workflow-bundle/workflow-builders.js";const WORKFLOW_VIRTUAL_ENTRY_ID=`\0eve-workflow-entry`,PSEUDO_PACKAGES=new Set([`server-only`,`client-only`,`next/dist/compiled/server-only`,`next/dist/compiled/client-only`]),NODE_BUILTIN_MODULES=new Set([...builtinModules,...builtinModules.map(e=>`node:${e}`)]),WORKFLOW_INPUT_EXTENSIONS=new Set([`.ts`,`.tsx`,`.mts`,`.cts`,`.js`,`.jsx`,`.mjs`,`.cjs`]),IGNORED_INPUT_DIRECTORIES=new Set([`node_modules`,`.git`,`.next`,`.nuxt`,`.output`,`.vercel`,`.workflow-data`,`.workflow-vitest`,`.well-known`,`.svelte-kit`,`.turbo`,`.cache`,`.yarn`,`.pnpm-store`]);async function collectWorkflowInputFiles(e){let t=[];async function visit(e){let r;try{r=await readdir(e,{withFileTypes:!0})}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return;throw e}for(let i of r){if(i.isDirectory()){IGNORED_INPUT_DIRECTORIES.has(i.name)||await visit(join(e,i.name));continue}if(!i.isFile())continue;let r=i.name.match(/\.[^.]+$/)?.[0];r!==void 0&&WORKFLOW_INPUT_EXTENSIONS.has(r)&&t.push(join(e,i.name))}}return await visit(e),t}function createWorkflowImport(e,t){let{importPath:n,isPackage:r}=getImportPath(e,t);return r?`import ${JSON.stringify(n)};`:`import ${JSON.stringify(toRelativeImportSpecifier(t,e))};`}function createWorkflowVirtualEntryPlugin(e){return{name:`eve-workflow-virtual-entry`,resolveId(e){if(e===`\0eve-workflow-entry`)return{id:e}},load(t){if(t===`\0eve-workflow-entry`)return{code:e,moduleSideEffects:!0,moduleType:`js`}}}}function createWorkflowPseudoPackagePlugin(){return{name:`eve-workflow-pseudo-packages`,resolveId(e){if(PSEUDO_PACKAGES.has(e))return{id:`\0eve-workflow-pseudo-package:${e}`}},load(e){if(e.startsWith(`\0eve-workflow-pseudo-package:`))return{code:``,moduleType:`js`}}}}function createWorkflowRuntimeAliasPlugin(){return{name:`eve-workflow-runtime-aliases`,resolveId(e){if(!(e!==`workflow`&&!e.startsWith(`workflow/`)))return resolveWorkflowModulePath(e)}}}function createEvePackageImportsPlugin(e,t={}){return{name:`eve-package-imports`,resolveId(r){let i=r.match(/^#compiled\/(.+)$/)?.[1];if(i!==void 0)return t.workflowCondition===!0&&i===`@workflow/core/index.js`?resolveFirstExistingPath([join(e,`src`,`internal`,`workflow-bundle`,`workflow-core-shim.ts`),join(e,`dist`,`src`,`internal`,`workflow-bundle`,`workflow-core-shim.js`)]):resolveFirstExistingPath([join(e,`.generated`,`compiled`,i),join(e,`dist`,`src`,`compiled`,i)]);let a=r.match(/^#(.+)\.js$/)?.[1];if(a!==void 0)return resolveFirstExistingPath([`.ts`,`.tsx`,`.mts`,`.cts`,`.js`,`.jsx`,`.mjs`,`.cjs`].flatMap(t=>[join(e,`src`,`${a}${t}`),join(e,`dist`,`src`,`${a}${t}`)]))}}}function createWorkflowTransformPlugin(e){let t=new Set(e.sideEffectFiles?.map(e=>e.replaceAll(`\\`,`/`))??[]);return{name:`eve-workflow-transform`,async load(n){if(!isJavaScriptLikePath(n))return;let r=await readFile(n,`utf8`),i=await applyWorkflowTransform(createManifestRelativeFilepath(e.workingDir,n),r.replace(/require\(\s*(['"])server-only\1\s*\)/g,`void 0`).replace(/require\(\s*(['"])client-only\1\s*\)/g,`void 0`),e.mode??`workflow`,n,e.projectRoot);return mergeWorkflowManifest(e.manifest,i.workflowManifest),{code:i.code,map:null,moduleSideEffects:t.has(n.replaceAll(`\\`,`/`))||void 0}}}}async function bundleWorkflowStepRegistrations(e){let t=[...e.discoveredEntries.discoveredSteps].sort(),n=new Set(t),r=[...e.discoveredEntries.discoveredSerdeFiles].sort().filter(e=>!n.has(e)),i={},a=[createWorkflowImport(e.builtinsPath,e.workingDir),...t.map(t=>createWorkflowImport(t,e.workingDir)),...r.map(t=>createWorkflowImport(t,e.workingDir)),`export const __steps_registered = true;`].join(`
+`),o=getSingleRolldownChunk(await buildWithNitroRolldown({cwd:e.workingDir,input:WORKFLOW_VIRTUAL_ENTRY_ID,platform:`node`,plugins:[createWorkflowVirtualEntryPlugin(a),createWorkflowPseudoPackagePlugin(),createWorkflowRuntimeAliasPlugin(),createEvePackageImportsPlugin(e.workingDir),createWorkflowTransformPlugin({manifest:i,mode:`step`,projectRoot:e.projectRoot,sideEffectFiles:[...t,...r],workingDir:e.workingDir})],resolve:{conditionNames:[`eve-source`,`node`,`import`,`default`],extensions:[`.ts`,`.tsx`,`.mts`,`.cts`,`.js`,`.jsx`,`.mjs`,`.cjs`],mainFields:[`module`,`main`]},tsconfig:e.tsconfigPath??!1,write:!1,output:{codeSplitting:!1,comments:!1,format:`esm`,sourcemap:`inline`}}),`step registrations bundle for "${e.outfile}"`);await writeWorkflowBundleAtomically(e.outfile,o.code)}function createWorkflowNodeBuiltinGuardPlugin(){return{name:`eve-workflow-node-builtins`,resolveId(e,t){let n=e.startsWith(`node:`)?e.slice(5):e;if(!NODE_BUILTIN_MODULES.has(e)&&!NODE_BUILTIN_MODULES.has(n))return;let r=t?` (imported by "${t}")`:``;throw Error(`Workflow bundle cannot import Node.js builtin "${e}"${r}. Move Node.js APIs behind a "use step" function, or keep the importing module out of the workflow driver body (only reachable through a "use step").`)}}}async function bundleFinalWorkflowOutput(e){let t=`// biome-ignore-all lint: generated file
+/* eslint-disable */
+import { workflowEntrypoint } from 'workflow/runtime';
+
+const workflowCode = \`${(e.code.endsWith(`
+`)?e.code:`${e.code}\n`).replace(/[\\`$]/g,`\\$&`)}\`;
+
+export const POST = workflowEntrypoint(workflowCode);`;if(!e.bundleFinalOutput){await writeWorkflowBundleAtomically(e.outfile,t);return}let n=getSingleRolldownChunk(await buildWithNitroRolldown({cwd:e.workingDir,input:WORKFLOW_VIRTUAL_ENTRY_ID,external:e=>e===`@aws-sdk/credential-provider-web-identity`,platform:`node`,plugins:[createWorkflowVirtualEntryPlugin(t)],write:!1,output:{comments:!1,format:e.format,sourcemap:!1}}),`final workflow bundle for "${e.outfile}"`);await writeWorkflowBundleAtomically(e.outfile,n.code)}function convertStepsManifest(e){let t={};for(let[n,r]of Object.entries(e??{})){t[n]={};for(let[e,i]of Object.entries(r))t[n][e]={stepId:i.stepId}}return t}function convertWorkflowsManifest(e){let t={};for(let[n,r]of Object.entries(e??{})){t[n]={};for(let[e,i]of Object.entries(r))t[n][e]={graph:{edges:[],nodes:[]},workflowId:i.workflowId}}return t}function convertClassesManifest(e){let t={};for(let[n,r]of Object.entries(e??{})){t[n]={};for(let[e,i]of Object.entries(r))t[n][e]={classId:i.classId}}return t}function toRelativeImportSpecifier(e,t){let n=relative(e,t).replaceAll(`\\`,`/`);return n.startsWith(`./`)||n.startsWith(`../`)?n:`./${n}`}function resolveFirstExistingPath(e){for(let t of e)if(existsSync(t))return{id:resolve(t)}}async function writeWorkflowBundleAtomically(e,n){await mkdir(dirname(e),{recursive:!0});let r=`${e}.${process.pid}.${Date.now()}.tmp`;await writeFile(r,n),await rename(r,e)}function mergeWorkflowManifest(e,t){e.steps=mergeWorkflowManifestSection(e.steps,t.steps),e.workflows=mergeWorkflowManifestSection(e.workflows,t.workflows),e.classes=mergeWorkflowManifestSection(e.classes,t.classes)}function mergeWorkflowManifestSection(e,t){if(t===void 0)return e;let n={...e};for(let[e,r]of Object.entries(t))n[e]={...n[e],...r};return n}function createManifestRelativeFilepath(e,t){let n=t.replaceAll(`\\`,`/`),i=relative(e.replaceAll(`\\`,`/`),n).replaceAll(`\\`,`/`);return i.startsWith(`../`)&&(i=i.split(`/`).filter(e=>e!==`..`).join(`/`)),i}function isJavaScriptLikePath(e){return/\.(?:[cm]?[jt]sx?)$/.test(e)}async function atomicWriteFile(e,t){let n=`${e}.tmp-${process.pid}-${Date.now().toString(36)}`;await writeFile(n,t),await rename(n,e)}export{WORKFLOW_VIRTUAL_ENTRY_ID,atomicWriteFile,bundleFinalWorkflowOutput,bundleWorkflowStepRegistrations,collectWorkflowInputFiles,convertClassesManifest,convertStepsManifest,convertWorkflowsManifest,createEvePackageImportsPlugin,createWorkflowImport,createWorkflowNodeBuiltinGuardPlugin,createWorkflowPseudoPackagePlugin,createWorkflowRuntimeAliasPlugin,createWorkflowTransformPlugin,createWorkflowVirtualEntryPlugin};

package/dist/src/internal/workflow-bundle/builder.d.ts

@@ -0,0 +1,36 @@
+import { type WorkflowBundleBuilderConfig, type WorkflowBundleCreateWorkflowsBundleOptions, type WorkflowBundleCreateWorkflowsBundleResult, type WorkflowBundleDiscoveredEntries } from "#internal/workflow-bundle/builder-support.js";
+import { type WorkflowManifest } from "#internal/workflow-bundle/workflow-builders.js";
+export declare class WorkflowBundleBuilder {
+    #private;
+    protected readonly config: WorkflowBundleBuilderConfig;
+    constructor(options: WorkflowBundleBuilderOptions);
+    build(options?: {
+        nitroStepOutfile?: string;
+        nitroWorkflowOutfile?: string;
+    }): Promise<void>;
+    protected get transformProjectRoot(): string;
+    protected findTsConfigPath(): Promise<string | undefined>;
+    protected getInputFiles(): Promise<string[]>;
+    protected discoverEntries(inputs: readonly string[], _outdir: string, _tsconfigPath?: string): Promise<WorkflowBundleDiscoveredEntries>;
+    protected createWorkflowsBundle({ bundleFinalOutput, discoveredEntries, format, inputFiles, keepInterimBundleContext, outfile, tsconfigPath, }: WorkflowBundleCreateWorkflowsBundleOptions): Promise<WorkflowBundleCreateWorkflowsBundleResult>;
+    protected createManifest({ manifest, manifestDir, }: {
+        manifest: WorkflowManifest;
+        manifestDir: string;
+        workflowBundlePath: string;
+    }): Promise<string | undefined>;
+    buildVercelOutput(options: {
+        flowNitroOutputDir: string;
+        outputDir: string;
+        runtime?: string;
+    }): Promise<void>;
+}
+interface WorkflowBundleBuilderOptions {
+    appRoot: string;
+    compiledArtifactsBootstrapPath: string;
+    outDir: string;
+    rootDir: string;
+    watch: boolean;
+    /** Test-harness-only: also scans `src/internal/testing/`. */
+    includeTestFixtures?: boolean;
+}
+export {};

package/dist/src/internal/workflow-bundle/builder.js

@@ -0,0 +1,5 @@
+import{dirname,join,relative,resolve}from"node:path";import{cp,mkdir,readFile,rm,writeFile}from"node:fs/promises";import{resolvePackageSourceDirectoryPath,resolveWorkflowModulePath}from"#internal/application/package.js";import{normalizeEsmImportSpecifier}from"#internal/application/import-specifier.js";import{buildWithNitroRolldown,getSingleRolldownChunk}from"#internal/bundler/nitro-rolldown.js";import{prepareEveVersionedCacheDirectory,writeEveVersionedCacheMetadata}from"#internal/application/cache-metadata.js";import{WORKFLOW_BUILDER_DEFERRED_PACKAGES,WORKFLOW_STEP_EXTERNAL_PACKAGES,copyNitroFunctionDirectory,createWorkflowFunctionEnvironment,retargetNitroFunctionDirectoryToWorkflowRoute}from"#internal/workflow-bundle/vercel-workflow-output.js";import{WORKFLOW_QUEUE_TRIGGER,detectWorkflowPatterns}from"#internal/workflow-bundle/workflow-builders.js";import{Buffer}from"node:buffer";import{WORKFLOW_VIRTUAL_ENTRY_ID,atomicWriteFile,bundleFinalWorkflowOutput,collectWorkflowInputFiles,convertClassesManifest,convertStepsManifest,convertWorkflowsManifest,createEvePackageImportsPlugin,createWorkflowImport,createWorkflowNodeBuiltinGuardPlugin,createWorkflowPseudoPackagePlugin,createWorkflowTransformPlugin,createWorkflowVirtualEntryPlugin}from"#internal/workflow-bundle/builder-support.js";import{writeNitroStepEntrypoint}from"#internal/workflow-bundle/nitro-step-entry.js";const workflowBundleBuildLocks=new Map;var WorkflowBundleBuilder=class{#e;#t;config;#n=new WeakMap;constructor(e){let t=[resolvePackageSourceDirectoryPath(`src/execution`)];e.includeTestFixtures===!0&&t.push(resolvePackageSourceDirectoryPath(`src/internal/testing`)),this.config={buildTarget:`standalone`,dirs:t,externalPackages:[...WORKFLOW_STEP_EXTERNAL_PACKAGES,...WORKFLOW_BUILDER_DEFERRED_PACKAGES],projectRoot:e.appRoot,watch:e.watch,workingDir:e.rootDir},this.#e=e.compiledArtifactsBootstrapPath,this.#t=e.outDir}async build(e={}){let t=(workflowBundleBuildLocks.get(this.#t)??Promise.resolve()).then(()=>this.#r(e));workflowBundleBuildLocks.set(this.#t,t.catch(()=>{})),await t}async#r(n){await prepareEveVersionedCacheDirectory(this.#t);let r=await this.#i();if(r.length===0)throw Error(`Expected the execution workflow source file under "${resolvePackageSourceDirectoryPath(`src/execution`)}".`);let i=await this.findTsConfigPath();await mkdir(this.#t,{recursive:!0});let o=await this.discoverEntries(r,this.#t,i),s=join(this.#t,`workflows.mjs`),{manifest:c}=await this.createWorkflowsBundle({discoveredEntries:o,keepInterimBundleContext:!1,outfile:s,bundleFinalOutput:!1,format:`esm`,inputFiles:r,tsconfigPath:i}),d=join(this.#t,`steps.mjs`),f=await writeNitroStepEntrypoint({builtinsPath:resolveWorkflowModulePath(`workflow/internal/builtins`),discoveredEntries:o,outfile:d,preferAbsoluteFileImports:!0,projectRoot:this.config.projectRoot??this.config.workingDir,workingDir:this.config.workingDir}),p=n.nitroStepOutfile;p!==void 0&&p!==d&&await writeNitroStepEntrypoint({builtinsPath:resolveWorkflowModulePath(`workflow/internal/builtins`),discoveredEntries:o,outfile:p,preferAbsoluteFileImports:!0,projectRoot:this.config.projectRoot??this.config.workingDir,workingDir:this.config.workingDir}),await addStepRegistrationsImport(s,d),await rewriteWorkflowRuntimeImports(s),await rewriteWorkflowCodeLiteral(s);let g=n.nitroWorkflowOutfile;g!==void 0&&g!==s&&(await mkdir(dirname(g),{recursive:!0}),await mirrorFileBypassingUnlink(s,g),p!==void 0&&(await addStepRegistrationsImport(g,p),await rewriteWorkflowRuntimeImports(g),await rewriteWorkflowCodeLiteral(g))),await this.createManifest({workflowBundlePath:join(this.#t,`workflows.mjs`),manifestDir:this.#t,manifest:{steps:{...f.steps,...c.steps},workflows:{...f.workflows,...c.workflows},classes:{...f.classes,...c.classes}}}),await writeEveVersionedCacheMetadata(this.#t)}get transformProjectRoot(){return this.config.projectRoot??this.config.workingDir}async findTsConfigPath(){let n=this.config.workingDir;for(;;){for(let e of[`tsconfig.json`,`jsconfig.json`]){let r=join(n,e);try{return await readFile(r),r}catch(e){if(!(e instanceof Error&&`code`in e&&e.code===`ENOENT`))throw e}}let r=dirname(n);if(r===n)return;n=r}}async getInputFiles(){let e=this.config.dirs.map(e=>resolve(this.config.workingDir,e));return(await Promise.all(e.map(e=>collectWorkflowInputFiles(e)))).flat()}async discoverEntries(e,t,n){let r=this.#n.get(e);if(r!==void 0)return r;let i={discoveredSerdeFiles:[],discoveredSteps:[],discoveredWorkflows:[]};for(let t of e){let e=detectWorkflowPatterns(await readFile(t,`utf8`));e.hasUseStep&&i.discoveredSteps.push(t),e.hasUseWorkflow&&i.discoveredWorkflows.push(t),e.hasSerde&&i.discoveredSerdeFiles.push(t)}return this.#n.set(e,i),i}async createWorkflowsBundle({bundleFinalOutput:t=!0,discoveredEntries:n,format:r=`cjs`,inputFiles:i,keepInterimBundleContext:a=this.config.watch,outfile:o,tsconfigPath:s}){let c=n??await this.discoverEntries(i,dirname(o),s),l=[...c.discoveredWorkflows].sort(),u=new Set(l),d=[...c.discoveredSerdeFiles].sort().filter(e=>!u.has(e)),m={},h=[...l.map(e=>createWorkflowImport(e,this.config.workingDir)),...d.map(e=>createWorkflowImport(e,this.config.workingDir))].join(`
+`);return await bundleFinalWorkflowOutput({bundleFinalOutput:t,code:getSingleRolldownChunk(await buildWithNitroRolldown({cwd:this.config.workingDir,input:WORKFLOW_VIRTUAL_ENTRY_ID,platform:`neutral`,plugins:[createWorkflowVirtualEntryPlugin(h),createWorkflowPseudoPackagePlugin(),createEvePackageImportsPlugin(this.config.workingDir,{workflowCondition:!0}),createWorkflowTransformPlugin({manifest:m,projectRoot:this.transformProjectRoot,sideEffectFiles:[...l,...d],workingDir:this.config.workingDir}),createWorkflowNodeBuiltinGuardPlugin()],resolve:{conditionNames:[`eve-source`,`workflow`,`node`,`import`,`default`],extensions:[`.ts`,`.tsx`,`.mts`,`.cts`,`.js`,`.jsx`,`.mjs`,`.cjs`],mainFields:[`module`,`main`]},tsconfig:s??!1,write:!1,output:{banner:`globalThis.__private_workflows = new Map();`,codeSplitting:!1,comments:!1,format:`cjs`,sourcemap:`inline`}}),`intermediate workflow bundle for "${o}"`).code,format:r,outfile:o,workingDir:this.config.workingDir}),a?{bundleFinal:async e=>{await bundleFinalWorkflowOutput({bundleFinalOutput:t,code:e,format:r,outfile:o,workingDir:this.config.workingDir})},interimBundleCtx:void 0,manifest:m}:{manifest:m}}async createManifest({manifest:e,manifestDir:n}){let r={version:`1.0.0`,steps:convertStepsManifest(e.steps),workflows:convertWorkflowsManifest(e.workflows),classes:convertClassesManifest(e.classes)},i=JSON.stringify(r,null,2);return await mkdir(n,{recursive:!0}),await writeFile(join(n,`manifest.json`),i),i}async buildVercelOutput(e){await this.build();let n=join(this.#t,`vercel-build-output`,`functions`,`.well-known`,`workflow`,`v1`),r=join(n,`flow.func`),o=join(e.outputDir,`functions`,`.well-known`,`workflow`,`v1`),c=join(e.flowNitroOutputDir,`functions`,`__server.func`),l=join(e.flowNitroOutputDir,`functions`,`.well-known`,`workflow`,`v1`,`flow.func`),u=join(o,`flow.func`),d=join(o,`step.func`),f=join(o,`webhook`,`[token].func`);await copyNitroFunctionDirectory({fallbackPath:c,sourcePath:l,targetPath:r}),await Promise.all([this.#a(r,{experimentalTriggers:Array.from([WORKFLOW_QUEUE_TRIGGER]),maxDuration:`max`,runtime:e.runtime??null,shouldAddHelpers:!1}),cp(join(this.#t,`manifest.json`),join(n,`manifest.json`))]),await retargetNitroFunctionDirectoryToWorkflowRoute({functionDirectoryPath:r,workflowRoutePath:`/.well-known/workflow/v1/flow`}),await Promise.all([rm(u,{force:!0,recursive:!0}),rm(d,{force:!0,recursive:!0}),rm(f,{force:!0,recursive:!0})]),await mkdir(o,{recursive:!0}),await Promise.all([cp(r,u,{recursive:!0}),cp(join(n,`manifest.json`),join(o,`manifest.json`))])}async#i(){return[...await this.getInputFiles(),this.#e]}async#a(e,n){let r=join(e,`.vc-config.json`),i=await this.#o(r),a={...i};a.environment=createWorkflowFunctionEnvironment(i.environment),n.runtime!==null&&(a.runtime=n.runtime),n.maxDuration!==void 0&&(a.maxDuration=n.maxDuration),n.shouldAddHelpers!==void 0&&(a.shouldAddHelpers=n.shouldAddHelpers),n.shouldAddSourcemapSupport!==void 0&&(a.shouldAddSourcemapSupport=n.shouldAddSourcemapSupport),n.experimentalTriggers!==void 0&&(a.experimentalTriggers=[...n.experimentalTriggers]),await writeFile(r,`${JSON.stringify(a,null,2)}\n`)}async#o(e){try{let t=JSON.parse(await readFile(e,`utf8`));if(typeof t==`object`&&t)return t}catch{}return{}}};async function addStepRegistrationsImport(t,n){let r=await readTextFileIfPresent(t);if(r===null||r.includes(`__eveWorkflowStepsRegistered`))return;let i=createRelativeImportSpecifier(dirname(t),n),a=[`import { __steps_registered as __eveWorkflowStepsRegistered } from ${JSON.stringify(i)};`,`void __eveWorkflowStepsRegistered;`,``].join(`
+`),o=r.match(/^import\s.+?;\n/m);if(o===null||o.index===void 0){await atomicWriteFile(t,`${a}${r}`);return}let s=o.index+o[0].length;await atomicWriteFile(t,`${r.slice(0,s)}${a}${r.slice(s)}`)}async function rewriteWorkflowRuntimeImports(e){let t=await readTextFileIfPresent(e);if(t===null)return;let n=t;for(let e of[`workflow`,`workflow/api`,`workflow/internal/builtins`,`workflow/internal/private`,`workflow/runtime`]){let t=normalizeImportSpecifierPath(resolveWorkflowModulePath(e));n=replaceStringLiteralSpecifier(n,e,t)}n!==t&&await atomicWriteFile(e,n)}async function rewriteWorkflowCodeLiteral(e){let t=await readTextFileIfPresent(e);if(t===null)return;let n=t.indexOf(`const workflowCode = `),r=t.lastIndexOf(`;
+
+export const POST = workflowEntrypoint(workflowCode);`);if(n===-1||r===-1||r<=n)return;let i=n+21,a=t.slice(i,r);if(!a.trimStart().startsWith("`"))return;let o=decodeWorkflowCodeTemplateLiteral(a,e),s=`${t.slice(0,i)}${encodeWorkflowCodeLiteral(o)}${t.slice(r)}`;s!==t&&await atomicWriteFile(e,s)}function encodeWorkflowCodeLiteral(e){let t=Buffer.from(e,`utf8`).toString(`base64`).match(/.{1,16384}/g)??[``];return`Buffer.from(${JSON.stringify(t)}.join(""), "base64").toString("utf8")`}function decodeWorkflowCodeTemplateLiteral(e,t){let n=e.trim();if(!n.startsWith("`")||!n.endsWith("`"))throw Error(`Expected generated workflow code literal in "${t}" to be a template.`);let r=n.slice(1,-1),i=``;for(let e=0;e<r.length;e+=1){let t=r[e];if(t!==`\\`){i+=t;continue}let n=r[e+1];if(n===`\\`||n==="`"||n===`$`){i+=n,e+=1;continue}i+=t}return i}function replaceStringLiteralSpecifier(e,t,n){return e.replaceAll(JSON.stringify(t),JSON.stringify(n)).replaceAll(`'${t}'`,JSON.stringify(n))}function normalizeImportSpecifierPath(e){return normalizeEsmImportSpecifier(e)}function createRelativeImportSpecifier(e,t){let r=relative(e,t).replaceAll(`\\`,`/`);return r.startsWith(`.`)?r:`./${r}`}async function readTextFileIfPresent(e){try{return await readFile(e,`utf8`)}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return null;throw e}}async function readBinaryFileIfPresent(e){try{return await readFile(e)}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return null;throw e}}async function mirrorFileBypassingUnlink(e,t){let n=await readFile(e),r=await readBinaryFileIfPresent(t);r!==null&&r.equals(n)||await atomicWriteFile(t,n)}export{WorkflowBundleBuilder};

package/dist/src/internal/workflow-bundle/dynamic-tool-transform.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Compiler transform for dynamic tool files.
+ *
+ * Hoists inline `execute` functions from `defineDynamic`
+ * event handler return values to module-scope named functions
+ * registered in the global step registry. The workflow SDK then
+ * handles serialization and replay.
+ *
+ * The walker enters nested functions (helpers, callbacks, IIFEs) so
+ * patterns like `function buildTool(n) { return { execute() {} } }`
+ * are supported. For each execute found, scope variables from every
+ * enclosing function between the handler and the execute are
+ * collected. Only variables the execute body actually references are
+ * captured — this avoids TDZ errors from later declarations.
+ *
+ * At each call site the inline execute is replaced with:
+ * - A wrapper that passes referenced scope values as `__vars`
+ * - `__executeStepFn`: reference to the hoisted function
+ * - `__closureVars`: snapshot for durable serialization
+ *
+ * Limitation: `execute` must be an inline function literal (function
+ * expression, arrow, or method shorthand). Variable references
+ * (`execute: myFn`) and call results (`execute: makeFn()`) are not
+ * detected — the transform returns null and the tool works on the
+ * first workflow step but is not replayable.
+ */
+/**
+ * Transforms a dynamic tool file:
+ * 1. Hoists execute functions to module scope with "use step"
+ * 2. Captures handler-scope variables via __vars parameter
+ * 3. Adds "use step" to event handlers so the workflow SDK caches
+ *    the handler's return value (resolver runs once per scope)
+ *
+ * Returns null if the file doesn't contain a dynamic tool pattern.
+ */
+export declare function transformDynamicToolExecute(filename: string, source: string): Promise<{
+    code: string;
+} | null>;
+export { transformDynamicToolExecute as transformDynamicToolAwait };

package/dist/src/internal/workflow-bundle/dynamic-tool-transform.js

@@ -0,0 +1,4 @@
+import{loadNitroRolldownParseAst}from"#internal/bundler/nitro-rolldown.js";let transformCounter=0;async function transformDynamicToolExecute(e,t){if(!t.includes(`defineDynamic`)||!t.includes(`events`)||!t.includes(`execute`))return null;let n=findDynamicToolHandlers(t,await parseSource(e,t));return n.every(e=>e.executes.length===0)?null:applyTransform(t,n)}async function parseSource(t,n){let{parseAst:r}=await loadNitroRolldownParseAst();return r(n,{astType:`ts`,lang:inferLang(t),range:!0,sourceType:`module`},t)}function inferLang(e){return e.endsWith(`.tsx`)?`tsx`:e.endsWith(`.jsx`)?`jsx`:e.endsWith(`.js`)||e.endsWith(`.mjs`)||e.endsWith(`.cjs`)?`js`:`ts`}function findDynamicToolHandlers(e,t){let n=[];return walkNode(t,t=>{if(t.type===`CallExpression`&&t.callee?.type===`Identifier`&&t.callee.name===`defineDynamic`&&t.arguments?.length===1){let r=t.arguments[0];if(r.type===`ObjectExpression`){let t=findProperty(r,`events`);t?.value&&t.value.type===`ObjectExpression`&&collectHandlers(e,t.value,n)}return!1}return!0}),n}function collectHandlers(e,t,n){for(let r of t.properties??[]){if(r.type!==`Property`)continue;let t=r.value;if(!t||t.type!==`ArrowFunctionExpression`&&t.type!==`FunctionExpression`)continue;let i=t.body;if(!i)continue;let a=findBlockBodyStart(i);if(a===null)continue;let o=extractParamNames(t),s=collectScopeVarDeclarations(i),c=findExecuteFunctions(e,i);c.length>0&&n.push({handlerNode:t,bodyStart:a,scopeVars:s,paramNames:o,executes:c})}}function findBlockBodyStart(e){return e.type===`BlockStatement`&&e.start!==void 0?e.start:typeof e.body==`object`&&!Array.isArray(e.body)&&e.body?.type===`BlockStatement`&&e.body.start!==void 0?e.body.start:null}function extractParamNames(e){let t=[];for(let n of e.params??[])n.type===`Identifier`&&n.name&&t.push(n.name);return t}function collectScopeVarDeclarations(e){let t=[];return collectVarsRecursive(e,t),t}function collectVarsRecursive(e,t){if(!e||e.type===`FunctionExpression`||e.type===`ArrowFunctionExpression`||e.type===`FunctionDeclaration`)return;if(e.type===`VariableDeclaration`)for(let n of e.declarations??[])collectDeclaredNames(n,t);e.type===`ForStatement`&&e.init&&collectVarsRecursive(e.init,t);let n=e;if((e.type===`ForInStatement`||e.type===`ForOfStatement`)&&e.left&&collectVarsRecursive(e.left,t),Array.isArray(e.body))for(let n of e.body)collectVarsRecursive(n,t);else e.body&&typeof e.body==`object`&&`type`in e.body&&collectVarsRecursive(e.body,t);if(e.declarations)for(let n of e.declarations)collectVarsRecursive(n,t);if(e.expression&&collectVarsRecursive(e.expression,t),Array.isArray(n.consequent))for(let e of n.consequent)collectVarsRecursive(e,t);else n.consequent&&collectVarsRecursive(n.consequent,t);if(n.alternate&&collectVarsRecursive(n.alternate,t),n.block&&collectVarsRecursive(n.block,t),n.handler&&collectVarsRecursive(n.handler,t),n.finalizer&&collectVarsRecursive(n.finalizer,t),n.cases&&Array.isArray(n.cases))for(let e of n.cases)collectVarsRecursive(e,t)}function collectDeclaredNames(e,t){e.type===`VariableDeclarator`&&collectPatternNames(e.id,t)}function collectPatternNames(e,t){if(e){if(e.type===`Identifier`&&e.name){t.push(e.name);return}if(e.type===`ObjectPattern`)for(let n of e.properties??[])n.type===`Property`?collectPatternNames(n.value,t):n.type===`RestElement`&&collectPatternNames(n.argument,t);if(e.type===`ArrayPattern`)for(let n of e.elements??[])n&&collectPatternNames(n,t)}}function findExecuteFunctions(e,t){let n=[];return walkForExecuteProps(e,t,n,[]),n}function walkForExecuteProps(e,n,r,i){if(!n)return;if(n.type===`FunctionExpression`||n.type===`ArrowFunctionExpression`||n.type===`FunctionDeclaration`){let t=extractParamNames(n),a=n.body;if(!a)return;let o=collectScopeVarDeclarations(a),s=[...i,{params:t,vars:o}];a.type,walkForExecuteProps(e,a,r,s);return}if(n.type===`CallExpression`&&n.callee?.type===`Identifier`&&n.callee.name===`defineTool`&&n.arguments?.length===1&&n.arguments[0].type===`ObjectExpression`){let a=n.arguments[0];for(let n of a.properties??[])if(n.type===`Property`&&!n.computed&&n.key?.type===`Identifier`&&n.key.name===`execute`&&n.start!==void 0&&n.end!==void 0){let a=n.value;if(!a||a.start===void 0||a.end===void 0)continue;let o=a.type===`FunctionExpression`||a.type===`ArrowFunctionExpression`,s=n.method===!0;if(o||s){let o=extractFnParams(e,a),s=extractFnBody(e,a),c=a.async===!0;r.push({propStart:n.start,propEnd:n.end,fnSource:e.slice(a.start,a.end),isAsync:c,params:o,body:s,hoistedName:`__eve_dynamic_exec_${transformCounter++}`,nestedScopes:i})}}return}let walk=t=>walkForExecuteProps(e,t,r,i);if(Array.isArray(n.body))for(let e of n.body)walk(e);else n.body&&typeof n.body==`object`&&`type`in n.body&&walk(n.body);if(n.properties)for(let e of n.properties)e.value&&typeof e.value==`object`&&`type`in e.value&&walk(e.value);if(n.callee&&walk(n.callee),n.arguments)for(let e of n.arguments)walk(e);if(n.expression&&walk(n.expression),n.argument&&walk(n.argument),n.init&&walk(n.init),n.left&&walk(n.left),n.right&&walk(n.right),n.declarations)for(let e of n.declarations)walk(e);let a=n;if(Array.isArray(a.consequent))for(let e of a.consequent)walk(e);else a.consequent&&walk(a.consequent);if(a.alternate&&walk(a.alternate),a.block&&walk(a.block),a.handler&&walk(a.handler),a.finalizer&&walk(a.finalizer),a.cases&&Array.isArray(a.cases))for(let e of a.cases)walk(e)}function extractFnParams(e,t){if(!t.params||t.params.length===0)return``;let n=t.params[0],r=t.params[t.params.length-1];return n.start===void 0||r.end===void 0?``:e.slice(n.start,r.end)}function extractFnBody(e,t){let n=t.body;if(!n||n.start===void 0||n.end===void 0)return`{}`;let r=e.slice(n.start,n.end);return t.type===`ArrowFunctionExpression`&&n.type!==`BlockStatement`?`{ return ${r}; }`:r}function applyTransform(e,t){let n=[],r=[],i=[],a=[];for(let e of t)for(let t of e.executes){let o=[...e.paramNames,...e.scopeVars,...t.nestedScopes.flatMap(e=>[...e.params,...e.vars])],s=new Set,c=[];for(let e=o.length-1;e>=0;e--)s.has(o[e])||(s.add(o[e]),c.unshift(o[e]));let l=t.body,u=extractExecuteParamNames(t.params),d=c.filter(e=>!u.has(e)&&RegExp(`\\b${escapeForRegex(e)}\\b`).test(l)),f=d.length>0?`{ ${d.join(`, `)} }`:`{}`,p=t.isAsync?`async `:``,m=d.length>0?`const ${f} = __vars;\n  `:``,h=t.params,g=h?`__vars, ${h}`:`__vars`,_=t.body.slice(1,-1).trim(),v=`eve:dynamic-tool//${t.hoistedName}`;r.push(`${p}function ${t.hoistedName}(${g}) {\n  ${m}${_}\n}`),i.push(`${t.hoistedName}.stepId = ${JSON.stringify(v)};`),i.push(`__eveStepRegistry.set(${JSON.stringify(v)}, ${t.hoistedName});`),a.push(t.hoistedName);let y=h||``,b=h?splitParamsTopLevel(h).map(e=>extractParamBindingName(e)).join(`, `):``,x=b?`${f}, ${b}`:f,S=t.isAsync?`async `:``,C=t.isAsync?`await `:``;n.push({start:t.propStart,end:t.propEnd,text:[`execute: ${S}(${y}) => ${C}${t.hoistedName}(${x})`,`__executeStepFn: ${t.hoistedName}`,`__closureVars: ${f}`].join(`,
+          `)})}let o=[...n].sort((e,t)=>t.start-e.start),s=e;for(let e of o)s=s.slice(0,e.start)+e.text+s.slice(e.end);s=`${[`var __eveStepRegistrySym = Symbol.for("@workflow/core//registeredSteps");`,`if (!globalThis[__eveStepRegistrySym]) globalThis[__eveStepRegistrySym] = new Map();`,`var __eveStepRegistry = globalThis[__eveStepRegistrySym];`].join(`
+`)}\n${s}`;let c=[...r,...i];return c.length>0&&(s=`${s}\n\n${c.join(`
+`)}\n`),{code:s}}function walkNode(e,t){if(t(e)){if(Array.isArray(e.body))for(let n of e.body)walkNode(n,t);else e.body&&typeof e.body==`object`&&`type`in e.body&&walkNode(e.body,t);if(e.declarations)for(let n of e.declarations)walkNode(n,t);if(e.init&&walkNode(e.init,t),e.expression&&walkNode(e.expression,t),e.declaration&&walkNode(e.declaration,t),e.argument&&walkNode(e.argument,t),e.arguments)for(let n of e.arguments)walkNode(n,t);if(e.properties)for(let n of e.properties)walkNode(n,t),n.value&&typeof n.value==`object`&&`type`in n.value&&walkNode(n.value,t);e.left&&walkNode(e.left,t),e.right&&walkNode(e.right,t)}}function findProperty(e,t){return e.properties?.find(e=>e.type===`Property`&&!e.computed&&e.key?.type===`Identifier`&&e.key.name===t)}function escapeForRegex(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function splitParamsTopLevel(e){let t=[],n=0,r=0;for(let i=0;i<e.length;i++){let a=e[i];a===`<`||a===`(`||a===`[`||a===`{`?n++:a===`>`||a===`)`||a===`]`||a===`}`?n--:a===`,`&&n===0&&(t.push(e.slice(r,i)),r=i+1)}return t.push(e.slice(r)),t}function extractParamBindingName(e){let t=e.trim(),n=0;for(let e=0;e<t.length;e++){let r=t[e];if(r===`<`||r===`(`||r===`[`||r===`{`)n++;else if(r===`>`||r===`)`||r===`]`||r===`}`)n--;else if(n===0&&(r===`:`||r===`=`))return t.slice(0,e).trim()}return t}function extractExecuteParamNames(e){if(!e)return new Set;let t=new Set;for(let n of splitParamsTopLevel(e)){let e=extractParamBindingName(n);e&&t.add(e)}return t}export{transformDynamicToolExecute as transformDynamicToolAwait,transformDynamicToolExecute};

package/dist/src/internal/workflow-bundle/eve-service-route-output.d.ts

@@ -0,0 +1,4 @@
+export declare const EVE_SHARED_SERVER_FUNCTION_PATH = "eve/__server.func";
+export declare function isEveVercelFunctionPath(path: string): boolean;
+export declare function normalizeEveVercelRoutes(routes: readonly unknown[], servicePrefix: string | undefined): unknown[];
+export declare function applyEveServiceRoutePrefixWrapper(functionPath: string, servicePrefix: string): Promise<void>;

package/dist/src/internal/workflow-bundle/eve-service-route-output.js

@@ -0,0 +1,54 @@
+import{join}from"node:path";import{readFile,writeFile}from"node:fs/promises";const EVE_SHARED_SERVER_FUNCTION_PATH=`eve/__server.func`,EVE_SERVICE_ROUTE_PREFIX_WRAPPER=`index.__eve_service_route_prefix.mjs`,EVE_VERCEL_FUNCTION_PREFIXES=[`eve/`,`.well-known/workflow/`];function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function isEveVercelFunctionPath(e){return EVE_VERCEL_FUNCTION_PREFIXES.some(t=>e.startsWith(t))}function normalizeEveVercelRoutes(e,t){return e.filter(isEveVercelRoute).map(e=>normalizeEveVercelRoute(e,t))}function isEveVercelRoute(e){if(!isRecord(e)||`handle`in e)return!0;let t=typeof e.src==`string`?e.src:``,n=typeof e.dest==`string`?e.dest:``;return isEveVercelRoutePath(t)||isEveVercelRoutePath(n)}function isEveVercelRoutePath(e){return e.includes(`/eve/v1`)||e.includes(`/.well-known/workflow/`)}function isEveProtocolRoutePath(e){return e.includes(`/eve/v1`)}function normalizeEveVercelRoute(e,t){if(!isRecord(e)||`handle`in e||typeof e.src!=`string`)return e;let n=isEveProtocolRoutePath(e.src)||typeof e.dest==`string`&&isEveProtocolRoutePath(e.dest),r={...e,src:prefixEveVercelRoutePath(e.src,t)};return n&&(r.dest=`/eve/__server`),r}function prefixEveVercelRoutePath(e,t){if(t===void 0||t===`/`||!isEveVercelRoutePath(e)||e.includes(t))return e;let n=t.endsWith(`/`)?t.slice(0,-1):t,r=n.replaceAll(`/`,`\\/`);return e.includes(r)?e:e.startsWith(`^(?:/`)?`^(?:${n}${e.slice(4)}`:e.startsWith(`^/`)?`^${n}${e.slice(1)}`:e.startsWith(`/`)?`${n}${e}`:e}async function applyEveServiceRoutePrefixWrapper(r,i){let a=join(r,`.vc-config.json`),o=join(r,EVE_SERVICE_ROUTE_PREFIX_WRAPPER),s=JSON.parse(await readFile(a,`utf8`)),c=isRecord(s)?s:{};await writeFile(o,createEveServiceRoutePrefixWrapper(i)),await writeFile(a,`${JSON.stringify({...c,handler:EVE_SERVICE_ROUTE_PREFIX_WRAPPER},null,2)}\n`)}function createEveServiceRoutePrefixWrapper(e){return`
+import { Server } from "node:http";
+
+const SERVICE_PREFIX = ${JSON.stringify(normalizeServiceRoutePrefix(e))};
+const PATCH_SYMBOL = Symbol.for("eve.service.route-prefix-strip.patch");
+
+function stripServiceRoutePrefix(requestUrl) {
+  if (typeof requestUrl !== "string" || requestUrl === "*") {
+    return requestUrl;
+  }
+
+  const queryIndex = requestUrl.indexOf("?");
+  const rawPath = queryIndex === -1 ? requestUrl : requestUrl.slice(0, queryIndex);
+  const query = queryIndex === -1 ? "" : requestUrl.slice(queryIndex);
+  const path = rawPath.startsWith("/") ? rawPath : \`/\${rawPath}\`;
+
+  if (path === SERVICE_PREFIX) {
+    return \`/\${query}\`;
+  }
+
+  if (path.startsWith(\`\${SERVICE_PREFIX}/\`)) {
+    return path.slice(SERVICE_PREFIX.length) + query;
+  }
+
+  return path + query;
+}
+
+if (!globalThis[PATCH_SYMBOL]) {
+  globalThis[PATCH_SYMBOL] = true;
+  const originalEmit = Server.prototype.emit;
+  Server.prototype.emit = function patchedEmit(event, request, ...args) {
+    if ((event === "request" || event === "upgrade") && request && typeof request.url === "string") {
+      request.url = stripServiceRoutePrefix(request.url);
+    }
+
+    return originalEmit.call(this, event, request, ...args);
+  };
+}
+
+const originalModule = await import("./index.mjs");
+const entrypoint = originalModule?.default ?? originalModule;
+
+export const handleUpgrade = originalModule.handleUpgrade
+  ? (request, socket, head) => {
+      if (request && typeof request.url === "string") {
+        request.url = stripServiceRoutePrefix(request.url);
+      }
+
+      return originalModule.handleUpgrade(request, socket, head);
+    }
+  : undefined;
+
+export default entrypoint;
+`.trimStart()}function normalizeServiceRoutePrefix(e){let t=(e.startsWith(`/`)?e:`/${e}`).replace(/\/+$/,``);return t.length===0?`/`:t}export{EVE_SHARED_SERVER_FUNCTION_PATH,applyEveServiceRoutePrefixWrapper,isEveVercelFunctionPath,normalizeEveVercelRoutes};

package/dist/src/internal/workflow-bundle/nitro-step-entry.d.ts

@@ -0,0 +1,17 @@
+import { type WorkflowManifest } from "#internal/workflow-bundle/workflow-builders.js";
+export interface NitroStepEntrypointDiscoveredEntries {
+    readonly discoveredSerdeFiles: readonly string[];
+    readonly discoveredSteps: readonly string[];
+}
+/**
+ * Writes the hosted Nitro step entrypoint source and returns the manifest
+ * metadata discovered from the imported step and serde files.
+ */
+export declare function writeNitroStepEntrypoint(input: {
+    readonly builtinsPath?: string;
+    readonly discoveredEntries: NitroStepEntrypointDiscoveredEntries;
+    readonly outfile: string;
+    readonly preferAbsoluteFileImports?: boolean;
+    readonly projectRoot: string;
+    readonly workingDir: string;
+}): Promise<WorkflowManifest>;

package/dist/src/internal/workflow-bundle/nitro-step-entry.js

@@ -0,0 +1,2 @@
+import{dirname,relative}from"node:path";import{mkdir,readFile,writeFile}from"node:fs/promises";import{normalizeEsmImportSpecifier}from"#internal/application/import-specifier.js";import{applyWorkflowTransform}from"#internal/workflow-bundle/workflow-builders.js";async function writeNitroStepEntrypoint(t){let r=[...t.discoveredEntries.discoveredSteps].sort(),a=new Set(r),o=[...t.discoveredEntries.discoveredSerdeFiles].sort().filter(e=>!a.has(e)),s=await collectNitroStepManifest({projectRoot:t.projectRoot,stepFiles:r,serdeOnlyFiles:o,workingDir:t.workingDir}),c=dirname(t.outfile),l=[`// Generated by Eve. Do not edit by hand.`,...createEntrypointImportLines({builtinsImportSpecifier:t.builtinsPath===void 0?`workflow/internal/builtins`:createFileImportSpecifier({outfileDirectory:c,preferAbsoluteFileImports:t.preferAbsoluteFileImports??!1,targetPath:t.builtinsPath}),outfileDirectory:c,preferAbsoluteFileImports:t.preferAbsoluteFileImports??!1,serdeOnlyFiles:o,stepFiles:r}),`export const __steps_registered = true;`,``].join(`
+`);return await mkdir(c,{recursive:!0}),await readTextFileIfPresent(t.outfile)!==l&&await writeFile(t.outfile,l),s}function createEntrypointImportLines(e){return[e.builtinsImportSpecifier,...e.stepFiles.map(t=>createFileImportSpecifier({outfileDirectory:e.outfileDirectory,preferAbsoluteFileImports:e.preferAbsoluteFileImports,targetPath:t})),...e.serdeOnlyFiles.map(t=>createFileImportSpecifier({outfileDirectory:e.outfileDirectory,preferAbsoluteFileImports:e.preferAbsoluteFileImports,targetPath:t}))].map(e=>`import ${JSON.stringify(e)};`)}function createFileImportSpecifier(e){return e.preferAbsoluteFileImports?normalizeEsmImportSpecifier(e.targetPath):createRelativeImportSpecifier(e.outfileDirectory,e.targetPath)}async function collectNitroStepManifest(e){let t={},n=[...e.stepFiles,...e.serdeOnlyFiles];for(let i of n){let n=await readFile(i,`utf8`);mergeWorkflowManifest(t,(await applyWorkflowTransform(createManifestRelativeFilepath(e.workingDir,i),n,`step`,i,e.projectRoot)).workflowManifest)}return t}function mergeWorkflowManifest(e,t){e.steps=mergeWorkflowManifestSection(e.steps,t.steps),e.workflows=mergeWorkflowManifestSection(e.workflows,t.workflows),e.classes=mergeWorkflowManifestSection(e.classes,t.classes)}function mergeWorkflowManifestSection(e,t){if(t===void 0)return e;let n={...e};for(let[e,r]of Object.entries(t))n[e]={...n[e],...r};return n}function createManifestRelativeFilepath(e,n){let r=n.replaceAll(`\\`,`/`),i=relative(e.replaceAll(`\\`,`/`),r).replaceAll(`\\`,`/`);return i.startsWith(`../`)&&(i=i.split(`/`).filter(e=>e!==`..`).join(`/`)),i}function createRelativeImportSpecifier(e,n){let r=relative(e,n).replaceAll(`\\`,`/`);return r.startsWith(`.`)?r:`./${r}`}async function readTextFileIfPresent(e){try{return await readFile(e,`utf8`)}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return null;throw e}}export{writeNitroStepEntrypoint};

package/dist/src/internal/workflow-bundle/vercel-workflow-output.d.ts

@@ -0,0 +1,66 @@
+export declare const WORKFLOW_STEP_EXTERNAL_PACKAGES: readonly ["@mongodb-js/zstd", "node-liblzma"];
+/**
+ * Packages that must stay external during the initial workflow builder
+ * pass so `node:*` transitive dependencies do not fail the workflow VM check.
+ * Nitro performs the final bundling/tracing pass for hosted output.
+ */
+export declare const WORKFLOW_BUILDER_DEFERRED_PACKAGES: readonly ["@chat-adapter/slack", "chat"];
+/**
+ * Builds the environment block every generated Vercel workflow function needs.
+ */
+export declare function createWorkflowFunctionEnvironment(environment?: unknown): Record<string, unknown>;
+/**
+ * Creates an empty staging directory for one emitted Vercel function.
+ */
+export declare function prepareVercelFunctionDirectory(path: string): Promise<void>;
+/**
+ * Copies a Nitro-bundled Vercel function directory into one standalone
+ * workflow function directory.
+ *
+ * Nitro may emit route functions as symlinks back to `__server.func`. This
+ * helper dereferences the source path first, then copies concrete files so the
+ * generated workflow functions do not rely on symlinks.
+ */
+export declare function copyNitroFunctionDirectory(input: {
+    fallbackPath: string;
+    sourcePath: string;
+    targetPath: string;
+}): Promise<void>;
+/**
+ * Keeps only Eve-owned Vercel function output and rewrites Eve route function
+ * symlinks to a shared Eve-owned server function.
+ *
+ * Nitro emits generic app routes such as `index.func -> ./__server.func` for
+ * Eve's standalone landing page. In a multi-service Next.js deployment those
+ * root aliases collide with Next's own functions. The Next integration only
+ * proxies Eve's `/eve/v1/**` transport routes, so Vercel output should expose
+ * those route functions and workflow trigger functions, not Eve's root page.
+ *
+ * Nitro also dedupes every route function through `__server.func`. Preserve
+ * that model by copying the shared target once into the Eve-owned tree and
+ * repointing Eve route aliases at it before pruning the root target.
+ */
+export declare function normalizeEveVercelFunctionOutput(outputDir: string, options?: {
+    readonly servicePrefix?: string;
+}): Promise<void>;
+/**
+ * Bundles one package-owned workflow handler into a standalone Vercel function
+ * directory without inheriting Nitro's hosted server chunks.
+ */
+export declare function emitBundledWorkflowFunctionDirectory(input: {
+    bundlePath: string;
+    pluginPaths?: readonly string[];
+    targetPath: string;
+}): Promise<void>;
+/**
+ * Rewrites one copied Nitro function directory so its handler always dispatches
+ * to a concrete workflow route path.
+ *
+ * Queue-triggered workflow functions do not guarantee a request URL that
+ * matches Nitro's original route table. This helper keeps Nitro's traced
+ * output intact but swaps the entrypoint with a small URL-rewriting adapter.
+ */
+export declare function retargetNitroFunctionDirectoryToWorkflowRoute(input: {
+    functionDirectoryPath: string;
+    workflowRoutePath: string;
+}): Promise<void>;

package/dist/src/internal/workflow-bundle/vercel-workflow-output.js

@@ -0,0 +1,3 @@
+import{basename,dirname,extname,join,relative}from"node:path";import{cp,mkdir,readFile,readdir,realpath,rename,rm,symlink,writeFile}from"node:fs/promises";import{buildWithNitroRolldown,getSingleRolldownChunk}from"#internal/bundler/nitro-rolldown.js";import{EVE_SHARED_SERVER_FUNCTION_PATH,applyEveServiceRoutePrefixWrapper,isEveVercelFunctionPath,normalizeEveVercelRoutes}from"#internal/workflow-bundle/eve-service-route-output.js";const WORKFLOW_STEP_EXTERNAL_PACKAGES=[`@mongodb-js/zstd`,`node-liblzma`],WORKFLOW_BUILDER_DEFERRED_PACKAGES=[`@chat-adapter/slack`,`chat`];function createWorkflowFunctionEnvironment(e){let t={};return isRecord(e)&&Object.assign(t,e),t.NODE_OPTIONS=`--experimental-require-module`,t}function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}async function prepareVercelFunctionDirectory(e){await rm(e,{force:!0,recursive:!0}),await mkdir(e,{recursive:!0})}async function resolveNitroFunctionDirectory(e){try{return await realpath(e.sourcePath)}catch{return await realpath(e.fallbackPath)}}async function copyNitroFunctionDirectory(e){let t=await resolveNitroFunctionDirectory({fallbackPath:e.fallbackPath,sourcePath:e.sourcePath});await prepareVercelFunctionDirectory(e.targetPath),await cp(t,e.targetPath,{dereference:!0,recursive:!0})}async function normalizeEveVercelFunctionOutput(e,t={}){let n=join(e,`functions`),i=await prepareSharedEveServerFunction(n);i!==null&&(t.servicePrefix!==void 0&&await applyEveServiceRoutePrefixWrapper(i,t.servicePrefix),await repointEveFunctionSymlinksInDirectory(n,i)),await pruneNonEveFunctionEntries(n,n),await pruneNonEveVercelRoutes(e,t.servicePrefix)}async function prepareSharedEveServerFunction(e){let n=join(e,`__server.func`),i=join(e,EVE_SHARED_SERVER_FUNCTION_PATH),s;try{s=await realpath(n)}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return null;throw e}let c=`${i}.eve-staging`;return await mkdir(dirname(i),{recursive:!0}),await rm(c,{force:!0,recursive:!0}),await cp(s,c,{dereference:!0,recursive:!0}),await rm(i,{force:!0,recursive:!0}),await rename(c,i),i}async function repointEveFunctionSymlinksInDirectory(e,t,n=e){let a;try{a=await readdir(e,{withFileTypes:!0})}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return;throw e}await Promise.all(a.map(async a=>{let o=join(e,a.name),s=normalizeVercelOutputPath(relative(n,o));if(a.isSymbolicLink()){a.name.endsWith(`.func`)&&isEveVercelFunctionPath(s)&&await repointFunctionSymlink(o,t);return}a.isDirectory()&&!a.name.endsWith(`.func`)&&await repointEveFunctionSymlinksInDirectory(o,t,n)}))}async function repointFunctionSymlink(e,n){await rm(e,{force:!0,recursive:!0}),await symlink(normalizeVercelOutputPath(relative(dirname(e),n)),e,`dir`)}async function pruneNonEveFunctionEntries(e,t){let n;try{n=await readdir(t,{withFileTypes:!0})}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return;throw e}await Promise.all(n.map(async n=>{let a=join(t,n.name),o=normalizeVercelOutputPath(relative(e,a));if(n.name.endsWith(`.func`)){isEveVercelFunctionPath(o)||await rm(a,{force:!0,recursive:!0});return}n.isDirectory()&&await pruneNonEveFunctionEntries(e,a)}))}async function pruneNonEveVercelRoutes(e,t){let n=join(e,`config.json`),i;try{i=JSON.parse(await readFile(n,`utf8`))}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return;throw e}!isRecord(i)||!Array.isArray(i.routes)||(i.routes=normalizeEveVercelRoutes(i.routes,t),await writeFile(n,`${JSON.stringify(i,null,2)}\n`))}function normalizeVercelOutputPath(e){return e.replaceAll(`\\`,`/`)}async function emitBundledWorkflowFunctionDirectory(e){await prepareVercelFunctionDirectory(e.targetPath);let n=await emitBundledWorkflowPluginModules({build:buildWithNitroRolldown,pluginPaths:e.pluginPaths??[],targetPath:e.targetPath}),i=join(dirname(e.bundlePath),`__eve_workflow_function_entry.js`),a=getSingleRolldownChunk(await buildWithNitroRolldown({cwd:dirname(e.bundlePath),input:i,platform:`node`,plugins:[createVirtualModulePlugin({id:i,moduleType:`js`,source:createWorkflowFunctionEntrypointSource({bundlePath:e.bundlePath,pluginModulePaths:n})})],write:!1,output:{codeSplitting:!1,comments:!1,format:`cjs`,sourcemap:!1}}),`Vercel workflow function for "${e.bundlePath}"`);await Promise.all([writeFile(join(e.targetPath,`index.js`),a.code),writeFile(join(e.targetPath,`package.json`),`${JSON.stringify({type:`commonjs`},null,2)}\n`),writeFile(join(e.targetPath,`.vc-config.json`),`${JSON.stringify({environment:createWorkflowFunctionEnvironment(),handler:`index.js`,launcherType:`Nodejs`,supportsResponseStreaming:!0},null,2)}\n`)])}async function emitBundledWorkflowPluginModules(e){return await Promise.all(e.pluginPaths.map(async(t,n)=>{let i=getSingleRolldownChunk(await e.build({input:t,platform:`node`,write:!1,output:{codeSplitting:!1,comments:!1,format:`esm`,sourcemap:!1}}),`workflow plugin for "${t}"`),a=`__eve_workflow_plugin_${n}.mjs`;return await writeFile(join(e.targetPath,a),i.code),`./${a}`}))}function createVirtualModulePlugin(e){return{name:`eve-virtual-module`,resolveId(t){return t===e.id?e.id:void 0},load(t){return t===e.id?{code:e.source,moduleType:e.moduleType}:void 0}}}function toRelativeImportPath(e){let t=relative(e.fromDirectoryPath,e.toFilePath).replaceAll(`\\`,`/`);return t.startsWith(`.`)?t:`./${t}`}function normalizeImportSpecifierPath(e){return e.replaceAll(`\\`,`/`)}function createWorkflowFunctionEntrypointSource(t){let n=t.pluginModulePaths.map(e=>normalizeImportSpecifierPath(e)),r=n.length>0;return[`const { POST } = require(${JSON.stringify(`./${basename(t.bundlePath)}`)});`,...r?[`const workflowPluginModulePaths = ${JSON.stringify(n)};`,``,`let workflowPluginPromise;`,``,`async function loadWorkflowPlugins() {`,`  if (workflowPluginPromise == null) {`,`    workflowPluginPromise = (async () => {`,`      for (const pluginPath of workflowPluginModulePaths) {`,`        await import(pluginPath);`,`      }`,`    })();`,`  }`,`  return await workflowPluginPromise;`,`}`]:[],``,`const DEFAULT_WORKFLOW_REQUEST_ORIGIN = "https://workflow.invalid";`,``,`function getHeader(headers, name) {`,`  if (headers === null || headers === undefined) {`,`    return undefined;`,`  }`,`  if (typeof headers.get === "function") {`,`    const value = headers.get(name);`,`    return typeof value === "string" && value.length > 0 ? value : undefined;`,`  }`,`  if (typeof headers !== "object") {`,`    return undefined;`,`  }`,`  const record = headers;`,`  const lowerName = name.toLowerCase();`,`  for (const [key, value] of Object.entries(record)) {`,`    if (key.toLowerCase() !== lowerName || value === undefined) {`,`      continue;`,`    }`,`    if (Array.isArray(value)) {`,`      return value.find((item) => typeof item === "string" && item.length > 0);`,`    }`,`    return typeof value === "string" && value.length > 0 ? value : undefined;`,`  }`,`  return undefined;`,`}`,``,`function createHeaders(headers) {`,`  const normalized = new Headers();`,`  if (headers === null || headers === undefined) {`,`    return normalized;`,`  }`,`  if (headers instanceof Headers) {`,`    return headers;`,`  }`,`  if (typeof headers.forEach === "function" && typeof headers.entries === "function") {`,`    for (const [key, value] of headers.entries()) {`,`      normalized.append(key, value);`,`    }`,`    return normalized;`,`  }`,`  for (const [key, value] of Object.entries(headers)) {`,`    if (value === undefined) {`,`      continue;`,`    }`,`    if (Array.isArray(value)) {`,`      for (const item of value) {`,`        normalized.append(key, String(item));`,`      }`,`      continue;`,`    }`,`    normalized.set(key, String(value));`,`  }`,`  return normalized;`,`}`,``,`function toAbsoluteWorkflowUrl(request) {`,`  const url = typeof request?.url === "string" ? request.url : "/";`,`  if (/^https?:\\/\\//.test(url)) {`,`    return url;`,`  }`,`  const host = getHeader(request?.headers, "x-forwarded-host") ?? getHeader(request?.headers, "host");`,`  const protocolHeader = getHeader(request?.headers, "x-forwarded-proto");`,`  const protocol = protocolHeader === "http" || protocolHeader === "https" ? protocolHeader : "https";`,`  const origin = typeof host === "string" && host.length > 0 ? protocol + "://" + host : DEFAULT_WORKFLOW_REQUEST_ORIGIN;`,`  return new URL(url, origin).toString();`,`}`,``,`function normalizeWorkflowRequest(request) {`,`  if (request instanceof Request) {`,`    if (/^https?:\\/\\//.test(request.url)) {`,`      return request;`,`    }`,`    return new Request(toAbsoluteWorkflowUrl(request), request);`,`  }`,`  const method = typeof request?.method === "string" ? request.method : "GET";`,`  const headers = createHeaders(request?.headers);`,`  const init = {`,`    headers,`,`    method,`,`  };`,`  if (method !== "GET" && method !== "HEAD") {`,`    const body = request?.body ?? (request !== null && typeof request === "object" && typeof request.pipe === "function" ? request : undefined);`,`    if (body !== undefined) {`,`      init.body = body;`,`      init.duplex = "half";`,`    }`,`  }`,`  return new Request(toAbsoluteWorkflowUrl(request), init);`,`}`,``,`module.exports = async function handleWorkflowFunctionRequest(requestContext) {`,`  const request =`,`    requestContext !== null && typeof requestContext === "object" && "req" in requestContext`,`      ? requestContext.req`,`      : requestContext;`,...r?[`  await loadWorkflowPlugins();`]:[],`  return await POST(normalizeWorkflowRequest(request));`,`};`,``].join(`
+`)}function createRoutedNitroEntrypoint(e){return[`import nitroHandler from ${JSON.stringify(e.delegateImportPath)};`,``,`function invokeNitroHandler(request, context) {`,`  if (typeof nitroHandler === "function") {`,`    return nitroHandler(request, context);`,`  }`,``,`  if (nitroHandler !== null && typeof nitroHandler === "object" && "fetch" in nitroHandler) {`,`    const fetch = nitroHandler.fetch;`,`    if (typeof fetch === "function") {`,`      return fetch.call(nitroHandler, request, context);`,`    }`,`  }`,``,`  throw new TypeError("Expected Nitro handler to export a function or an object with fetch(request, context).");`,`}`,``,`const workflowRoutePath = ${JSON.stringify(e.workflowRoutePath)};`,``,`function rewriteRequestToWorkflowRoute(request) {`,`  const sourceUrl = new URL(request.url);`,`  const routedUrl = new URL(workflowRoutePath, sourceUrl);`,`  routedUrl.search = sourceUrl.search;`,`  return new Request(routedUrl, request);`,`}`,``,`export default {`,`  fetch(request, context) {`,`    return invokeNitroHandler(rewriteRequestToWorkflowRoute(request), context);`,`  },`,`};`,``].join(`
+`)}async function readVercelHandlerPath(e){try{let t=JSON.parse(await readFile(join(e,`.vc-config.json`),`utf8`));if(typeof t.handler==`string`&&t.handler.length>0)return t.handler}catch{}return`index.mjs`}async function retargetNitroFunctionDirectoryToWorkflowRoute(e){let i=await readVercelHandlerPath(e.functionDirectoryPath),a=join(e.functionDirectoryPath,i),o=dirname(a),s=extname(i),c=join(o,`__eve_nitro_handler__${s.length>0?s:`.mjs`}`),l=toRelativeImportPath({fromDirectoryPath:o,toFilePath:c});await rename(a,c),await writeFile(a,createRoutedNitroEntrypoint({delegateImportPath:l,workflowRoutePath:e.workflowRoutePath}))}export{WORKFLOW_BUILDER_DEFERRED_PACKAGES,WORKFLOW_STEP_EXTERNAL_PACKAGES,copyNitroFunctionDirectory,createWorkflowFunctionEnvironment,emitBundledWorkflowFunctionDirectory,normalizeEveVercelFunctionOutput,prepareVercelFunctionDirectory,retargetNitroFunctionDirectoryToWorkflowRoute};

package/dist/src/internal/workflow-bundle/workflow-builders.d.ts

@@ -0,0 +1,44 @@
+export type WorkflowManifest = {
+    steps?: {
+        [relativeFileName: string]: {
+            [functionName: string]: {
+                stepId: string;
+            };
+        };
+    };
+    workflows?: {
+        [relativeFileName: string]: {
+            [functionName: string]: {
+                workflowId: string;
+            };
+        };
+    };
+    classes?: {
+        [relativeFileName: string]: {
+            [className: string]: {
+                classId: string;
+            };
+        };
+    };
+};
+export declare const WORKFLOW_QUEUE_TRIGGER: {
+    readonly type: "queue/v2beta";
+    readonly topic: "__wkf_workflow_*";
+    readonly consumer: "default";
+    readonly retryAfterSeconds: 5;
+    readonly initialDelaySeconds: 0;
+};
+export declare function applyWorkflowTransform(filename: string, source: string, mode: "workflow" | "step" | "client" | false, absolutePath?: string, projectRoot?: string, stableWorkflowNames?: ReadonlySet<string>): Promise<{
+    code: string;
+    workflowManifest: WorkflowManifest;
+}>;
+export declare function detectWorkflowPatterns(source: string): {
+    hasSerde: boolean;
+    hasUseStep: boolean;
+    hasUseWorkflow: boolean;
+};
+export declare function getImportPath(filePath: string, projectRoot: string): {
+    importPath: string;
+    isPackage: boolean;
+};
+export declare function readSourceFile(path: string): Promise<string>;

package/dist/src/internal/workflow-bundle/workflow-builders.js

@@ -0,0 +1 @@
+import{transformWorkflowDirectives}from"./workflow-transformer.js";import{dirname,isAbsolute,join,relative,resolve,sep}from"node:path";import{readFile}from"node:fs/promises";import{existsSync,readFileSync}from"node:fs";import{STABLE_WORKFLOW_NAMES}from"#execution/workflow-runtime.js";const WORKFLOW_QUEUE_TRIGGER={type:`queue/v2beta`,topic:`__wkf_workflow_*`,consumer:`default`,retryAfterSeconds:5,initialDelaySeconds:0},packageJsonCache=new Map,projectDepsCache=new Map;async function applyWorkflowTransform(t,i,a,o,s,c=STABLE_WORKFLOW_NAMES){let l=s??process.cwd(),{moduleSpecifier:u,stableModuleSpecifier:d}=resolveModuleSpecifier(o===void 0?isAbsolute(t)?t:join(l,t):o,l);return transformWorkflowDirectives({filename:t,mode:a,moduleSpecifier:u,source:i,stableModuleSpecifier:d,stableWorkflowNames:c})}function detectWorkflowPatterns(e){return{hasSerde:e.includes(`workflow.serde`)||e.includes(`@serde`)||e.includes(`workflowSerde`)||e.includes(`__workflow_serde`),hasUseStep:/["']use step["']/.test(e),hasUseWorkflow:/["']use workflow["']/.test(e)}}function getImportPath(e,t){let n=isInNodeModules(e),r=!n&&isWorkspacePackage(e,t);if(n||r){let n=findPackageJson(e);if(n!==null){let i=getProjectDependencies(t).has(n.name);if(!(r||i))return{importPath:toRelativeImportPath(e,t),isPackage:!1};let a=resolveExportSubpath(e,n);return a?{importPath:`${n.name}${a}`,isPackage:!0}:isRootEntrypointFile(e,n)?{importPath:n.name,isPackage:!0}:{importPath:toRelativeImportPath(e,t),isPackage:!1}}}return{importPath:toRelativeImportPath(e,t),isPackage:!1}}function resolveModuleSpecifier(e,t){let n=isInNodeModules(e),r=!n&&isWorkspacePackage(e,t);if(!n&&!r)return{moduleSpecifier:void 0,stableModuleSpecifier:void 0};let i=findPackageJson(e);if(i===null)return{moduleSpecifier:void 0,stableModuleSpecifier:void 0};let a=resolveExportSubpath(e,i),o=a?`${i.name}${a}`:i.name;return{moduleSpecifier:`${o}@${i.version}`,stableModuleSpecifier:o}}function findPackageJson(e){let n=dirname(e),i=[];for(;n!==dirname(n);){let e=packageJsonCache.get(n);if(e!==void 0){for(let t of i)packageJsonCache.set(t,e);return e}i.push(n);let a=join(n,`package.json`);if(existsSync(a))try{let e=JSON.parse(readFileSync(a,`utf8`));if(typeof e.name==`string`&&typeof e.version==`string`){let t={dir:n,exports:e.exports,main:e.main,module:e.module,name:e.name,version:e.version};packageJsonCache.set(n,t);for(let e of i)packageJsonCache.set(e,t);return t}}catch{}n=dirname(n)}for(let e of i)packageJsonCache.set(e,null);return null}function resolveExportSubpath(e,t){if(t.exports===null||typeof t.exports!=`object`||Array.isArray(t.exports))return``;let n=e.replace(/\\/g,`/`),r=t.dir.replace(/\\/g,`/`),i=n.startsWith(`${r}/`)?`./${n.substring(r.length+1)}`:null;if(i===null)return``;for(let[e,n]of Object.entries(t.exports)){let t=resolveExportTarget(n);if(t!==null&&normalizeExportPath(t)===i)return e===`.`?``:e.substring(1)}return``}function resolveExportTarget(e){if(typeof e==`string`)return e;if(Array.isArray(e)){for(let t of e){let e=resolveExportTarget(t);if(e!==null)return e}return null}if(typeof e==`object`&&e)for(let t of[`workflow`,`default`,`require`,`import`,`node`]){let n=e[t],r=resolveExportTarget(n);if(r!==null)return r}return null}function normalizeExportPath(e){return e.startsWith(`./`)?e:`./${e}`}function isInNodeModules(e){return e.split(sep).join(`/`).includes(`/node_modules/`)}function getProjectDependencies(e){let t=projectDepsCache.get(e);if(t!==void 0)return t;let n=new Set,i=join(e,`package.json`);if(existsSync(i))try{let e=JSON.parse(readFileSync(i,`utf8`));for(let t of[`dependencies`,`devDependencies`,`peerDependencies`,`optionalDependencies`]){let r=e[t];if(typeof r==`object`&&r&&!Array.isArray(r))for(let e of Object.keys(r))n.add(e)}}catch{}return projectDepsCache.set(e,n),n}function isWorkspacePackage(e,t){if(isInNodeModules(e))return!1;let n=findPackageJson(e);return n===null||resolve(n.dir)===resolve(t)?!1:getProjectDependencies(t).has(n.name)}function toRelativeImportPath(e,t){let n=t.replace(/\\/g,`/`),r=e.replace(/\\/g,`/`),a=r.startsWith(`${n}/`)?r.substring(n.length+1):relative(t,e).replace(/\\/g,`/`);return a.startsWith(`.`)||(a=`./${a}`),a}function hasRootExport(e){if(typeof e==`string`||Array.isArray(e))return!0;if(typeof e!=`object`||!e)return!1;let t=Object.keys(e);return t.length>0&&t.every(e=>!e.startsWith(`.`))?!0:`.`in e}function normalizePackageTargetPath(e){let t=e.replace(/\\/g,`/`);return t.startsWith(`./`)?t.substring(2):t.startsWith(`/`)?t.substring(1):t}function isRootEntrypointFile(e,t){let n=e.replace(/\\/g,`/`),r=t.dir.replace(/\\/g,`/`);if(!n.startsWith(`${r}/`))return!1;let i=n.substring(r.length+1);if(t.exports!==void 0){let e;if(t.exports!==null&&typeof t.exports==`object`&&`.`in t.exports)e=t.exports[`.`];else if(hasRootExport(t.exports))e=t.exports;else return!1;let n=resolveExportTarget(e);return n!==null&&normalizePackageTargetPath(n)===i}return[t.module,t.main,`index.js`,`index.mjs`,`index.cjs`,`index.ts`,`index.mts`,`index.cts`].flatMap(e=>typeof e==`string`?[normalizePackageTargetPath(e)]:[]).includes(i)}async function readSourceFile(e){return await readFile(e,`utf8`)}export{WORKFLOW_QUEUE_TRIGGER,applyWorkflowTransform,detectWorkflowPatterns,getImportPath,readSourceFile};

package/dist/src/internal/workflow-bundle/workflow-core-shim.d.ts

@@ -0,0 +1,82 @@
+export declare class RetryableError extends Error {
+}
+export declare class FatalError extends Error {
+}
+/**
+ * Creates a Workflow hook from inside a durable workflow body.
+ */
+export declare function createHook<T = unknown>(options?: unknown): AsyncIterable<T> & {
+    readonly token: string;
+};
+/**
+ * Returns metadata for the current durable workflow body.
+ */
+export declare function getWorkflowMetadata(): Record<string, unknown>;
+/**
+ * Creates a Workflow writable stream handle from inside a durable workflow body.
+ */
+export declare function getWritable<T = unknown>(options?: {
+    namespace?: string;
+}): WritableStream<T>;
+/**
+ * Creates a Workflow webhook from inside a durable workflow body.
+ */
+export declare function createWebhook<T = unknown>(options?: unknown): AsyncIterable<T> & {
+    readonly token: string;
+    url?: string;
+};
+/**
+ * Defines a Workflow hook factory for workflow-body code.
+ */
+export declare function defineHook<T = unknown>(): {
+    readonly create: (options?: unknown) => AsyncIterable<T> & {
+        readonly token: string;
+    };
+    readonly resume: () => never;
+};
+/**
+ * Sleeps from inside workflow-body code.
+ */
+export declare function sleep(): never;
+/**
+ * `resumeHook()` is an external/runtime API and must not run in workflow bodies.
+ */
+export declare function resumeHook(): never;
+/**
+ * Step metadata is only available in step functions.
+ */
+export declare function getStepMetadata(): never;
+/**
+ * Options accepted by {@link experimental_setAttributes}.
+ *
+ * Mirrors `ExperimentalSetAttributesOptions` from `@workflow/core` so the
+ * Eve workflow-body bundle does not have to pull the real type in.
+ */
+export interface ExperimentalSetAttributesOptions {
+    /**
+     * Permit attribute keys that start with the reserved `$` prefix. Eve
+     * framework code passes `true` so it can write the `$eve.*` namespace;
+     * authored agent code never calls this shim directly.
+     */
+    allowReservedAttributes?: boolean;
+}
+/**
+ * Workflow-body implementation of `experimental_setAttributes` for the Eve
+ * bundle. Mirrors the dispatch path of `@workflow/core`'s workflow-body
+ * export (`dist/workflow/set-attributes.js`):
+ *
+ * 1. Convert the attribute map into the `AttributeChange[]` shape the
+ *    runtime expects (`undefined` -> `null` to clear a key).
+ * 2. Resolve the workflow runtime's step dispatcher from
+ *    `globalThis[Symbol.for("WORKFLOW_USE_STEP")]` (the same global symbol
+ *    Eve already relies on to materialize `"use step"` proxies).
+ * 3. Invoke the builtin `__builtin_set_attributes` step with the changes,
+ *    which the runtime records on the active workflow run.
+ *
+ * Validation is intentionally skipped here. The only caller, `setEveAttributes`,
+ * already normalizes keys/values and is the sole entry point for the
+ * `$eve.*` reserved namespace; bouncing through the runtime's full
+ * validator would require pulling `@workflow/world` into the workflow body
+ * bundle.
+ */
+export declare function experimental_setAttributes(attrs: Record<string, string | undefined>, options?: ExperimentalSetAttributesOptions): Promise<void>;

package/dist/src/internal/workflow-bundle/workflow-core-shim.js

@@ -0,0 +1 @@
+const WORKFLOW_CONTEXT_SYMBOL=Symbol.for(`WORKFLOW_CONTEXT`),WORKFLOW_CREATE_HOOK=Symbol.for(`WORKFLOW_CREATE_HOOK`),WORKFLOW_GET_STREAM_ID=Symbol.for(`WORKFLOW_GET_STREAM_ID`),WORKFLOW_USE_STEP=Symbol.for(`WORKFLOW_USE_STEP`),STREAM_NAME_SYMBOL=Symbol.for(`WORKFLOW_STREAM_NAME`),workflowGlobal=globalThis;var RetryableError=class extends Error{},FatalError=class extends Error{};function createHook(e){let n=workflowGlobal[WORKFLOW_CREATE_HOOK];if(n===void 0)throw Error("`createHook()` can only be called inside a workflow function");return n(e)}function getWorkflowMetadata(){let t=workflowGlobal[WORKFLOW_CONTEXT_SYMBOL];if(t===void 0)throw Error("`getWorkflowMetadata()` can only be called inside a workflow or step function");return t}function getWritable(e={}){let t=workflowGlobal[WORKFLOW_GET_STREAM_ID];if(t===void 0)throw Error("`getWritable()` can only be called inside a workflow function");let r=t(e.namespace);return Object.create(globalThis.WritableStream.prototype,{[STREAM_NAME_SYMBOL]:{value:r,writable:!1}})}function createWebhook(e){let t=createHook(e),n=getWorkflowMetadata();return t.url=`${typeof n.url==`string`?n.url:``}/.well-known/workflow/v1/webhook/${encodeURIComponent(t.token)}`,t}function defineHook(){return{create:createHook,resume(){throw Error("`defineHook().resume()` can only be called from external contexts.")}}}function sleep(){throw Error("`sleep()` is not available in Eve workflow body bundles")}function resumeHook(){throw Error("`resumeHook()` can only be called from outside a workflow function")}function getStepMetadata(){throw Error("`getStepMetadata()` can only be called inside a step function")}async function experimental_setAttributes(e,t={}){let n=Object.entries(e);if(n.length===0)return;let i=workflowGlobal[WORKFLOW_USE_STEP];if(i===void 0)throw Error("`experimental_setAttributes()` can only be called inside a workflow runtime context");let a=n.map(([e,t])=>({key:e,value:t===void 0?null:t})),o=t.allowReservedAttributes===!0?{allowReservedAttributes:!0}:{};await i(`__builtin_set_attributes`)(a,o)}export{FatalError,RetryableError,createHook,createWebhook,defineHook,experimental_setAttributes,getStepMetadata,getWorkflowMetadata,getWritable,resumeHook,sleep};