weflayr 0.1.0__tar.gz

weflayr-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+*.pyc
+src/sdk/docs/
+.coverage
+secrets.*.tfvars
+launch.json

weflayr-0.1.0/LICENSE

@@ -0,0 +1,91 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+**control** means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

weflayr-0.1.0/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: weflayr
+Version: 0.1.0
+Summary: Drop-in instrumented wrappers for AI clients with zero-overhead telemetry
+Project-URL: Homepage, https://weflayr.com
+Project-URL: Documentation, https://weflayr.com/docs
+Project-URL: Repository, https://github.com/weflayr/weflayr
+Project-URL: Bug Tracker, https://github.com/weflayr/weflayr/issues
+Author-email: Weflayr <contact@weflayr.com>
+License: Elastic-2.0
+License-File: LICENSE
+Keywords: ai,instrumentation,llm,mistral,observability,openai,telemetry,tracing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mistralai>=2.0.5
+Requires-Dist: openai>=2.29.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: pdoc; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# Weflayr SDK
+
+Drop-in instrumented wrappers for OpenAI and Mistral AI clients. Add telemetry to your LLM calls in one line - no changes to your existing code structure required.
+
+## How it works
+
+Weflayr wraps the official provider SDKs and automatically fires telemetry events to your Weflayr intake API before, after, and on error for every LLM call. Your application code stays identical.
+
+```
+your code  →  weflayr.sdk.openai.OpenAI  →  openai.OpenAI  →  OpenAI API
+                       ↓
+              Weflayr Intake API
+              (before / after / error events)
+```
+
+## Installation
+
+```bash
+pip install weflayr
+```
+
+## Quickstart
+
+### Configuration
+
+Set the following environment variables:
+
+| Variable | Description | Default |
+|---|---|---|
+| `WEFLAYR_INTAKE_URL` | Your Weflayr intake API base URL | `https://api.weflayr.com` |
+| `WEFLAYR_CLIENT_ID` | Your client identifier | `unknown_client` |
+| `WEFLAYR_CLIENT_SECRET` | Your bearer token | _(empty)_ |
+
+```bash
+export WEFLAYR_INTAKE_URL="https://api.weflayr.com"
+export WEFLAYR_CLIENT_ID="my-app"
+export WEFLAYR_CLIENT_SECRET="your-secret-token"
+```
+
+---
+
+## OpenAI
+
+Drop-in replacement for `openai.OpenAI` and `openai.AsyncOpenAI`.
+
+### Sync
+
+```python
+from weflayr.sdk.openai.client import OpenAI
+
+client = OpenAI(api_key="sk-...")
+
+response = client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+
+print(response.choices[0].message.content)
+```
+
+### Async
+
+```python
+import asyncio
+from weflayr.sdk.openai.client import AsyncOpenAI
+
+client = AsyncOpenAI(api_key="sk-...")
+
+async def main():
+    response = await client.chat.completions.create(
+        model="gpt-4o-mini",
+        messages=[{"role": "user", "content": "Hello!"}],
+    )
+    print(response.choices[0].message.content)
+
+asyncio.run(main())
+```
+
+### Tagging calls
+
+Pass a `tags` dict to attach arbitrary metadata to your telemetry events:
+
+```python
+response = client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{"role": "user", "content": "Summarize this."}],
+    tags={"feature": "summarization", "user_id": "u_123"},
+)
+```
+
+---
+
+## Mistral AI
+
+Drop-in replacement for `mistralai.client.Mistral`.
+
+### Sync
+
+```python
+from weflayr.sdk.mistralai.client import Mistral
+
+client = Mistral(api_key="sk-...")
+
+response = client.chat.complete(
+    model="mistral-small-latest",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+
+print(response.choices[0].message.content)
+```
+
+### Async
+
+```python
+import asyncio
+from weflayr.sdk.mistralai.client import Mistral
+
+client = Mistral(api_key="sk-...")
+
+async def main():
+    response = await client.chat.complete_async(
+        model="mistral-small-latest",
+        messages=[{"role": "user", "content": "Hello!"}],
+    )
+    print(response.choices[0].message.content)
+
+asyncio.run(main())
+```
+
+### Tagging calls
+
+```python
+response = client.chat.complete(
+    model="mistral-small-latest",
+    messages=[{"role": "user", "content": "Translate this."}],
+    tags={"feature": "translation", "env": "production"},
+)
+```
+
+---
+
+## Telemetry events
+
+For every LLM call, Weflayr sends up to three events to your intake API:
+
+| Event | When | Payload includes |
+|---|---|---|
+| `<call>.before` | Before the provider call | `model`, `message_count`, `tags` |
+| `<call>.after` | On success | `model`, `elapsed_ms`, `prompt_tokens`, `completion_tokens` |
+| `<call>.error` | On failure | `model`, `elapsed_ms`, `error_type`, `error_message`, `status_code` |
+
+Events are sent **fire-and-forget** in background threads — they never block your application or raise exceptions.
+
+---
+
+## Advanced: per-client configuration
+
+Override the intake URL, client ID, and bearer token directly on the client instead of using environment variables:
+
+```python
+from weflayr.sdk.openai.client import OpenAI
+
+client = OpenAI(
+    api_key="sk-...",
+    intake_url="https://intake.weflayr.com",
+    client_id="my-service",
+    bearer_token="my-secret",
+)
+```
+
+---
+
+## License
+
+[Elastic License 2.0](LICENSE) — free to use, modifications and redistribution not permitted.

