Tipos de nota
Toda nota tem uma classe — ela define onde a nota fica visível e como é indexada. A classe não é um rótulo livre no frontmatter que você preenche na mão: é um conjunto de políticas que o sistema infere a partir de onde a nota é armazenada e aplica por conta própria. Em uma resposta da API, a classe é somente leitura.
A classe é um conjunto de políticas
Por trás de cada classe há um conjunto de políticas — sim/não para cada uma: se a nota é indexada, se aparece no grafo, no Feed, na árvore, na busca voltada ao usuário, se está disponível ao recall de um agente, se é versionada, se é replicada. O ponto central: a visibilidade é verificada em um único lugar, não por um filtro que você precisa lembrar de acrescentar a cada consulta. "Ocultar dos resultados" e "excluir do índice" são coisas diferentes, e o Notarium nunca as confunde.
A identidade de uma nota é seu notarium-id, não seu caminho. É por isso que mover ou renomear a nota nunca altera a classe silenciosamente nem quebra os índices.
O registro de classes
| Classe | Status | Visibilidade |
|---|---|---|
user-doc | ativa | Visível em todo lugar: árvore, Feed, grafo, busca. A classe padrão para todo o conteúdo do usuário. |
agent-memory | ativa | Indexada e disponível ao recall de um agente, mas oculta das superfícies voltadas ao usuário; visível ao dono em uma seção à parte. |
attachment | carrega políticas | Anexos são dados de pleno direito, mas não são indexados como conhecimento: só arquivos .md são pesquisáveis. |
derived | carrega políticas | Artefatos regeneráveis (pré-visualizações, renders); não chegam ao índice. |
profile | ativa | Oculta em todo lugar onde você busca e navega por notas; acessível apenas via Settings → Profile e ao agente em start_session. |
As duas classes com que você trabalha
Na prática, duas classes permanecem ativas e continuam se enchendo.
user-doc — suas notas. A classe padrão: organizadas livremente na árvore, alimentando a busca, o grafo e o Feed. É exatamente para cá que escrevem tanto a pessoa (pelo editor) quanto o agente (via create_note).
agent-memory — a memória do agente. São notas legíveis, não um armazenamento oculto: o agente anexa observações a um arquivo por categoria, em vez de gerar microarquivos. A memória vive em uma pasta de serviço à parte, .notarium/memory/, para não se misturar com a sua árvore nem colidir com as suas pastas.
Você lê, edita e apaga o conteúdo da memória — é assim que audita e controla o que pode ter chegado ao contexto (o histórico mostra quem escreveu o quê). Mas você não a reorganiza: o arranjo pertence ao agente (um conjunto plano de categorias mais um índice derivado). Mover coisas é tecnicamente seguro — a proibição de reorganizar é uma decisão de produto, para que o modelo de memória permaneça previsível.
O índice de memória é derivado: ele é montado a partir do campo summary de cada arquivo de memória e reconstruído com uma nova varredura completa. Ele carrega de imediato no start_session, enquanto os próprios arquivos são trazidos sob demanda pelo recall. Mais em Memória do agente.
profile — "sobre você"
Uma classe dedicada à nota de perfil: conteúdo escrito por humano sobre você (escrito por você, não pelo agente). Ela fica oculta em todo lugar onde você busca e navega por notas, e só pode ser alcançada de duas formas — via Settings → Profile e fazendo o start_session carregá-la no contexto do agente por identificador. Isto não é a memória do agente; é um cartão de contexto que você mesmo cura.
A classe é inferida a partir de onde a nota é armazenada e definida pelo sistema — o agente não escolhe nem a pasta nem a classe. Para saber como isso se conecta ao isolamento e ao endereçamento, veja Espaços e projetos.