Skip to content

implementation-status-python-contracts.md

Latest commit

 

History

History
67 lines (46 loc) · 2.67 KB

implementation-status-python-contracts.md

File metadata and controls

67 lines (46 loc) · 2.67 KB
Raw

Implementation Status: Python and Contracts

Purpose

Detailed status snapshot for Python client and contract-generation surfaces.

Use with implementation-status.md when validating SDK coverage and typed contract posture.

Python Client (packages/python-client) Status

Implemented core capabilities:

  • sync/async clients (CodexManager, AsyncCodexManager)
  • domain wrappers for codex-manager API surfaces
  • decorator-based stream/event hooks
  • request hook decorators and middleware registration
  • protocol-oriented dependency injection boundaries
  • deterministic plugin lifecycle support
  • generic wait helpers for sync/async workflows
  • session wrapper status handling aligned with API for system-owned sessions (403) on approvals/tool-input/controls/settings/resume routes
  • turn-control and suggest-request wrappers include operational non-2xx status handling aligned to API contracts

Remote tool and orchestration support

Implemented:

  • dynamic tool-call wrappers (sessions.tool_calls, tool_calls.respond)
  • create-time remote-skill catalog registration helpers (remote_skills.create_session, remote_skills.lifecycle)
  • bound-session dispatch helpers (respond_to_signal, respond_to_pending_call, drain_pending_calls, send_and_handle)
  • signature/docstring-driven remote-skill input schema enrichment, including structured object-type expansion support
  • inferred return-contract instruction metadata (output_schema, output_description) for remote-skill prompt grounding
  • pending-call drain fallback for websocket delay windows

Typed model status

Implemented:

  • additive typed facade (cm.typed, acm.typed)
  • generated Pydantic models from OpenAPI
  • typed validation modes (typed-only, off, strict)
  • explicit typed/raw operation coverage declarations

Contract and generation status

Implemented:

  • OpenAPI route/method parity checks (API side)
  • OpenAPI schema quality checks for typed-target operations
  • Python typed coverage checks
  • generated API client and protocol schema outputs in repo

Validation status

Passing baseline checks:

  • TypeScript typecheck/test/build workflows
  • runtime smoke and agent conformance gates
  • Python compile checks

Environment-limited checks may still be blocked when local Python test dependencies are unavailable.

Related docs