bpmlinks-smartspend-test 0.1.0__tar.gz

bpmlinks_smartspend_test-0.1.0/.gitignore

@@ -0,0 +1,40 @@
+__pycache__/
+build/
+dist/
+*.egg-info/
+.pytest_cache/
+
+playground
+
+# pyenv
+.python-version
+
+# Environments
+.env
+.venv
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# JetBrains
+.idea/
+
+/coverage.xml
+/.coverage
+
+.DS_Store
+
+# Docs
+docs
+
+# Llamaindex
+tests/mocks/llama-index-storage
+
+*.local.*
+
+# Codex local runtime state
+.codex/log/
+.codex/sessions/
+.codex/tmp/

bpmlinks_smartspend_test-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Finto Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bpmlinks_smartspend_test-0.1.0/NOTICE

@@ -0,0 +1,32 @@
+SmartSpend Python SDK
+Copyright (c) 2026 BPMLinks
+
+This product includes software derived from the langfuse-python SDK
+(https://github.com/langfuse/langfuse-python), distributed under the MIT
+License:
+
+  Copyright (c) 2022 Finto Technologies
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+
+"Langfuse" is a trademark of its respective owner. SmartSpend is an
+independent product of BPMLinks and is not affiliated with, endorsed by, or
+sponsored by the Langfuse project, Langfuse GmbH, or ClickHouse, Inc. The
+trademark owner's marks are not used in the SmartSpend product, and this
+notice exists solely to satisfy the MIT License attribution requirement.

bpmlinks_smartspend_test-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.5
+Name: bpmlinks_smartspend_test
+Version: 0.1.0
+Summary: SmartSpend Python SDK - LLM observability/tracing, datasets, experiments, LLM-as-a-judge evaluation, and prompt management
+Author-email: BPMLinks <Naresh.Edagotti@bpmlinks.com>
+License-Expression: MIT
+License-File: LICENSE
+License-File: NOTICE
+Requires-Python: <4.0,>=3.10
+Requires-Dist: backoff>=1.10.0
+Requires-Dist: httpx<1.0,>=0.15.4
+Requires-Dist: opentelemetry-api<2,>=1.33.1
+Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.33.1
+Requires-Dist: opentelemetry-sdk<2,>=1.33.1
+Requires-Dist: packaging<27.0,>=23.2
+Requires-Dist: pydantic<3,>=2
+Requires-Dist: wrapt<3,>=1.14
+Description-Content-Type: text/markdown
+
+# SmartSpend Python SDK
+
+**SmartSpend is an AI FinOps platform: observability and cost intelligence in one.**
+
+One SDK captures everything your AI workloads do — models, tokens, latency, errors,
+retries, business attribution — and the SmartSpend platform turns that into cost
+analytics, optimization recommendations, and verified savings. No separate
+observability tool, no separate FinOps tool.
+
+## Why SmartSpend
+
+- **Cost needs metadata, not your prompts.** SmartSpend runs in `metadata_only`
+  privacy mode by default: token usage, model, latency, and attribution leave your
+  process — prompt and completion content does not. Content capture is opt-in
+  (`redacted` and `full` modes), not the default.
+- **FinOps attribution is first-class.** Tag every trace with `workload`, `task`,
+  `team`, and `cost_center` — at the client, or per request — and slice spend by
+  those dimensions in the platform.
+- **Provider-aware.** Automatic instrumentation for OpenAI (incl. Azure OpenAI) and
+  Anthropic, with cached-token and reasoning-token usage normalized so prompt
+  caching is priced correctly, plus OpenTelemetry `gen_ai.*` interop for
+  everything else (LangChain handler included).
+- **Standard OpenTelemetry underneath.** Spans export via OTLP; bring your own
+  tracer provider, span filters, or export-stage masking if you need more control.
+
+## Installation
+
+```
+pip install smartspend
+```
+
+## Quickstart
+
+```python
+# env: SMARTSPEND_PUBLIC_KEY, SMARTSPEND_SECRET_KEY, SMARTSPEND_BASE_URL
+
+from smartspend import SmartSpend, observe, propagate_attributes
+
+ss = SmartSpend(
+    workload="support-bot",        # FinOps defaults applied to every trace
+    team="platform",
+    cost_center="cc-1001",
+    # privacy_mode="metadata_only" is the default: content never leaves your process
+)
+
+# Automatic LLM instrumentation — drop-in imports
+from smartspend.openai import openai          # instead of `import openai`
+from smartspend.anthropic import anthropic    # instead of `import anthropic`
+
+with propagate_attributes(user_id="user-123", task="summarize-ticket"):
+    completion = openai.OpenAI().chat.completions.create(
+        model="gpt-4o-mini",
+        messages=[{"role": "user", "content": "Summarize this ticket..."}],
+    )
+# → captured with model, token usage (incl. cached tokens), latency, cost
+#   attribution by workload/task/team/cost_center — content stripped by default.
+```
+
+Or instrument any function with the decorator:
+
+```python
+@observe()
+def handle_request(query: str) -> str:
+    ...
+```
+
+## Privacy modes
+
+| Mode | What leaves your process |
+|---|---|
+| `metadata_only` (default) | Usage, model, latency, errors, attribution metadata — **no prompt/completion content** |
+| `redacted` | Same, plus content attributes replaced with `"<redacted>"` |
+| `full` | Everything (explicit opt-in) |
+
+Set via `SmartSpend(privacy_mode=...)` or `SMARTSPEND_PRIVACY_MODE`.
+
+## License & acknowledgements
+
+MIT — see [LICENSE](LICENSE) and [NOTICE](NOTICE).
+
+The SmartSpend SDK is derived from open-source work distributed under the MIT
+license; original copyright notices are preserved in [NOTICE](NOTICE). SmartSpend
+is an independent product and is not affiliated with or endorsed by the authors
+of that work.

bpmlinks_smartspend_test-0.1.0/README.md

@@ -0,0 +1,84 @@
+# SmartSpend Python SDK
+
+**SmartSpend is an AI FinOps platform: observability and cost intelligence in one.**
+
+One SDK captures everything your AI workloads do — models, tokens, latency, errors,
+retries, business attribution — and the SmartSpend platform turns that into cost
+analytics, optimization recommendations, and verified savings. No separate
+observability tool, no separate FinOps tool.
+
+## Why SmartSpend
+
+- **Cost needs metadata, not your prompts.** SmartSpend runs in `metadata_only`
+  privacy mode by default: token usage, model, latency, and attribution leave your
+  process — prompt and completion content does not. Content capture is opt-in
+  (`redacted` and `full` modes), not the default.
+- **FinOps attribution is first-class.** Tag every trace with `workload`, `task`,
+  `team`, and `cost_center` — at the client, or per request — and slice spend by
+  those dimensions in the platform.
+- **Provider-aware.** Automatic instrumentation for OpenAI (incl. Azure OpenAI) and
+  Anthropic, with cached-token and reasoning-token usage normalized so prompt
+  caching is priced correctly, plus OpenTelemetry `gen_ai.*` interop for
+  everything else (LangChain handler included).
+- **Standard OpenTelemetry underneath.** Spans export via OTLP; bring your own
+  tracer provider, span filters, or export-stage masking if you need more control.
+
+## Installation
+
+```
+pip install smartspend
+```
+
+## Quickstart
+
+```python
+# env: SMARTSPEND_PUBLIC_KEY, SMARTSPEND_SECRET_KEY, SMARTSPEND_BASE_URL
+
+from smartspend import SmartSpend, observe, propagate_attributes
+
+ss = SmartSpend(
+    workload="support-bot",        # FinOps defaults applied to every trace
+    team="platform",
+    cost_center="cc-1001",
+    # privacy_mode="metadata_only" is the default: content never leaves your process
+)
+
+# Automatic LLM instrumentation — drop-in imports
+from smartspend.openai import openai          # instead of `import openai`
+from smartspend.anthropic import anthropic    # instead of `import anthropic`
+
+with propagate_attributes(user_id="user-123", task="summarize-ticket"):
+    completion = openai.OpenAI().chat.completions.create(
+        model="gpt-4o-mini",
+        messages=[{"role": "user", "content": "Summarize this ticket..."}],
+    )
+# → captured with model, token usage (incl. cached tokens), latency, cost
+#   attribution by workload/task/team/cost_center — content stripped by default.
+```
+
+Or instrument any function with the decorator:
+
+```python
+@observe()
+def handle_request(query: str) -> str:
+    ...
+```
+
+## Privacy modes
+
+| Mode | What leaves your process |
+|---|---|
+| `metadata_only` (default) | Usage, model, latency, errors, attribution metadata — **no prompt/completion content** |
+| `redacted` | Same, plus content attributes replaced with `"<redacted>"` |
+| `full` | Everything (explicit opt-in) |
+
+Set via `SmartSpend(privacy_mode=...)` or `SMARTSPEND_PRIVACY_MODE`.
+
+## License & acknowledgements
+
+MIT — see [LICENSE](LICENSE) and [NOTICE](NOTICE).
+
+The SmartSpend SDK is derived from open-source work distributed under the MIT
+license; original copyright notices are preserved in [NOTICE](NOTICE). SmartSpend
+is an independent product and is not affiliated with or endorsed by the authors
+of that work.

bpmlinks_smartspend_test-0.1.0/pyproject.toml

@@ -0,0 +1,140 @@
+[project]
+name = "bpmlinks_smartspend_test"
+version = "0.1.0"
+description = "SmartSpend Python SDK - LLM observability/tracing, datasets, experiments, LLM-as-a-judge evaluation, and prompt management"
+readme = "README.md"
+authors = [{ name = "BPMLinks", email = "Naresh.Edagotti@bpmlinks.com" }]
+license = "MIT"
+license-files = ["LICENSE", "NOTICE"]
+requires-python = ">=3.10,<4.0"
+dependencies = [
+    "httpx>=0.15.4,<1.0",
+    "pydantic>=2,<3",
+    "backoff>=1.10.0",
+    "wrapt>=1.14,<3",
+    "packaging>=23.2,<27.0",
+    "opentelemetry-api>=1.33.1,<2",
+    "opentelemetry-sdk>=1.33.1,<2",
+    "opentelemetry-exporter-otlp-proto-http>=1.33.1,<2",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=7.4,<9.0",
+    "pytest-timeout>=2.1.0,<3",
+    "pytest-xdist>=3.3.1,<4",
+    "pre-commit>=3.2.2,<4",
+    "pytest-asyncio>=0.21.1,<1.2.0",
+    "pytest-httpserver>=1.0.8,<2",
+    "ruff>=0.15.2,<0.16",
+    "mypy>=1.0.0,<2",
+    "openai>=0.27.8",
+    "langchain-openai>=0.0.5,<0.4",
+    "langchain>=1,<2",
+    "langgraph>=1,<2",
+    "autoevals>=0.0.130,<0.1",
+    "opentelemetry-instrumentation-threading>=0.59b0,<1",
+    "tenacity>=9.1.4",
+]
+docs = [
+    "pdoc>=15.0.4,<16",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv]
+# Basic protection against supply chain attacks
+exclude-newer = "7 days"
+
+[tool.uv.build-backend]
+module-root = ""
+# Import package is always `smartspend`, independent of the distribution name
+# (allows test-named uploads like bpmlinks-smartspend-test).
+module-name = "bpmlinks_smartspend_test"
+
+[tool.pytest.ini_options]
+log_cli = true
+markers = [
+    "unit: deterministic tests that run without a SmartSpend server",
+    "e2e: tests that require a real SmartSpend server or persisted backend behaviour",
+    "serial_e2e: e2e tests that must not share server concurrency with the rest of the suite",
+    "live_provider: tests that call live model providers and run as a dedicated CI suite",
+]
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = false
+warn_no_return = true
+warn_unreachable = true
+strict_equality = true
+show_error_codes = true
+
+# Performance optimizations for CI
+cache_dir = ".mypy_cache"
+sqlite_cache = true
+incremental = true
+show_column_numbers = true
+
+[[tool.mypy.overrides]]
+module = [
+    "langchain.*",
+    "openai.*",
+    "chromadb.*",
+    "tiktoken.*",
+    "google.*",
+    "anthropic.*",
+    "cohere.*",
+    "dashscope.*",
+    "pymongo.*",
+    "bson.*",
+    "boto3.*",
+    "llama_index.*",
+    "respx.*",
+    "bs4.*",
+    "lark.*",
+    "huggingface_hub.*",
+    "backoff.*",
+    "wrapt.*",
+    "packaging.*",
+    "requests.*",
+    "opentelemetry.*"
+]
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = "smartspend.api.*"
+disable_error_code = ["redundant-cast", "no-untyped-def"]
+
+[tool.ruff]
+target-version = "py310"
+
+[tool.ruff.lint]
+extend-select = [
+    "I", # Import formatting
+    # These used to be enabled in the "local ruff.toml",
+    # which was never enforced; hence, enabling these will
+    # cause a large number of linting errors.
+
+    # "D", # Docstring lints
+    # "D401", # Enforce imperative mood in docstrings
+]
+exclude = ["smartspend/api/**/*.py"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.hatch.build.targets.wheel]
+packages = ["smartspend"]
+
+[tool.hatch.build.targets.sdist]
+include = ["smartspend", "LICENSE", "NOTICE", "README.md"]

bpmlinks_smartspend_test-0.1.0/smartspend/__init__.py

@@ -0,0 +1,144 @@
+"""SmartSpend Python SDK — observability, evaluation, and prompt management for LLM applications.
+
+Capabilities:
+
+- **Tracing / observability**: `@observe` decorator, `SmartSpend.start_observation` /
+  `start_as_current_observation` context managers, OpenTelemetry-based; integrations
+  for OpenAI (`smartspend.openai`) and LangChain (`smartspend.langchain.CallbackHandler`).
+- **Trace attributes**: `propagate_attributes` (top-level function) sets user_id,
+  session_id, tags, and metadata on all spans in a context.
+- **Datasets & experiments**: `SmartSpend.get_dataset`, `SmartSpend.run_experiment` for
+  offline evaluation and regression testing of prompt/model changes (CI support via
+  https://github.com/smartspend/experiment-action and `RegressionError`).
+- **Evaluation / LLM-as-a-judge**: `Evaluation` results from custom or model-based
+  evaluators; scores via `SmartSpend.create_score` / `span.score`.
+- **Prompt management**: `SmartSpend.get_prompt`, `SmartSpend.create_prompt` with
+  client-side caching and version/label control.
+- **Full REST API**: `SmartSpend.api` (sync) / `SmartSpend.async_api` (async) clients.
+
+Quickstart:
+
+```python
+# env: SMARTSPEND_PUBLIC_KEY, SMARTSPEND_SECRET_KEY, SMARTSPEND_BASE_URL
+from smartspend import get_client
+
+smartspend = get_client()
+
+# Create a span using a context manager
+with smartspend.start_as_current_observation(as_type="span", name="process-request") as span:
+    # Your processing logic here
+    span.update(output="Processing complete")
+
+    # Create a nested generation for an LLM call
+    with smartspend.start_as_current_observation(as_type="generation", name="llm-response", model="gpt-3.5-turbo") as generation:
+        # Your LLM call logic here
+        generation.update(output="Generated response")
+
+# All spans are automatically closed when exiting their context blocks
+
+# Flush events in short-lived applications
+smartspend.flush()
+```
+
+Configuration is via constructor args or environment variables: `SMARTSPEND_PUBLIC_KEY`,
+`SMARTSPEND_SECRET_KEY`, `SMARTSPEND_BASE_URL` (defaults to https://cloud.smartspend.com). See `smartspend._client.environment_variables`
+for the full list.
+
+Docs: https://smartspend.com/docs — machine-readable index: https://smartspend.com/llms.txt
+
+.. include:: ../README.md
+"""
+
+from smartspend.batch_evaluation import (
+    BatchEvaluationResult,
+    BatchEvaluationResumeToken,
+    CompositeEvaluatorFunction,
+    EvaluatorInputs,
+    EvaluatorStats,
+    MapperFunction,
+)
+from smartspend.experiment import Evaluation, RegressionError, RunnerContext
+
+from ._client import client as _client_module
+from ._client.attributes import SmartSpendOtelSpanAttributes
+from ._client.constants import ObservationTypeLiteral
+from ._client.get_client import get_client
+from ._client.observe import observe
+from ._client.privacy import PrivacyMode
+from ._client.propagation import propagate_attributes
+from ._client.span import (
+    SmartSpendAgent,
+    SmartSpendChain,
+    SmartSpendEmbedding,
+    SmartSpendEvaluator,
+    SmartSpendEvent,
+    SmartSpendGeneration,
+    SmartSpendGuardrail,
+    SmartSpendRetriever,
+    SmartSpendSpan,
+    SmartSpendTool,
+)
+from ._version import __version__
+from .media import SmartSpendMedia, SmartSpendMediaReference
+from .span_filter import (
+    KNOWN_LLM_INSTRUMENTATION_SCOPE_PREFIXES,
+    is_default_export_span,
+    is_genai_span,
+    is_known_llm_instrumentor,
+    is_smartspend_span,
+)
+from .types import (
+    MaskOtelSpansFunction,
+    MaskOtelSpansParams,
+    MaskOtelSpansResult,
+    OtelSpanData,
+    OtelSpanIdentifier,
+    OtelSpanPatch,
+)
+
+SmartSpend = _client_module.SmartSpend
+
+__all__ = [
+    "SmartSpend",
+    "SmartSpendMedia",
+    "SmartSpendMediaReference",
+    "get_client",
+    "observe",
+    "propagate_attributes",
+    "PrivacyMode",
+    "ObservationTypeLiteral",
+    "SmartSpendSpan",
+    "SmartSpendGeneration",
+    "SmartSpendEvent",
+    "SmartSpendOtelSpanAttributes",
+    "SmartSpendAgent",
+    "SmartSpendTool",
+    "SmartSpendChain",
+    "SmartSpendEmbedding",
+    "SmartSpendEvaluator",
+    "SmartSpendRetriever",
+    "SmartSpendGuardrail",
+    "Evaluation",
+    "EvaluatorInputs",
+    "MapperFunction",
+    "CompositeEvaluatorFunction",
+    "EvaluatorStats",
+    "BatchEvaluationResumeToken",
+    "BatchEvaluationResult",
+    "RunnerContext",
+    "RegressionError",
+    "__version__",
+    "is_default_export_span",
+    "is_smartspend_span",
+    "is_genai_span",
+    "is_known_llm_instrumentor",
+    "KNOWN_LLM_INSTRUMENTATION_SCOPE_PREFIXES",
+    "MaskOtelSpansFunction",
+    "MaskOtelSpansParams",
+    "MaskOtelSpansResult",
+    "OtelSpanData",
+    "OtelSpanIdentifier",
+    "OtelSpanPatch",
+    "experiment",
+    "api",
+]