adapters: a second deep adapter, chosen by Phase 1 demand #223

Activity

1. amirkhan-ak-sf

   added this to the Phase 2 — Differentiate, go beyond (0.2.0) milestone on Sep 4, 2026
2. amirkhan-ak-sf

   added

   enhancementNew feature or requestNew feature or request

   priority/p2Meaningful improvement, ship soonMeaningful improvement, ship soon

   size/m1-2 days, multiple files1-2 days, multiple files

   area:adaptersFramework adapters and connection_kwargs() (1.8, 2.8)Framework adapters and connection_kwargs() (1.8, 2.8)

   on Sep 4, 2026
3. tbolis-at-mulesoft

   added a commit that references this issue on Sep 9, 2026

   docs(skills): reflect one-deep-seven-shallow adapter roster in afdk-c…

   ...

   9d80d26
4. tbolis-at-mulesoft

   self-assigned this

   on Oct 16, 2026
5. tbolis-at-mulesoft commented on Oct 16, 2026

   

   tbolis-at-mulesoft

   on Oct 16, 2026

   Collaborator

   More actions

   Second deep adapter: OpenAI Agents SDK (openai_agents)

   Choice: promote openai_agents to the conformance-tested tier, next to LangGraph.

   Demand evidence

   • Direct user requests (maintainer report). Users are asking us directly for OpenAI Agents SDK support. This is the signal Phase 1 said would pick the second deep adapter, and none of the other six shallow adapters has a comparable ask.
   • Public signals on this repo. I searched issues and discussions for openai-agents, openai_agents and "OpenAI Agents". There is no user-filed feature request; the matches are our own adapter, verification and bot release-watch issues. The one outside contributor touching it is @msaleme, who picked up the openai_agents verification slice in verify(openai_agents): installed constructor, MCP binding and descriptor APIs (§§8–10) #638. I'm not counting that as a feature request.
   • Adoption data. The metrics archive (donkey-development-kit-metrics) records package-level PyPI downloads only (484 without-mirror downloads over 19 days to 2026-10-13). It has no per-extra or per-framework split, so it can't tell [openai-agents] installs apart from any other extra. Docs page views per framework page are on the authenticated dashboard and weren't pulled for this comment.

   Why it is cheap to deepen

   • The adapter already builds its own AsyncOpenAI on the SDK's shared transport (full injection), so every governed header, hook and correlation id is on the wire with no framework hook needed.
   • It already passes the adapter contract suite, and the typed-refusal bridge through a Runner.run (test(refusals): typed-refusal bridge conformance for openai-agents, LlamaIndex, ADK gemini() #955).
   • The §8 constructor row is VERIFIED (LIVE) from Verify the eight framework constructor signatures against installed packages (§8) #34.

   What "deep" means in the PR

   • conformance_tested=True on the roster.
   • Runner.run surfaces added to the deep-only scenarios: handler un-refuse, custom policy, kill switch.
   • A blocking openai-agents-demo CI job, mirroring langgraph-demo: a timed simulator-only demo, then --donkey-conformance against its build(). Unlike LangGraph there is no separate mypy-against-the-real-package step: agents.* stays in mypy's follow_imports = "skip" list, so the example is type-checked with the framework as Any.
   • Correlation IDs propagate with no exemption: a Runner.run-level test shows the run id reaching dynamic instructions, a function_tool, and every request's header.
   • The nightly matrix leg.
   • A tutorial page (Support triage with the OpenAI Agents SDK).

   One asserted exemption: approval_round_trip. By default the Agents SDK turns an exception raised inside a function_tool into a tool-result string for the model, so ApprovalRequired never reaches user code. Mapping DDK approvals onto the SDK's own needs_approval / interruptions is #213. The exemption is recorded in KNOWN_LIMITATIONS and pinned by a test that fails once that changes.
6. tbolis-at-mulesoft

   added a commit that references this issue on Oct 16, 2026

   docs(examples): re-capture demo 08's output for two deep adapters (#223)

   ...

   206267e
7. tbolis-at-mulesoft

   closed this as completedin #1164on Oct 16, 2026