relay_mark_elixir

{
  "$schema": "../schemas/relaymark-directive.schema.json",
  "name": "AgentSuggestion",
  "ast_type": "relay.agent_suggestion",
  "version": 1,
  "category": "relay_kit",
  "description": "A visible or sidecar suggestion generated by an agent and attached to document context.",
  "attributes": {
    "confidence": {
      "type": "number",
      "description": "Agent confidence from 0.0 to 1.0 when applicable."
    },
    "evidence": {
      "type": "array",
      "items": "string",
      "description": "Block or source ids that ground the suggestion."
    },
    "review": {
      "type": "enum",
      "values": ["draft", "ready", "accepted", "rejected"],
      "default": "draft"
    },
    "kind": {
      "type": "enum",
      "values": ["note", "action", "match", "journey", "source", "share"],
      "default": "note"
    },
    "anchor": {
      "type": "string",
      "description": "Optional block id when source syntax needs an explicit anchor."
    }
  },
  "children": {
    "mode": "mixed",
    "allowed_types": ["paragraph", "text", "relay.entity_ref"],
    "min": 1
  },
  "validation": [
    "agent-created suggestions must remain draft or ready until reviewed",
    "evidence refs should resolve to known blocks or source manifest entries when present",
    "anchored sidecar suggestions should compile to annotations instead of visible blocks when the host requests annotation projection"
  ],
  "projections": {
    "relay_kit": "AgentSuggestion",
    "html": "agent-suggestion",
    "plain_text": "suggestion text",
    "manifest": []
  },
  "policy": {
    "requires_review": true,
    "requires_evidence": false,
    "allows_agent_creation": true
  }
}