Skip to content

feat(core): harden v2 interaction contracts - #219

Merged
seanbrar merged 1 commit into
mainfrom
codex/v2-rc-contract-hardening
Jul 12, 2026
Merged

seanbrar merged 1 commit into
mainfrom
codex/v2-rc-contract-hardening

Conversation

@seanbrar

Copy link
Copy Markdown
Owner

Summary

Hardens the v2 RC boundaries required by downstream agent runtimes: public provider-aware environment identity, opaque schema-v2 continuation state with validated portable history messages, and deterministic cancellation/early-stream cleanup through core and every provider adapter.

Related issue

None

Test plan

  • just check — Ruff formatting/lint, Markdown lint, mypy, and 472 non-API tests passed; 19 credentialed API tests were deselected by the standard check target.
  • just docs-build — MkDocs built the documentation successfully.
  • Boundary coverage includes environment fingerprint semantics, continuation schema/provider compatibility, portable text and parallel tool history, Anthropic signed-thinking replay, one-shot/session cancellation, and explicit early stream closure across all provider adapters.

Notes

This intentionally uses the RC window for breaking corrections. Schema-v1 RC continuations are rejected; Continuation construction/state inspection and transcript conversion helpers are removed; EnvironmentSnapshot is no longer public; and system history moves to Environment.instructions. Runtime policy, persistence, tool execution, memory, and idempotency remain downstream concerns.


  • PR title follows conventional commits
  • just check passes
  • Tests cover the meaningful cases, not just the happy path
  • Docs updated (if this changes public API or user-facing behavior)

@seanbrar
seanbrar merged commit e8ef4ee into main Jul 12, 2026
9 checks passed
@seanbrar
seanbrar deleted the codex/v2-rc-contract-hardening branch July 12, 2026 02:35
@codecov

codecov Bot commented Jul 12, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 85.64356% with 29 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
src/pollux/_lifecycle.py 63.63% 12 Missing ⚠️
src/pollux/interaction/continuation.py 90.00% 12 Missing ⚠️
src/pollux/interaction/environment.py 58.33% 5 Missing ⚠️

📢 Thoughts on this report? Let us know!

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.

1 participant