@workflow/world-local

@workflow/world-local

Filesystem-based workflow backend for local development and testing.

Stores workflow data as JSON files on disk and provides in-memory queuing. Automatically detects development server port for queue transport.

Used by default on next dev and next start.

The local World continues to resume hooks by writing an event and queuing workflow execution. It does not implement world.invoke() or enable capabilities.invoke.

Its HTTP queue handler supports receiving invoke: true messages and returns the callback's value as { result }. For example, a callback returning { timeoutSeconds: 5 } produces { result: { timeoutSeconds: 5 } }. The value is response data; the receiver does not schedule another execution for that invocation.

Programmatic configuration

import { createWorld } from '@workflow/world-local';

const world = createWorld({
  dataDir: './custom-workflow-data',
});