민감한 메모리

민감도는 memory type이 아니라 처리 정책입니다

memory contract의 memory_type enum은 episodic, semantic, procedural, working 또는 identity이며 sensitive 값은 없습니다. 민감도는 여섯 번째 memory type을 만들어내는 대신 공용 redaction 및 security-envelope 제어로 처리합니다.

• 자격 증명 형태의 값은 canonical server sanitizer가 항상 redaction합니다.
• 소유자의 개인 PII는 기본적으로 유지되며 owner가 auto_redact_pii를 활성화하면 redaction됩니다.
• 고위험 private-key 또는 AWS-secret content가 있으면 agent capture가 event를 건너뜁니다.

content, metadata, provenance를 함께 sanitize하기

sanitize_server_write는 memory row에서 도달 가능한 모든 문자열에 shared rule registry를 적용하며 content, metadata, provenance도 포함합니다. Credential label, API key, JWT, URL secret 및 등록된 기타 credential 형태 값은 persistence 전에 제거됩니다. redaction은 result metadata에 raw value를 절대 반환하지 않습니다.

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를 제외합니다. 또한 metadata가 vault_semantic_index_opt_in을 명시적으로 선택하지 않으면 Vault row도 제외됩니다. security envelope는 server-side semantic index를 허용하므로 이 opt-in을 tradeoff로 설명합니다. 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