Skip to content

Conversation

@0xtotaylor
Copy link

@0xtotaylor 0xtotaylor commented Jan 11, 2026

Enhancement Proposal: Intent Trace Extension

Status Provisional
Author @0xtotaylor
RFC rfcs/intent-trace.md

Summary

This proposal extends POST /checkout-sessions/{id}/cancel to accept an optional intent_trace object, enabling agents to transmit structured data about why a checkout session was abandoned.

Type of change

  • Enhancement Proposal (new capability/extension per GOVERNANCE.md)

Proposal Contents

Per the Enhancement Proposal process, the RFC (rfcs/intent-trace.md) includes:

  • Summary
  • Motivation
  • Detailed Design
  • Risks
  • Test Plan
  • Graduation Criteria

Implementation

This PR also includes a complete implementation ready to merge once the proposal reaches Implementable status:

  • source/schemas/shopping/intent_trace.json — Extension schema
  • docs/specification/intent-trace.md — Specification documentation
  • mkdocs.yml — Navigation updates

Checklist

  • RFC document follows Enhancement Proposal template
  • Implementation aligns with RFC detailed design
  • Documentation complete
  • Schema validation passes
  • mkdocs build --strict passes

Requested Action

Requesting TC review to advance from ProvisionalImplementable.

Introduces the Intent Trace extension, allowing agents to provide structured reasons and context for checkout session cancellations. Adds documentation, updates navigation in mkdocs.yml, and provides JSON schema definitions for the new intent_trace object, supporting analytics and merchant response to abandonment reasons.
@google-cla
Copy link

google-cla bot commented Jan 11, 2026

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@0xtotaylor 0xtotaylor marked this pull request as ready for review January 11, 2026 22:26
@0xtotaylor 0xtotaylor requested a review from a team January 11, 2026 22:26
@yanheChen
Copy link
Contributor

Thank you for your contribution to the Universal Commerce Protocol!

While we appreciate your ethusiam for UCP, this doesn't align with our process for Enhancement proposals (https://github.com/Universal-Commerce-Protocol/ucp/blob/main/GOVERNANCE.md#enhancement-proposals). We encourage you to explore either a formal proposal or implement this as a vendor specific extension and have them live & hosted on your own domain.

@0xtotaylor
Copy link
Author

Thanks for the guidance, @yanheChen! I've updated this PR to follow the Enhancement Proposal process:

  • Added rfcs/intent-trace.md with all required sections (Summary, Motivation, Detailed Design, Risks, Test Plan, Graduation Criteria)
  • Updated the PR description to reflect Provisional status
  • Implementation is included and ready to merge once the proposal reaches implementability.

Happy to address any feedback on the proposal. Requesting TC review when ready.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants