Metadata-Version: 2.4
Name: inceptiva
Version: 0.4.0
Summary: Official Python SDK for Inceptiva agents
Author: Inceptiva
License-Expression: MIT
Project-URL: Documentation, https://sdk.inceptiva.com/docs/sdk/python
Project-URL: Repository, https://github.com/lucasovalle/inceptiva-sdk
Project-URL: Issues, https://github.com/lucasovalle/inceptiva-sdk/issues
Keywords: inceptiva,ai,agents,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

﻿# Inceptiva for Python

Official Python SDK for Inceptiva agents. Requires Python 3.10+ and has no runtime dependencies.

```bash
pip install inceptiva
```

```python
import os
from inceptiva import Inceptiva, collect_stream

client = Inceptiva(
    api_key=os.environ["INCEPTIVA_API_KEY"],
    agent_id=os.environ["INCEPTIVA_AGENT_ID"],
)

agent = client.get_agent()
first = client.responses.create(message="Analyze this opportunity")
follow_up = client.responses.create(
    message="What should we do next?",
    conversation_id=first.conversation_id,
    external_reference="crm-opportunity-123",
    idempotency_key="request-unique-id",
)
history = client.conversations.get_messages(follow_up.conversation_id, page=1, page_size=50)

print(agent.capabilities)
print(follow_up.response, follow_up.citations, follow_up.response_metadata.idempotency_replayed)
print(history.items, history.has_more)

streamed = collect_stream(client.responses.stream(
    message="Summarize it in real time",
    conversation_id=follow_up.conversation_id,
))
print(streamed.response)
```

`client.invoke(...)` remains available as a backward-compatible alias. The SDK never accepts or exposes internal `retrieval_sources`.

See the [full documentation](https://sdk.inceptiva.com/docs/sdk/python).
