hyperprobe-agent 1.2.24__py3-none-any.whl

hyperprobe/protos/agent_pb2.py

@@ -0,0 +1,57 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: agent.proto
+# Protobuf Python Version: 4.25.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0b\x61gent.proto\x12\x13hyperprobe.agent.v1\"\x9c\x01\n\x10GetProbesRequest\x12\x10\n\x08\x61gent_id\x18\x01 \x01(\t\x12\x12\n\nservice_id\x18\x02 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x03 \x01(\t\x12\x12\n\ncommit_sha\x18\x04 \x01(\t\x12\x10\n\x08language\x18\x05 \x01(\t\x12\x15\n\ragent_version\x18\x06 \x01(\t\x12\x10\n\x08hostname\x18\x07 \x01(\t\"\xbc\x01\n\x11GetProbesResponse\x12*\n\x06probes\x18\x01 \x03(\x0b\x32\x1a.hyperprobe.agent.v1.Probe\x12\"\n\x15next_sync_interval_ms\x18\x02 \x01(\x05H\x00\x88\x01\x01\x12=\n\rglobal_config\x18\x03 \x01(\x0b\x32&.hyperprobe.agent.v1.AgentGlobalConfigB\x18\n\x16_next_sync_interval_ms\"U\n\x16SourceMapStatusRequest\x12\x12\n\nservice_id\x18\x01 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x02 \x01(\t\x12\x12\n\ncommit_sha\x18\x03 \x01(\t\"C\n\x17SourceMapStatusResponse\x12\x13\n\x0bis_uploader\x18\x01 \x01(\x08\x12\x13\n\x0bis_complete\x18\x02 \x01(\x08\"n\n\x0eSourceMapChunk\x12\x12\n\nservice_id\x18\x01 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x02 \x01(\t\x12\x12\n\ncommit_sha\x18\x03 \x01(\t\x12\x11\n\tfile_name\x18\x04 \x01(\t\x12\x0c\n\x04\x64\x61ta\x18\x05 \x01(\x0c\"!\n\x0eUploadResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"[\n\x1cMarkSourceMapCompleteRequest\x12\x12\n\nservice_id\x18\x01 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x02 \x01(\t\x12\x12\n\ncommit_sha\x18\x03 \x01(\t\"0\n\x1dMarkSourceMapCompleteResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"\x85\x03\n\x11\x41gentGlobalConfig\x12\x13\n\x0bredact_keys\x18\x01 \x03(\t\x12\x15\n\rredact_values\x18\x02 \x03(\t\x12\x1d\n\x10max_object_depth\x18\x03 \x01(\x05H\x00\x88\x01\x01\x12\x1d\n\x10max_array_length\x18\x04 \x01(\x05H\x01\x88\x01\x01\x12\x1e\n\x11stack_frame_depth\x18\x05 \x01(\x05H\x02\x88\x01\x01\x12\"\n\x15max_object_properties\x18\x06 \x01(\x05H\x03\x88\x01\x01\x12\x1e\n\x11max_string_length\x18\x07 \x01(\x05H\x04\x88\x01\x01\x12\x1d\n\x10\x63\x61pture_closures\x18\x08 \x01(\x08H\x05\x88\x01\x01\x42\x13\n\x11_max_object_depthB\x13\n\x11_max_array_lengthB\x14\n\x12_stack_frame_depthB\x18\n\x16_max_object_propertiesB\x14\n\x12_max_string_lengthB\x13\n\x11_capture_closures\"\x91\x07\n\x05Probe\x12\n\n\x02id\x18\x01 \x01(\t\x12,\n\x04type\x18\x02 \x01(\x0e\x32\x1e.hyperprobe.agent.v1.ProbeType\x12\x18\n\x10runtime_location\x18\x03 \x01(\t\x12\x14\n\x0cruntime_line\x18\x04 \x01(\x05\x12\"\n\x1asecondary_runtime_location\x18\x05 \x01(\t\x12\x1e\n\x16secondary_runtime_line\x18\x06 \x01(\x05\x12\x11\n\tcondition\x18\x07 \x01(\t\x12\x10\n\x08template\x18\x08 \x01(\t\x12\x13\n\x0bmetric_name\x18\t \x01(\t\x12\x19\n\x11metric_expression\x18\n \x01(\t\x12\x19\n\x11watch_expressions\x18\x0b \x03(\t\x12\x11\n\thit_limit\x18\x0c \x01(\x05\x12\x13\n\x0b\x65xpiry_time\x18\r \x01(\x03\x12\x16\n\x0eruntime_column\x18\x0e \x01(\x05\x12 \n\x18secondary_runtime_column\x18\x0f \x01(\x05\x12\x1e\n\x16\x63orrelation_expression\x18\x10 \x01(\t\x12\x1d\n\x10max_object_depth\x18\x11 \x01(\x05H\x00\x88\x01\x01\x12\x1d\n\x10max_array_length\x18\x12 \x01(\x05H\x01\x88\x01\x01\x12\x1e\n\x11stack_frame_depth\x18\x13 \x01(\x05H\x02\x88\x01\x01\x12\"\n\x15max_object_properties\x18\x14 \x01(\x05H\x03\x88\x01\x01\x12\x1e\n\x11max_string_length\x18\x15 \x01(\x05H\x04\x88\x01\x01\x12$\n\x17should_capture_trace_id\x18\x16 \x01(\x08H\x05\x88\x01\x01\x12\x16\n\tlog_level\x18\x17 \x01(\tH\x06\x88\x01\x01\x12!\n\x14should_log_to_stdout\x18\x18 \x01(\x08H\x07\x88\x01\x01\x12\x1d\n\x10\x63\x61pture_closures\x18\x19 \x01(\x08H\x08\x88\x01\x01\x42\x13\n\x11_max_object_depthB\x13\n\x11_max_array_lengthB\x14\n\x12_stack_frame_depthB\x18\n\x16_max_object_propertiesB\x14\n\x12_max_string_lengthB\x1a\n\x18_should_capture_trace_idB\x0c\n\n_log_levelB\x17\n\x15_should_log_to_stdoutB\x13\n\x11_capture_closures\"W\n\x0eTelemetryBatch\x12\x10\n\x08\x61gent_id\x18\x01 \x01(\t\x12\x33\n\x06\x65vents\x18\x02 \x03(\x0b\x32#.hyperprobe.agent.v1.TelemetryEvent\"\x8a\x01\n\nStackFrame\x12\x15\n\rfunction_name\x18\x01 \x01(\t\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x13\n\x0bline_number\x18\x03 \x01(\x05\x12\x15\n\rcolumn_number\x18\x04 \x01(\x05\x12\x17\n\nclass_name\x18\x05 \x01(\tH\x00\x88\x01\x01\x42\r\n\x0b_class_name\"\x8f\x02\n\x0eTelemetryEvent\x12\x10\n\x08probe_id\x18\x01 \x01(\t\x12\x14\n\x0ctimestamp_ms\x18\x02 \x01(\x03\x12\x35\n\x0cstack_frames\x18\x03 \x03(\x0b\x32\x1f.hyperprobe.agent.v1.StackFrame\x12\x1a\n\x12\x63\x61ptured_vars_json\x18\x04 \x01(\t\x12\x1a\n\x12watch_results_json\x18\x05 \x01(\t\x12\x15\n\revaluated_log\x18\x06 \x01(\t\x12\x14\n\x0cmetric_value\x18\x07 \x01(\x01\x12\x15\n\rcapture_error\x18\x08 \x01(\t\x12\x15\n\x08trace_id\x18\t \x01(\tH\x00\x88\x01\x01\x42\x0b\n\t_trace_id\"/\n\x11TelemetryResponse\x12\x1a\n\x12\x66inished_probe_ids\x18\x01 \x03(\t*\x9c\x01\n\tProbeType\x12\x1a\n\x16PROBE_TYPE_UNSPECIFIED\x10\x00\x12\x17\n\x13PROBE_TYPE_SNAPSHOT\x10\x01\x12\x12\n\x0ePROBE_TYPE_LOG\x10\x02\x12\x16\n\x12PROBE_TYPE_COUNTER\x10\x03\x12\x15\n\x11PROBE_TYPE_METRIC\x10\x04\x12\x17\n\x13PROBE_TYPE_DURATION\x10\x05\x32\x99\x04\n\x0b\x41gentBroker\x12Z\n\tGetProbes\x12%.hyperprobe.agent.v1.GetProbesRequest\x1a&.hyperprobe.agent.v1.GetProbesResponse\x12^\n\x0fReportTelemetry\x12#.hyperprobe.agent.v1.TelemetryBatch\x1a&.hyperprobe.agent.v1.TelemetryResponse\x12o\n\x12GetSourceMapStatus\x12+.hyperprobe.agent.v1.SourceMapStatusRequest\x1a,.hyperprobe.agent.v1.SourceMapStatusResponse\x12]\n\x0fUploadSourceMap\x12#.hyperprobe.agent.v1.SourceMapChunk\x1a#.hyperprobe.agent.v1.UploadResponse(\x01\x12~\n\x15MarkSourceMapComplete\x12\x31.hyperprobe.agent.v1.MarkSourceMapCompleteRequest\x1a\x32.hyperprobe.agent.v1.MarkSourceMapCompleteResponseB\tB\x05\x41gentP\x00\x62\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'agent_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'B\005AgentP\000'
+  _globals['_PROBETYPE']._serialized_start=2694
+  _globals['_PROBETYPE']._serialized_end=2850
+  _globals['_GETPROBESREQUEST']._serialized_start=37
+  _globals['_GETPROBESREQUEST']._serialized_end=193
+  _globals['_GETPROBESRESPONSE']._serialized_start=196
+  _globals['_GETPROBESRESPONSE']._serialized_end=384
+  _globals['_SOURCEMAPSTATUSREQUEST']._serialized_start=386
+  _globals['_SOURCEMAPSTATUSREQUEST']._serialized_end=471
+  _globals['_SOURCEMAPSTATUSRESPONSE']._serialized_start=473
+  _globals['_SOURCEMAPSTATUSRESPONSE']._serialized_end=540
+  _globals['_SOURCEMAPCHUNK']._serialized_start=542
+  _globals['_SOURCEMAPCHUNK']._serialized_end=652
+  _globals['_UPLOADRESPONSE']._serialized_start=654
+  _globals['_UPLOADRESPONSE']._serialized_end=687
+  _globals['_MARKSOURCEMAPCOMPLETEREQUEST']._serialized_start=689
+  _globals['_MARKSOURCEMAPCOMPLETEREQUEST']._serialized_end=780
+  _globals['_MARKSOURCEMAPCOMPLETERESPONSE']._serialized_start=782
+  _globals['_MARKSOURCEMAPCOMPLETERESPONSE']._serialized_end=830
+  _globals['_AGENTGLOBALCONFIG']._serialized_start=833
+  _globals['_AGENTGLOBALCONFIG']._serialized_end=1222
+  _globals['_PROBE']._serialized_start=1225
+  _globals['_PROBE']._serialized_end=2138
+  _globals['_TELEMETRYBATCH']._serialized_start=2140
+  _globals['_TELEMETRYBATCH']._serialized_end=2227
+  _globals['_STACKFRAME']._serialized_start=2230
+  _globals['_STACKFRAME']._serialized_end=2368
+  _globals['_TELEMETRYEVENT']._serialized_start=2371
+  _globals['_TELEMETRYEVENT']._serialized_end=2642
+  _globals['_TELEMETRYRESPONSE']._serialized_start=2644
+  _globals['_TELEMETRYRESPONSE']._serialized_end=2691
+  _globals['_AGENTBROKER']._serialized_start=2853
+  _globals['_AGENTBROKER']._serialized_end=3390
+# @@protoc_insertion_point(module_scope)

