Skip to content

docs: add cart session persistence guidance#608

Open
hemanth wants to merge 1 commit into
Universal-Commerce-Protocol:mainfrom
hemanth:docs/cart-session-guidance
Open

docs: add cart session persistence guidance#608
hemanth wants to merge 1 commit into
Universal-Commerce-Protocol:mainfrom
hemanth:docs/cart-session-guidance

Conversation

@hemanth

@hemanth hemanth commented Jul 17, 2026

Copy link
Copy Markdown

Closes #344

Summary

Adds a non-normative implementation guidance document for cart session persistence, covering TTL recommendations, session resumption patterns, expiry handling, and agent reconnection scenarios.

Changes

  • docs/guides/cart-session-guidance.md: New guidance document

Key guidance points

  • Recommended TTL ranges by use case (food ordering: 15-30min, retail: 1-24hr, B2B: 1-7 days)
  • Cart ID as transport-agnostic resumption handle
  • cart_expired error code instead of generic 404
  • Agent-specific reconnection patterns

This is intentionally non-normative — it captures recommended patterns without mandating implementation details.

@damaz91 damaz91 added the status:needs-triage Signal that the PR is ready for human triage label Jul 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status:needs-triage Signal that the PR is ready for human triage

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Cart sessions need persistence guidance

2 participants