敏感记忆

敏感性是处理策略，不是记忆类型

memory contract 的 memory_type enum 是 episodic、semantic、procedural、working 或 identity；其中没有 sensitive 值。敏感性由共享 redaction 和 security-envelope 控制处理，而不是创造第六种记忆类型。

• 凭据形态的值始终会由 canonical server sanitizer 做 redaction。
• 所有者的个人 PII 默认保留，只有在所有者启用 auto_redact_pii 时才会被 redaction。
• 高风险的私钥或 AWS secret 内容会使 agent capture 跳过该事件。

同时清理 content、metadata 和 provenance

sanitize_server_write 会将共享 rule registry 应用于 memory row 可访问到的每个字符串，包括 content、metadata 和 provenance。凭据标签、API keys、JWT、URL secrets 以及其他已注册的凭据形态值会在持久化前被移除；redaction 绝不会在结果 metadata 中返回原始值。

from memory_manager.security.redact import sanitize_server_write

result = sanitize_server_write(
    "Deploy with token=not-a-real-secret",
    redact_contact_pii=False,
)
print(result.text)
print(result.applied, result.redactions)

Vault mode 可以让记忆留在本地

security envelope 会记录 security_mode、encryption_state、retrieval_visibility、server_embeddings_enabled 和 server_content_search_enabled。Vault mode 存储 ciphertext，默认使用 retrieval_visibility=client_local_only 并禁用 server embeddings；除非 tenant 明确选择 semantic indexing，否则 server recall 会排除这些内容。

{
  "security_mode": "vault",
  "encryption_state": "ciphertext",
  "retrieval_visibility": "client_local_only",
  "server_embeddings_enabled": false,
  "server_content_search_enabled": false
}

Recall 遵循 security envelope

server recall gate 会丢弃标记为 client_local_only 或 not_retrievable 的行。Vault 行也会被排除，除非其 metadata 明确选择 vault_semantic_index_opt_in；security envelope 将该 opt-in 描述为一种权衡，因为它允许建立 server-side semantic index。必须避免进入 server recall 的 content 应使用 local recall。

client_local_only  -> excluded from server recall
not_retrievable    -> excluded from server recall
vault + opt-in     -> server vector recall allowed
vault without opt-in -> local recall required