How limenagent/prodagent works
prodagent is a small, dependency-free agent runtime: applications compose agent and workflow strategies from a shared execution kernel. A typical run enters through the Agent or Workflow facade, executes graph nodes in scheduler waves, and can invoke a model or governed tools; runs may suspend for approval and resume. The kernel records events as its source of truth, enabling state reconstruction, replay, artifacts, and traces. The playground exposes scenarios and run data in a browser. Some runtime modules are indexed but unsampled, so their internal links are omitted unless documented.
Main entry points: scheduler.py Wave scheduler · server.py Playground server · agent.py Agent runner · workflow.py Workflow graph
Components 28
Agent API
- Public facade
src/__init__.py
Runtime strategies
- Agent runner
src/runtime/agent.py - Workflow graph
src/runtime/workflow.py - ReAct loop
src/runtime/react.py - Agent context
src/runtime/context.py - Agent memory
src/runtime/memory.py - Agent skills
src/runtime/skills.py - Tool registry
src/runtime/tools.py - MCP adapter
src/runtime/mcp.py - Model selection
src/runtime/llm.py - OpenAI-compatible client
src/runtime/openai_lite.py
Execution kernel
- Plan and nodes
src/kernel/graph.py - Executable bodies
src/kernel/body.py - Wave scheduler
src/kernel/scheduler.py - Run state machine
src/kernel/run.py - State reducers
src/kernel/channels.py - Routing commands
src/kernel/command.py - Observe and approve
src/kernel/bus.py
Run records
- Event log
src/kernel/eventlog.py - Replay runs
src/kernel/replay.py - Artifact storage
src/kernel/blob.py - File blob backend
src/backends/blob_store.py - Run traces
src/kernel/trace.py
Browser playground
- Playground server
src/playground/server.py - Scenario catalog
src/playground/scenarios.py - Browser interface
src/playground/web.py
Other components
- Application caller
- Playground user
Connections 32
- Application caller → Public facade: calls
README.md - Public facade → Agent runner: exports
src/__init__.py - Public facade → Workflow graph: exports
src/__init__.py - Agent runner → ReAct loop: uses
src/runtime/agent.py - Agent runner → Tool registry: uses
src/runtime/agent.py - Workflow graph → ReAct loop: uses
src/runtime/workflow.py - Workflow graph → Tool registry: uses
src/runtime/workflow.py - Agent runner → Wave scheduler: hosts runs
src/runtime/agent.py - Workflow graph → Wave scheduler: hosts runs
src/runtime/workflow.py - ReAct loop → Tool registry: dispatches tools
src/runtime/react.py - Tool registry → MCP adapter: adapts tools
src/runtime/mcp.py - ReAct loop → Model selection: requests completions
- Model selection → OpenAI-compatible client: selects client
src/runtime/llm.py - Wave scheduler → Plan and nodes: checks readiness
src/kernel/scheduler.py - Wave scheduler → Run state machine: advances
src/kernel/scheduler.py - Wave scheduler → Executable bodies: executes nodes
src/kernel/scheduler.py - Wave scheduler → Event log: commits events
src/kernel/scheduler.py - Wave scheduler → Observe and approve: publishes events
src/kernel/scheduler.py - Wave scheduler → Artifact storage: stores artifacts
src/kernel/scheduler.py - Run state machine → State reducers: folds state
src/kernel/run.py - Run state machine → Routing commands: applies routing
src/kernel/run.py - Event log → State reducers: folds deltas
src/kernel/eventlog.py - Replay runs → Event log: reads events
src/kernel/replay.py - Replay runs → Run state machine: rebuilds run
src/kernel/replay.py - Run traces → Event log: projects events
src/kernel/trace.py - File blob backend → Artifact storage: implements storage
src/backends/blob_store.py - Playground user → Browser interface: uses
- Browser interface → Playground server: sends requests
src/playground/server.py - Playground server → Scenario catalog: loads scenarios
src/playground/server.py - Playground server → Agent runner: runs scenarios
src/playground/server.py - Playground server → Run traces: builds run traces
src/playground/server.py - Playground server → Artifact storage: loads artifact bytes
src/playground/server.py