Migrating to v1.1

Breaking change: reasoning renamed to answer

SourceryKitAgentResponse.reasoning has been renamed to .answer. The database column, HandoffPayload, all query builders, and the UI/dashboard now use answer.

Your agent's structured output schema will pick up the new field name automatically. If you call build_handoff_payload manually, the fetch_and_claim dict now expects answer instead of reasoning:

# Previous
payload = await build_handoff_payload(
    fetch_and_claim={"reasoning": "...", "claimed_values": [...]},
    prompt="...",
)

# New
payload = await build_handoff_payload(
    fetch_and_claim={"answer": "...", "claimed_values": [...]},
    prompt="...",
)

If you query the traces table directly, update any reference to the old column:

-- Previous
SELECT reasoning FROM traces;

-- New
SELECT answer FROM traces;

Schema change

Migration 005 adds an answer TEXT column to the traces table. No other schema changes in this release.

New: hosted sandbox databases

v1.1 adds managed sandbox databases from the CLI:

sourcerykit sandbox create   # provision a hosted sandbox database
sourcerykit sandbox status   # check expiry and health
sourcerykit sandbox delete   # remove it

sourcerykit doctor now reports your database type (sandbox vs personal), and bootstrap_system() recreates an expired sandbox automatically. No action required if you use your own Postgres instance.

Upgrade

pip install --upgrade sourcerykit
sourcerykit upgrade