Provenance et attribution

La provenance fait partie intégrante de l'enregistrement public de mémoire

Le contrat de mémoire expose la provenance aux côtés de content, path, source_identity, agent_id, agent_instance_id_hash et agent_instance_source. La provenance constitue un ensemble structuré de preuves décrivant la manière dont un enregistrement a été produit ; il ne s'agit pas d'un jeton porteur et elle ne peut en aucun cas élargir les accès de l'appelant.

• source_identity est le libellé compact de l'appelant ou de la source utilisé par les flux d'écriture et d'audit.
• provenance est un objet JSON contenant des champs relatifs à la source, à l'adaptateur, à l'événement ou à d'autres preuves.
• agent_instance_id_hash constitue la valeur d'attribution d'installation garantissant la protection de la vie privée.

Les événements d'agent véhiculent leur origine

AgentEvent.to_memory_candidate génère un MemoryCandidate dont la provenance contient source=agent_integration, adapter=<event source> et event_id. Les métadonnées du candidat conservent également le type d'événement, l'horodatage, l'identifiant d'agent, l'identifiant de tâche, le nom de l'outil, la commande, le chemin du fichier et le statut une fois le filtre partagé de nettoyage exécuté.

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

Associer l'attribution lors de l'enregistrement de la mémoire

Les modèles de requête publics remember et store acceptent source et provenance. Fournissez des libellés stables et non secrets au moment de la capture ; conservez l'identifiant d'accès dans son en-tête ou ses variables d'environnement et laissez le serveur assainir le contenu, les métadonnées et la provenance avant la persistance.

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>"
  }
}

L'assainissement n'efface pas la traçabilité

L'assainisseur de persistance parcourt structurellement le contenu, les métadonnées et la provenance. Les valeurs s'apparentant à des identifiants d'authentification sont supprimées ; si une expurgation intervient, le serveur consigne des métadonnées d'audit privacy.server_write_sanitizer tout en préservant les champs de provenance sûrs. Considérez l'enregistrement résultant comme un ensemble de preuves assainies, et non comme une archive brute d'événements.