conduit-observability 0.1.0__py3-none-any.whl

conduit_observability/__init__.py

@@ -0,0 +1,33 @@
+"""Conduit SDK: emit agent spans to the Conduit gateway over mTLS/gRPC."""
+
+from .client import (
+    SEVERITY_DEBUG,
+    SEVERITY_ERROR,
+    SEVERITY_INFO,
+    SEVERITY_UNSPECIFIED,
+    SEVERITY_WARN,
+    STATUS_ERROR,
+    STATUS_OK,
+    STATUS_UNSET,
+    Client,
+    ConduitError,
+    LLMCall,
+    Span,
+)
+from .llm import estimate_cost_usd
+
+__all__ = [
+    "Client",
+    "ConduitError",
+    "LLMCall",
+    "Span",
+    "SEVERITY_DEBUG",
+    "SEVERITY_ERROR",
+    "SEVERITY_INFO",
+    "SEVERITY_UNSPECIFIED",
+    "SEVERITY_WARN",
+    "STATUS_ERROR",
+    "STATUS_OK",
+    "STATUS_UNSET",
+    "estimate_cost_usd",
+]

conduit_observability/_proto/__init__.py

@@ -0,0 +1 @@
+"""Generated protobuf and gRPC stubs (scripts/gen-proto-python.sh). Do not edit."""

conduit_observability/_proto/ingestion_pb2.py

@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: ingestion.proto
+# Protobuf Python Version: 7.35.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 runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    7,
+    35,
+    1,
+    '',
+    'ingestion.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from . import span_pb2 as span__pb2
+from . import metric_pb2 as metric__pb2
+from . import log_pb2 as log__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0fingestion.proto\x12\x10observability.v1\x1a\nspan.proto\x1a\x0cmetric.proto\x1a\tlog.proto\"9\n\x11IngestSpanRequest\x12$\n\x04span\x18\x01 \x01(\x0b\x32\x16.observability.v1.Span\"@\n\x12IngestSpanResponse\x12\x10\n\x08\x61\x63\x63\x65pted\x18\x01 \x01(\x08\x12\x18\n\x10rejection_reason\x18\x02 \x01(\t\"\x91\x01\n\x12IngestBatchRequest\x12%\n\x05spans\x18\x01 \x03(\x0b\x32\x16.observability.v1.Span\x12)\n\x07metrics\x18\x02 \x03(\x0b\x32\x18.observability.v1.Metric\x12)\n\x04logs\x18\x03 \x03(\x0b\x32\x1b.observability.v1.LogRecord\"n\n\x13IngestBatchResponse\x12\x16\n\x0espans_accepted\x18\x01 \x01(\x05\x12\x18\n\x10metrics_accepted\x18\x02 \x01(\x05\x12\x15\n\rlogs_accepted\x18\x03 \x01(\x05\x12\x0e\n\x06\x65rrors\x18\x04 \x03(\t2\xc7\x01\n\x10IngestionService\x12W\n\nIngestSpan\x12#.observability.v1.IngestSpanRequest\x1a$.observability.v1.IngestSpanResponse\x12Z\n\x0bIngestBatch\x12$.observability.v1.IngestBatchRequest\x1a%.observability.v1.IngestBatchResponseB$Z\"github.com/tjscanlan/conduit/protob\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'ingestion_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z\"github.com/tjscanlan/conduit/proto'
+  _globals['_INGESTSPANREQUEST']._serialized_start=74
+  _globals['_INGESTSPANREQUEST']._serialized_end=131
+  _globals['_INGESTSPANRESPONSE']._serialized_start=133
+  _globals['_INGESTSPANRESPONSE']._serialized_end=197
+  _globals['_INGESTBATCHREQUEST']._serialized_start=200
+  _globals['_INGESTBATCHREQUEST']._serialized_end=345
+  _globals['_INGESTBATCHRESPONSE']._serialized_start=347
+  _globals['_INGESTBATCHRESPONSE']._serialized_end=457
+  _globals['_INGESTIONSERVICE']._serialized_start=460
+  _globals['_INGESTIONSERVICE']._serialized_end=659
+# @@protoc_insertion_point(module_scope)

conduit_observability/_proto/ingestion_pb2.pyi

@@ -0,0 +1,46 @@
+from . import span_pb2 as _span_pb2
+from . import metric_pb2 as _metric_pb2
+from . import log_pb2 as _log_pb2
+from google.protobuf.internal import containers as _containers
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Iterable as _Iterable, Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class IngestSpanRequest(_message.Message):
+    __slots__ = ("span",)
+    SPAN_FIELD_NUMBER: _ClassVar[int]
+    span: _span_pb2.Span
+    def __init__(self, span: _Optional[_Union[_span_pb2.Span, _Mapping]] = ...) -> None: ...
+
+class IngestSpanResponse(_message.Message):
+    __slots__ = ("accepted", "rejection_reason")
+    ACCEPTED_FIELD_NUMBER: _ClassVar[int]
+    REJECTION_REASON_FIELD_NUMBER: _ClassVar[int]
+    accepted: bool
+    rejection_reason: str
+    def __init__(self, accepted: _Optional[bool] = ..., rejection_reason: _Optional[str] = ...) -> None: ...
+
+class IngestBatchRequest(_message.Message):
+    __slots__ = ("spans", "metrics", "logs")
+    SPANS_FIELD_NUMBER: _ClassVar[int]
+    METRICS_FIELD_NUMBER: _ClassVar[int]
+    LOGS_FIELD_NUMBER: _ClassVar[int]
+    spans: _containers.RepeatedCompositeFieldContainer[_span_pb2.Span]
+    metrics: _containers.RepeatedCompositeFieldContainer[_metric_pb2.Metric]
+    logs: _containers.RepeatedCompositeFieldContainer[_log_pb2.LogRecord]
+    def __init__(self, spans: _Optional[_Iterable[_Union[_span_pb2.Span, _Mapping]]] = ..., metrics: _Optional[_Iterable[_Union[_metric_pb2.Metric, _Mapping]]] = ..., logs: _Optional[_Iterable[_Union[_log_pb2.LogRecord, _Mapping]]] = ...) -> None: ...
+
+class IngestBatchResponse(_message.Message):
+    __slots__ = ("spans_accepted", "metrics_accepted", "logs_accepted", "errors")
+    SPANS_ACCEPTED_FIELD_NUMBER: _ClassVar[int]
+    METRICS_ACCEPTED_FIELD_NUMBER: _ClassVar[int]
+    LOGS_ACCEPTED_FIELD_NUMBER: _ClassVar[int]
+    ERRORS_FIELD_NUMBER: _ClassVar[int]
+    spans_accepted: int
+    metrics_accepted: int
+    logs_accepted: int
+    errors: _containers.RepeatedScalarFieldContainer[str]
+    def __init__(self, spans_accepted: _Optional[int] = ..., metrics_accepted: _Optional[int] = ..., logs_accepted: _Optional[int] = ..., errors: _Optional[_Iterable[str]] = ...) -> None: ...

conduit_observability/_proto/ingestion_pb2_grpc.py

