Proveniência e atribuição

A proveniência faz parte do registro público da memória

O contrato de memória expõe a proveniência junto com content, path, source_identity, agent_id, agent_instance_id_hash e agent_instance_source. Proveniência é uma evidência estruturada de como um registro foi produzido; não é um bearer token e não pode ampliar o acesso do chamador.

• source_identity é o rótulo compacto do chamador/origem usado pelos caminhos de escrita e auditoria.
• provenance é um objeto JSON para campos de origem, adaptador, evento ou outras evidências.
• agent_instance_id_hash é o valor de atribuição da instalação que preserva a privacidade.

Os eventos do agente carregam sua origem

AgentEvent.to_memory_candidate cria um MemoryCandidate com provenance contendo source=agent_integration, adapter=<event source> e event_id. Os metadados do candidato também mantêm o tipo do evento, o horário, o ID do agente, o ID da tarefa, o nome da ferramenta, o comando, o caminho do arquivo e o status depois que o sanitizador compartilhado é executado.

{
  "provenance": {
    "source": "agent_integration",
    "adapter": "codex",
    "event_id": "evt_<stable-event-id>"
  },
  "metadata": {
    "agent_event": {
      "event_type": "decision_made",
      "task_id": "<task-id>"
    }
  }
}

Escreva a atribuição junto com a memória

Os modelos públicos de requisição remember e store aceitam source e provenance. Forneça rótulos estáveis e não secretos no momento da captura; mantenha a credencial de acesso no cabeçalho ou no ambiente e deixe o servidor sanitizar o conteúdo, os metadados e a proveniência antes da persistência.

POST /v1/remember
X-API-Key: <your-assigned-api-key>
Content-Type: application/json

{
  "content": "The deployment decision was verified.",
  "path": "projects/memory-os/decisions",
  "source": "codex",
  "provenance": {
    "source": "agent_integration",
    "adapter": "codex",
    "event_id": "evt_<stable-event-id>"
  }
}

A sanitização não apaga a linhagem

O sanitizador de persistência percorre estruturalmente o conteúdo, os metadados e a proveniência. Valores com formato de credencial são removidos; se ocorrer uma redação, o servidor registra metadados de auditoria privacy.server_write_sanitizer enquanto preserva campos seguros de proveniência. Trate o registro resultante como evidência sanitizada, não como um arquivo bruto de eventos.