에이전트 인스턴스 신원

instance id는 credential이 아닙니다

XMEMO_AGENT_INSTANCE_ID는 로컬 client 또는 runner instance를 식별하며 요청을 승인하지 않습니다. API key 또는 OAuth grant가 access credential입니다. 서버는 instance value에서 agent_instance_id_hash를 만들고 boundary authority를 attribution_only로 보고합니다.

• Credential: X-API-Key 또는 허용된 OAuth bearer grant가 access를 제어합니다.
• Instance label: X-Memory-OS-Agent-Instance-ID를 사용하면 서버가 작성 runner와 이후 caller를 비교할 수 있습니다.
• Agent label: X-Memory-OS-Agent-ID는 하나의 설치와 별도로 논리적 agent를 식별합니다.

정규화한 다음 해시하기

런타임은 instance id의 앞뒤 공백을 제거하고 빈 값을 거부하며, 해시하기 전에 최대 256자를 허용합니다. 저장된 hash는 sha256:<64 hexadecimal characters> 형식으로 정규화됩니다. 잘못된 사전 해시 값은 credential로 취급하지 않고 무시합니다.

from memory_manager.auth.agent_identity import agent_instance_id_hash

instance_hash = agent_instance_id_hash("codex-local-install")
# sha256:<64 hexadecimal characters>

로컬 설치마다 하나의 값 유지하기

하나의 비밀이 아닌 instance 값을 repository 밖에 저장하고 access credential과 함께 보내세요. 같은 설치에서는 재시작 후에도 재사용하고, 다른 로컬 profile에는 다른 값을 선택하세요.

X-API-Key: <your-assigned-api-key>
X-Memory-OS-Agent-ID: codex
X-Memory-OS-Agent-Instance-ID: <stable-local-instance-id>

경계 의미를 명시적으로 다루기

memory_agent_boundary는 호출자의 agent_id 및 instance hash를 row의 값과 비교합니다. 둘 다 일치하면 self이고, agent_id는 일치하지만 다른 hash면 same_agent_other_instance입니다. 비교 가능한 신원이 없으면 unverified 또는 unknown으로 보고됩니다. 이 라벨은 귀속을 설명할 뿐 token authorization을 대체하지 않습니다.

{
  "relation": "self",
  "ownership": "current_agent",
  "boundary_authority": "attribution_only",
  "current_agent_trust": "client_asserted"
}