GeezerVison

…ified-harness planning doc

PR 10 is stacked on PR 9 (#423). The plan sequences the 13 cleanup-scope items
plus a filesystem layout/naming consolidation (every harness -> _<harness>_sync.py
+ _<harness>_turn.py under _modules/, openai moved out of providers/_modules/)
and a harness.md docs refresh. The pre-unified unified-harness-surface plan doc is
removed now that the stack is merged.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

…s, canonical yield_turn example)

Completes the taps table with claude-code/codex/openai, names the per-harness
HarnessTurn wrappers, and replaces the pre-unified sync example (which left
UnifiedEmitter unused) with the canonical emitter.yield_turn(turn) flow.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

…rminism test once

Adds tests/lib/core/harness/_fakes.py with a single superset FakeSpan/FakeTracing
(started/ended/ended_spans plus started_names/started_pairs/ended_outputs views) and
migrates every consumer off its local copy. Keeps the conformance determinism test
once (parametrized over all_fixtures) and drops the per-harness copies. run_yield_turn
and test_langgraph_sync_unified's _FakeTracingBackend left in place (genuinely divergent).

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

…s onto the numbered paradigm

Replaces the pre-unified langgraph/pydantic-ai/openai tutorials (which imported the
deprecated create_*_tracing_handler) with their unified-surface harness_* counterparts,
moved into the numbered NNN_<name> slots. codex takes fresh numbers (070/140/150).
Fixes the 060/130/140 numbering collision between harness_openai and claude_code by
folding openai into the old openai slots (050/120, renamed _openai_agents). Adds the
shared .dockerignore to langgraph/codex tutorials. 090_claude_agents_sdk_mvp untouched.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

…emplates to the unified surface

BREAKING CHANGE: removes create_langgraph_tracing_handler / create_pydantic_ai_tracing_handler
and their handler classes (AgentexLangGraphTracingHandler / AgentexPydanticAITracingHandler) from
the public adk surface. Span tracing is now derived from the canonical stream by UnifiedEmitter.

Migrates the five sync-/default-/temporal- pydantic-ai and langgraph CLI templates onto
UnifiedEmitter + the per-harness Turn wrappers (mirroring the migrated tutorials), drops the now-dead
tracing_handler parameter from the pydantic-ai sync/async/turn modules, deletes the deprecated-path
tests, and trims the resolved AGX1-377/378 workaround markers to plain current-contract comments.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

…_<harness>_turn.py

Folds the pydantic-ai/langgraph _async + _langgraph_messages helpers into their
turn/sync modules (stream_*_events -> _<h>_turn.py, emit_langgraph_messages ->
_langgraph_sync.py); public facade names are unchanged. Relocates the OpenAI harness
Turn + convert_openai_to_agentex_events tap into _modules/_openai_turn.py /
_modules/_openai_sync.py, leaving back-compat shims at providers/_modules/{openai_turn,
sync_provider}.py so the adk.providers namespace + CLI template keep working (the larger
openai.py Temporal/MCP provider stays under adk.providers). Merges the duplicate
_sync / _sync_unified test modules into one per harness.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

… claude_code, codex

Brings integration-test parity across all five harnesses (was pydantic-ai + langgraph only):
9 new test_harness_<h>_{sync,async,temporal}.py suites built on the shared _fakes, with
native-stream shapes drawn from each harness's turn + conformance tests. Extends the
harness-integration.yml live-matrix to all five harnesses and generalizes the trigger glob.
Temporal suites assert the auto_send delivery + created_at threading (no harness has a
separate temporal stream helper), documented per file.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

…x stale tutorial refs

Documents the deprecated-tracing-handler removal and the _modules consolidation /
openai relocation (with back-compat shim window) under CHANGELOG Unreleased, and
updates the sync_provider deprecation note to the renamed openai tutorial slots.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

…ile P1)

The shared test_span_derivation_is_deterministic parametrized over all_fixtures()
at COLLECTION time, which froze the set to the 5 generic fixtures registered before
test_conformance.py was imported — silently dropping per-harness determinism coverage
when the per-harness copies were removed in Batch A2. Make it iterate all_fixtures()
at RUN time (after all modules are collected) with a guard asserting per-harness
fixtures are present, and add a conformance/conftest.py that eagerly imports every
per-harness module so coverage is independent of collection order / run scope.

Also fixes the plan doc per greptile: make the openai tutorial mapping explicitly
delete-and-replace the old slots, and correct the Batch I/H verification to expect the
sync_provider/openai_turn shims (used by the sync-openai template + base sync tutorials)
rather than zero references.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

…the cleanup has landed

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

…nc openai-agents

Adds scaffolding for the harnesses that lacked an init path: claude-code and codex
across all three tiers (sync / default-async / temporal), plus the missing
default-openai-agents (async-base) variant. Each template uses the unified harness
surface (UnifiedEmitter + the harness *Turn), mirrors the migrated tutorials, and is
wired into the TemplateType enum, project-file map, and the sync/async/temporal init
menus. All 19 template types render to valid Python under test_init_templates.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

Pyright can't statically resolve the absolute `tests.lib.core.harness._fakes` import
(it only works at pytest runtime via the rootdir on sys.path), failing ./scripts/lint.
Switch every consumer to a relative import (matching the conformance package's
convention) and re-sort the affected import blocks.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>