hyperprobe/protos/agent_pb2_grpc.py

@@ -0,0 +1,199 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+
+from . import agent_pb2 as agent__pb2
+
+
+class AgentBrokerStub(object):
+    """Missing associated documentation comment in .proto file."""
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.GetProbes = channel.unary_unary(
+                '/hyperprobe.agent.v1.AgentBroker/GetProbes',
+                request_serializer=agent__pb2.GetProbesRequest.SerializeToString,
+                response_deserializer=agent__pb2.GetProbesResponse.FromString,
+                )
+        self.ReportTelemetry = channel.unary_unary(
+                '/hyperprobe.agent.v1.AgentBroker/ReportTelemetry',
+                request_serializer=agent__pb2.TelemetryBatch.SerializeToString,
+                response_deserializer=agent__pb2.TelemetryResponse.FromString,
+                )
+        self.GetSourceMapStatus = channel.unary_unary(
+                '/hyperprobe.agent.v1.AgentBroker/GetSourceMapStatus',
+                request_serializer=agent__pb2.SourceMapStatusRequest.SerializeToString,
+                response_deserializer=agent__pb2.SourceMapStatusResponse.FromString,
+                )
+        self.UploadSourceMap = channel.stream_unary(
+                '/hyperprobe.agent.v1.AgentBroker/UploadSourceMap',
+                request_serializer=agent__pb2.SourceMapChunk.SerializeToString,
+                response_deserializer=agent__pb2.UploadResponse.FromString,
+                )
+        self.MarkSourceMapComplete = channel.unary_unary(
+                '/hyperprobe.agent.v1.AgentBroker/MarkSourceMapComplete',
+                request_serializer=agent__pb2.MarkSourceMapCompleteRequest.SerializeToString,
+                response_deserializer=agent__pb2.MarkSourceMapCompleteResponse.FromString,
+                )
+
+
+class AgentBrokerServicer(object):
+    """Missing associated documentation comment in .proto file."""
+
+    def GetProbes(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def ReportTelemetry(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetSourceMapStatus(self, request, context):
+        """Handshake for JS source maps
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def UploadSourceMap(self, request_iterator, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def MarkSourceMapComplete(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_AgentBrokerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'GetProbes': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetProbes,
+                    request_deserializer=agent__pb2.GetProbesRequest.FromString,
+                    response_serializer=agent__pb2.GetProbesResponse.SerializeToString,
+            ),
+            'ReportTelemetry': grpc.unary_unary_rpc_method_handler(
+                    servicer.ReportTelemetry,
+                    request_deserializer=agent__pb2.TelemetryBatch.FromString,
+                    response_serializer=agent__pb2.TelemetryResponse.SerializeToString,
+            ),
+            'GetSourceMapStatus': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetSourceMapStatus,
+                    request_deserializer=agent__pb2.SourceMapStatusRequest.FromString,
+                    response_serializer=agent__pb2.SourceMapStatusResponse.SerializeToString,
+            ),
+            'UploadSourceMap': grpc.stream_unary_rpc_method_handler(
+                    servicer.UploadSourceMap,
+                    request_deserializer=agent__pb2.SourceMapChunk.FromString,
+                    response_serializer=agent__pb2.UploadResponse.SerializeToString,
+            ),
+            'MarkSourceMapComplete': grpc.unary_unary_rpc_method_handler(
+                    servicer.MarkSourceMapComplete,
+                    request_deserializer=agent__pb2.MarkSourceMapCompleteRequest.FromString,
+                    response_serializer=agent__pb2.MarkSourceMapCompleteResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'hyperprobe.agent.v1.AgentBroker', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+
+
+ # This class is part of an EXPERIMENTAL API.
+class AgentBroker(object):
+    """Missing associated documentation comment in .proto file."""
+
+    @staticmethod
+    def GetProbes(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/hyperprobe.agent.v1.AgentBroker/GetProbes',
+            agent__pb2.GetProbesRequest.SerializeToString,
+            agent__pb2.GetProbesResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
+    @staticmethod
+    def ReportTelemetry(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/hyperprobe.agent.v1.AgentBroker/ReportTelemetry',
+            agent__pb2.TelemetryBatch.SerializeToString,
+            agent__pb2.TelemetryResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
+    @staticmethod
+    def GetSourceMapStatus(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/hyperprobe.agent.v1.AgentBroker/GetSourceMapStatus',
+            agent__pb2.SourceMapStatusRequest.SerializeToString,
+            agent__pb2.SourceMapStatusResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
+    @staticmethod
+    def UploadSourceMap(request_iterator,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.stream_unary(request_iterator, target, '/hyperprobe.agent.v1.AgentBroker/UploadSourceMap',
+            agent__pb2.SourceMapChunk.SerializeToString,
+            agent__pb2.UploadResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
+    @staticmethod
+    def MarkSourceMapComplete(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/hyperprobe.agent.v1.AgentBroker/MarkSourceMapComplete',
+            agent__pb2.MarkSourceMapCompleteRequest.SerializeToString,
+            agent__pb2.MarkSourceMapCompleteResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)

hyperprobe_agent-1.2.24.dist-info/METADATA

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: hyperprobe-agent
+Version: 1.2.24
+Summary: Production-grade, non-breaking live debugger and telemetry agent for Python.
+Home-page: https://www.hyperprobe.co
+Author: Arif, Saksham, Karan
+Author-email: arif@hypertest.co, saksham@hypertest.co, karan@hypertest.co
+License: Hyperprobe Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: protobuf<6.0.0,>=4.25.3
+Requires-Dist: grpcio>=1.62.2
+Provides-Extra: dev
+Requires-Dist: grpcio>=1.50.0; extra == "dev"
+Requires-Dist: grpcio-tools>=1.50.0; extra == "dev"
+Requires-Dist: protobuf>=4.21.0; extra == "dev"
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# HyperProbe Python Agent
+
+Production-grade, non-breaking live debugger and telemetry agent for Python.
+
+HyperProbe allows you to debug running Python applications in real-time without breaking them, restarting them, or altering production traffic. It leverages modern Python's fast, low-overhead monitoring APIs (`sys.monitoring`) to securely and dynamically extract stack frames, local variables, and logs at targeted lines.
+
+## Features
+
+- **Non-Breaking Snapshot Probes:** Capture local variables and stack traces dynamically at any line of code.
+- **Dynamic Log Probes:** Inject live log templates to print formatted output without redeploying code.
+- **Counter Probes:** Emit a value of `1` whenever a configured source line is reached.
+- **Metric Probes:** Safely evaluate a numerical Python expression and emit its value.
+- **Duration Probes:** Measure elapsed monotonic time in milliseconds between two source lines, with optional request correlation.
+- **Zero-Code-Change Auto-Instrumentation:** Prepend our bootstrap runtime to any Python process without editing your application's code.
+- **Circular Reference & Deep Object Protection:** Memory-safe serialization of deeply nested or cyclic variables.
+- **High-Performance Safety Guard:** Automatically pauses monitoring and goes idle if CPU/memory boundaries or pause budgets are exceeded.
+
+## Metric-family probes
+
+Counter, metric, and duration probes are created through HyperProbe in the same way as snapshot and log probes. No application code changes or additional public SDK calls are required.
+
+| Probe | Configuration | Emitted `metric_value` |
+| --- | --- | --- |
+| Counter | `metric_name` and one runtime location | `1` per matching hit |
+| Metric | `metric_name`, `metric_expression`, and one runtime location | The finite numerical expression result |
+| Duration | `metric_name`, primary and secondary runtime locations, and optional `correlation_expression` | Monotonic elapsed milliseconds |
+
+Conditions are evaluated at every configured location. Metric expressions use the same restricted, read-only Python evaluator as conditions and watches. Numerical strings follow Node SDK `parseFloat` behavior for compatibility; invalid or non-finite values are exported with `metric_value` set to `0` and a populated `capture_error`.
+
+Duration correlation expressions must evaluate to a string or number. When omitted or when they evaluate to `None`, a singleton correlation key is used. Unmatched duration ends are ignored, and pending starts expire after 60 seconds.
+
+## Installation
+
+Install the package via `pip` (or `testpypi` for testing):
+
+```bash
+pip install hyperprobe-agent
+```
+
+## Usage
+
+Run your application using the `hyperprobe-run` launcher. This automatically injects the live-debugging runtime before your code executes:
+
+```bash
+HYPERPROBE_BROKER_URL="https://logger.app.hyperprobe.co" \
+HYPERPROBE_SERVICE_ID="<service-uuid-from-dashboard>" \
+HYPERPROBE_ENVIRONMENT="development" \
+GIT_COMMIT=$(git rev-parse HEAD) \
+hyperprobe-run python app.py
+```
+
+### Configuration Environment Variables
+
+Configure the agent using the following environment variables:
+
+| Variable | Description | Default |
+| --- | --- | --- |
+| `HYPERPROBE_BROKER_URL` | The URL of the HyperProbe Telemetry Broker. | *Required* |
+| `HYPERPROBE_SERVICE_ID` | A unique name identifying this service. | *Required* |
+| `HYPERPROBE_ENVIRONMENT` | Deployment environment name (e.g., `production`, `staging`). | *Required* |
+| `HYPERPROBE_COMMIT_SHA` or `GIT_COMMIT` | Git commit SHA of the running application version. | *Required* |
+| `HYPERPROBE_DISABLED` | Set to `YES` to explicitly disable the agent. | *(unset)* |
+| `HYPERPROBE_SYNC_INTERVAL_MS` | Rate at which the agent syncs probe definitions from the broker. | `60000` (1 min) |
+| `HYPERPROBE_FLUSH_INTERVAL_MS` | Delay before sending telemetry events to the broker. | `1000` (1 sec) |
+| `HYPERPROBE_MAX_QUEUE_SIZE` | Maximum number of telemetry events held before flush. | `100` |
+| `HYPERPROBE_HITS_PER_SEC` | Max snapshot capture requests per second (quota). | `10` |
+| `HYPERPROBE_BANDWIDTH_KB_PER_SEC` | Max bandwidth limit for telemetry transmissions (quota). | `1024` (1 MB) |
+| `HYPERPROBE_RPC_TIMEOUT_SEC` | Deadline for broker RPCs. | `10` |
+| `HYPERPROBE_COOLDOWN_SEC` | Tracing suspension duration after a RED safety state. | `10` |
+| `HYPERPROBE_MAX_LAG_MS` | Execution-thread lag threshold for the safety monitor. | `50` |
+| `HYPERPROBE_PAUSE_BUDGET_MS` | Per-second capture pause budget for the safety monitor. | `15` |
+| `HYPERPROBE_REDACT_KEYS` | Comma-separated key patterns to redact. | `password,secret,token,authorization,cookie,key,signature` |
+| `HYPERPROBE_REDACT_VALUES` | Comma-separated value patterns to redact. | *(empty)* |
+| `HYPERPROBE_MAX_OBJECT_DEPTH` | Maximum serialized object depth. | `3` |
+| `HYPERPROBE_MAX_ARRAY_LENGTH` | Maximum serialized array length. | `3` |
+| `HYPERPROBE_STACK_FRAME_DEPTH` | Maximum captured stack-frame depth. | `3` |
+| `HYPERPROBE_MAX_OBJECT_PROPERTIES` | Maximum serialized properties per object. | `50` |
+| `HYPERPROBE_MAX_STRING_LENGTH` | Maximum serialized string length. | `1024` |
+
+### Debug logging
+
+Set `DEBUG` to a comma- or space-separated list of namespaces. Patterns accept
+`*`, and exclusions begin with `-`:
+
+```bash
+DEBUG=hyperprobe*                               # all HyperProbe SDK logs
+DEBUG=hyperprobe:broker,hyperprobe:monitor      # selected components
+DEBUG=hyperprobe*,-hyperprobe:evaluator         # exclude a component
+DEBUG_COLORS=1                                  # force ANSI colors
+```
+
+Without `*`, a selector is exact: `DEBUG=hyperprobe` does not match
+`hyperprobe:agent`. Use `DEBUG=hyperprobe*` to enable every component.
+Set `DEBUG_COLORS=0` to disable colors. Logging configuration is read during
+SDK initialization, so set these variables before starting the process.
+
+## Programmatic Usage (Inside Your Code)
+
+If you prefer to start the agent directly inside your Python script instead of using the `hyperprobe-run` launcher, you can do so by importing the package and calling `HyperProbe.start()` programmatically.
+
+This is useful for applications where you want to control exactly when the agent boots up or configure the agent dynamically at runtime:
+
+```python
+import os
+from hyperprobe import HyperProbe
+
+# Start the agent programmatically at your application's entrypoint
+agent = HyperProbe.start({
+    "service_id": "<service-uuid-from-dashboard>",
+    "environment": os.getenv("PYTHON_ENV"),  # Your environment name (e.g. dev, staging, production). Use whatever variable contains the env value.
+    "broker_url": "https://logger.app.hyperprobe.co",
+    "commit_sha": os.getenv("GIT_COMMIT"),  # CI-injected commit SHA (reads os.getenv("GIT_COMMIT") by default)
+})
+
+# Your application code goes here...
+
+# To cleanly shut down the agent when your app stops:
+HyperProbe.shutdown()
+```

hyperprobe_agent-1.2.24.dist-info/RECORD

@@ -0,0 +1,24 @@
+hyperprobe/__init__.py,sha256=ErvFIpUhK2fDe0vKIkUuEEs1mLf5BvrFQJczW4KBsP4,237
+hyperprobe/agent.py,sha256=YUKtghBiRJVDQ5mNkShEy_KmkSU2Ng0RJWFubIf2hu8,22112
+hyperprobe/bootstrap.py,sha256=arp0lWSdGDSGigen38PPTOEjwze6d14fLusQ7_cuOQg,1501
+hyperprobe/core/__init__.py,sha256=1r5vPRYaDz5zQ5A5G4JPi9iEUxvBC1CzY8kqKKXr3JY,25
+hyperprobe/core/broker.py,sha256=dpTUkWiokVN2vN7rzV4OUvNsilhGtXlWpjVckMV4J7Q,4467
+hyperprobe/core/evaluator.py,sha256=NeW89apY_H7csF52OYmdwmvC2f3YJ-4pLrf4xklP7ws,4231
+hyperprobe/core/logger.py,sha256=FroDqYVLnsY7hCIaIHwbYsPkeAYvyxJqlL1CJgEcSY8,4245
+hyperprobe/core/monitoring_engine.py,sha256=PPD4aozQ8FP89KzAfxNBq4Q964YdOxK_4Du0K_101RY,31030
+hyperprobe/core/probe_output.py,sha256=bw1kAkKOPfMzGFQcedd27mBWs9Wb-Hgy2606LUKrUEk,5410
+hyperprobe/core/quota.py,sha256=P-lF0oWX5BI1Oz06-HSClAyv8YpHn1LrH--lgYExi6A,2259
+hyperprobe/core/safety.py,sha256=we59VYMzDBNWCuFWFekx5jZ_xGHDWyBxZl-HeywaHBY,4621
+hyperprobe/core/serializer.py,sha256=Q6z-GQFB-dojVO0OE2APYQiRDjZ1fZj98ITc0XmJyX4,6926
+hyperprobe/core/trace_extractor.py,sha256=dvPh6ZVG4fbHhkXUu-qjtiHocdlhinWJBwG6D5BukQ4,3035
+hyperprobe/core/injection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hyperprobe/core/injection/sitecustomize.py,sha256=8CeHcyO5A-O3h1SPSEXibG-6DECYyW27_TCfErKylgM,773
+hyperprobe/protos/__init__.py,sha256=JU1jQzcuydepMdz-b0Nd9mMwi6TkLEWMpM55r7QBwII,248
+hyperprobe/protos/agent_pb2.py,sha256=A6j74DEvGJgwcNVaOoFtMtl0I3Y9wYIn3aC-ldbGOGU,8281
+hyperprobe/protos/agent_pb2_grpc.py,sha256=gBQ0YDqWHqAUiE5iH0kVYl-mnSSu96WHX0ztO5X1RCg,8861
+hyperprobe_agent-1.2.24.dist-info/licenses/LICENSE,sha256=DatEVqJNb8DiIMXzkSJfATqgcOdjMZiA2MZihcu_3MU,492
+hyperprobe_agent-1.2.24.dist-info/METADATA,sha256=ULI93QU258yQrSGI-0o0IlBd_gGB8yPxOPe3e8o5Zqs,8061
+hyperprobe_agent-1.2.24.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+hyperprobe_agent-1.2.24.dist-info/entry_points.txt,sha256=rq9v7B2STaSYyqS3OVQB4wTjbqPPmTtyXhUCkidYSYQ,61
+hyperprobe_agent-1.2.24.dist-info/top_level.txt,sha256=_73ZHbABMnTWvNhqFoUOD0NF0ECScwIAiQqzyZCowRE,11
+hyperprobe_agent-1.2.24.dist-info/RECORD,,

hyperprobe_agent-1.2.24.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

hyperprobe_agent-1.2.24.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hyperprobe-run = hyperprobe.bootstrap:main

hyperprobe_agent-1.2.24.dist-info/licenses/LICENSE

@@ -0,0 +1,13 @@
+Hyperprobe Proprietary License
+
+Copyright (c) 2026 Hyperprobe. All rights reserved.
+
+This software and its associated documentation are proprietary to Hyperprobe.
+No permission is granted to use, copy, modify, distribute, sublicense, or
+create derivative works except as expressly authorized under a written
+commercial license agreement with Hyperprobe.
+
+A valid commercial license from Hyperprobe is required to operate this
+software.
+
+For licensing inquiries, visit https://hyperprobe.co/.

hyperprobe_agent-1.2.24.dist-info/top_level.txt

@@ -0,0 +1 @@
+hyperprobe