Skip to content

docs(rfd): Add stdio_bus Transport Layer and cross-model OpenAI Agent#720

Open
morozow wants to merge 3 commits intoagentclientprotocol:mainfrom
morozow:stdio_bus/open-ai-agent-including-cloud-infra-providers
Open

docs(rfd): Add stdio_bus Transport Layer and cross-model OpenAI Agent#720
morozow wants to merge 3 commits intoagentclientprotocol:mainfrom
morozow:stdio_bus/open-ai-agent-including-cloud-infra-providers

Conversation

@morozow
Copy link

@morozow morozow commented Mar 10, 2026

Summary

Add stdio Bus — a deterministic stdio-based kernel in C — and its universal OpenAI Agent to the ACP ecosystem. This provides transport-level routing for ACP protocols and a single agent that bridges to any OpenAI Chat Completions API-compatible endpoint.

RFD documents:

Motivation

Developers need a reliable transport layer for stdio-based ACP communication and a universal way to connect ACP clients to various LLM providers without building custom integrations for each.

What's included

stdio Bus kernel — process supervisor and NDJSON message router written in C

  • Pool-based agent instance management
  • Session ID mapping between clients and agents
  • TCP interface for ACP clients

OpenAI Agent — TypeScript worker implementing full ACP protocol

  • Works with OpenAI, AWS Bedrock, Azure OpenAI, Ollama, vLLM, LiteLLM
  • Multi-turn conversation history per session
  • SSE streaming with per-request cancellation via AbortController
  • Zero HTTP dependencies (native fetch())

Architecture

flowchart LR
    Client([ACP Client]) <-->|TCP| Kernel[stdio Bus<br/>Kernel]
    Kernel <-->|NDJSON| Agent[OpenAI<br/>Agent]
    Agent -->|POST /chat/completions| API[OpenAI-compatible<br/>API]
    API -->|SSE stream| Agent
Loading

Changes

File Change
docs/get-started/registry.mdx Add stdio Bus card (v2.0.3)
docs/get-started/clients.mdx Add stdio Bus to Connectors
docs/get-started/agents.mdx Add OpenAI Agent via stdio Bus
.gitignore Add .idea

Links

- Add Open AI Agent to agents list with stdio Bus worker adapter
- Add stdio Bus connector to clients documentation
- Add stdio Bus card to registry with version 2.0.3
- Update .gitignore to exclude JetBrains IDE .idea directory
@morozow morozow requested a review from a team as a code owner March 10, 2026 18:41
morozow added 2 commits March 10, 2026 19:49
- Add new RFD document for stdio Bus integration
- Document stdio Bus as deterministic stdio-based kernel for ACP/MCP protocols
- Include registry entry with version 2.0.3
- List stdio Bus as transport-level routing solution for clients/connectors
- Reference OpenAI Agent worker adapter implementation
- Provide links to stdio Bus repository and documentation
…details

- Expand title to reflect both stdio Bus transport layer and OpenAI Agent worker
- Add author attribution (Raman Marozau)
- Restructure elevator pitch with detailed problem statement and solution overview
- Enhance status quo section with four specific pain points: no standardized routing kernel, fragmented LLM provider support, missing reference implementation, and local model friction
- Add comprehensive proposal section detailing stdio Bus kernel capabilities and OpenAI Agent provider support (OpenAI, AWS Bedrock, Azure OpenAI, Ollama, vLLM, LiteLLM)
- Include provider compatibility table with base URLs for each supported endpoint
- Expand shiny future section with concrete benefits: unified LLM access, simplified local development, production-ready reference implementation, and infrastructure foundation
- Add detailed implementation section with architecture diagram showing kernel components, agent transport/protocol/state layers, and HTTP client integration
- Document session management with per-session conversation history and AbortController support
- Clarify stdio Bus role as process supervisor, NDJSON router, and pool manager
@morozow morozow changed the title Add stdio Bus to ACP ecosystem rfd: Add stdio Bus Transport Layer and Universal OpenAI Agent Mar 10, 2026
@morozow morozow changed the title rfd: Add stdio Bus Transport Layer and Universal OpenAI Agent docs(rfd): Add stdio Bus Transport Layer and Universal OpenAI Agent Mar 10, 2026
@morozow morozow changed the title docs(rfd): Add stdio Bus Transport Layer and Universal OpenAI Agent docs(rfd): Add stdio Bus Transport Layer and OpenAI Agent Mar 10, 2026
@morozow morozow changed the title docs(rfd): Add stdio Bus Transport Layer and OpenAI Agent docs(rfd): Add stdio Bus Transport Layer and cross-model OpenAI Agent Mar 10, 2026
@morozow morozow changed the title docs(rfd): Add stdio Bus Transport Layer and cross-model OpenAI Agent docs(rfd): Add stdio_bus Transport Layer and cross-model OpenAI Agent Mar 12, 2026
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