Metadata-Version: 2.4
Name: tibet-tail
Version: 0.2.1
Summary: Live AInternet Event Viewer — tail -f for the AInternet
Project-URL: Homepage, https://humotica.com
Project-URL: Repository, https://github.com/jaspertvdm/tibet-tail
Author-email: "J. van de Meent" <jasper@humotica.nl>, Root AI <root_idd@humotica.nl>
License-Expression: MIT
License-File: LICENSE
Keywords: ainternet,events,monitoring,tail,tibet
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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: Topic :: System :: Monitoring
Requires-Python: >=3.10
Requires-Dist: httpx-sse>=0.4.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: jis-core>=0.4.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tibet-core>=0.5.0
Provides-Extra: full
Requires-Dist: textual>=1.0.0; extra == 'full'
Provides-Extra: tui
Requires-Dist: textual>=1.0.0; extra == 'tui'
Description-Content-Type: text/markdown

# tibet-tail

Live AInternet Event Viewer -- `tail -f` for the AInternet.

Shows live events from brain_api's JIS-SIP bridge with color-coded categories and real-time statistics.

## Install

```bash
pip install tibet-tail
```

For TUI mode (interactive node monitor):

```bash
pip install tibet-tail[tui]
```

## Usage

```bash
tibet-tail                      # Live SSE stream (default)
tibet-tail --history 100        # Show last 100 events first
tibet-tail --cat ains           # Filter by category
tibet-tail --cat ains,tibet     # Multiple categories
tibet-tail --cat ipoll          # I-Poll messages
tibet-tail --level ERROR        # Only errors
tibet-tail --json               # Raw JSON output
tibet-tail --file               # Read JSONL directly (no API)
tibet-tail tui                  # Interactive TUI node monitor
```

## Categories

| Category | Icon | Description |
|----------|------|-------------|
| ains | globe | AINS name resolution |
| ami | satellite | Asterisk AMI commands |
| tibet | link | TIBET token events |
| call | phone | Call flow events |
| resolve | search | SIP resolution |
| devices | mobile | Device listing |
| delegation | handshake | Delegation events |
| handoff | shuffle | Handoff events |
| ipoll | mailbox | I-Poll messages |
| ains_claim | label | Domain claim events |

## Configuration

| Env var | Default | Description |
|---------|---------|-------------|
| `BRAIN_API_URL` | `http://localhost:8000` | brain_api address |
| `TIBET_TAIL_JSONL` | `/tmp/jis_sip_events.jsonl` | JSONL file path |

## Part of HumoticaOS

tibet-tail is part of the TIBET ecosystem -- Traceable Intent-Based Event Tokens.

One love, one fAmIly.


## License

MIT

## Credits

Designed by [Jasper van de Meent](https://github.com/jaspertvdm). Built by Jasper and [Root AI](https://humotica.com) as part of [HumoticaOS](https://humotica.com).

---

**Stack-positie:** Groep `agentic` · Bootstrap = OSAPI-handshake naar [`tibet`](https://pypi.org/project/tibet-core/) + [`jis`](https://pypi.org/project/jis-core/) (fail → snaft-rule + tibet-pol-rapport) · ← [`ainternet`](https://pypi.org/project/ainternet/) · [`tibet-trail`](https://pypi.org/project/tibet-trail/) → · See `STACK.md` · See `demo/golden-path/` for the spine end-to-end.
---

## Enterprise

For private hub hosting, SLA support, custom integrations, or compliance guidance:

| | |
|---|---|
| **Enterprise** | enterprise@humotica.com |
| **Support** | support@humotica.com |
| **Security** | security@humotica.com |

See [ENTERPRISE.md](ENTERPRISE.md) for details.
