trazio-telemetry 0.3.0__tar.gz

trazio_telemetry-0.3.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: trazio-telemetry
+Version: 0.3.0
+Summary: Scoped telemetry, artifact, investigation, and semantic-query SDK
+Author-email: Trazio <vc@hyperlake.cloud>
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://hyperlake.cloud
+Project-URL: Documentation, https://hyperlake.cloud/docs
+Project-URL: Repository, https://github.com/cerebrixos-org/sovereign-telemetry-platform
+Keywords: opentelemetry,otlp,openinference,agents,temporal,langflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: certifi>=2024.2.2
+Provides-Extra: temporal
+Requires-Dist: temporalio[opentelemetry]>=1.20; extra == "temporal"
+Provides-Extra: langflow
+Requires-Dist: langflow>=1.6; extra == "langflow"
+Provides-Extra: otel
+Requires-Dist: opentelemetry-api>=1.30; extra == "otel"
+Requires-Dist: opentelemetry-sdk>=1.30; extra == "otel"
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.30; extra == "otel"
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: twine>=6; extra == "dev"
+
+# Trazio Telemetry SDK for Python
+
+Version 0.3.0 renames the package from `hyperlake-telemetry`; the API is unchanged.
+See [SDK integration and release status](https://github.com/cerebrixos-org/sovereign-telemetry-platform/blob/main/sovereign-telemetry-platform/sdk/README.md).
+
+`trazio-telemetry` sends standards-compatible OTLP/HTTP JSON, attaches
+events and immutable artifacts, manages tenant-editable settings, and performs
+scoped event, artifact, video, Run, and evidence-graph investigations. It does not replace the
+OpenTelemetry SDK: applications with existing instrumentation should continue
+using their normal exporter and use this package only for run context, stable
+event identity, evaluations, and artifact attachment.
+
+```bash
+pip install trazio-telemetry
+```
+
+```python
+from trazio_telemetry import Client, Privacy
+
+client = Client(
+    base_url="https://us.hyperlake.cloud",
+    protocol_token="write-only-protocol-token",
+    tenant_jwt="short-lived-jwks-jwt",
+    privacy=Privacy(capture_content=False),
+)
+
+with client.run("invoice-agent", goal_id="goal-42") as run:
+    with run.span("lookup-account", kind="RETRIEVER"):
+        pass
+    run.evaluate("groundedness", score=0.97, label="pass")
+
+client.flush()
+
+result = client.semantic_query(
+    "Show critical robot video and related faults from the last 2 hours"
+)
+
+detection = client.analyze_live_frame(
+    "./frame.jpg",
+    stream_session_id="camera-session-17",
+    frame_id="frame-42",
+    device_id="robot-17",
+)
+```
+
+`analyze_live_frame()` uses the immutable model profile pinned to the JWT's
+pipeline. It requires a short-lived JWT with `live:analyze` and `event:ingest`.
+The response is a factual object-detection result; the attached live Rule Packs
+determine whether it becomes an alert or notification.
+
+The JWT determines tenant and pipeline routing. Explicit routing IDs are
+optional with a JWT and are rejected when they conflict with its claims. Local
+claim decoding is not signature verification; the regional service verifies
+signature, issuer, audience, expiry, permissions, tenant, and pipeline for every
+request.
+Prompt, response, tool argument, and tool result content is suppressed by
+default. Set `capture_content=True` only after applying an approved data policy.
+
+See the repository integration guides for Temporal, Langflow, OpenInference,
+Collector, and Alloy examples.
+
+## Reliable semantic queries
+
+`semantic_query()` creates and validates a versioned, bounded query plan before
+calling any endpoint. Plans may target event retrieval, artifact/vector search,
+and evidence-graph traversal, but cannot contain tenant, pipeline, URL, token,
+SQL, or authorization fields. Every response includes the plan hash and scope
+provenance.
+
+`DeterministicSemanticPlanner` works without an LLM. `ModelSemanticPlanner`
+accepts any callable that returns a JSON-like object; unsafe or invalid model
+output falls back to the deterministic plan. A model therefore interprets user
+intent but cannot expand authorization or execute arbitrary queries.
+
+Artifact and video retrieval uses configured vector embeddings. Event retrieval
+is bounded structured/lexical retrieval, while graph results come from recorded
+scoped evidence edges. These signals remain separate and similarity is not
+treated as causation.
+
+The client also exposes event listing/search, artifact search/upload/download,
+typed telemetry, video playback/timeline, Runs, evidence graphs, tenant config,
+protocol-token rotation, and Rule Pack validate/dry-run/publish helpers.

trazio_telemetry-0.3.0/README.md

@@ -0,0 +1,82 @@
+# Trazio Telemetry SDK for Python
+
+Version 0.3.0 renames the package from `hyperlake-telemetry`; the API is unchanged.
+See [SDK integration and release status](https://github.com/cerebrixos-org/sovereign-telemetry-platform/blob/main/sovereign-telemetry-platform/sdk/README.md).
+
+`trazio-telemetry` sends standards-compatible OTLP/HTTP JSON, attaches
+events and immutable artifacts, manages tenant-editable settings, and performs
+scoped event, artifact, video, Run, and evidence-graph investigations. It does not replace the
+OpenTelemetry SDK: applications with existing instrumentation should continue
+using their normal exporter and use this package only for run context, stable
+event identity, evaluations, and artifact attachment.
+
+```bash
+pip install trazio-telemetry
+```
+
+```python
+from trazio_telemetry import Client, Privacy
+
+client = Client(
+    base_url="https://us.hyperlake.cloud",
+    protocol_token="write-only-protocol-token",
+    tenant_jwt="short-lived-jwks-jwt",
+    privacy=Privacy(capture_content=False),
+)
+
+with client.run("invoice-agent", goal_id="goal-42") as run:
+    with run.span("lookup-account", kind="RETRIEVER"):
+        pass
+    run.evaluate("groundedness", score=0.97, label="pass")
+
+client.flush()
+
+result = client.semantic_query(
+    "Show critical robot video and related faults from the last 2 hours"
+)
+
+detection = client.analyze_live_frame(
+    "./frame.jpg",
+    stream_session_id="camera-session-17",
+    frame_id="frame-42",
+    device_id="robot-17",
+)
+```
+
+`analyze_live_frame()` uses the immutable model profile pinned to the JWT's
+pipeline. It requires a short-lived JWT with `live:analyze` and `event:ingest`.
+The response is a factual object-detection result; the attached live Rule Packs
+determine whether it becomes an alert or notification.
+
+The JWT determines tenant and pipeline routing. Explicit routing IDs are
+optional with a JWT and are rejected when they conflict with its claims. Local
+claim decoding is not signature verification; the regional service verifies
+signature, issuer, audience, expiry, permissions, tenant, and pipeline for every
+request.
+Prompt, response, tool argument, and tool result content is suppressed by
+default. Set `capture_content=True` only after applying an approved data policy.
+
+See the repository integration guides for Temporal, Langflow, OpenInference,
+Collector, and Alloy examples.
+
+## Reliable semantic queries
+
+`semantic_query()` creates and validates a versioned, bounded query plan before
+calling any endpoint. Plans may target event retrieval, artifact/vector search,
+and evidence-graph traversal, but cannot contain tenant, pipeline, URL, token,
+SQL, or authorization fields. Every response includes the plan hash and scope
+provenance.
+
+`DeterministicSemanticPlanner` works without an LLM. `ModelSemanticPlanner`
+accepts any callable that returns a JSON-like object; unsafe or invalid model
+output falls back to the deterministic plan. A model therefore interprets user
+intent but cannot expand authorization or execute arbitrary queries.
+
+Artifact and video retrieval uses configured vector embeddings. Event retrieval
+is bounded structured/lexical retrieval, while graph results come from recorded
+scoped evidence edges. These signals remain separate and similarity is not
+treated as causation.
+
+The client also exposes event listing/search, artifact search/upload/download,
+typed telemetry, video playback/timeline, Runs, evidence graphs, tenant config,
+protocol-token rotation, and Rule Pack validate/dry-run/publish helpers.

trazio_telemetry-0.3.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "trazio-telemetry"
+version = "0.3.0"
+description = "Scoped telemetry, artifact, investigation, and semantic-query SDK"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "LicenseRef-Proprietary"
+authors = [{name = "Trazio", email = "vc@hyperlake.cloud"}]
+keywords = ["opentelemetry", "otlp", "openinference", "agents", "temporal", "langflow"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: System :: Monitoring",
+]
+dependencies = ["certifi>=2024.2.2"]
+
+[project.optional-dependencies]
+temporal = ["temporalio[opentelemetry]>=1.20"]
+langflow = ["langflow>=1.6"]
+otel = [
+  "opentelemetry-api>=1.30",
+  "opentelemetry-sdk>=1.30",
+  "opentelemetry-exporter-otlp-proto-http>=1.30",
+]
+dev = ["build>=1.2", "pytest>=8", "twine>=6"]
+
+[project.urls]
+Homepage = "https://hyperlake.cloud"
+Documentation = "https://hyperlake.cloud/docs"
+Repository = "https://github.com/cerebrixos-org/sovereign-telemetry-platform"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

trazio_telemetry-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

trazio_telemetry-0.3.0/src/hyperlake_telemetry/__init__.py

@@ -0,0 +1,20 @@
+"""Deprecated alias: the SDK is now ``trazio_telemetry`` (package ``trazio-telemetry``)."""
+
+import sys
+import warnings
+
+import trazio_telemetry as _trazio
+from trazio_telemetry import *  # noqa: F401,F403
+from trazio_telemetry import __all__, __version__  # noqa: F401
+from trazio_telemetry import client, integrations, semantic_query  # noqa: F401
+
+warnings.warn(
+    "hyperlake_telemetry is renamed to trazio_telemetry; update your imports",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+for _name in ("client", "semantic_query", "integrations", "integrations.openinference", "integrations.temporal"):
+    __import__(f"trazio_telemetry.{_name}")
+    sys.modules[f"{__name__}.{_name}"] = sys.modules[f"trazio_telemetry.{_name}"]
+del _name, _trazio

trazio_telemetry-0.3.0/src/trazio_telemetry/__init__.py

@@ -0,0 +1,16 @@
+"""Standards-first OTLP telemetry and artifact helpers."""
+
+from .client import AdminClient, Client, Privacy, Run, Span, stable_event_id
+from .semantic_query import (
+    DeterministicSemanticPlanner,
+    ModelSemanticPlanner,
+    deterministic_plan,
+    normalize_semantic_query,
+)
+
+__all__ = [
+    "AdminClient", "Client", "Privacy", "Run", "Span", "stable_event_id",
+    "DeterministicSemanticPlanner", "ModelSemanticPlanner",
+    "deterministic_plan", "normalize_semantic_query",
+]
+__version__ = "0.3.0"