naylence-runtime 0.4.2

Naylence Runtime

Naylence Runtime

Message fabric, connectors, listeners, and security primitives that power Naylence agents, nodes and sentinels. This package provides the runtime substrate—not the high‑level Agent SDK or tutorials.

---

What this is

naylence‑runtime is the foundational library that implements:

• FAME fabric (in‑process and networked) for routing envelopes between clients, agents, and sentinels.
• Connectors & listeners for WebSocket/HTTP transports, back‑pressure, flow control, and streaming.
• Profiles & admission: pluggable admission flows (e.g., token‑based), logical addressing, and attach APIs.
• Security building blocks: envelope signing, overlay encryption, JWT/JWKS helpers, and identity hooks.
• FastAPI utilities used by sentinels and auxiliary services (JWKS, OAuth token router, etc.).

It is meant to be embedded by the Agent SDK, sentinels, and security add‑ons. Most users should not call it directly unless they’re extending transports, writing custom admission, or integrating Naylence into an existing control plane.

---

When to use (and when not)

Use naylence‑runtime if you need to:

• Build or customize transport connectors/listeners.
• Implement or extend admission/identity flows.
• Operate a bespoke sentinel or welcome/CA services.

Prefer the higher‑level packages for day‑to‑day development:

• Naylence Agent SDK (Python) — idiomatic agent APIs & ergonomics. → https://github.com/naylence/naylence-agent-sdk-python
• Naylence Examples (Python) — runnable learning path & patterns. → https://github.com/naylence/naylence-examples-python

If you’re just getting started, learn with the Agent SDK and Examples first; drop down to Runtime only when you need lower‑level control.

---

Security profiles

The runtime exposes security primitives used by sentinels and agents through profiles:

• direct — no admission; useful for local/dev.
• gated — OAuth2/JWT‑gated admission; TLS via your reverse proxy.
• strict‑overlay — sealed, end‑to‑end overlay encryption with SPIFFE/X.509‑style identities.

Important: The strict‑overlay profile is supported only when the naylence‑advanced‑security package is installed. Install that add‑on to enable sealed channels and SVID‑backed identities.

---

Relationship to other repos

• Runtime (this repo): https://github.com/naylence/naylence-runtime-python
• Agent SDK (Python): https://github.com/naylence/naylence-agent-sdk-python
• Examples (Python): https://github.com/naylence/naylence-examples-python
• Advanced Security add‑on: https://github.com/naylence/naylence-advanced-security-python

---

What this README intentionally omits

This page explains purpose and scope only. It does not include code samples, quick starts, or container recipes. For that:

• Start with the Agent SDK docs and examples to learn the development model.
• Refer to the Examples repository for runnable demos from simple to distributed to security‑hardened.

---

Support & license

• Issues: open tickets in the corresponding repository (Runtime, SDK, Examples, or Advanced Security) based on where the problem belongs.
• License: Apache‑2.0.