Repository navigation
0.37.0: Poppy 1.0 as published - #18
Conversation
Version 1.0 as published (upstream 8c02b42, frozen 2026-11-14; reviewed through 6764732), the default, in both SDKs and both reference companies; 0.4 as published unchanged. Required conversation protocol descriptions (CompanyConfig.agent_description), Pushed Authorization Requests (agent pushes when offered; company offers or requires), prompt=consent and consent pages that list every scope, refresh tokens bound to their DPoP key (bind_refresh_tokens), UCP sign-ins naming every scope, ports in organization.domain (allow_ports), PS384 with RSA 2048-4096, invalid_target for a left-out service, null clears context, unknown roles, author types, SSE events and error codes read safely, working only while replying, unknown authorization errors, and the Mediated Sign-In retirement date. Conformance: new cases and a pushed-requests world in all four pairings, at 1.0 and 0.4. Ledger, coverage, migration, compatibility, conformance report, upstream snapshot and schemas updated. Agent Runtimes adopts on feat/scenes.
There was a problem hiding this comment.
🟡 Changes recommended
Unresolved critical defects reject valid RSA signatures on Python 3.10, allow prototype manipulation through context keys, lose stored refresh tokens, and prevent the examples CI job from resolving dependencies.
7 open issues
Update upstream dependency constraint before installing SDK 0.37 · New Pass explicit byte order to support Python 3.10 · New Preserve refresh proof for Bearer-only MCP servers · New Preserve proto as an own context property · New Avoid consuming callback state in open_link() · New Reject redirects when checking PAR refusal · New Accept empty SSE event names as message events · New
What changed in this PR
Updates the Python and TypeScript SDKs and reference companies to Poppy 1.0 as published, keeping 1.0 as the default and retaining opt-in 0.4 support.
Changes:
- Adds published 1.0 discovery, authorization, token-binding, and conversation behavior.
- Extends shared fixtures and cross-language conformance coverage, including pushed authorization requests.
- Updates release metadata, schemas, examples, migration guidance, and protocol documentation.
| File | Description |
|---|---|
src/ucp.ts |
Makes scope requests version-aware. |
src/reactor.ts |
Updates core plugin version. |
src/profile.ts |
Records published 1.0 revision. |
src/pages.ts |
Matches session destinations by host and port. |
src/models.ts |
Adds 1.0 models, validation, and helpers. |
src/mediated.ts |
Exposes planned retirement date. |
src/index.ts |
Exports new public APIs. |
src/discovery.ts |
Adds explicit nondefault-port support. |
src/device.ts |
Handles port-bearing organization domains. |
src/demo/manzanita.ts |
Supplies required agent description. |
src/conversations.ts |
Updates context, streaming, and error handling. |
src/company/verify.ts |
Enforces RSA key-size limits. |
src/company/testing.ts |
Extends stored-record samples. |
src/company/store.ts |
Adds pushed-request and key-binding fields. |
src/company/points.ts |
Adds shared context and resource policy. |
src/company/index.ts |
Updates version and verification exports. |
src/browser-control.ts |
Extracts hosts from port-bearing domains. |
src/accounts.ts |
Handles excluded services as signed out. |
src/__tests__/ucp.test.mjs |
Checks version-specific scope requests. |
src/__tests__/support/conformance.mjs |
Adds description, PAR, and binding cases. |
src/__tests__/security-review.test.mjs |
Updates company configurations. |
src/__tests__/schemas.test.mjs |
Separates 0.4 fixtures from 1.0 schemas. |
src/__tests__/reactor-points.test.mjs |
Supplies required agent description. |
src/__tests__/operator-signatures.test.mjs |
Updates configuration fixture. |
src/__tests__/issuerless.test.mjs |
Adds discovery and company descriptions. |
src/__tests__/idempotency.test.mjs |
Updates company configuration. |
src/__tests__/draft-10.test.mjs |
Checks published revision date. |
src/__tests__/draft-04.test.mjs |
Updates company configuration. |
src/__tests__/dpop.test.mjs |
Updates shared company fixture. |
src/__tests__/conformance-pairing.test.mjs |
Runs pushed-request world and adjusts skips. |
src/__tests__/conformance-fixtures.test.mjs |
Handles new shared fixture checks. |
src/__tests__/company.test.mjs |
Checks consent prompt metadata. |
scripts/generate_coverage.py |
Labels version-specific requirements. |
scripts/conformance_report.py |
Updates generated protocol summary. |
README.md |
Announces published 1.0 support. |
protocol/UPSTREAM.md |
Records frozen upstream revision and changes. |
protocol/schemas/poppy.schema.json |
Requires descriptions and permits domain ports. |
protocol/schemas/message.schema.json |
Allows null context fields. |
protocol/schemas/authorization-server-metadata.schema.json |
Updates algorithm requirement description. |
protocol/fixtures/discovery-valid.json |
Adds conversation description. |
protocol/fixtures/conformance/protocol.json |
Adds published 1.0 behavior fixtures. |
protocol/fixtures/conformance/dpop.json |
Adds PAR and bound-refresh world. |
personal_agent_protocol/ucp.py |
Makes scope requests version-aware. |
personal_agent_protocol/reactor.py |
Updates core plugin version. |
personal_agent_protocol/profile.py |
Records published 1.0 revision. |
personal_agent_protocol/pages.py |
Matches session destinations by host and port. |
personal_agent_protocol/models.py |
Adds 1.0 models, validation, and helpers. |
personal_agent_protocol/mediated.py |
Exposes planned retirement date. |
personal_agent_protocol/discovery.py |
Adds explicit nondefault-port support. |
personal_agent_protocol/device.py |
Handles port-bearing organization domains. |
personal_agent_protocol/demo/northwind.py |
Supplies agent description. |
personal_agent_protocol/demo/manzanita.py |
Supplies agent description. |
personal_agent_protocol/demo/ledgerly.py |
Supplies agent description. |
personal_agent_protocol/conversations.py |
Updates context, streaming, and error handling. |
personal_agent_protocol/conformance.py |
Adds description, PAR, and binding cases. |
personal_agent_protocol/company/verify.py |
Enforces RSA key-size limits. |
personal_agent_protocol/company/testing.py |
Extends stored-record samples. |
personal_agent_protocol/company/store.py |
Persists pushed requests and key bindings. |
personal_agent_protocol/company/points.py |
Adds shared context and resource policy. |
personal_agent_protocol/company/__init__.py |
Updates company plugin version. |
personal_agent_protocol/cli_commands.py |
Passes PAR metadata into sign-in. |
personal_agent_protocol/browser_control.py |
Extracts hosts from port-bearing domains. |
personal_agent_protocol/auth.py |
Adds consent prompts, PAR, and deferred links. |
personal_agent_protocol/accounts.py |
Handles excluded services as signed out. |
personal_agent_protocol/__version__.py |
Sets SDK version to 0.37.0. |
personal_agent_protocol/__tests__/test_ucp.py |
Checks version-specific scope requests. |
personal_agent_protocol/__tests__/test_security_review.py |
Updates company configurations. |
personal_agent_protocol/__tests__/test_schemas.py |
Separates 0.4 fixtures from 1.0 schemas. |
personal_agent_protocol/__tests__/test_reactor_points.py |
Supplies required agent description. |
personal_agent_protocol/__tests__/test_operator_signatures.py |
Updates configuration fixture. |
personal_agent_protocol/__tests__/test_issuerless.py |
Adds discovery descriptions. |
personal_agent_protocol/__tests__/test_hosted_pages.py |
Checks consent prompt metadata. |
personal_agent_protocol/__tests__/test_fixtures.py |
Handles new shared fixture checks. |
personal_agent_protocol/__tests__/test_draft_10.py |
Checks published revision date. |
personal_agent_protocol/__tests__/test_draft_04.py |
Updates company configuration. |
personal_agent_protocol/__tests__/test_docs_examples.py |
Updates example fixtures with descriptions. |
personal_agent_protocol/__tests__/test_cross_language.py |
Includes pushed-request world. |
personal_agent_protocol/__tests__/test_conversations.py |
Uses defined request-conflict error code. |
personal_agent_protocol/__tests__/test_conformance.py |
Runs pushed-request conformance cases. |
personal_agent_protocol/__init__.py |
Exports new public APIs. |
package.json |
Sets package version to 0.37.0. |
examples/pydantic-ai/company-service/app.py |
Supplies required agent description. |
docs/docs/sdk/typescript.mdx |
Updates company configuration example. |
docs/docs/sdk/python-api.mdx |
Lists new public APIs. |
docs/docs/releases/support.mdx |
Moves support window to 0.37.x. |
docs/docs/releases/migration.mdx |
Documents 0.37 migration requirements. |
docs/docs/releases/compatibility.mdx |
Records published 1.0 compatibility. |
docs/docs/protocol/status.mdx |
Updates implementation status. |
docs/docs/protocol/open-topics.mdx |
Documents unresolved sign-out behavior. |
docs/docs/protocol/coverage/ucp.mdx |
Marks incremental authorization as 0.4-only. |
docs/docs/protocol/coverage/sign-in.mdx |
Maps new authorization requirements. |
docs/docs/protocol/coverage/security-considerations.mdx |
Adds consent-page coverage. |
docs/docs/protocol/coverage/identity-sessions.mdx |
Adds assertion and algorithm coverage. |
docs/docs/protocol/coverage/discovery.mdx |
Adds ports and version-boundary coverage. |
docs/docs/protocol/coverage/conversations.mdx |
Adds description and stream-tolerance coverage. |
docs/docs/protocol/coverage.mdx |
Updates targets and coverage totals. |
docs/docs/protocol/conformance-report.mdx |
Publishes expanded conformance results. |
docs/docs/guides/personal-agent.mdx |
Explains published-version selection. |
docs/docs/guides/mediated-sign-in.mdx |
Documents planned retirement date. |
docs/docs/guides/direct-sign-in.mdx |
Explains consent and pushed requests. |
docs/docs/guides/conversations.mdx |
Clarifies the meaning of working. |
docs/docs/guides/company.mdx |
Documents new company capabilities. |
docs/docs/guides/acting-for-a-person.mdx |
Adds agent descriptions to examples. |
CHANGELOG.md |
Summarizes 0.37.0 changes. |
.github/workflows/examples.yaml |
Selects Agent Runtimes integration branch. |
Review effort: Balanced
| AGENT_RUNTIMES_REF: '' | ||
| # 0.37 breaks the API: Agent Runtimes adopts it on feat/scenes (pin >=0.37.0,<0.38), so | ||
| # the job installs Agent Runtimes from that branch until a release accepts 0.37. | ||
| AGENT_RUNTIMES_REF: feat/scenes |
| try { | ||
| result = | ||
| metadata !== undefined && this.#isMcp(metadata.resource) | ||
| ? await refresh.tokenForMcp(reference, { context, server: metadata, ...narrowed }) |
There was a problem hiding this comment.
Fixed in #19 (8b19846, 0.37.1), both SDKs: tokenForMcp / token_for_mcp keep the issuer's algorithms whenever it lists ES256, so the refresh always proves with the refresh token's key (spec 4.4); the reference companies issue a Bearer token for a server whose metadata lists no ES256, even after a proof (spec 4.5). Tested with bind_refresh_tokens and a Bearer-only MCP server in published-10.test.mjs and test_published_10.py; the shared fixture and dpop.mcp-server-decides-the-proof updated.
| for (const message of messages) { | ||
| for (const [name, value] of Object.entries(message.context ?? {})) { | ||
| if (value === null) delete shared[name]; | ||
| else shared[name] = value; |
| clock = cast(Clock, first_contribution(self.reactor, CLOCKS, "clock")) | ||
| link_reference = _link_reference(link) | ||
| reference = await store.take(link_reference) | ||
| pending = await store.take(reference) if isinstance(reference, str) else None |
There was a problem hiding this comment.
| const unpushed = await ctx.send("GET", request.authorizationUrl.reveal()); | ||
| const location = unpushed.headers.get("location") ?? ""; | ||
| check( | ||
| unpushed.status >= 400 || !location.includes("code="), |
| throw new ConversationError("sse_unsupported", "the company does not stream this conversation"); | ||
| } | ||
| for await (const frame of sseFrames(response.body, this.#maxResponseBytes)) { | ||
| if (frame.event !== undefined && !STREAM_EVENT_NAMES.has(frame.event)) { |


Implements Personal Agent Protocol 1.0 as published (upstream
8c02b42, frozen 2026-11-14; reviewed through6764732, whose later commits restructure the site only) in both SDKs and both reference companies. 1.0 stays the default; 0.4 as published is unchanged (1.0's rules apply at 1.0 only).Breaking (see the 0.36 → 0.37 migration page):
CompanyConfig.agent_description/agentDescriptionis required; a 1.0poppy.jsonwhoseagent.protocolsentry has nodescriptionis refused.prompt=consent(same_device_redirect/sameDeviceRedirectleaves it out).conversation_request_failed(original indetails.error).New: Pushed Authorization Requests (agent pushes when the issuer lists the endpoint;
link_page+open_link; companypushed_authorization_requestsoff/offered/required),bind_refresh_tokens, consent pages withgranted_before,allow_portsand ports inorganization.domain,allows_resource→invalid_target,effective_contextandnullclearing, unknown role/author type/SSE event tolerance,ConversationEvent.sign_in_scopes,ucp_scopesper version, RSA 2048–4096 for PS384,MEDIATED_RETIREMENT_DATE.Conformance: new fixture cases and a
pushed-requestsworld, all four pairings at 1.0 and at 0.4. Ledger (PAP10-*), coverage, conformance report, UPSTREAM.md, vendored schemas at8c02b42, CHANGELOG, compatibility/support/migration updated. Upstream #84 (operation in flight at sign-out) documented on the open-topics page, no normative behaviour invented.Examples:
AGENT_RUNTIMES_REF: feat/scenes(Agent Runtimes adopts 0.37 there).Local: Python 1598 passed (+ conformance report test after regeneration); TypeScript 1069 passed, 1 skipped (pre-existing).