来源与归因

来源信息是公开记忆记录的一部分

memory contract 会在 content、path、source_identity、agent_id、agent_instance_id_hash 和 agent_instance_source 旁公开 provenance。Provenance 是关于记录如何产生的结构化证据；它不是 bearer token，也不能扩大 caller 的访问权限。

• source_identity 是写入和审计路径使用的简洁 caller/source 标签。
• provenance 是承载 source、adapter、event 或其他证据字段的 JSON object。
• agent_instance_id_hash 是保护隐私的安装归因值。

Agent 事件携带其来源

AgentEvent.to_memory_candidate 会创建一个 MemoryCandidate，其 provenance 包含 source=agent_integration、adapter=<event source> 和 event_id。共享 sanitizer 运行后，candidate metadata 还会保留 event type、time、agent id、task id、tool name、command、file path 和 status。

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

将归因信息与记忆一起写入

公开的 remember 和 store request model 接受 source 与 provenance。在捕获时提供稳定且非机密的标签；将访问凭据保留在 header 或 environment 中，让服务器在持久化前清理 content、metadata 和 provenance。

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

清理不会抹去 lineage

persistence sanitizer 会结构化遍历 content、metadata 和 provenance。凭据形态的值会被移除；如果发生 redaction，服务器会记录 privacy.server_write_sanitizer audit metadata，同时保留安全的 provenance 字段。应将结果记录视为经过清理的证据，而不是原始 event archive。