eve 0.22.1 → 0.22.2

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # eve
 
+## 0.22.2
+
+### Patch Changes
+
+- 4da4d86: Fixed Anthropic prompt caching placing the final cache breakpoint one message too early. Fresh tool results were billed as uncached input every turn and only entered the cache on the following request, capping the effective cache hit rate near 50%; the breakpoint now sits on the last message of each request, so agentic tool loops get near-full prefix hits.
+- 4446f96: Update the vendored Workflow SDK packages to the latest 5.0 beta releases. eve now delegates world target selection and construction to the upstream SDK instead of maintaining parallel factory and compatibility logic, and no longer disables stable Workflow Turbo mode.
+- 3da5def: Retry transient provider overload errors delivered inside model streams. Classified transient failures get at most three fresh model-call attempts, while other recoverable task-mode errors fall back to Workflow's durable step retries without multiplying retry budgets.
+- 2afed3b: Update `withEve()` to generate Vercel Build Output service routes for eve instead of the legacy Next.js rewrite setup. The generated output now uses the stable `services` field and service routes, including in hosted Vercel builds where no local `.vercel/project.json` exists, so Vercel builds the eve service without Next.js rewrites.
+- 3983d36: The Slack channel's default typing indicator for `actions.requested` now shows the action's contents instead of a generic `Running <tool>...` label: the tool name plus its most telling argument (`grep useEveAgent`, `read_file agent/agent.ts`), the subagent or remote-agent name for dispatched calls, and `+N more` for batches. The label helpers are exported from `eve/channels/slack` as `describeActionRequest` and `describeActionRequests` for use in custom handlers.
+- 15309f3: New projects created with `eve init` now use stable TypeScript 7.0.2 instead of the release candidate.
+
 ## 0.22.1
 
 ### Patch Changes

package/dist/src/cli/commands/init-repl.d.ts

@@ -1,20 +1,21 @@
 import { type Prompter } from "#setup/prompter.js";
+declare const positional: (prompt: string) => string[];
 declare const CODING_AGENT_REPLS: readonly [{
     readonly command: "claude";
     readonly label: "Claude Code";
-    readonly promptArgs: (prompt: string) => string[];
+    readonly promptArgs: typeof positional;
 }, {
     readonly command: "codex";
     readonly label: "Codex";
-    readonly promptArgs: (prompt: string) => string[];
+    readonly promptArgs: typeof positional;
 }, {
     readonly command: "cursor-agent";
     readonly label: "Cursor";
-    readonly promptArgs: (prompt: string) => string[];
+    readonly promptArgs: typeof positional;
 }, {
     readonly command: "droid";
     readonly label: "Droid";
-    readonly promptArgs: (prompt: string) => string[];
+    readonly promptArgs: typeof positional;
 }, {
     readonly command: "gemini";
     readonly label: "Gemini CLI";
@@ -26,7 +27,7 @@ declare const CODING_AGENT_REPLS: readonly [{
 }, {
     readonly command: "pi";
     readonly label: "Pi";
-    readonly promptArgs: (prompt: string) => string[];
+    readonly promptArgs: typeof positional;
 }];
 type CodingAgentReplDefinition = (typeof CODING_AGENT_REPLS)[number];
 /** A coding-agent REPL that can take over the terminal after `eve init`. */

package/dist/src/compiled/.vendor-stamp.json

@@ -27,12 +27,14 @@
     "@vercel/detect-agent": "1.2.3",
     "@vercel/oidc": "3.5.0",
     "@vercel/sandbox": "2.3.0",
-    "@workflow/core": "5.0.0-beta.26",
-    "@workflow/errors": "5.0.0-beta.8",
+    "@workflow/core": "5.0.0-beta.28",
+    "@workflow/errors": "5.0.0-beta.10",
     "@workflow/serde": "5.0.0-beta.2",
-    "@workflow/world": "5.0.0-beta.14",
+    "@workflow/world": "5.0.0-beta.16",
+    "@workflow/world-local": "5.0.0-beta.24",
+    "@workflow/world-vercel": "5.0.0-beta.24",
     "zod": "4.4.3",
     "zod-validation-error": "5.0.0"
   },
-  "scriptHash": "5bf2d1b5f6695983ae1a233467bb9baa93e057fdbb25283f4603c1d46d5e16bf"
+  "scriptHash": "b46518404fb685affcfcac4ee0dd5559c3e7b1b1472e79a6d8ecf043b445c792"
 }