weflayr-0.1.0/README.md

@@ -0,0 +1,175 @@
+# Weflayr SDK
+
+Drop-in instrumented wrappers for OpenAI and Mistral AI clients. Add telemetry to your LLM calls in one line - no changes to your existing code structure required.
+
+## How it works
+
+Weflayr wraps the official provider SDKs and automatically fires telemetry events to your Weflayr intake API before, after, and on error for every LLM call. Your application code stays identical.
+
+```
+your code  →  weflayr.sdk.openai.OpenAI  →  openai.OpenAI  →  OpenAI API
+                       ↓
+              Weflayr Intake API
+              (before / after / error events)
+```
+
+## Installation
+
+```bash
+pip install weflayr
+```
+
+## Quickstart
+
+### Configuration
+
+Set the following environment variables:
+
+| Variable | Description | Default |
+|---|---|---|
+| `WEFLAYR_INTAKE_URL` | Your Weflayr intake API base URL | `https://api.weflayr.com` |
+| `WEFLAYR_CLIENT_ID` | Your client identifier | `unknown_client` |
+| `WEFLAYR_CLIENT_SECRET` | Your bearer token | _(empty)_ |
+
+```bash
+export WEFLAYR_INTAKE_URL="https://api.weflayr.com"
+export WEFLAYR_CLIENT_ID="my-app"
+export WEFLAYR_CLIENT_SECRET="your-secret-token"
+```
+
+---
+
+## OpenAI
+
+Drop-in replacement for `openai.OpenAI` and `openai.AsyncOpenAI`.
+
+### Sync
+
+```python
+from weflayr.sdk.openai.client import OpenAI
+
+client = OpenAI(api_key="sk-...")
+
+response = client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+
+print(response.choices[0].message.content)
+```
+
+### Async
+
+```python
+import asyncio
+from weflayr.sdk.openai.client import AsyncOpenAI
+
+client = AsyncOpenAI(api_key="sk-...")
+
+async def main():
+    response = await client.chat.completions.create(
+        model="gpt-4o-mini",
+        messages=[{"role": "user", "content": "Hello!"}],
+    )
+    print(response.choices[0].message.content)
+
+asyncio.run(main())
+```
+
+### Tagging calls
+
+Pass a `tags` dict to attach arbitrary metadata to your telemetry events:
+
+```python
+response = client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{"role": "user", "content": "Summarize this."}],
+    tags={"feature": "summarization", "user_id": "u_123"},
+)
+```
+
+---
+
+## Mistral AI
+
+Drop-in replacement for `mistralai.client.Mistral`.
+
+### Sync
+
+```python
+from weflayr.sdk.mistralai.client import Mistral
+
+client = Mistral(api_key="sk-...")
+
+response = client.chat.complete(
+    model="mistral-small-latest",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+
+print(response.choices[0].message.content)
+```
+
+### Async
+
+```python
+import asyncio
+from weflayr.sdk.mistralai.client import Mistral
+
+client = Mistral(api_key="sk-...")
+
+async def main():
+    response = await client.chat.complete_async(
+        model="mistral-small-latest",
+        messages=[{"role": "user", "content": "Hello!"}],
+    )
+    print(response.choices[0].message.content)
+
+asyncio.run(main())
+```
+
+### Tagging calls
+
+```python
+response = client.chat.complete(
+    model="mistral-small-latest",
+    messages=[{"role": "user", "content": "Translate this."}],
+    tags={"feature": "translation", "env": "production"},
+)
+```
+
+---
+
+## Telemetry events
+
+For every LLM call, Weflayr sends up to three events to your intake API:
+
+| Event | When | Payload includes |
+|---|---|---|
+| `<call>.before` | Before the provider call | `model`, `message_count`, `tags` |
+| `<call>.after` | On success | `model`, `elapsed_ms`, `prompt_tokens`, `completion_tokens` |
+| `<call>.error` | On failure | `model`, `elapsed_ms`, `error_type`, `error_message`, `status_code` |
+
+Events are sent **fire-and-forget** in background threads — they never block your application or raise exceptions.
+
+---
+
+## Advanced: per-client configuration
+
+Override the intake URL, client ID, and bearer token directly on the client instead of using environment variables:
+
+```python
+from weflayr.sdk.openai.client import OpenAI
+
+client = OpenAI(
+    api_key="sk-...",
+    intake_url="https://intake.weflayr.com",
+    client_id="my-service",
+    bearer_token="my-secret",
+)
+```
+
+---
+
+## License
+
+[Elastic License 2.0](LICENSE) — free to use, modifications and redistribution not permitted.

weflayr-0.1.0/coverage/.gitignore

@@ -0,0 +1,2 @@
+# Created by coverage.py
+*