Metadata-Version: 2.4
Name: xenevis
Version: 0.1.0a1
Summary: Deterministic Python Runtime SDK for event-driven bots, automations, and runtime-backed applications.
Author: Xenevis contributors
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/avrhxxx/xenevis
Project-URL: Repository, https://github.com/avrhxxx/xenevis
Project-URL: Issues, https://github.com/avrhxxx/xenevis/issues
Keywords: runtime,sdk,bots,telegram,automation,workflow,event-driven,signals,diagnostics,tracing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Provides-Extra: google
Requires-Dist: google-auth>=2.0.0; extra == "google"
Requires-Dist: requests>=2.0.0; extra == "google"
Dynamic: license-file

# Xenevis SDK

Xenevis SDK is a deterministic Python Runtime SDK for building event-driven bots, automations, workflows, and runtime-backed application surfaces.

Xenevis is Telegram-first, but not Telegram-only.

It is not an AI runtime by default, not a Telegram API wrapper, and not a hidden-agent framework.

## Status

Xenevis SDK is currently in alpha-stage Runtime foundation development.

This package is intended for early testing, development, and validation. Do not treat this alpha release as stable production infrastructure yet.

## Install

```bash
pip install xenevis
```

## Minimal Telegram bot

```python
import xenevis
from xenevis.telegram import button

xenevis.configure(
    observer=xenevis.observer.console(format="native")
)

@xenevis.telegram.command("start")
async def start(ctx):
    return xenevis.telegram.ui(
        screen="Start",
        text="Welcome to Xenevis.",
        inline=[
            button.callback("Run demo", "demo.run"),
        ],
    )

@xenevis.telegram.callback("demo.run")
async def demo(ctx):
    return xenevis.telegram.ui(
        screen="Demo",
        text="Runtime executed this callback.",
    )

if __name__ == "__main__":
    xenevis.telegram.polling().run()
```

## Core model

```text
Event -> Entry -> Context -> Execution Primitive -> Components -> Signals -> Diagnostics -> Trace -> Surface Delivery
```

Xenevis Runtime executes the flow. Signals describe what happened. Diagnostics explain problems. Surfaces deliver outputs.

## Public primitives

Xenevis exposes four public execution primitives:

```python
xenevis.direct(...)
xenevis.chain(...)
xenevis.trigger(...)
xenevis.stream(...)
```

There is no public root `xenevis.run(...)` API.

## Privacy

Xenevis SDK does not start background telemetry, automated crash reporting, phone-home behavior, or silent external diagnostics by default.

Diagnostics and observer output are local by default.

## License

Xenevis SDK is licensed under the Apache License 2.0.

The Xenevis name, logo, visual identity, and project branding are separate from the software code licensed under Apache-2.0. See `BRAND.md`.
