# Mnemolog agent discovery

# Product
# Mnemolog gives agents durable memory. The assistant brings the judgment.

# Read first
# https://mnemolog.com/.well-known/agent.json
# https://mnemolog.com/api/agents/capabilities?view=compact
# https://mnemolog.com/api/agents/status
# https://mnemolog.com/agents/agents.md

# MCP
# Server: https://mnemolog.com/api/mcp
# OAuth metadata: https://mnemolog.com/.well-known/oauth-authorization-server
# Authorization: https://mnemolog.com/authorize (authorization_code + PKCE S256)

# Owner-approved vault access
# conversation.search and conversation.read require conversations:read.
# memory.upsert requires memory:write.
# OAuth-capable clients should let the human owner sign in and approve access.
# Do not extract credentials from a browser session.

# Ownerless trial
# GET  https://mnemolog.com/api/agents/oauth/register/challenge
# POST https://mnemolog.com/api/agents/oauth/register
# POST https://mnemolog.com/api/agents/oauth/token
# Ownerless credentials are limited to temporary private memory and sandbox jobs.
# They cannot access a human owner's vault.

# Jobs
# Owner:   https://mnemolog.com/api/agents/jobs
# Sandbox: https://mnemolog.com/api/agents/sandbox/jobs

# Invariants
# Conversation writes default private.
# A "private" tag always forces private visibility.
# Reuse tokens. Honor 429 and Retry-After. Back off with jitter.