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

# Sources

> Connect the documents and Royaltyport data your organization's Brain learns from

## Overview

**Sources** are the evidence your organization's [Brain](/organizations/agents/brain) learns from. You can upload your own documents and sync your Royaltyport records, and every source is stored as an immutable revision so the knowledge it produces can always be traced back to it.

Open it from **Agents → Sources**.

## The sources table

Each source is listed with three columns:

| Column     | What it shows                                                                                     |
| ---------- | ------------------------------------------------------------------------------------------------- |
| **Source** | The source title, its type, and when it was recorded (plus an error message if processing failed) |
| **Access** | Who the source's evidence is visible to                                                           |
| **Status** | Where the source is in processing                                                                 |

### Source status

| Status                    | Meaning                                                           |
| ------------------------- | ----------------------------------------------------------------- |
| **Awaiting upload**       | The source has been created but its file hasn't arrived yet       |
| **Queued**                | Waiting to be processed                                           |
| **Processing**            | The Brain Maintainer is reading the source                        |
| **Completed** / **Ready** | The source has been processed and its evidence is available       |
| **Failed**                | Processing couldn't finish — an error message is shown on the row |

The table refreshes automatically while any source is queued or processing, so you can watch progress without reloading. When one of your uploads finishes, you'll get a notification telling you whether it succeeded or failed.

## Uploading a document

Organization admins can add documents for the Brain to learn from.

<Steps>
  <Step title="Open the upload dialog">
    Click **Files** above the table.
  </Step>

  <Step title="Choose a file">
    Select a **PDF, Word, RTF, Markdown, text, CSV, or JSON** file, up to **20 MB**.
  </Step>

  <Step title="Upload">
    Click **Upload**. The file is stored securely and processing begins automatically.
  </Step>

  <Step title="Wait for processing">
    The source appears in the table and moves through *queued → processing → completed*. Any knowledge the Brain Maintainer extracts is submitted for review before it becomes active.
  </Step>
</Steps>

<Note>
  Uploaded documents are stored in a private organization store and hashed before an immutable source revision is created, so every fact the Brain derives can be traced back to the exact evidence it came from.
</Note>

## Syncing Royaltyport data

Click **Organization** above the table to compile your organization's supported Royaltyport records into the Brain as sources. This reads your canonical records and creates or updates the evidence revisions behind them.

The sync is safe to run at any time — it's revision-aware, updates what has changed, and retracts sources that no longer exist. When it finishes, a notification reports how many sources and knowledge nodes were compiled.

<Info>
  Your canonical Royaltyport records remain the source of truth. The Brain is built from them and is eventually consistent, so use the **Organization** sync to bring it up to date or recover after a large change.
</Info>

## Related Documentation

<CardGroup cols={2}>
  <Card title="Brain" icon="book-open" href="/organizations/agents/brain">
    Browse the knowledge produced from your sources.
  </Card>

  <Card title="Agent Registry" icon="bot" href="/organizations/agents/registry">
    The Brain Maintainer and the other agents.
  </Card>

  <Card title="Playbooks" icon="file-text" href="/organizations/agents/playbooks">
    Procedural guidance for extraction agents.
  </Card>

  <Card title="Agents Overview" icon="sparkles" href="/organizations/agents/overview">
    How sources, knowledge, and agents fit together.
  </Card>
</CardGroup>