Module blueprints 

HTTP surface for inspecting/registering Blueprint state (/v1/blueprints/*). HTTP surface for inspecting Blueprint state (= for debug / animation verification). /v1/blueprints/:id/head returns the head Blueprint JSON; /v1/blueprints/:id/history returns the commit-version list; /v1/blueprints/:id/binding-requirements returns the declaration-side BindRequest list an operator’s capability manifest must cover. Callers pass a shared Store via Arc and mount the router.

Structs

BindingRequirementsResponse

Response body for GET /v1/blueprints/:id/binding-requirements.

BlueprintsState

Router state: BP store + the base dir used to resolve $file / $agent_md refs + default_agent_kind from the CLI (= layer (2) of the 4-tier cascade — the CLI override layer). When ref_base = None, ref expansion is skipped (= seed bodies are parsed as raw JSON).

Functions

build_blueprints_router

Minimal entry: no ref_base (ref expansion skipped), no CLI default kind override, and strict_embed = false (backward-compat = the server accepts raw refs and runs the linker itself when ref_base is set).

build_blueprints_router_with_refs

When ref_base is set, seed_blueprint resolves {"$file": ...} / {"$agent_md": ...} refs in the body under that base dir and expands them. Path hygiene (absolute paths and .. are rejected) is enforced inside expand_file_refs, sandboxed to the subtree under the base dir.