Python

The inceptiva package requires Python 3.10+ and has no runtime dependencies.

pip install inceptiva

from inceptiva import Inceptiva, ResponseOutputTextDelta, collect_stream

client = Inceptiva(api_key=api_key, agent_id=agent_id)
first = client.responses.create(message="Analyze this opportunity")
events = client.responses.stream(
    message="What should we do next?",
    conversation_id=first.conversation_id,
)

for event in events:
    if isinstance(event, ResponseOutputTextDelta):
        print(event.delta, end="", flush=True)

Close the generator early with events.close(). collect_stream(events) returns a final compatible response. An initiated stream is never retried. History and deletion are available through client.conversations; typed exceptions cover 401, 403, 404, 422, and 429.

Robust 0.4.0 contract

responses.create() and responses.stream() accept external_reference and idempotency_key. Paginate history with get_messages(conversation_id, page=1, page_size=50). Results expose rate limits, usage, and replay state through response_metadata.