waken-openai

OpenAI Target adapter for Waken — "nginx for AI agents." Routes a waken Event to the OpenAI Responses API and returns a Response.

Install

pip install waken-openai

OPENAI_API_KEY must be set in the environment — that's the openai SDK's own convention, nothing waken-specific.

Usage

from waken import Runtime
from waken_openai import OpenAIAdapter

runtime = Runtime()
runtime.target("openai", OpenAIAdapter())
runtime.run()

waken send openai "Build tic tac toe." --wait

OpenAIAdapter keeps a waken session_id -> OpenAI response id map internally, so a multi-turn conversation (same event.session_id across calls) resumes via the Responses API's own previous_response_id — its native server-side continuation mechanism — instead of starting over each turn. Pass a model or extra client options at construction time:

runtime.target("openai", OpenAIAdapter(model="gpt-4o", organization="org-..."))

model defaults to "gpt-4.1". Any other keyword argument is forwarded straight to AsyncOpenAI(...) (api_key, organization, base_url, ...).

Development

git clone https://github.com/WakenHQ/waken-openai
cd waken-openai
pip install -e ".[dev]"
pytest

Tests mock openai.AsyncOpenAI entirely — no API key or network access needed to run the suite.

License

MIT