センシティブなメモリ

Sensitiveはmemory typeではなくhandling policyです

メモリcontractのmemory_type enumはepisodic、semantic、procedural、working、identityです。sensitiveという値はありません。Sensitivityは6つ目のmemory typeを作るのではなく、共有redactionとsecurity-envelopeの制御で扱います。

• Credentialのような値は、canonical server sanitizerによって常にredactされます。
• 所有者の個人PIIはデフォルトで保持され、所有者がauto_redact_piiを有効にするとredactされます。
• 高リスクなprivate-keyまたはAWS-secretのcontentを検出すると、agent captureはeventをスキップします。

content、metadata、provenanceを一緒にsanitizeする

sanitize_server_writeは、memory rowから到達できるすべての文字列に共有rule registryを適用します。content、metadata、provenanceも対象です。Credential label、API key、JWT、URL secretなど登録済みのcredential形式の値は保存前に除去され、redaction後のresult 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はenvelopeに従う

Server recall gateはclient_local_onlyまたはnot_retrievableとマークされたrowを除外します。Vault rowも、metadataでvault_semantic_index_opt_inが明示的に選ばれていない限り除外されます。Security envelopeは、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