Component Specifications

Spec: Agent Tooling

Provides tools to agents for interacting with the project workspace: file, search, code intelligence (code.lsp), debugging (debug).

Spec: Agent Harness

Compiles the project DSL into running agents; wires processor pipeline, provider routing, and observability.

Spec: Daemon

Defines the kaged daemon process: startup, shutdown, CLI, configuration, and lifecycle gates.

Spec: Federated Project Configuration

How projects compose, override, and resolve configuration across multiple layers and overlays.

Spec: Guests and Project Grants

Guest principals with daemon-managed credentials; per-project permission sets for external collaborators.

Spec: HTTP + WebSocket API

Operator-facing HTTP endpoints, WebSocket protocol, auth contract, and warning headers.

Spec: Issues

Structured inbox for project-scoped work; guests surface requests, operators triage into actions.

Spec: LLM Provider Interface

Talks to LLM providers; takes a resolved route and conversation context, returns typed stream events.

Spec: Local config

Operator-local configuration file: credentials, preferences, project registry — per-user, per-machine.

Spec: Operational Logging

Structured operational logging: dual-sink pipeline, log levels, sources, retention, HTTP API, plugin logging, and UI integration.

Spec: Plugin Host

Spawns, supervises, and communicates with plugins over JSON-RPC 2.0 on stdio.

Spec: Project DSL

The YAML file an operator authors to declare agents, cages, tools, prompts, and model routing.

Spec: project.recipe

Spec: Project Terminals

End-to-end wiring from UI click through PTY/tmux spawn to xterm.js over WebSocket.

Spec: Sandbox

Compiles DSL cage blocks into kernel-level isolation: bwrap, network allowlists, seccomp, cgroups.

Spec: Session Manager

Owns session lifecycle: creation, active work, checkpoint, detach, reattach, termination.

Spec: Task Runner

Launch, observe, and manage project-scoped terminal commands from the web UI.

Spec: Workflows

Operator-authored, parameterised agent recipes: structured inputs, limited tools, defined lifecycle.