session-migrate

session-migrate

Move ADK 2.0 sessions across users, apps, or storage backends. Useful for promoting from dev → prod, archival, or transferring ownership.

Common scenarios

From	To	Why
InMemorySessionService	VertexAiSessionService	Promote dev session to persistent storage
One Vertex project	Another	Cross-environment migration
User A	User B	Transfer ownership / handoff
Live session	Archive bucket	Compliance retention

Template — export + import

from google.adk.sessions import InMemorySessionService, VertexAiSessionService

# Source: in-memory dev session
src = InMemorySessionService()
session = await src.create_session(app_name="demo", user_id="dev_user")
# ... run agent against session ...

# Export the full session payload
payload = await src.export_session(session.id)
# payload includes: state, events, invocations, metadata

# Destination: persistent Vertex session
dst = VertexAiSessionService(project="prod-project", location="us-central1")
new_session = await dst.import_session(
    payload,
    target_app_name="demo",
    target_user_id="prod_user",
)

print(f"Migrated: {session.id} → {new_session.id}")

Bulk migration

sessions = await src.list_sessions(app_name="demo")
for s in sessions:
    payload = await src.export_session(s.id)
    await dst.import_session(payload, target_app_name="demo", target_user_id=s.user_id)

Filtered migration

Migrate only sessions newer than a date, or for specific users:

import datetime
cutoff = datetime.datetime(2026, 1, 1)
for s in await src.list_sessions(app_name="demo"):
    if s.created_at >= cutoff:
        await dst.import_session(await src.export_session(s.id), ...)

Cross-app migration

Move sessions from one logical app to another (e.g., schema upgrade from v1 → v2):

new_session = await dst.import_session(
    payload,
    target_app_name="demo_v2",
    transform=lambda state: {**state, "schema_version": 2},
)

Validation

• After import: len(new_session.events) == len(session.events)
• State dict round-trips identically
• Invocation IDs preserved (or remapped consistently)
• Test rewind on the migrated session — should still work

See also

• session-rewind-checkpoint for time-travel within a session