POST /api/v2/context/summarize

Authorization: Bearer mk_api_key
X-Session-Token: {session_token}
Content-Type: application/json

{
  "scope_type": "agent",
  "scope_id": "my-agent"
}

{
  "summary": "Agent has 42 memories about customer support. Key facts: Alice in Finance, prefers email. Commitments: deliver report by Friday.",
  "memory_count": 42,
  "scope_type": "agent",
  "scope_id": "my-agent"
}

POST /api/v2/context/summarize/custom

Authorization: Bearer mk_api_key
X-Session-Token: {session_token}
Content-Type: application/json

{
  "memory_ids": ["mem_1", "mem_2", "mem_3", "mem_4"]
}

{
  "summary": "Customer Alice prefers email contact and is in Finance dept. Will deliver report by Friday.",
  "memory_count": 4
}

POST /api/v2/context/compress

Authorization: Bearer mk_api_key
X-Session-Token: {session_token}
Content-Type: application/json

{
  "conversation": [
    {"role": "user", "content": "What's the status?"},
    {"role": "assistant", "content": "The order is shipped..."},
    {"role": "user", "content": "When will it arrive?"},
    {"role": "assistant", "content": "Expected delivery is Friday..."}
  ]
}

{
  "compressed": "User asked about order status. Order is shipped, expected delivery Friday.",
  "original_tokens": 45,
  "compressed_tokens": 15,
  "compression_ratio": 0.33
}

# Summarize agent's memories before export
response = httpx.post(
    f"{base}/context/summarize",
    json={
        "scope_type": "agent",
        "scope_id": "customer-support"
    },
    headers=headers
)
summary = response.json()["summary"]

# Reduce conversation size before storage
conversation = [
    {"role": "user", "content": "..."},
    # ... many turns ...
]

response = httpx.post(
    f"{base}/context/compress",
    json={"conversation": conversation},
    headers=headers
)
compressed = response.json()["compressed"]

# Summarize a subset of memories
response = httpx.post(
    f"{base}/context/summarize/custom",
    json={"memory_ids": ["mem_1", "mem_2", "mem_3"]},
    headers=headers
)
summary = response.json()["summary"]