Metadata-Version: 2.4
Name: iknowhy
Version: 0.1.0
Summary: Causal event capture for AI agents
License: MIT
Project-URL: Homepage, https://iknowhy.ai
Project-URL: Documentation, https://iknowhy.ai/docs-guide
Project-URL: Repository, https://github.com/bytecreeper/iknowhy-sdk
Keywords: ai,agents,causal,observability,tracing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24.0

# iknowhy

Causal event capture for AI agents. Track every decision, tool call, and outcome — and trace any result back to its root cause.

## Install

```
pip install iknowhy
```

## Quickstart

```python
from iknowhy import CausewayClient

c = CausewayClient(api_key='cwy_your_key')

# Log a causal chain
req  = c.log('user_request', payload={'task': 'search docs'}, session_id='s1')
call = c.log('tool_call',    payload={'tool': 'web_search'}, cause_ids=[req], session_id='s1')
res  = c.log('tool_result',  payload={'results': 5},         cause_ids=[call], session_id='s1')

# Trace back from any event
chain = c.chain(res)
for e in chain:
    print(e['name'], '->', e['payload'])
```

## API key

Get a free key at [https://iknowhy.ai](https://iknowhy.ai)