@@ -0,0 +1,150 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+from . import ingestion_pb2 as ingestion__pb2
+
+GRPC_GENERATED_VERSION = '1.85.1'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + ' but the generated code in ingestion_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )
+
+
+class IngestionServiceStub:
+    """IngestionService is the gateway's inbound API.
+    All RPCs require mTLS — agent identity comes from the client certificate.
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.IngestSpan = channel.unary_unary(
+                '/observability.v1.IngestionService/IngestSpan',
+                request_serializer=ingestion__pb2.IngestSpanRequest.SerializeToString,
+                response_deserializer=ingestion__pb2.IngestSpanResponse.FromString,
+                _registered_method=True)
+        self.IngestBatch = channel.unary_unary(
+                '/observability.v1.IngestionService/IngestBatch',
+                request_serializer=ingestion__pb2.IngestBatchRequest.SerializeToString,
+                response_deserializer=ingestion__pb2.IngestBatchResponse.FromString,
+                _registered_method=True)
+
+
+class IngestionServiceServicer:
+    """IngestionService is the gateway's inbound API.
+    All RPCs require mTLS — agent identity comes from the client certificate.
+    """
+
+    def IngestSpan(self, request, context):
+        """IngestSpan submits a single span. Used for real-time streaming from agents.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def IngestBatch(self, request, context):
+        """IngestBatch submits spans, metrics, and logs. Each item is validated and
+        accepted independently (not atomically); rejected items are reported in
+        IngestBatchResponse.errors.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_IngestionServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'IngestSpan': grpc.unary_unary_rpc_method_handler(
+                    servicer.IngestSpan,
+                    request_deserializer=ingestion__pb2.IngestSpanRequest.FromString,
+                    response_serializer=ingestion__pb2.IngestSpanResponse.SerializeToString,
+            ),
+            'IngestBatch': grpc.unary_unary_rpc_method_handler(
+                    servicer.IngestBatch,
+                    request_deserializer=ingestion__pb2.IngestBatchRequest.FromString,
+                    response_serializer=ingestion__pb2.IngestBatchResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'observability.v1.IngestionService', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('observability.v1.IngestionService', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class IngestionService:
+    """IngestionService is the gateway's inbound API.
+    All RPCs require mTLS — agent identity comes from the client certificate.
+    """
+
+    @staticmethod
+    def IngestSpan(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,
+            '/observability.v1.IngestionService/IngestSpan',
+            ingestion__pb2.IngestSpanRequest.SerializeToString,
+            ingestion__pb2.IngestSpanResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def IngestBatch(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,
+            '/observability.v1.IngestionService/IngestBatch',
+            ingestion__pb2.IngestBatchRequest.SerializeToString,
+            ingestion__pb2.IngestBatchResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

conduit_observability/_proto/log_pb2.py

@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: log.proto
+# Protobuf Python Version: 7.35.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 runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    7,
+    35,
+    1,
+    '',
+    'log.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\tlog.proto\x12\x10observability.v1\x1a\x1fgoogle/protobuf/timestamp.proto\"\x90\x02\n\tLogRecord\x12-\n\ttimestamp\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x08severity\x18\x02 \x01(\x0e\x32\x1d.observability.v1.LogSeverity\x12\x0c\n\x04\x62ody\x18\x03 \x01(\t\x12?\n\nattributes\x18\x04 \x03(\x0b\x32+.observability.v1.LogRecord.AttributesEntry\x12\x10\n\x08trace_id\x18\x05 \x01(\t\x12\x0f\n\x07span_id\x18\x06 \x01(\t\x1a\x31\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01*\x89\x01\n\x0bLogSeverity\x12\x1c\n\x18LOG_SEVERITY_UNSPECIFIED\x10\x00\x12\x16\n\x12LOG_SEVERITY_DEBUG\x10\x01\x12\x15\n\x11LOG_SEVERITY_INFO\x10\x02\x12\x15\n\x11LOG_SEVERITY_WARN\x10\x03\x12\x16\n\x12LOG_SEVERITY_ERROR\x10\x04\x42$Z\"github.com/tjscanlan/conduit/protob\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'log_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z\"github.com/tjscanlan/conduit/proto'
+  _globals['_LOGRECORD_ATTRIBUTESENTRY']._loaded_options = None
+  _globals['_LOGRECORD_ATTRIBUTESENTRY']._serialized_options = b'8\001'
+  _globals['_LOGSEVERITY']._serialized_start=340
+  _globals['_LOGSEVERITY']._serialized_end=477
+  _globals['_LOGRECORD']._serialized_start=65
+  _globals['_LOGRECORD']._serialized_end=337
+  _globals['_LOGRECORD_ATTRIBUTESENTRY']._serialized_start=288
+  _globals['_LOGRECORD_ATTRIBUTESENTRY']._serialized_end=337
+# @@protoc_insertion_point(module_scope)

conduit_observability/_proto/log_pb2.pyi

@@ -0,0 +1,47 @@
+import datetime
+
+from google.protobuf import timestamp_pb2 as _timestamp_pb2
+from google.protobuf.internal import containers as _containers
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class LogSeverity(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    LOG_SEVERITY_UNSPECIFIED: _ClassVar[LogSeverity]
+    LOG_SEVERITY_DEBUG: _ClassVar[LogSeverity]
+    LOG_SEVERITY_INFO: _ClassVar[LogSeverity]
+    LOG_SEVERITY_WARN: _ClassVar[LogSeverity]
+    LOG_SEVERITY_ERROR: _ClassVar[LogSeverity]
+LOG_SEVERITY_UNSPECIFIED: LogSeverity
+LOG_SEVERITY_DEBUG: LogSeverity
+LOG_SEVERITY_INFO: LogSeverity
+LOG_SEVERITY_WARN: LogSeverity
+LOG_SEVERITY_ERROR: LogSeverity
+
+class LogRecord(_message.Message):
+    __slots__ = ("timestamp", "severity", "body", "attributes", "trace_id", "span_id")
+    class AttributesEntry(_message.Message):
+        __slots__ = ("key", "value")
+        KEY_FIELD_NUMBER: _ClassVar[int]
+        VALUE_FIELD_NUMBER: _ClassVar[int]
+        key: str
+        value: str
+        def __init__(self, key: _Optional[str] = ..., value: _Optional[str] = ...) -> None: ...
+    TIMESTAMP_FIELD_NUMBER: _ClassVar[int]
+    SEVERITY_FIELD_NUMBER: _ClassVar[int]
+    BODY_FIELD_NUMBER: _ClassVar[int]
+    ATTRIBUTES_FIELD_NUMBER: _ClassVar[int]
+    TRACE_ID_FIELD_NUMBER: _ClassVar[int]
+    SPAN_ID_FIELD_NUMBER: _ClassVar[int]
+    timestamp: _timestamp_pb2.Timestamp
+    severity: LogSeverity
+    body: str
+    attributes: _containers.ScalarMap[str, str]
+    trace_id: str
+    span_id: str
+    def __init__(self, timestamp: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., severity: _Optional[_Union[LogSeverity, str]] = ..., body: _Optional[str] = ..., attributes: _Optional[_Mapping[str, str]] = ..., trace_id: _Optional[str] = ..., span_id: _Optional[str] = ...) -> None: ...

conduit_observability/_proto/log_pb2_grpc.py

@@ -0,0 +1,24 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+
+GRPC_GENERATED_VERSION = '1.85.1'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + ' but the generated code in log_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )

conduit_observability/_proto/metric_pb2.py

@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: metric.proto
+# Protobuf Python Version: 7.35.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 runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    7,
+    35,
+    1,
+    '',
+    'metric.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0cmetric.proto\x12\x10observability.v1\x1a\x1fgoogle/protobuf/timestamp.proto\"\xe5\x01\n\x06Metric\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x34\n\x06labels\x18\x02 \x03(\x0b\x32$.observability.v1.Metric.LabelsEntry\x12\r\n\x05value\x18\x03 \x01(\x01\x12-\n\ttimestamp\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12*\n\x04type\x18\x05 \x01(\x0e\x32\x1c.observability.v1.MetricType\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01*Y\n\nMetricType\x12\x1b\n\x17METRIC_TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11METRIC_TYPE_GAUGE\x10\x01\x12\x17\n\x13METRIC_TYPE_COUNTER\x10\x02\x42$Z\"github.com/tjscanlan/conduit/protob\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'metric_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z\"github.com/tjscanlan/conduit/proto'
+  _globals['_METRIC_LABELSENTRY']._loaded_options = None
+  _globals['_METRIC_LABELSENTRY']._serialized_options = b'8\001'
+  _globals['_METRICTYPE']._serialized_start=299
+  _globals['_METRICTYPE']._serialized_end=388
+  _globals['_METRIC']._serialized_start=68
+  _globals['_METRIC']._serialized_end=297
+  _globals['_METRIC_LABELSENTRY']._serialized_start=252
+  _globals['_METRIC_LABELSENTRY']._serialized_end=297
+# @@protoc_insertion_point(module_scope)

conduit_observability/_proto/metric_pb2.pyi

@@ -0,0 +1,41 @@
+import datetime
+
+from google.protobuf import timestamp_pb2 as _timestamp_pb2
+from google.protobuf.internal import containers as _containers
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class MetricType(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    METRIC_TYPE_UNSPECIFIED: _ClassVar[MetricType]
+    METRIC_TYPE_GAUGE: _ClassVar[MetricType]
+    METRIC_TYPE_COUNTER: _ClassVar[MetricType]
+METRIC_TYPE_UNSPECIFIED: MetricType
+METRIC_TYPE_GAUGE: MetricType
+METRIC_TYPE_COUNTER: MetricType
+
+class Metric(_message.Message):
+    __slots__ = ("name", "labels", "value", "timestamp", "type")
+    class LabelsEntry(_message.Message):
+        __slots__ = ("key", "value")
+        KEY_FIELD_NUMBER: _ClassVar[int]
+        VALUE_FIELD_NUMBER: _ClassVar[int]
+        key: str
+        value: str
+        def __init__(self, key: _Optional[str] = ..., value: _Optional[str] = ...) -> None: ...
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    LABELS_FIELD_NUMBER: _ClassVar[int]
+    VALUE_FIELD_NUMBER: _ClassVar[int]
+    TIMESTAMP_FIELD_NUMBER: _ClassVar[int]
+    TYPE_FIELD_NUMBER: _ClassVar[int]
+    name: str
+    labels: _containers.ScalarMap[str, str]
+    value: float
+    timestamp: _timestamp_pb2.Timestamp
+    type: MetricType
+    def __init__(self, name: _Optional[str] = ..., labels: _Optional[_Mapping[str, str]] = ..., value: _Optional[float] = ..., timestamp: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., type: _Optional[_Union[MetricType, str]] = ...) -> None: ...

conduit_observability/_proto/metric_pb2_grpc.py

@@ -0,0 +1,24 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+
+GRPC_GENERATED_VERSION = '1.85.1'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + ' but the generated code in metric_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )

conduit_observability/_proto/span_pb2.py

@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: span.proto
+# Protobuf Python Version: 7.35.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 runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    7,
+    35,
+    1,
+    '',
+    'span.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\nspan.proto\x12\x10observability.v1\x1a\x1fgoogle/protobuf/timestamp.proto\"\xf6\x02\n\x04Span\x12\x10\n\x08trace_id\x18\x01 \x01(\t\x12\x0f\n\x07span_id\x18\x02 \x01(\t\x12\x11\n\tparent_id\x18\x03 \x01(\t\x12\x0c\n\x04name\x18\x04 \x01(\t\x12.\n\nstart_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x06status\x18\x07 \x01(\x0e\x32\x1c.observability.v1.SpanStatus\x12:\n\nattributes\x18\x08 \x03(\x0b\x32&.observability.v1.Span.AttributesEntry\x12/\n\x08llm_call\x18\t \x01(\x0b\x32\x1d.observability.v1.LLMCallData\x1a\x31\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x7f\n\x0bLLMCallData\x12\r\n\x05model\x18\x01 \x01(\t\x12\x0e\n\x06prompt\x18\x02 \x01(\t\x12\x12\n\ncompletion\x18\x03 \x01(\t\x12\x14\n\x0cinput_tokens\x18\x04 \x01(\x05\x12\x15\n\routput_tokens\x18\x05 \x01(\x05\x12\x10\n\x08\x63ost_usd\x18\x06 \x01(\x01*N\n\nSpanStatus\x12\x15\n\x11SPAN_STATUS_UNSET\x10\x00\x12\x12\n\x0eSPAN_STATUS_OK\x10\x01\x12\x15\n\x11SPAN_STATUS_ERROR\x10\x02\x42$Z\"github.com/tjscanlan/conduit/protob\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'span_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z\"github.com/tjscanlan/conduit/proto'
+  _globals['_SPAN_ATTRIBUTESENTRY']._loaded_options = None
+  _globals['_SPAN_ATTRIBUTESENTRY']._serialized_options = b'8\001'
+  _globals['_SPANSTATUS']._serialized_start=571
+  _globals['_SPANSTATUS']._serialized_end=649
+  _globals['_SPAN']._serialized_start=66
+  _globals['_SPAN']._serialized_end=440
+  _globals['_SPAN_ATTRIBUTESENTRY']._serialized_start=391
+  _globals['_SPAN_ATTRIBUTESENTRY']._serialized_end=440
+  _globals['_LLMCALLDATA']._serialized_start=442
+  _globals['_LLMCALLDATA']._serialized_end=569
+# @@protoc_insertion_point(module_scope)

conduit_observability/_proto/span_pb2.pyi

@@ -0,0 +1,65 @@
+import datetime
+
+from google.protobuf import timestamp_pb2 as _timestamp_pb2
+from google.protobuf.internal import containers as _containers
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class SpanStatus(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    SPAN_STATUS_UNSET: _ClassVar[SpanStatus]
+    SPAN_STATUS_OK: _ClassVar[SpanStatus]
+    SPAN_STATUS_ERROR: _ClassVar[SpanStatus]
+SPAN_STATUS_UNSET: SpanStatus
+SPAN_STATUS_OK: SpanStatus
+SPAN_STATUS_ERROR: SpanStatus
+
+class Span(_message.Message):
+    __slots__ = ("trace_id", "span_id", "parent_id", "name", "start_time", "end_time", "status", "attributes", "llm_call")
+    class AttributesEntry(_message.Message):
+        __slots__ = ("key", "value")
+        KEY_FIELD_NUMBER: _ClassVar[int]
+        VALUE_FIELD_NUMBER: _ClassVar[int]
+        key: str
+        value: str
+        def __init__(self, key: _Optional[str] = ..., value: _Optional[str] = ...) -> None: ...
+    TRACE_ID_FIELD_NUMBER: _ClassVar[int]
+    SPAN_ID_FIELD_NUMBER: _ClassVar[int]
+    PARENT_ID_FIELD_NUMBER: _ClassVar[int]
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    START_TIME_FIELD_NUMBER: _ClassVar[int]
+    END_TIME_FIELD_NUMBER: _ClassVar[int]
+    STATUS_FIELD_NUMBER: _ClassVar[int]
+    ATTRIBUTES_FIELD_NUMBER: _ClassVar[int]
+    LLM_CALL_FIELD_NUMBER: _ClassVar[int]
+    trace_id: str
+    span_id: str
+    parent_id: str
+    name: str
+    start_time: _timestamp_pb2.Timestamp
+    end_time: _timestamp_pb2.Timestamp
+    status: SpanStatus
+    attributes: _containers.ScalarMap[str, str]
+    llm_call: LLMCallData
+    def __init__(self, trace_id: _Optional[str] = ..., span_id: _Optional[str] = ..., parent_id: _Optional[str] = ..., name: _Optional[str] = ..., start_time: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., end_time: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., status: _Optional[_Union[SpanStatus, str]] = ..., attributes: _Optional[_Mapping[str, str]] = ..., llm_call: _Optional[_Union[LLMCallData, _Mapping]] = ...) -> None: ...
+
+class LLMCallData(_message.Message):
+    __slots__ = ("model", "prompt", "completion", "input_tokens", "output_tokens", "cost_usd")
+    MODEL_FIELD_NUMBER: _ClassVar[int]
+    PROMPT_FIELD_NUMBER: _ClassVar[int]
+    COMPLETION_FIELD_NUMBER: _ClassVar[int]
+    INPUT_TOKENS_FIELD_NUMBER: _ClassVar[int]
+    OUTPUT_TOKENS_FIELD_NUMBER: _ClassVar[int]
+    COST_USD_FIELD_NUMBER: _ClassVar[int]
+    model: str
+    prompt: str
+    completion: str
+    input_tokens: int
+    output_tokens: int
+    cost_usd: float
+    def __init__(self, model: _Optional[str] = ..., prompt: _Optional[str] = ..., completion: _Optional[str] = ..., input_tokens: _Optional[int] = ..., output_tokens: _Optional[int] = ..., cost_usd: _Optional[float] = ...) -> None: ...

conduit_observability/_proto/span_pb2_grpc.py

@@ -0,0 +1,24 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+
+GRPC_GENERATED_VERSION = '1.85.1'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + ' but the generated code in span_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )

conduit_observability/client.py

@@ -0,0 +1,271 @@
+"""Conduit SDK for Python agents: send spans to the gateway over mTLS/gRPC.
+
+Usage::
+
+    from conduit_observability import Client, LLMCall
+
+    with Client.from_env() as client:
+        with client.span("agent.run") as run:
+            run.set_attr("task", "summarize")
+            with client.span("llm.call") as llm:      # child of agent.run
+                resp = call_model(prompt)
+                llm.record_llm_call(LLMCall(model=resp.model, prompt=prompt,
+                                            completion=resp.text,
+                                            input_tokens=resp.in_tokens,
+                                            output_tokens=resp.out_tokens))
+
+An exception raised inside ``with client.span(...)`` marks the span as an
+error (recording the message in ``error.message``) and is re-raised.
+"""
+
+from __future__ import annotations
+
+import contextvars
+import logging
+import os
+import secrets
+import time
+from contextlib import contextmanager
+from dataclasses import dataclass, field
+from typing import Iterator, Optional
+
+import grpc
+
+from ._proto import ingestion_pb2, ingestion_pb2_grpc, log_pb2, metric_pb2, span_pb2
+
+log = logging.getLogger("conduit_observability")
+
+# Mirrors the gateway's schema.MaxAttributeValLen; longer values get the
+# whole span rejected.
+MAX_ATTR_VALUE_BYTES = 4096
+
+# The span that new spans become children of, per thread and per asyncio task.
+_current: contextvars.ContextVar[Optional["Span"]] = contextvars.ContextVar("conduit_current_span", default=None)
+
+
+class ConduitError(Exception):
+    """A span could not be delivered or was rejected by the gateway."""
+
+
+@dataclass
+class LLMCall:
+    model: str
+    prompt: str
+    completion: str
+    input_tokens: int
+    output_tokens: int
+    cost_usd: float = 0.0
+
+
+SEVERITY_UNSPECIFIED = log_pb2.LOG_SEVERITY_UNSPECIFIED
+SEVERITY_DEBUG = log_pb2.LOG_SEVERITY_DEBUG
+SEVERITY_INFO = log_pb2.LOG_SEVERITY_INFO
+SEVERITY_WARN = log_pb2.LOG_SEVERITY_WARN
+SEVERITY_ERROR = log_pb2.LOG_SEVERITY_ERROR
+
+STATUS_UNSET = span_pb2.SPAN_STATUS_UNSET
+STATUS_OK = span_pb2.SPAN_STATUS_OK
+STATUS_ERROR = span_pb2.SPAN_STATUS_ERROR
+
+
+@dataclass
+class Span:
+    trace_id: str
+    span_id: str
+    parent_id: str
+    name: str
+    start_ns: int
+    attrs: dict = field(default_factory=dict)
+    status: int = STATUS_UNSET
+    llm_call: Optional[LLMCall] = None
+    _client: Optional["Client"] = field(default=None, repr=False)
+    _ended: bool = field(default=False, repr=False)
+
+    def set_attr(self, key: str, value: str) -> "Span":
+        self.attrs[key] = str(value)
+        return self
+
+    def set_ok(self) -> "Span":
+        self.status = STATUS_OK
+        return self
+
+    def set_error(self, err: Optional[BaseException | str]) -> "Span":
+        """Mark the span failed. ``None`` is a no-op, so callers needn't branch."""
+        if err is None:
+            return self
+        self.status = STATUS_ERROR
+        self.attrs["error.message"] = _truncate_utf8(str(err), MAX_ATTR_VALUE_BYTES)
+        return self
+
+    def record_llm_call(self, call: LLMCall) -> "Span":
+        self.llm_call = call
+        return self
+
+    def end(self) -> None:
+        """Send the span (once). Raises ConduitError if it isn't accepted."""
+        if self._ended:
+            return
+        self._ended = True
+        if self._client is not None:
+            self._client._send(self, time.time_ns())
+
+
+class Client:
+    """SDK client. Create one per process and share it; safe across threads and asyncio tasks."""
+
+    def __init__(self, gateway_addr: str, tls_cert: str, tls_key: str, tls_ca: str,
+                 timeout: float = 10.0, agent_name: Optional[str] = None):
+        # agent_name is accepted for compatibility but not sent: the gateway takes
+        # the agent's identity from its client certificate's CommonName.
+        del agent_name
+        self._timeout = timeout
+        self._channel = _secure_channel(gateway_addr, tls_cert, tls_key, tls_ca)
+        self._stub = ingestion_pb2_grpc.IngestionServiceStub(self._channel)
+
+    @classmethod
+    def from_env(cls) -> "Client":
+        """Build a client from CONDUIT_GATEWAY_ADDR, TLS_CERT, TLS_KEY, and TLS_CA.
+
+        OTEL_GATEWAY_ADDR is accepted as a fallback for CONDUIT_GATEWAY_ADDR.
+        """
+        addr = os.environ.get("CONDUIT_GATEWAY_ADDR") or os.environ["OTEL_GATEWAY_ADDR"]
+        return cls(addr, os.environ["TLS_CERT"], os.environ["TLS_KEY"], os.environ["TLS_CA"])
+
+    def start_span(self, name: str) -> Span:
+        """Start a span that is a child of the current span (if any). Call ``end()`` yourself."""
+        parent = _current.get()
+        return Span(
+            # W3C/OTLP sizes: 16-byte trace ID, 8-byte span ID, lowercase hex.
+            trace_id=parent.trace_id if parent else secrets.token_hex(16),
+            span_id=secrets.token_hex(8),
+            parent_id=parent.span_id if parent else "",
+            name=name,
+            start_ns=time.time_ns(),
+            _client=self,
+        )
+
+    @contextmanager
+    def span(self, name: str, *, raise_errors: bool = False) -> Iterator[Span]:
+        """Open a span as the current span; end and send it on exit.
+
+        By default, delivery failures are logged and not raised, so
+        instrumentation can't break the agent. With ``raise_errors=True`` they
+        raise ConduitError, unless the block is already raising its own
+        exception, which is never masked.
+        """
+        s = self.start_span(name)
+        token = _current.set(s)
+        failed = False
+        try:
+            yield s
+        except BaseException as exc:
+            failed = True
+            s.set_error(exc)
+            raise
+        finally:
+            _current.reset(token)
+            try:
+                s.end()
+            except ConduitError as err:
+                if raise_errors and not failed:
+                    raise
+                log.warning("conduit: span %r not delivered: %s", s.name, err)
+
+    def log(self, severity: int, body: str, attributes: Optional[dict] = None) -> None:
+        """Send one log record. Inside a span (``with client.span(...)``) it is
+        linked to that span and its trace. Raises ConduitError if not accepted."""
+        rec = log_pb2.LogRecord(
+            severity=severity,
+            body=body,
+            attributes={k: str(v) for k, v in (attributes or {}).items()},
+        )
+        rec.timestamp.FromNanoseconds(time.time_ns())
+        current = _current.get()
+        if current is not None:
+            rec.trace_id, rec.span_id = current.trace_id, current.span_id
+        try:
+            resp = self._stub.IngestBatch(ingestion_pb2.IngestBatchRequest(logs=[rec]), timeout=self._timeout)
+        except grpc.RpcError as err:
+            raise ConduitError(f"ingest log: {err.code().name}: {err.details()}") from err
+        if resp.logs_accepted != 1:
+            reason = resp.errors[0] if resp.errors else "unknown reason"
+            raise ConduitError(f"gateway rejected log: {reason}")
+
+    def gauge(self, name: str, value: float, labels: Optional[dict] = None) -> None:
+        """Record the current value of ``name`` (e.g. a queue depth)."""
+        self._metric(name, value, labels, metric_pb2.METRIC_TYPE_GAUGE)
+
+    def counter(self, name: str, value: float, labels: Optional[dict] = None) -> None:
+        """Record a cumulative, non-negative value of ``name`` (e.g. requests_total)."""
+        self._metric(name, value, labels, metric_pb2.METRIC_TYPE_COUNTER)
+
+    def _metric(self, name: str, value: float, labels: Optional[dict], typ: int) -> None:
+        m = metric_pb2.Metric(name=name, value=float(value), type=typ,
+                              labels={k: str(v) for k, v in (labels or {}).items()})
+        m.timestamp.FromNanoseconds(time.time_ns())
+        try:
+            resp = self._stub.IngestBatch(ingestion_pb2.IngestBatchRequest(metrics=[m]), timeout=self._timeout)
+        except grpc.RpcError as err:
+            raise ConduitError(f"ingest metric: {err.code().name}: {err.details()}") from err
+        if resp.metrics_accepted != 1:
+            reason = resp.errors[0] if resp.errors else "unknown reason"
+            raise ConduitError(f"gateway rejected metric: {reason}")
+
+    def _send(self, s: Span, end_ns: int) -> None:
+        req = ingestion_pb2.IngestSpanRequest(span=_to_proto(s, end_ns))
+        try:
+            resp = self._stub.IngestSpan(req, timeout=self._timeout)
+        except grpc.RpcError as err:
+            raise ConduitError(f"ingest span: {err.code().name}: {err.details()}") from err
+        if not resp.accepted:
+            raise ConduitError(f"gateway rejected span: {resp.rejection_reason}")
+
+    def close(self) -> None:
+        self._channel.close()
+
+    def __enter__(self) -> "Client":
+        return self
+
+    def __exit__(self, *_exc) -> None:
+        self.close()
+
+
+def _to_proto(s: Span, end_ns: int) -> span_pb2.Span:
+    out = span_pb2.Span(
+        trace_id=s.trace_id,
+        span_id=s.span_id,
+        parent_id=s.parent_id,
+        name=s.name,
+        status=s.status,
+        attributes=s.attrs,
+    )
+    out.start_time.FromNanoseconds(s.start_ns)
+    out.end_time.FromNanoseconds(max(end_ns, s.start_ns))
+    if s.llm_call is not None:
+        c = s.llm_call
+        out.llm_call.CopyFrom(span_pb2.LLMCallData(
+            model=c.model, prompt=c.prompt, completion=c.completion,
+            input_tokens=c.input_tokens, output_tokens=c.output_tokens, cost_usd=c.cost_usd,
+        ))
+    return out
+
+
+def _secure_channel(addr: str, cert: str, key: str, ca: str) -> grpc.Channel:
+    """mTLS channel that trusts only ``ca`` for the gateway's certificate."""
+    def read(path: str) -> bytes:
+        with open(path, "rb") as f:
+            return f.read()
+
+    creds = grpc.ssl_channel_credentials(
+        root_certificates=read(ca),
+        private_key=read(key),
+        certificate_chain=read(cert),
+    )
+    return grpc.secure_channel(addr, creds)
+
+
+def _truncate_utf8(s: str, limit: int) -> str:
+    b = s.encode("utf-8")
+    if len(b) <= limit:
+        return s
+    return b[:limit].decode("utf-8", errors="ignore")

