Smithers Flows is an Effect-based SDK and durable runtime for typed workflows. It records side effects in a journal, resumes interrupted executions, protects state with fenced ownership, and gives each step a content-addressed identity.
This repository is the cohesive Flow runtime extracted from the original prototype monorepo. Build tools, file-framework packages, agents, and applications intentionally remain outside it.
Node.js 22.19 or newer is required. The packages are pre-1.0 and currently pin
effect to 4.0.0-rc.108.
pnpm add @smthrs/flows effect@4.0.0-rc.108@smthrs/canonical is maintained in its own
repository and is consumed as an
external dependency; there is no workspace copy here.
- SDK:
@smthrs/flow,@smthrs/flows,@smthrs/engine - durable runtime:
@smthrs/engine-store,@smthrs/database,@smthrs/journal,@smthrs/run-store,@smthrs/step-cache,@smthrs/time-travel,@smthrs/sync,@smthrs/plan - identity and artifacts:
@smthrs/crypto,@smthrs/keys,@smthrs/artifacts - host boundaries:
@smthrs/capability,@smthrs/kernel,@smthrs/jj,@smthrs/sandbox - platforms:
@smthrs/platform-node,@smthrs/platform-bun,@smthrs/platform-browser - support:
@smthrs/core,@smthrs/observability,@smthrs/testing
pnpm install --frozen-lockfile
pnpm run verifyCI type-checks, tests, builds, and checks circular dependencies for every package. npm publishing is intentionally not part of this repository's CI.