package/dist/src/compiled/@workflow/core/create-hook.d.ts

@@ -156,8 +156,8 @@ export interface HookOptions {
      * Whether this hook can be resumed via the public webhook endpoint.
      *
      * When `true`, the hook can be triggered by sending an HTTP request to the
-     * public `/.well-known/workflow/v1/webhook/{token}` URL. This is automatically
-     * set when using `createWebhook()`.
+     * public workflow webhook URL. This is automatically set when using
+     * `createWebhook()`.
      *
      * When `false` (the default), the hook can only be resumed server-side
      * via `resumeHook()`.

package/dist/src/compiled/@workflow/core/events-consumer.d.ts

@@ -1,4 +1,4 @@
-import type { Event } from '#compiled/@workflow/world/index.js';
+import { type Event } from '#compiled/@workflow/world/index.js';
 /**
  * Delay before firing the deferred unconsumed-event check after the promise
  * queue has drained. Must be long enough for cross-VM microtask chains to

package/dist/src/compiled/@workflow/core/index.js

@@ -1,2 +1,2 @@
-import{c as e,i as t}from"../../_chunks/workflow/dist-Dxrjttr2.js";import{L as n,R as r,S as i,_n as a,bn as o,cn as s,dr as c,h as l,lr as u,on as d,sn as f,t as p,ur as m,vn as h,w as g,yn as _}from"../../_chunks/workflow/attribute-changes-zAifvEhb.js";import{n as v}from"../../_chunks/workflow/resume-hook-C15uJ2ik.js";import{t as y}from"../../_chunks/workflow/sleep-C8B-TYir.js";function b(e){m(`createHook()`,`https://workflow-sdk.dev/docs/api-reference/workflow/create-hook`,b)}function x(e){m(`createWebhook()`,`https://workflow-sdk.dev/docs/api-reference/workflow/create-webhook`,x)}function S({schema:e}={}){function t(e){m(`defineHook().create()`,`https://workflow-sdk.dev/docs/api-reference/workflow/define-hook`,t)}return{create:t,async resume(t,n){if(!e?.[`~standard`])return await v(t,n);let r=e[`~standard`].validate(n);if(r instanceof Promise&&(r=await r),r.issues){let e=r.issues.map(e=>{let t=e.path?.map(e=>String(typeof e==`object`&&e?e.key:e)).join(`.`);return t?`  at "${t}": ${e.message}`:`  ${e.message}`});throw Error(`Hook payload did not match the defined schema:\n${e.join(`
-`)}`)}return await v(t,r.value)}}}async function C(e,n={}){let i=r.getStore(),o=i?.workflowMetadata?.workflowRunId;if(!o)throw new t(`experimental_setAttributes() must be called from a 'use workflow' or 'use step' function. Calling it from plain host code is not supported.`);let s=p(e,n);if(s.length!==0){if(i.runReadyBarrier)try{await i.runReadyBarrier}catch{}await(await a()).events.create(o,{eventType:`attr_set`,specVersion:5,eventData:{changes:s,writer:{type:`step`,stepId:i.stepMetadata.stepId,attempt:i.stepMetadata.attempt},...n.allowReservedAttributes===!0?{allowReservedAttributes:!0}:{}}})}}function w(){let e=r.getStore();return e||u(`getStepMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-step-metadata`,w),e.stepMetadata}function T(){let e=r.getStore();return e||c(`getWorkflowMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-workflow-metadata`,T),e.workflowMetadata}function E(e={}){let t=r.getStore();t||c(`getWritable()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-writable`,E);let{namespace:a}=e,u=t.workflowMetadata.workflowRunId,p=n(u,a),m=t.writables??=new Map,v=m.get(p);if(v)return v.writable;let y=g(i(globalThis,t.ops,u,t.encryptionKey,!0,t.runReadyBarrier),t.encryptionKey),b=new l(u,p,t.runReadyBarrier),x=h();return t.ops.push(x.promise),_(y.readable,b,x).catch(()=>{}),o(y.writable,x),Object.defineProperty(y.writable,d,{value:p,writable:!1}),Object.defineProperty(y.writable,s,{value:u,writable:!1}),t.workflowDeploymentId&&Object.defineProperty(y.writable,f,{value:t.workflowDeploymentId,writable:!1}),m.set(p,{writable:y.writable,state:x}),y.writable}export{t as FatalError,e as RetryableError,b as createHook,x as createWebhook,S as defineHook,C as experimental_setAttributes,w as getStepMetadata,T as getWorkflowMetadata,E as getWritable,y as sleep};
+import{c as e,i as t}from"../../_chunks/workflow/dist-DpDDcpTl.js";import{C as n,Dn as r,En as i,R as a,Sn as o,T as s,Tn as c,bn as l,cn as u,h as d,ln as f,sn as p,t as m,vn as h,xn as g,z as _}from"../../_chunks/workflow/attribute-changes-BnKD8Y3m.js";import"../../_chunks/workflow/dist-DJU_7R9s.js";import{n as v}from"../../_chunks/workflow/resume-hook-DjPY9VGg.js";import{t as y}from"../../_chunks/workflow/sleep-phozDCW8.js";function b(e){i(`createHook()`,`https://workflow-sdk.dev/docs/api-reference/workflow/create-hook`,b)}function x(e){i(`createWebhook()`,`https://workflow-sdk.dev/docs/api-reference/workflow/create-webhook`,x)}function S({schema:e}={}){function t(e){i(`defineHook().create()`,`https://workflow-sdk.dev/docs/api-reference/workflow/define-hook`,t)}return{create:t,async resume(t,n){if(!e?.[`~standard`])return await v(t,n);let r=e[`~standard`].validate(n);if(r instanceof Promise&&(r=await r),r.issues){let e=r.issues.map(e=>{let t=e.path?.map(e=>String(typeof e==`object`&&e?e.key:e)).join(`.`);return t?`  at "${t}": ${e.message}`:`  ${e.message}`});throw Error(`Hook payload did not match the defined schema:\n${e.join(`
+`)}`)}return await v(t,r.value)}}}async function C(e,n={}){let r=_.getStore(),i=r?.workflowMetadata?.workflowRunId;if(!i)throw new t(`experimental_setAttributes() must be called from a 'use workflow' or 'use step' function. Calling it from plain host code is not supported.`);let a=m(e,n);if(a.length!==0){if(r.runReadyBarrier)try{await r.runReadyBarrier}catch{}await(await h()).events.create(i,{eventType:`attr_set`,specVersion:5,eventData:{changes:a,writer:{type:`step`,stepId:r.stepMetadata.stepId,attempt:r.stepMetadata.attempt},...n.allowReservedAttributes===!0?{allowReservedAttributes:!0}:{}}})}}function w(){let e=_.getStore();return e||c(`getStepMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-step-metadata`,w),e.stepMetadata}function T(){let e=_.getStore();return e||r(`getWorkflowMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-workflow-metadata`,T),e.workflowMetadata}function E(e={}){let t=_.getStore();t||r(`getWritable()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-writable`,E);let{namespace:i}=e,c=t.workflowMetadata.workflowRunId,m=a(c,i),h=t.writables??=new Map,v=h.get(m);if(v)return v.writable;let y=s(n(globalThis,t.ops,c,t.encryptionKey,!0,t.runReadyBarrier),t.encryptionKey),b=new d(c,m,t.runReadyBarrier),x=l();return t.ops.push(x.promise),g(y.readable,b,x).catch(()=>{}),o(y.writable,x),Object.defineProperty(y.writable,p,{value:m,writable:!1}),Object.defineProperty(y.writable,f,{value:c,writable:!1}),t.workflowDeploymentId&&Object.defineProperty(y.writable,u,{value:t.workflowDeploymentId,writable:!1}),h.set(m,{writable:y.writable,state:x}),y.writable}export{t as FatalError,e as RetryableError,b as createHook,x as createWebhook,S as defineHook,C as experimental_setAttributes,w as getStepMetadata,T as getWorkflowMetadata,E as getWritable,y as sleep};

package/dist/src/compiled/@workflow/core/private.js

@@ -1 +1 @@
-import{a as e}from"../../_chunks/workflow/dist-FLIfyJ4Y.js";const t=Symbol.for(`@workflow/core//registeredSteps`),n=globalThis,r=n[t]??=new Map,i=new Set([`__builtin_response_array_buffer`,`__builtin_response_json`,`__builtin_response_text`]);function a(e){let t=e.split(`//`);if(t.length!==3||t[0]!==`step`)return[];let n=t[1],r=t[2],i=new Set,a=e=>{e!==n&&i.add(e)};if(n.startsWith(`./workflows/`)){let e=n.slice(2);a(`./example/${e}`),a(`./src/${e}`)}else if(n.startsWith(`./example/workflows/`)){let e=n.slice(10);a(`./${e}`),a(`./src/${e}`)}else if(n.startsWith(`./src/workflows/`)){let e=n.slice(6);a(`./${e}`),a(`./example/${e}`)}return Array.from(i,e=>`step//${e}//${r}`)}function o(e){if(i.has(e)){for(let[t,n]of r.entries())if(t.endsWith(`//${e}`))return n}}function s(e,t){r.set(e,t),t.stepId=e}function c(e){let t=r.get(e);if(t)return t;for(let t of a(e)){let e=r.get(t);if(e)return e}let n=o(e);if(n)return n}async function l(e,t,n){if(t===void 0||!e.pendingDeliveryBarriers||e.pendingDeliveryBarriers.size===0)return;let r=[];for(let[i,a]of e.pendingDeliveryBarriers)i<t&&n.includes(a.kind)&&r.push(a.delivered);r.length>0&&await Promise.all(r)}function u(t,n,r){let i=t.pendingDeliveryBarriers;if(!i||n===void 0)return{markDelivered:()=>{}};let a=!1,{promise:o,resolve:s}=e(),c={kind:r,delivered:o};i.set(n,c);let l=()=>{a||(a=!0,i.get(n)===c&&i.delete(n),s())};return d(t,l),{markDelivered:l}}function d(e,t){let n=()=>{e.pendingDeliveries>0?e.promiseQueue.then(()=>{setTimeout(n,0)}):t()};setTimeout(n,0)}export{l as awaitEarlierDeliveries,c as getStepFunction,u as registerDeliveryBarrier,s as registerStepFunction,d as scheduleWhenIdle};
+import{c as e}from"../../_chunks/workflow/dist-CttsoN4D.js";const t=Symbol.for(`@workflow/core//registeredSteps`),n=globalThis,r=n[t]??=new Map,i=new Set([`__builtin_response_array_buffer`,`__builtin_response_json`,`__builtin_response_text`]);function a(e){let t=e.split(`//`);if(t.length!==3||t[0]!==`step`)return[];let n=t[1],r=t[2],i=new Set,a=e=>{e!==n&&i.add(e)};if(n.startsWith(`./workflows/`)){let e=n.slice(2);a(`./example/${e}`),a(`./src/${e}`)}else if(n.startsWith(`./example/workflows/`)){let e=n.slice(10);a(`./${e}`),a(`./src/${e}`)}else if(n.startsWith(`./src/workflows/`)){let e=n.slice(6);a(`./${e}`),a(`./example/${e}`)}return Array.from(i,e=>`step//${e}//${r}`)}function o(e){if(i.has(e)){for(let[t,n]of r.entries())if(t.endsWith(`//${e}`))return n}}function s(e,t){r.set(e,t),t.stepId=e}function c(e){let t=r.get(e);if(t)return t;for(let t of a(e)){let e=r.get(t);if(e)return e}let n=o(e);if(n)return n}async function l(e,t,n){if(t===void 0||!e.pendingDeliveryBarriers||e.pendingDeliveryBarriers.size===0)return;let r=[];for(let[i,a]of e.pendingDeliveryBarriers)i<t&&n.includes(a.kind)&&r.push(a.delivered);r.length>0&&await Promise.all(r)}function u(t,n,r){let i=t.pendingDeliveryBarriers;if(!i||n===void 0)return{markDelivered:()=>{}};let a=!1,{promise:o,resolve:s}=e(),c={kind:r,delivered:o};i.set(n,c);let l=()=>{a||(a=!0,i.get(n)===c&&i.delete(n),s())};return d(t,l),{markDelivered:l}}function d(e,t){let n=()=>{e.pendingDeliveries>0?e.promiseQueue.then(()=>{setTimeout(n,0)}):t()};setTimeout(n,0)}export{l as awaitEarlierDeliveries,c as getStepFunction,u as registerDeliveryBarrier,s as registerStepFunction,d as scheduleWhenIdle};

package/dist/src/compiled/@workflow/core/runtime/constants.d.ts

@@ -1,4 +1,8 @@
 export declare const MAX_QUEUE_DELIVERIES = 48;
+/**
+ * Effective max queue deliveries. Override via `WORKFLOW_MAX_QUEUE_DELIVERIES`.
+ */
+export declare function getMaxQueueDeliveries(): number;
 /**
  * Default maximum time allowed for the *replay* portion of a single workflow
  * handler invocation (in ms). This budget only covers deterministic-replay
@@ -48,6 +52,11 @@ export declare function getReplayTimeoutMs(): number;
  */
 export declare function _resetReplayTimeoutWarnCacheForTests(): void;
 export declare const REPLAY_TIMEOUT_MAX_RETRIES = 3;
+/**
+ * Effective replay-timeout retry budget. Override via
+ * `WORKFLOW_REPLAY_TIMEOUT_MAX_RETRIES`.
+ */
+export declare function getReplayTimeoutMaxRetries(): number;
 /**
  * Default maximum number of steps the owned-inline path runs inline (in
  * parallel) per suspension. The rest are queued to background handlers. Each
@@ -122,4 +131,9 @@ export declare function isOptimisticInlineStartExplicitlyDisabled(): boolean;
  */
 export declare function isTurboEnabled(): boolean;
 export declare const REPLAY_DIVERGENCE_MAX_RETRIES = 3;
+/**
+ * Effective replay-divergence recovery budget. Override via
+ * `WORKFLOW_REPLAY_DIVERGENCE_MAX_RETRIES`.
+ */
+export declare function getReplayDivergenceMaxRetries(): number;
 //# sourceMappingURL=constants.d.ts.map

package/dist/src/compiled/@workflow/core/runtime/get-world-lazy.d.ts

@@ -13,19 +13,10 @@
  *    `getWorld()` call. This is the steady-state hot path.
  * 2. `globalThis[GetWorldFnKey]` — populated by the module-load side
  *    effect at the bottom of `./world.ts`. Fires on every server bundle
- *    that reaches this file via `workflow/api` (which imports
+ *    that reaches this file via `workflow` or `workflow/api` (which import
  *    `./world-init.ts` for its side effect; see that file for the full
- *    rationale). This is the cold-start path for routes that consume
- *    `start` without any prior workflow run.
- * 3. Dynamic `import('./world.js')` — last-resort fallback for
- *    environments where neither (1) nor (2) is available (CJS test
- *    runners, scripts that import deeply into `@workflow/core` without
- *    going through `workflow/api`, future bundlers we haven't validated).
- *    The specifier is built at runtime so esbuild can't trace it into
- *    step bundles. Note: this branch is unreliable in webpack-bundled
- *    routes because webpack inlines this module into the route file and
- *    the relative path resolves against the bundle location — paths (1)
- *    and (2) cover those cases instead.
+ *    rationale). This is the cold-start path for routes that consume host
+ *    helpers without any prior workflow run.
  */
 import type { World } from '#compiled/@workflow/world/index.js';
 export declare function getWorldLazy(): Promise<World>;

package/dist/src/compiled/@workflow/core/runtime/wait-continuation.d.ts

@@ -58,8 +58,8 @@
  */
 /**
  * Maximum `delaySeconds` for a single wait-continuation message. Waits
- * longer than this are chained across multiple hops. 23 hours: VQS
- * messages have a 24h retention limit; the 1h buffer mirrors
+ * longer than this are chained across multiple hops. 23 hours leaves a 1h
+ * buffer under Vercel Queues' default 24h message TTL and mirrors
  * world-vercel's `MAX_DELAY_SECONDS`.
  */
 export declare const WAIT_CONTINUATION_MAX_DELAY_SECONDS = 82800;

package/dist/src/compiled/@workflow/core/runtime/world-compatibility.d.ts

@@ -0,0 +1,5 @@
+import type { World } from '#compiled/@workflow/world/index.js';
+type WorldSpecVersionMetadata = Pick<World, 'specVersion'>;
+export declare function assertWorldSupportsRuntimeProtocol(world: WorldSpecVersionMetadata): void;
+export {};
+//# sourceMappingURL=world-compatibility.d.ts.map

package/dist/src/compiled/@workflow/core/runtime/world-init.d.ts

@@ -6,30 +6,17 @@
  * # Why this exists
  *
  * `getWorldLazy()` in `./get-world-lazy.ts` checks the globalThis cache
- * (populated by `world.ts`'s module-load side effect) before falling back
- * to a runtime-built dynamic `import('./world.js')`. When a server route
- * only consumes a single helper that goes through `getWorldLazy` — most
- * commonly `start` from `workflow/api` — webpack/turbopack tree-shake the
- * named import `{ getWorld } from './runtime/world.js'` out of
- * `runtime.ts`, taking `world.ts`'s module evaluation with it. The
+ * populated by `world.ts`'s module-load side effect. When a server route
+ * only consumes a helper that goes through `getWorldLazy` — for example
+ * `start` from `workflow/api`, or `defineHook().resume()` from `workflow`
+ * — webpack/turbopack can tree-shake the named import `{ getWorld }` out
+ * of `runtime.ts`, taking `world.ts`'s module evaluation with it. The
  * globalThis registration never fires.
  *
- * `getWorldLazy` then falls through to its dynamic-import fallback, which
- * itself fails: webpack inlines `get-world-lazy.js` into the bundled route
- * file, so the relative specifier `./world.js` resolves against
- * `/var/task/<app>/.next/server/app/<...>/route.js` — where no sibling
- * `world.js` exists — and Node throws `MODULE_NOT_FOUND`. The symptom is a
- * cold-start regression: the very first user request that goes through
- * `start()` fails until some other code path (typically the queue-driven
- * `/.well-known/workflow/v1/flow` route, which uses `getWorld` directly
- * via `workflowEntrypoint`) has loaded `world.ts` and populated the
- * cache.
- *
- * Importing this module for its side effect — exactly once, from the
- * host-side `workflow/api` (`packages/workflow/src/api.ts`) — guarantees
- * `world.ts` enters the bundle, the global is registered at module load,
- * and `getWorldLazy()` short-circuits to the registered function on the
- * first call.
+ * Importing this module for its side effect from the host-side `workflow`
+ * and `workflow/api` entries guarantees `world.ts` enters the bundle, the
+ * global is registered at module load, and `getWorldLazy()` short-circuits
+ * to the registered function on the first call.
  *
  * # Why a separate module instead of importing `./world.js` directly
  *
@@ -47,29 +34,17 @@
  * `workflow` condition active, so they pick up the stub and never reach
  * `world.ts`. Host bundlers (webpack, turbopack, Node.js) use the
  * `default` (or `node`) condition and pick up this file, loading
- * `world.ts` as intended. The split keeps `@workflow/world-vercel`,
- * `@workflow/world-local`, `cbor-x`, and other server-only deps out of
- * the workflow sandbox bundle.
- *
- * # Why we keep the `getWorldLazy` dynamic-import fallback
- *
- * The fallback remains in `./get-world-lazy.ts` as a defense-in-depth for
- * environments we haven't accounted for (CJS test runners, scripts that
- * import `start` without going through `workflow/api`, future bundlers
- * with stricter tree-shaking). With this init module in place, the
- * fallback should never fire in normal use — but if it does, the
- * dynamic-import branch still resolves correctly when `world.js` is
- * physically adjacent on disk (e.g., direct Node.js execution of
- * unbundled source).
+ * `world.ts` as intended. The split keeps the configured world package
+ * and other server-only deps out of the workflow sandbox bundle.
  *
  * # Maintenance notes
  *
  * If you add another `getWorldLazy()` consumer that's reachable from a
- * host route without going through `workflow/api` (e.g., a new helper in
- * `workflow/runtime`), make sure that entry also imports this module —
- * or that it transitively reaches `world.ts` via a non-tree-shakeable
- * path. Adding a regression test in `world-init.test.ts` is preferred to
- * relying on careful manual tracing.
+ * host route without going through `workflow` or `workflow/api`, make
+ * sure that entry also imports this module — or that it transitively
+ * reaches `world.ts` via a non-tree-shakeable path. Adding a regression
+ * test in `world-init.test.ts` is preferred to relying on careful manual
+ * tracing.
  */
 import './world.js';
 //# sourceMappingURL=world-init.d.ts.map

package/dist/src/compiled/@workflow/core/runtime/world-target.d.ts

@@ -0,0 +1,11 @@
+import type { World } from '#compiled/@workflow/world/index.js';
+/**
+ * Unaliased target stub.
+ *
+ * Framework integrations alias this module to the configured world package at
+ * build time, including the default local world. Reaching this file means that
+ * static injection did not happen, so fail loudly instead of importing a
+ * fallback world that bundlers could retain alongside the configured one.
+ */
+export declare function createWorld(): World | Promise<World>;
+//# sourceMappingURL=world-target.d.ts.map

package/dist/src/compiled/@workflow/core/runtime/world.d.ts

@@ -1,15 +1,27 @@
 import type { World } from '#compiled/@workflow/world/index.js';
+export type WorldFactoryModule = {
+    createWorld?: () => World | Promise<World>;
+    /** @deprecated World packages should export `createWorld()` instead. */
+    createLocalWorld?: () => World | Promise<World>;
+    /** @deprecated World packages should export `createWorld()` instead. */
+    createVercelWorld?: () => World | Promise<World>;
+    default?: (() => World | Promise<World>) | World;
+};
 /**
- * Create a new world instance based on environment variables.
- * WORKFLOW_TARGET_WORLD is used to determine the target world.
+ * Create a World instance from a world factory module. Shared by
+ * `createWorld()` (for the statically injected target world module) and
+ * tooling that loads a world module dynamically (e.g. the Nitro dev
+ * handler and `@workflow/world-testing`). Legacy world-specific factory
+ * names are still accepted for compatibility, but world packages should
+ * export `createWorld()`.
+ */
+export declare function createWorldFromModule(mod: WorldFactoryModule): World | Promise<World>;
+/**
+ * Create a new world instance from the statically imported target world module.
  *
- * Note: WORKFLOW_VERCEL_* env vars (PROJECT, TEAM, AUTH_TOKEN, etc.) are
- * intentionally NOT read here. Those are for CLI/observability tooling only
- * and should not affect runtime behavior. The Vercel runtime provides
- * authentication via OIDC tokens and project context via system env vars
- * (VERCEL_DEPLOYMENT_ID, VERCEL_PROJECT_ID). Tooling that needs these env
- * vars should call createVercelWorld() directly with an explicit config and
- * use setWorld() to inject the instance.
+ * Framework integrations alias `@workflow/core/runtime/world-target` to the
+ * concrete world package at build time, so bundlers see a static import path
+ * instead of tracing a runtime-built require/import expression.
  */
 export declare const createWorld: () => Promise<World>;
 export type WorldHandlers = Pick<World, 'createQueueHandler' | 'specVersion'>;

package/dist/src/compiled/@workflow/core/runtime.d.ts

@@ -6,7 +6,7 @@ export { getHookByToken, resumeHook, resumeWebhook, } from './runtime/resume-hoo
 export { getRun, Run, type WorkflowReadableStream, type WorkflowReadableStreamOptions, } from './runtime/run.js';
 export { cancelRun, listStreams, type ReadStreamOptions, type RecreateRunOptions, readStream, recreateRunFromExisting, reenqueueRun, type StopSleepOptions, type StopSleepResult, wakeUpRun, } from './runtime/runs.js';
 export { type StartOptions, type StartOptionsBase, type StartOptionsWithDeploymentId, type StartOptionsWithoutDeploymentId, start, } from './runtime/start.js';
-export { createWorld, getWorld, getWorldHandlers, setWorld, } from './runtime/world.js';
+export { createWorld, createWorldFromModule, getWorld, getWorldHandlers, setWorld, type WorldFactoryModule, } from './runtime/world.js';
 /**
  * Creates a single route which handles workflow execution requests,
  * executing steps inline when possible to reduce function invocations
@@ -21,5 +21,6 @@ export { createWorld, getWorld, getWorldHandlers, setWorld, } from './runtime/wo
 export declare function workflowEntrypoint(workflowCode: string, options?: {
     namespace?: string;
     routeModuleBodyStartedAt?: number;
+    basePath?: string;
 }): (req: Request) => Promise<Response>;
 //# sourceMappingURL=runtime.d.ts.map