René's URL Explorer Experiment


Title: Tier 2 commercial-identity gate: latency / headers / side-effects parity contract · Issue #392 · adcontextprotocol/adcp-client-python · GitHub

Open Graph Title: Tier 2 commercial-identity gate: latency / headers / side-effects parity contract · Issue #392 · adcontextprotocol/adcp-client-python

X Title: Tier 2 commercial-identity gate: latency / headers / side-effects parity contract · Issue #392 · adcontextprotocol/adcp-client-python

Description: Summary Follow-up from #375 (PR for the wire-code rename portion). This issue tracks the parity-contract refactor that was deferred from that PR per the user's stop-rule ("if the parity contract turns out to be more complex than fits in ...

Open Graph Description: Summary Follow-up from #375 (PR for the wire-code rename portion). This issue tracks the parity-contract refactor that was deferred from that PR per the user's stop-rule ("if the parity contract tu...

X Description: Summary Follow-up from #375 (PR for the wire-code rename portion). This issue tracks the parity-contract refactor that was deferred from that PR per the user's stop-rule ("if the parity co...

Opengraph URL: https://github.com/adcontextprotocol/adcp-client-python/issues/392

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Tier 2 commercial-identity gate: latency / headers / side-effects parity contract","articleBody":"## Summary\n\nFollow-up from #375 (PR for the wire-code rename portion). This issue tracks the **parity-contract refactor** that was deferred from that PR per the user's stop-rule (\\\"if the parity contract turns out to be more complex than fits in a single PR, file a separate issue for the parity-contract follow-up\\\").\n\n## Why\n\nThe cross-tenant onboarding-oracle clamp in the AdCP spec requires the unrecognized-agent path and the recognized-but-denied path to be observably **indistinguishable** to an external attacker — across:\n\n- HTTP status code (already aligned via shared `PERMISSION_DENIED` envelope).\n- Response headers (Content-Type, Content-Length within negligible tolerance).\n- Side effects (audit emission, metric increment with the same operation label).\n- Latency (cannot shortcut the unrecognized path; needs a deliberate budget).\n- Observability (logs, APM spans, third-party error telemetry).\n\n#375's rename portion closed the code mismatch but left the eager-raise structural difference — see the docstring on `_resolve_buyer_agent` (the \\\"Note on parity\\\" paragraph) and the test-file docstring on `tests/test_tier2_spec_conformance.py`.\n\n## Required design\n\nPer the issue body of #375:\n\n> Approach: introduce a `PermissionDeniedReason` internal enum/struct with `(scope, status)` fields. The dispatch layer raises a single `PermissionDeniedError` carrying a reason; the wire-level translator emits the spec-correct `PERMISSION_DENIED` envelope with `details` populated only when scope is set. The unrecognized path still does the same audit-emission + metric increment as the denied path. Latency parity may require an explicit small delay budget — document the tradeoff.\n\nConcretely:\n\n1. **Single emit point.** Move all four denial paths in `_resolve_buyer_agent` (and the `validate_billing_for_agent` path) through one common projection — an internal `PermissionDeniedError` wrapping a `PermissionDeniedReason` struct, projected to the wire envelope by a single translator. Today four call sites build the envelope inline.\n2. **Latency budget.** The unrecognized path needs to do equivalent resolution work to the recognized-but-denied path before raising. The simplest design is an explicit small delay (50–100 ms?) on every denial path so the variance between branches is dominated by the budget rather than the code path. Document the budget tradeoff (extra latency on every denial vs. closing the side channel).\n3. **Audit / metric parity.** Today the recognized branches log `details.agent_url` and `details.status`; the unrecognized branch logs nothing. Need to converge on a uniform log shape — same operation label, same fields (with the discriminator either missing or hashed-then-truncated to prevent log scraping from becoming the side channel).\n4. **Header parity.** A2A and MCP transports both go through the framework's wire serializer. Verify Content-Length is within tolerance (the message strings are already identical post-#375; the variance is `details` size). Consider padding the unrecognized envelope to match a fixed byte count.\n\n## Tests\n\n- Latency parity test: assert p99 difference between unrecognized-agent and recognized-but-suspended paths is \u003c 5 ms over N requests (with the explicit budget set high enough that branch-comparison variance is negligible).\n- Header parity test: same Content-Type, Content-Length within ±N bytes (where N covers the `details` shape variance).\n- Side-effects parity test: same audit-sink writes, same metric increments with the same operation label.\n- Status code parity test: same HTTP status across all four denial paths.\n\n## Refs\n\n- #375 (rename portion shipped here).\n- Spec source (when available): `static/schemas/source/error-details/agent-permission-denied.json` line 10 — the elevation note.\n- Spec uniform-response MUST list: `error-handling.mdx` (Per-Agent Authorization Gate).\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)","author":{"url":"https://github.com/bokelley","@type":"Person","name":"bokelley"},"datePublished":"2026-05-03T00:43:31Z","url":"https://github.com/adcontextprotocol/adcp-client-python/issues/392"}

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format)
route-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:25ae0f59-cac1-0e55-3553-4fc54613c2f0
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idA62A:291B58:24A588:2E7DE2:6B00FF13
html-safe-nonceb828fffcd3c42e0b75b9ddc8557b216b13ae86e568985da553c588173df2fd1e
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBNjJBOjI5MUI1ODoyNEE1ODg6MkU3REUyOjZCMDBGRjEzIiwidmlzaXRvcl9pZCI6Ijg2ODYyNzc0NzkxMTI5NjU5MDgiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac550a298b26b03daf40b7b14a08261f87e1e9238d1a02592a711378488cb68653
hovercard-subject-tagissue:4370471483
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/adcontextprotocol/adcp-client-python/392/issue_layout
twitter:imagehttps://opengraph.githubassets.com/7e46748a67a4da3ce16da037453ba899e299ca7daa2af4e2b3964c3bde7aa93e/adcontextprotocol/adcp-client-python/issues/392
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/7e46748a67a4da3ce16da037453ba899e299ca7daa2af4e2b3964c3bde7aa93e/adcontextprotocol/adcp-client-python/issues/392
og:image:altSummary Follow-up from #375 (PR for the wire-code rename portion). This issue tracks the parity-contract refactor that was deferred from that PR per the user's stop-rule ("if the parity contract tu...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamebokelley
hostnamegithub.com
expected-hostnamegithub.com
Nonecb7fa109eca7d4156c889f474306b0e91336055e9adf8fd4684b61e49094d124
turbo-cache-controlno-preview
go-importgithub.com/adcontextprotocol/adcp-client-python git https://github.com/adcontextprotocol/adcp-client-python.git
octolytics-dimension-user_id221690821
octolytics-dimension-user_loginadcontextprotocol
octolytics-dimension-repository_id1090305973
octolytics-dimension-repository_nwoadcontextprotocol/adcp-client-python
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id1090305973
octolytics-dimension-repository_network_root_nwoadcontextprotocol/adcp-client-python
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release2b59d31a4e44f08b7af67a4b67f8fd0af3befe2a
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/adcontextprotocol/adcp-client-python/issues/392#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fadcontextprotocol%2Fadcp-client-python%2Fissues%2F392
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fadcontextprotocol%2Fadcp-client-python%2Fissues%2F392
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=adcontextprotocol%2Fadcp-client-python
Reloadhttps://github.com/adcontextprotocol/adcp-client-python/issues/392
Reloadhttps://github.com/adcontextprotocol/adcp-client-python/issues/392
Reloadhttps://github.com/adcontextprotocol/adcp-client-python/issues/392
adcontextprotocolhttps://github.com/adcontextprotocol
adcp-client-pythonhttps://github.com/adcontextprotocol/adcp-client-python
Codehttps://github.com/adcontextprotocol/adcp-client-python
Issues44 (44)https://github.com/adcontextprotocol/adcp-client-python/issues
Pull requests13 (13)https://github.com/adcontextprotocol/adcp-client-python/pulls
Actionshttps://github.com/adcontextprotocol/adcp-client-python/actions
Projectshttps://github.com/adcontextprotocol/adcp-client-python/projects
Security and qualityhttps://github.com/adcontextprotocol/adcp-client-python/security
Insightshttps://github.com/adcontextprotocol/adcp-client-python/insights
https://github.com/adcontextprotocol/adcp-client-python
New issuehttps://github.com/login?return_to=https://github.com/adcontextprotocol/adcp-client-python/issues/392
New issuehttps://github.com/login?return_to=https://github.com/adcontextprotocol/adcp-client-python/issues/392
Tier 2 commercial-identity gate: latency / headers / side-effects parity contracthttps://github.com/adcontextprotocol/adcp-client-python/issues/392#top
bugSomething isn't workinghttps://github.com/adcontextprotocol/adcp-client-python/issues?q=state%3Aopen%20label%3A%22bug%22
claude-triagedhttps://github.com/adcontextprotocol/adcp-client-python/issues?q=state%3Aopen%20label%3A%22claude-triaged%22
https://github.com/bokelley
bokelleyhttps://github.com/bokelley
on May 3, 2026https://github.com/adcontextprotocol/adcp-client-python/issues/392#issue-4370471483
#375https://github.com/adcontextprotocol/adcp-client-python/issues/375
#375https://github.com/adcontextprotocol/adcp-client-python/issues/375
#375https://github.com/adcontextprotocol/adcp-client-python/issues/375
Tier 2 commercial-identity error codes don't conform to AdCP spec — cross-tenant oracle risk #375https://github.com/adcontextprotocol/adcp-client-python/issues/375
Tier 2 commercial-identity error codes don't conform to AdCP spec — cross-tenant oracle risk #375https://github.com/adcontextprotocol/adcp-client-python/issues/375
Claude Codehttps://claude.com/claude-code
bokelleyhttps://github.com/bokelley
bugSomething isn't workinghttps://github.com/adcontextprotocol/adcp-client-python/issues?q=state%3Aopen%20label%3A%22bug%22
claude-triagedhttps://github.com/adcontextprotocol/adcp-client-python/issues?q=state%3Aopen%20label%3A%22claude-triaged%22
on May 3, 2026https://github.com/adcontextprotocol/adcp-client-python/issues/392#event-25100786789
https://github.com/bokelley
bokelleyhttps://github.com/bokelley
on May 14, 2026https://github.com/adcontextprotocol/adcp-client-python/issues/392#issuecomment-4448763481
#375https://github.com/adcontextprotocol/adcp-client-python/issues/375
https://github.com/bokelley
bokelleyhttps://github.com/bokelley
on May 21, 2026https://github.com/adcontextprotocol/adcp-client-python/issues/392#issuecomment-4508831236
#748https://github.com/adcontextprotocol/adcp-client-python/pull/748
#772https://github.com/adcontextprotocol/adcp-client-python/issues/772
#748https://github.com/adcontextprotocol/adcp-client-python/pull/748
#748https://github.com/adcontextprotocol/adcp-client-python/pull/748
Tier 2 PERMISSION_DENIED: side-effect parity + timing budget (narrow follow-up to #392/#735) #772https://github.com/adcontextprotocol/adcp-client-python/issues/772
fix(server): Tier 2 permission-denied parity contract (#392) #735https://github.com/adcontextprotocol/adcp-client-python/pull/735
Tier 2 PERMISSION_DENIED: side-effect parity + timing budget (narrow follow-up to #392/#735) #772https://github.com/adcontextprotocol/adcp-client-python/issues/772
feat(decisioning): emit AGENT_SUSPENDED / AGENT_BLOCKED dedicated codes (closes #409) #748https://github.com/adcontextprotocol/adcp-client-python/pull/748
#735https://github.com/adcontextprotocol/adcp-client-python/pull/735
#772https://github.com/adcontextprotocol/adcp-client-python/issues/772
bokelleyhttps://github.com/bokelley
completedhttps://github.com/adcontextprotocol/adcp-client-python/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
on May 21, 2026https://github.com/adcontextprotocol/adcp-client-python/issues/392#event-25806994851
Sign up for freehttps://github.com/signup?return_to=https://github.com/adcontextprotocol/adcp-client-python/issues/392
Sign in to commenthttps://github.com/login?return_to=https://github.com/adcontextprotocol/adcp-client-python/issues/392
bugSomething isn't workinghttps://github.com/adcontextprotocol/adcp-client-python/issues?q=state%3Aopen%20label%3A%22bug%22
claude-triagedhttps://github.com/adcontextprotocol/adcp-client-python/issues?q=state%3Aopen%20label%3A%22claude-triaged%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.