Protection

Explain policy evaluation for the protection card

Calls the policy engine in dry-run mode against the agent's composed protection card and returns a structured trace + care-framed remediations. Optional enrich: true runs an LLM pass over the structured remediations to produce long-form prose; off by default. Read-style POST — no state mutation, no Idempotency-Key.

This endpoint returns a deferred Phase-5 stub (trace: null) — the dedicated protection evaluator has not landed, so no policy evaluation runs and no request field is required. request_snippet.tool_name is accepted and ignored today; when the evaluator lands it becomes REQUIRED with a 400 missing_tool_name, as on the alignment explain (MNE-5820).

post/protection/agent/{agent_id}/explain

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/protection/agent/{agent_id}/explain
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Mnemom-Api-Key
    • API key in cookie mnemom_session

Path parameters

agent_idstring required

Agent identifier (e.g. smolt-abc123)

Request body

turn_idstring

Optional — bind to a specific gateway turn.

enrichboolean

When true, runs an LLM pass over the structured remediations. Off by default.

Response

Policy evaluation trace + remediations.

oktrue required
resource'protection' required
traceobject nullable

EvaluationResult from @mnemom/policy-engine. Null for protection in V1.

reasoningstring required

Care-framed prose summary.

enrichedboolean required

True when the LLM enrichment ran.

Changes

No recorded changes to this operation across all 1 revision of this API.