Skip to content

0.37.0: Poppy 1.0 as published - #18

Merged
echarles merged 2 commits into
mainfrom
release/0.37.0
Nov 17, 2026
Merged

echarles merged 2 commits into
mainfrom
release/0.37.0

Conversation

@echarles

Copy link
Copy Markdown
Member

Implements Personal Agent Protocol 1.0 as published (upstream 8c02b42, frozen 2026-11-14; reviewed through 6764732, 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 / agentDescription is required; a 1.0 poppy.json whose agent.protocols entry has no description is refused.
  • Direct Sign-In requests carry prompt=consent (same_device_redirect / sameDeviceRedirect leaves it out).
  • Unknown conversation error codes become conversation_request_failed (original in details.error).

New: Pushed Authorization Requests (agent pushes when the issuer lists the endpoint; link_page + open_link; company pushed_authorization_requests off/offered/required), bind_refresh_tokens, consent pages with granted_before, allow_ports and ports in organization.domain, allows_resource → invalid_target, effective_context and null clearing, unknown role/author type/SSE event tolerance, ConversationEvent.sign_in_scopes, ucp_scopes per version, RSA 2048–4096 for PS384, MEDIATED_RETIREMENT_DATE.

Conformance: new fixture cases and a pushed-requests world, all four pairings at 1.0 and at 0.4. Ledger (PAP10-*), coverage, conformance report, UPSTREAM.md, vendored schemas at 8c02b42, 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).

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.
Copilot AI balanced review requested due to automatic review settings November 17, 2026 10:48

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 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
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

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Expected while Agent Runtimes adopted 0.37 on feat/scenes; it now pins >=0.37.0,<0.38 and 1.6.83 is released. #19 (8b19846, 0.37.1) empties AGENT_RUNTIMES_REF, and the Examples job there builds every app with agent-runtimes 1.6.83.

Comment thread src/accounts.ts
try {
result =
metadata !== undefined && this.#isMcp(metadata.resource)
? await refresh.tokenForMcp(reference, { context, server: metadata, ...narrowed })

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread src/models.ts
for (const message of messages) {
for (const [name, value] of Object.entries(message.context ?? {})) {
if (value === null) delete shared[name];
else shared[name] = value;

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in #19 (8b19846, 0.37.1): effectiveContext defines each field as an own data property, so a proto field stays a field; test added. The Python twin uses a dict and has no such issue.

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

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in #19 (8b19846, 0.37.1), both SDKs: the link has its own record (a copy of the request), open_link reads only that and never takes the callback state; complete() consumes the state once and drops the link. Tests check open_link never takes the state and that reopening then completing works.

const unpushed = await ctx.send("GET", request.authorizationUrl.reveal());
const location = unpushed.headers.get("location") ?? "";
check(
unpushed.status >= 400 || !location.includes("code="),

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in #19 (8b19846, 0.37.1), both runners: the case now requires an explicit OAuth refusal, an error status or a redirect carrying error (and no code); a redirect to a login page fails it.

Comment thread src/conversations.ts
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)) {

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in #19 (8b19846, 0.37.1), both SDKs: an empty event: name is the default message event; only non-empty unknown names are skipped. Tests added in both.

@echarles
echarles merged commit 34f8fbd into main Nov 17, 2026
17 of 19 checks passed
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