How changw98ic/cayw works
CAYW is a Rust agent runtime in which a model organizes tool calls through Luau CodeMode, while the runtime applies permissions, approvals, cancellation and budgets. The principal flow runs from a user-facing client through a session and model interaction to controlled tools and local execution; sessions and execution records support later recovery. The graph also preserves documented interface, plugin, vision and web-access capabilities. Relationships rely on README statements and the supplied source index; unsampled implementation details are not asserted.
Main entry points: session.rs Session runtime · lib.rs Controlled host · main.rs Client entry · agent.rs Agent execution
Components 22
User Interfaces
- Client entry
crates/cayw-runtime/src/main.rs - Terminal UI
crates/cayw-tui/src/main.rs - Web UI
crates/cayw-webui/src/main.rs
Agent Runtime
- Session runtime
crates/cayw-runtime/src/session.rs - Agent execution
crates/cayw-agent/src/agent.rs - Luau CodeMode
crates/cayw-codemode/src/runtime.rs - Execution controls
crates/cayw-runtime/src/permissions.rs - Context assembly
crates/cayw-context/src/assembly.rs - Work queue
crates/cayw-queue/src/queue.rs
Tools and Capabilities
- Model providers
crates/cayw-providers/src/transport.rs - Controlled host
crates/cayw-host/src/lib.rs - Workspace tools
crates/cayw-workspace/src/filesystem.rs - Local processes
crates/cayw-device/src/process.rs - Web access
crates/cayw-web-access/src/service.rs - Vision service
crates/cayw-vision/src/service.rs - Code cells
crates/cayw-cells/src/manager.rs
Sessions and State
- Execution records
crates/cayw-artifacts/src/persist.rs - Session store
crates/cayw-core/src/store.rs
Extensions
- Plugin lifecycle
crates/cayw-runtime/src/cli_plugins.rs - Plugin registry
crates/cayw-plugins/src/registry.rs
Other components
- User
- Model service
Connections 23
- User → Client entry: starts or connects
README.md - User → Terminal UI: uses
README.md - User → Web UI: optionally uses
README.md - Terminal UI → Client entry: connects through
README.md - Web UI → Client entry: connects through
README.md - Client entry → Session runtime: routes requests
README.md - Session runtime → Agent execution: runs tasks
README.md - Agent execution → Model service: exchanges messages
README.md - Agent execution → Luau CodeMode: orchestrates tools
README.md - Luau CodeMode → Execution controls: checks each call
README.md - Execution controls → Controlled host: permits controlled calls
README.md - Controlled host → Workspace tools: offers workspace tools
- Controlled host → Local processes: manages execution
- Controlled host → Web access: offers web tools
- Controlled host → Vision service: offers vision tools
- Luau CodeMode → Code cells: executes cell runs
crates/cayw-cells/src/manager.rs - Session runtime → Context assembly: assembles context
- Session runtime → Work queue: enqueues work
- Session runtime → Session store: persists session state
- Session runtime → Execution records: records execution
README.md - Client entry → Plugin lifecycle: manages plugins
crates/cayw-runtime/src/main.rs - Plugin lifecycle → Plugin registry: loads plugins
crates/cayw-runtime/src/cli_plugins.rs - Agent execution → Model providers: uses model transport