Python SDK v0.2.0 — Real server contract

BREAKING CHANGE. 0.1.0 was published with a fictional API. This rewrite matches the real Recall server contract verified end-to-end against ghcr.io/recallworks/recall:0.1.0.

Install

pip install --upgrade recall-client

Quick start

from recall_client import RecallClient

with RecallClient(""http://localhost:8787"", api_key=""changeme"") as c:
    c.remember(""dark mode preferred"", tags=""pref,ui"")
    print(c.recall(""preferences"", n=3).result)

What changed

• Auth header: X-API-Key (was Authorization: Bearer)
• Every tool returns ToolResponse(result, tool, by) — markdown, not structured Hits
• recall(query, n=5, type='all') — uses n not limit
• remember(content, source='agent-observation', tags='') — tags is COMMA-SEPARATED STRING
• forget(source) takes a source label and soft-archives (no chunk-id deletes)
• All 13 server tools have typed wrappers + generic call_tool() escape hatch
• Killed fictional types: Hit, RememberResult

Migration

Replace hits[i].score / .content access with parsing of response.result (markdown).

See PR #15 for full details.