How superdurable/dex works
Dex is a durable-execution platform: applications define flows and run workers through language SDKs, while clients start and interact with flow instances through the server. The server dispatches Step and RPC tasks to workers and builds on Temporal. SDKs provide flow primitives, execution context, value mapping, and worker dispatch. The repository also includes a web workspace and CLI tooling. The main workflow links are documented in the README; relationships among unsampled subsystems are omitted rather than inferred.
Main entry points: main.go Dex Server · async_client.py Python Client · client.go Go SDK Client · flow.py Python Flow Definitions
Components 19
Application SDKs
- Go SDK Client
sdk-go/dex/client.go - Python Flow Definitions
sdk-python/dex/flow.py - Python Primitives
sdk-python/dex/context.py - Python Client
sdk-python/dex/async_client.py - Python Worker Dispatcher
sdk-python/dex/_worker_dispatcher.py - Python Value Mapping
sdk-python/dex/_value_mapper.py - TypeScript Client
sdk-typescript/src/client.ts - Java Worker Service
sdk-java/src/main/java/io/superdurable/dex/JavaWorkerService.java
Execution Runtime
- Dex Server
server/cmd/server/main.go - Flow Interpreter
server/service/interpreter/queryHandler.go
User Interfaces
- Web Workspace
web/app/App.tsx - Web API
web/api/handlers.go - Dex CLI
cli/cmd/dexcli/main.go - CLI Commands
cli/internal/command/app.go
Protocol and Storage
- Service Protocol
protos/dex.proto - Attribute Store Manager
server/service/common/attributestore/manager.go - Blob Cache
blob-cache-go/blobcache/cache.go
Other components
- Application Developer
- Temporal
Connections 19
- Application Developer → Python Flow Definitions: defines flows
- Application Developer → Go SDK Client: uses client
- Application Developer → Python Client: uses client
- Application Developer → TypeScript Client: uses client
- Python Flow Definitions → Python Primitives: uses primitives
sdk-python/dex/flow.py - Python Client → Python Value Mapping: maps values
sdk-python/dex/async_client.py - Python Worker Dispatcher → Python Value Mapping: maps values
sdk-python/dex/_worker_dispatcher.py - Python Client → Dex Server: starts and interacts
- Go SDK Client → Dex Server: starts and interacts
- TypeScript Client → Dex Server: starts and interacts
- Dex Server → Python Worker Dispatcher: dispatches tasks
- Dex Server → Java Worker Service: dispatches tasks
- Dex Server → Flow Interpreter: runs flow logic
- Dex Server → Temporal: extends
- Dex Server → Attribute Store Manager: syncs attributes
- Dex Server → Blob Cache: offloads payloads
- Python Client → Service Protocol: uses protocol
- Web Workspace → Web API: uses API
- Dex CLI → CLI Commands: runs commands
cli/cmd/dexcli/main.go