How effect-ts/effect works
Effect is a TypeScript library and monorepo for constructing typed, resource-safe application workflows. The central workflow is to compose an Effect, provide its required services through Layers, execute it with the runtime, and inspect its success or failure. The repository also supplies domain libraries for AI, clustering, HTTP, SQL, platform runtimes, and observability integrations. The README documents package roles; sampled core and cluster sources support only the specific internal relationships shown below, so other links are omitted where wiring was not evidenced.
Main entry points: Effect.ts Effect Programs · effect.ts Effect Runtime · Layer.ts Service Layers · Exit.ts Execution Result
Components 20
Effect Runtime
- Effect Programs
packages/effect/src/Effect.ts - Effect Runtime
packages/effect/src/internal/effect.ts - Service Layers
packages/effect/src/Layer.ts - Service Context
packages/effect/src/Context.ts - Fibers
packages/effect/src/Fiber.ts - Resource Scopes
packages/effect/src/Scope.ts - Schedules
packages/effect/src/Schedule.ts - Execution Result
packages/effect/src/Exit.ts
Domain Capabilities
- Schema Validation
packages/effect/src/Schema.ts - Streams and Channels
packages/effect/src/Stream.ts - HTTP APIs
packages/effect/src/http-api/HttpApi.ts - AI Modules
packages/effect/src/ai/LanguageModel.ts - Cluster Entities
packages/effect/src/cluster/ClusterWorkflowEngine.ts - Cluster Messaging
packages/effect/src/cluster/MessageStorage.ts
Provider Integrations
- AI Providers
packages/ai - OpenTelemetry
packages/opentelemetry/src/NodeSdk.ts
Platform and Data
- Runtime Platforms
packages/platform - SQL Clients
packages/sql
Other components
- Application Developer
- Application Outcome
Connections 19
- Application Developer → Effect Programs: composes
README.md - Effect Programs → Effect Runtime: executes
packages/effect/src/Effect.ts - Effect Programs → Service Layers: accepts services
packages/effect/src/Effect.ts - Service Layers → Service Context: builds services
packages/effect/src/Layer.ts - Effect Programs → Fibers: forks work
packages/effect/src/Effect.ts - Effect Programs → Resource Scopes: manages lifetime
packages/effect/src/Effect.ts - Effect Programs → Schedules: retries work
packages/effect/src/Effect.ts - Effect Runtime → Execution Result: produces result
packages/effect/src/Exit.ts - Effect Programs → Schema Validation: validates data
- Effect Programs → Streams and Channels: composes streams
- Effect Programs → HTTP APIs: serves APIs
- Effect Programs → AI Modules: builds AI workflows
- Effect Programs → Cluster Entities: runs clustered workflows
packages/effect/src/cluster/ClusterWorkflowEngine.ts - Cluster Entities → Cluster Messaging: stores messages
packages/effect/src/cluster/MessageStorage.ts - AI Modules → AI Providers: connects providers
README.md - Application Developer → OpenTelemetry: adds telemetry
README.md - Application Developer → Runtime Platforms: uses runtime services
README.md - Application Developer → SQL Clients: uses database clients
README.md - Execution Result → Application Outcome: returns outcome
packages/effect/src/Exit.ts