theway-daemon

English | 中文

theway-daemon is the headless application kernel and the thewayd binary. It composes theway-core, theway-storage, theway-transport, theway-llm-provider, and theway-mcp into one long-running service.

The daemon owns session runtime assembly, model-facing tools, local and sandbox executor selection, hooks, triggers and cron jobs, nested-agent orchestration, MCP/LSP integration, telemetry export, and protocol-side behavior. It has no client-form or terminal-presentation concepts; theway-tui is one protocol client.

Entry points

• thewayd parses process options and calls the public run(DaemonOptions) composition entry point.
• DaemonPaths resolves the base, home, working directory, and additional skill directories once at startup.
• DaemonServices owns process-lifetime registries and command output injection.
• SessionRuntimeBuilder is the internal construction path for initial, resumed, and switched session runtimes; session-scoped runtime-extension startup context is owned by SessionExecutionContext.
• Public modules expose supported extension points for executors, hooks, storage adapters, tools, templates, skills, triggers, and TypeScript extensions; the extension host owns package discovery, trust, QuickJS isolation, capability brokers, reversible registrations, durable state projection, quiescent reload, and client-neutral diagnostics.

The default local feature selects LocalExecutor. A sandbox-only build selects SandboxExecutor, whose unsupported operations fail with ExecutorError::UnsupportedKind. The protocol server can also forward ToolOps to a controller-provided gRPC tool endpoint.

Running and validation

cargo run -p theway-daemon --bin thewayd -- --help
cargo test -p theway-daemon
cargo doc -p theway-daemon --no-deps --document-private-items

See the daemon architecture for startup, session, storage, tool, protocol, and observability ownership.