Metadata-Version: 2.4
Name: nora-sdk
Version: 0.4.4
Summary: Client SDK + dev CLI to build and debug robots on NORA (Robots Center).
Author: Valisoft
License: Proprietary
Project-URL: Homepage, https://nora.valisoftconsulting.com
Keywords: nora,rpa,automation,sdk,robots
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: License :: Other/Proprietary License
Classifier: Intended Audience :: Developers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx<1.0,>=0.27
Dynamic: license-file

# nora-sdk

Client SDK + `nora` developer CLI to build and debug **robots** on NORA
(Robots Center). Install it to develop locally; in production the NORA agent
provides the same SDK automatically, so your robot code is identical.

```bash
pip install nora-sdk
```

## Uso en el robot
```python
from nora_agent import sdk

item = sdk.get_queue_item("RPA-Challenge")   # consume una cola
cred = sdk.get_asset("API_KEY")              # lee un asset (secreto)
sdk.log("info", "hola")                      # log al dashboard
sdk.update_progress(50, "a mitad")
```

## Desarrollo local con breakpoints
```bash
nora login
nora dev env --write .env     # NORA_API_URL + token de dev (dev/staging, no prod)
# apunta tu IDE a .env y debuggea, o:
nora dev run main.py
```

## Seguridad
- El token solo viaja por **HTTPS** (rechaza http salvo localhost).
- Los nombres en la URL van **percent-encoded** (sin inyección de path/query).
- Sin `shell`, sin `eval`/`exec`. Dependencia única: `httpx`.
- El token de dev está limitado a `dev`/`staging`: nunca lee secretos de producción.
- La sesión se guarda en `~/.nora/credentials.json` con permisos solo-dueño.