conduit_observability/llm.py

@@ -0,0 +1,24 @@
+"""Cost estimation utilities for LLM calls."""
+
+# Prices per 1M tokens: (input $/1M, output $/1M)
+_PRICES: dict[str, tuple[float, float]] = {
+    "claude-opus-4-6":   (15.0, 75.0),
+    "claude-sonnet-4-6": (3.0, 15.0),
+    "claude-haiku-4-5":  (0.80, 4.0),
+    "gpt-4o":            (5.0, 15.0),
+    "gpt-4o-mini":       (0.15, 0.60),
+    "gemini-1.5-pro":    (7.0, 21.0),
+    "gemini-1.5-flash":  (0.35, 1.05),
+}
+
+
+def estimate_cost_usd(model: str, input_tokens: int, output_tokens: int) -> float:
+    """Estimate cost in USD from token counts and model pricing.
+
+    Returns 0.0 for unknown models — add the model to _PRICES to fix.
+    """
+    prices = _PRICES.get(model)
+    if prices is None:
+        return 0.0
+    input_price, output_price = prices
+    return (input_tokens * input_price + output_tokens * output_price) / 1_000_000

conduit_observability-0.1.0.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.5
+Name: conduit-observability
+Version: 0.1.0
+Summary: Python SDK for Conduit: send traces, logs and metrics from AI agents to a Conduit gateway over mTLS/gRPC
+Project-URL: Homepage, https://tjscanlan.github.io/conduit/
+Project-URL: Documentation, https://tjscanlan.github.io/conduit/sdk-python.html
+Project-URL: Repository, https://github.com/tjscanlan/conduit
+Project-URL: Issues, https://github.com/tjscanlan/conduit/issues
+Author: TJ Scanlan
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: ai-agents,grpc,llm,mtls,observability,telemetry,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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Logging
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Requires-Dist: grpcio>=1.85.1
+Requires-Dist: protobuf<8,>=7.35.1
+Provides-Extra: dev
+Requires-Dist: cryptography>=46; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# conduit-observability
+
+The Python SDK for [Conduit](https://tjscanlan.github.io/conduit/), secure, self-hosted observability for AI agents. It sends **traces, logs and metrics** from your agent to a Conduit gateway over gRPC with mutual TLS.
+
+```bash
+pip install conduit-observability
+```
+
+Requires Python 3.10 or newer, and a running Conduit gateway with a client certificate for your agent. See [Deployment](https://tjscanlan.github.io/conduit/deployment.html).
+
+## Quick start
+
+```python
+from conduit_observability import Client, LLMCall, SEVERITY_WARN
+
+with Client(
+    "gateway.example.com:4317",
+    tls_cert="certs/research-bot.crt",   # your agent's client certificate
+    tls_key="certs/research-bot.key",
+    tls_ca="certs/ca.crt",               # the only CA trusted for the gateway
+) as client:
+    with client.span("agent.run") as run:
+        run.set_attr("task", "summarize")
+
+        with client.span("llm.call") as llm:          # nested: same trace
+            resp = call_model(prompt)                  # an exception marks the span as an error
+            llm.record_llm_call(LLMCall(model=resp.model, prompt=prompt, completion=resp.text,
+                                        input_tokens=resp.input_tokens, output_tokens=resp.output_tokens))
+            llm.set_ok()
+
+        client.log(SEVERITY_WARN, "retrying tool call", {"attempt": 2})   # linked to agent.run
+        client.gauge("queue_depth", 7, {"queue": "tasks"})
+```
+
+## What you get
+
+- **Spans** that nest automatically. The current span is tracked with `contextvars`, so nesting is correct across threads and asyncio tasks.
+- **Errors recorded for you:** an exception inside `with client.span(...)` marks the span as an error, records the message, and propagates.
+- **Logs** (`client.log`) linked to the current span, and **metrics** (`client.gauge`, `client.counter`).
+- **Strict TLS:** the gateway is verified against your CA only, never the system roots.
+- **Identity from your certificate:** the gateway takes your agent's identity from the certificate's CommonName, so an attribute can't spoof it.
+
+## Documentation
+
+- [Python SDK guide](https://tjscanlan.github.io/conduit/sdk-python.html): the full API, limits and delivery semantics.
+- [API reference](https://tjscanlan.github.io/conduit/api.html): the wire protocol and validation limits.
+- [Source](https://github.com/tjscanlan/conduit/tree/main/sdk/python).
+
+Licensed under Apache-2.0.

conduit_observability-0.1.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+conduit_observability/__init__.py,sha256=D99Djt5s37WUypwsS5lgePijDLwpxGea0RSN1niaqcI,615
+conduit_observability/client.py,sha256=7_rtG7wYn7JbRkzjdnHQeFPJuwJiqXNUhVdEINwAHRo,10106
+conduit_observability/llm.py,sha256=Tr3pFP3qjKbyhG9fMzJQoshDJ_OMkMGBrtNWuZ3dc-U,840
+conduit_observability/_proto/__init__.py,sha256=UER8ftXk7Qrs0P5O03dYDC79KrIiwSHoKxpd268mQ7o,84
+conduit_observability/_proto/ingestion_pb2.py,sha256=vVm28y-IsIZ6HOApDPbTz-dGXOlTsM3nEGHRIyVtaRs,2865
+conduit_observability/_proto/ingestion_pb2.pyi,sha256=DgRhJlorLBX2wTvaW4J9xZQ9XIsk4YO8Ns9_1wJkf0E,2351
+conduit_observability/_proto/ingestion_pb2_grpc.py,sha256=8jMJQY4iQuWGg4YGgMQtLr04w3DbLCdKLXQyoDHY1bI,5641
+conduit_observability/_proto/log_pb2.py,sha256=dihfQm0e_ZRqfzK8RX5uQcWSt3N_E3F3ErQe_NmRWyo,2523
+conduit_observability/_proto/log_pb2.pyi,sha256=Klil0-Svr7HrrY8HNdX-fN3alXKrcRA5sZw9rdCZzAo,2135
+conduit_observability/_proto/log_pb2_grpc.py,sha256=hSuBHEpmJFRW-i5yQd0TwcFLyst18LYEmbW7D8koAUA,883
+conduit_observability/_proto/metric_pb2.py,sha256=Pw35RLWNXU4iHHmjOHDRlHSb3KZwZdVurmMCuuAo7LM,2347
+conduit_observability/_proto/metric_pb2.pyi,sha256=itBgErd0oS6G-QeTDQGcNMV_RIxoU91e8RlkMQyTFJc,1823
+conduit_observability/_proto/metric_pb2_grpc.py,sha256=gk08NrDP-jOODRRVnC-SyOkAWTHONO3-KseOVORYihc,886
+conduit_observability/_proto/span_pb2.py,sha256=MinhxGGjMnbhY5VVZByRRZNM7d-sEOfADdcDGij-Zpo,2921
+conduit_observability/_proto/span_pb2.pyi,sha256=0YpDtocy5K7dlXi7pzIoDuJElltiFqxIX_vJpIPeWYc,3111
+conduit_observability/_proto/span_pb2_grpc.py,sha256=oizS2UEvyXmZPrW_1AGpSK1JkMjkgczaV-oj5yx1JIo,884
+conduit_observability-0.1.0.dist-info/METADATA,sha256=NDpiKcuh_qbSg9OEeVjo1MAFZorXBonBhBBZnwDIzpo,3833
+conduit_observability-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+conduit_observability-0.1.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+conduit_observability-0.1.0.dist-info/RECORD,,

conduit_observability-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

conduit_observability-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.