Module app 

Application framework for WeftOS.

Applications are packaged units that declare their agents, tools, services, capabilities, and lifecycle hooks via a manifest file (weftapp.toml or weftapp.json). The kernel manages application installation, startup, shutdown, and removal.

Design

All types compile unconditionally. The AppManager tracks installed applications and their lifecycle state. Actual filesystem operations (install from disk, hook execution) require the native feature and a running async runtime – those integrations are future work.

Agent IDs are namespaced as app-name/agent-id to avoid conflicts between apps and with built-in agents.

Structs

AgentSpec

Specification for an agent within an application.

AppCapabilities

Application-level capability requirements.

AppHooks

Lifecycle hooks (scripts run at lifecycle transitions).

AppManager

Application lifecycle manager.

AppManifest

Application manifest, parsed from weftapp.toml or weftapp.json.

InstalledApp

An installed application with its runtime state.

ServiceSpec

Specification for a sidecar service.

ToolSpec

Specification for a tool provided by an application.

Enums

AppError

Application framework errors.

AppState

Application lifecycle state.

ToolSource

Source of a tool implementation.

Functions

validate_manifest

Validate an application manifest for structural correctness.