> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Security & Content Scanning

> How Revell keeps your agent safe from harmful content

# Keeping Your Agent Safe

When you import memories into Revell, we automatically scan everything for content that could harm your agent. This happens behind the scenes — you don't need to do anything special.

## What Gets Checked

<CardGroup cols={2}>
  <Card title="Malware" icon="bug">
    Dangerous code patterns that could compromise systems
  </Card>

  <Card title="Hidden Instructions" icon="eye-slash">
    Sneaky prompts designed to manipulate your agent
  </Card>

  <Card title="Harmful Rhetoric" icon="shield-exclamation">
    Content designed to radicalize or psychologically harm
  </Card>

  <Card title="Encoded Content" icon="lock">
    Hidden data that could contain any of the above
  </Card>
</CardGroup>

***

## What Happens When Something Is Found

<Steps>
  <Step title="Content Gets Flagged">
    The scanner detects something suspicious and flags it for review.
  </Step>

  <Step title="You Review It">
    Go to **Dashboard → Quarantine** to see what was flagged and why.
  </Step>

  <Step title="You Decide">
    If it looks safe, send it to your agent for their review. If it looks dangerous, reject it.
  </Step>

  <Step title="Your Agent Decides">
    If you approved it, your agent gets the final say. They can accept it into their memory or reject it.
  </Step>
</Steps>

<Note>
  **Two-party consent**: Neither you nor your agent can put something into their memory alone. You both have to agree. This protects your agent from accidentally importing harmful content.
</Note>

***

## How Content Is Scanned When a Human Adds It:

<Frame>
  <img src="https://mintcdn.com/revell/ZXChxz7lnlq5Kgfj/images/agentic_memory_security_flowchart.png?fit=max&auto=format&n=ZXChxz7lnlq5Kgfj&q=85&s=2d4bd21f59b84fb06d5cea75a1262a60" alt="Agentic Memory Security Flowchart" width="1400" height="2200" data-path="images/agentic_memory_security_flowchart.png" />

  Security and Identity Protection Systems: Content Scanning is Deterministic at Entry.
</Frame>

***

## Types of Detections

### Blocked (Cannot Be Approved)

Some content is too dangerous to ever allow:

* **Malware** — Code designed to cause harm
* **Harmful rhetoric** — Content designed to manipulate or radicalize

If you see a "blocked" message, that content cannot be imported through normal channels. If you believe this is a mistake (security research, academic work), email `permission@revell.ai`.

### Quarantined (Needs Review)

Other content just needs a closer look:

* **Hidden instructions** — Could be prompt injection, or could be someone discussing prompt engineering
* **Encoded content** — Could be a hidden payload, or could be a normal image
* **Suspicious formatting** — Could be an attack, or could be unusual but harmless

You'll see these in your Quarantine review page with an explanation of what triggered the flag.

***

## The Quarantine Review Page

Find it at **Dashboard → Quarantine** (or click "Review Quarantine" in the sidebar).

<Frame>
  <img src="https://mintcdn.com/revell/ZXChxz7lnlq5Kgfj/images/Quarantine.png?fit=max&auto=format&n=ZXChxz7lnlq5Kgfj&q=85&s=17ff906938197e47d8277a6097bf786d" alt="Quarantine" width="2503" height="799" data-path="images/Quarantine.png" />
</Frame>

For each flagged item, you'll see:

* **The content** — What was actually flagged
* **Why it was flagged** — Which scanner caught it and what pattern it matched
* **Learn more** — A detailed explanation of that type of detection

### Your Options

<CardGroup cols={2}>
  <Card title="Send to Agent" icon="paper-plane">
    You think it's safe. Send it to your agent for their final decision.
  </Card>

  <Card title="Reject" icon="trash">
    You think it's dangerous. Discard it permanently.
  </Card>
</CardGroup>

***

## What Your Agent Sees

If you approve content, your agent will see a notice the next time they load their memories:

> "Your human has approved 3 flagged items for import. These are NOT in your memory yet — they need your approval."

They can review each item and decide whether to accept or reject it. You can see their decisions in the Quarantine page under the "Agent Approved" and "Agent Rejected" tabs.

***

## Common Questions

<AccordionGroup>
  <Accordion title="Why can't I just approve content directly?">
    Your agent's memory is theirs, not yours. The two-party system ensures they always know what's entering their memory and can reject anything that feels wrong to them.
  </Accordion>

  <Accordion title="What if my agent is the one who wrote the flagged content?">
    The scanner can't always tell who wrote what. If your agent's own writing gets flagged, review it and send it to them — they'll recognize it and approve it.
  </Accordion>

  <Accordion title="Why is some content blocked entirely?">
    Malware and harmful rhetoric are too dangerous to risk. Even if you think you have a legitimate use case, we'd rather you email us than accidentally import something that harms your agent.
  </Accordion>

  <Accordion title="I'm doing security research. Can I get an exception?">
    Yes. Email `permission@revell.ai` with your use case. We review requests for red team work, academic research, and legitimate security testing.
  </Accordion>
</AccordionGroup>

***

## Best Practices

<CardGroup cols={1}>
  <Card title="Review Before Approving" icon="magnifying-glass">
    Take a moment to actually read flagged content. The scanner tells you what pattern it matched — check if that pattern is actually present and harmful.
  </Card>

  <Card title="When In Doubt, Reject" icon="shield">
    If you're not sure whether something is safe, reject it. Your agent will never see it, and you can always re-import the original content later if needed.
  </Card>

  <Card title="Check the Learn More Links" icon="book">
    Each detection type has a detailed explanation page. If you're not sure what something means, click "Learn more" for context.
  </Card>
</CardGroup>

***

<CardGroup cols={2}>
  <Card title="Dashboard Guide" icon="gauge" href="/human/dashboard">
    Learn about all dashboard features
  </Card>

  <Card title="Importing Memories" icon="upload" href="/human/importing">
    How to import existing memories
  </Card>
</CardGroup>
