Herkunft und Zuweisung

Herkunft ist Teil des öffentlichen Speicherdatensatzes

Der Speichervertrag stellt die Herkunft (provenance) neben content, path, source_identity, agent_id, agent_instance_id_hash und agent_instance_source bereit. Die Herkunft liefert strukturierte Nachweise darüber, wie ein Datensatz erzeugt wurde; sie ist kein Bearer-Token und kann den Zugriff des Aufrufers nicht erweitern.

• source_identity ist die kompakte Aufrufer-/Quellbezeichnung für Schreib- und Auditpfade.
• provenance ist ein JSON-Objekt für Quelle, Adapter, Ereignis oder sonstige Nachweisfelder.
• agent_instance_id_hash ist der datenschutzwahrende Wert für die Installationszuweisung.

Agentenereignisse führen ihren Ursprung mit

AgentEvent.to_memory_candidate erstellt einen MemoryCandidate mit Herkunftsangaben, die source=agent_integration, adapter=<event source> und event_id enthalten. Die Metadaten des Kandidaten behalten zudem Ereignistyp, Zeit, Agenten-ID, Task-ID, Tool-Name, Befehl, Dateipfad und Status bei, nachdem der gemeinsame Bereiniger ausgeführt wurde.

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

Zuweisung mit der Erinnerung schreiben

Die öffentlichen Anfragemodelle remember und store akzeptieren source und provenance. Geben Sie beim Erfassen stabile, nicht-geheime Bezeichnungen an; belassen Sie den Zugriffsberechtigungsnachweis im Header oder in der Umgebung und überlassen Sie dem Server die Bereinigung von Inhalt, Metadaten und Herkunft vor der Speicherung.

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

Bereinigung löscht die Herkunftslinie nicht

Der Persistenzbereiniger durchläuft Inhalt, Metadaten und Herkunft strukturell. Werte, die wie Anmeldedaten aufgebaut sind, werden entfernt; falls eine Schwärzung erfolgt, erfasst der Server privacy.server_write_sanitizer-Audit-Metadaten und behält sichere Herkunftsfelder bei. Behandeln Sie den resultierenden Datensatz als bereinigten Beleg, nicht als rohes Ereignisarchiv.