NativeMemoryProvider

Core, Recall e Wiki

O provider nativo usa PostgreSQL e pgvector diretamente. Core mantém blocos pinados; Recall projeta turnos recentes com paginação de mensagens grandes; Wiki recupera trechos de documentos. O contexto do turno é uma projeção limitada, enquanto o banco preserva o conteúdo e suas revisões.

pip install "orkmind[memory-provider]"
python -m orkmind.memory_provider.mcp

APIs e autorização

assemble_turn_context reúne as camadas. search_history exige sessão ou usuário; search_wiki e get_document compartilham o filtro de escopo. set_core_block é uma API de operador e não deve ser exposta como ferramenta do agente. Personas e invariantes obrigatórios ausentes produzem erro.

Histórico e ingestão

O banco protege histórico e revisões com triggers append-only. A ingestão normaliza conteúdo para deduplicação, prepara chunks e embeddings e grava o documento em transação. Mudança incompatível de dimensão vetorial ou idioma de busca é recusada. Os chunks são derivados e podem ser reconstruídos; o documento íntegro permanece a fonte.

Escrita em nome de uma pessoa

A ingestão de sistema não tem dono. Quando a escrita vem de uma pessoa, passe o escopo dela como writer: só é gravado o que ela conseguiria ler. Classificação fora do alcance levanta ClassificationOutOfReachError antes de fatiar ou gerar embeddings; slug de documento que ela não lê levanta SlugUnavailableError, sem revelar nada do documento que o ocupa. As duas recusas herdam de WriteOutOfScopeError.

A deduplicação por conteúdo só considera o que o escopo alcança, e cada atualização gera uma revisão nova registrada em ingested_by. suggest_documents completa [[link]] apenas com o que o escopo vê.

escopo = MemoryScopeFilter.for_user(user_context)
await memory.ingest_document(pedido, writer=escopo)