reskpoints 0.1.0__tar.gz

reskpoints-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+*.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.DS_Store

reskpoints-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 RESK Security
+
+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.

reskpoints-0.1.0/PKG-INFO

@@ -0,0 +1,259 @@
+Metadata-Version: 2.4
+Name: reskpoints
+Version: 0.1.0
+Summary: Agent Action Logging Platform — log all AI/LLM agent actions to any platform
+Project-URL: Homepage, https://github.com/Resk-Security/ReskPoints
+Project-URL: Repository, https://github.com/Resk-Security/ReskPoints
+Author: RESK Security
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,llm,logging,monitoring,observability
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: resklogits>=0.2.0
+Provides-Extra: all
+Requires-Dist: datadog-api-client>=2.0; extra == 'all'
+Requires-Dist: opentelemetry-api>=1.20; extra == 'all'
+Requires-Dist: opentelemetry-sdk>=1.20; extra == 'all'
+Requires-Dist: prometheus-client>=0.19; extra == 'all'
+Provides-Extra: datadog
+Requires-Dist: datadog-api-client>=2.0; extra == 'datadog'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Provides-Extra: opentelemetry
+Requires-Dist: opentelemetry-api>=1.20; extra == 'opentelemetry'
+Requires-Dist: opentelemetry-sdk>=1.20; extra == 'opentelemetry'
+Provides-Extra: prometheus
+Requires-Dist: prometheus-client>=0.19; extra == 'prometheus'
+Provides-Extra: slack
+Requires-Dist: httpx>=0.27.0; extra == 'slack'
+Provides-Extra: webhook
+Description-Content-Type: text/markdown
+
+# ReskPoints
+
+> **The AI Agent Logger** — track every action your agents take, with probability, parameters, and results. Ship to any platform.
+
+[![PyPI version](https://img.shields.io/pypi/v/reskpoints.svg)](https://pypi.org/project/reskpoints/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/reskpoints.svg)](https://pypi.org/project/reskpoints/)
+[![License](https://img.shields.io/pypi/l/reskpoints.svg)](https://github.com/Resk-Security/ReskPoints/blob/main/LICENSE)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+
+---
+
+You have **AI agents** making decisions — calling tools, executing code, sending messages, searching databases.  
+**ReskPoints** captures every action: *what* the agent did, *how confident* it was, *what parameters* it used, and *what happened*.  
+
+Pipe it to **Datadog, Prometheus, OpenTelemetry, webhooks, JSON files, or your console** — all from a single logger.
+
+---
+
+## One line, full trace
+
+```python
+from reskpoints import AgentLogger
+
+logger = AgentLogger()
+
+logger.log("agent-1", "tool_call", 0.95, {"tool": "search", "query": "RAG papers"}, "3 results")
+```
+
+Async? Same API:
+
+```python
+await logger.alog("agent-1", "tool_call", 0.95, {"tool": "search"}, "3 results")
+```
+
+Decorator? Wrap any function:
+
+```python
+@log_action(agent_id="coder")
+def execute_python(code: str) -> str:
+    ...
+```
+
+---
+
+## Why ReskPoints?
+
+| Problem | ReskPoints |
+|---------|------------|
+| **"I don't know what my agent is doing"** | Every tool call, API request, and decision is logged with full context |
+| **"It's too slow to add logging"** | One decorator, one line of code. Done. |
+| **"My logs go everywhere and nowhere"** | Ship to Console, File, Webhook, Datadog, Prometheus, OpenTelemetry — or all at once |
+| **"Sensitive data leaks in params"** | Auto-mask api_key, token, password, and custom fields before they leave your app |
+| **"I log too much / too little"** | Probabilistic sampling per action pattern (`heartbeat: 1%`, `tool_*: 100%`) |
+| **"One platform going down kills my logs"** | Retry + backoff + circuit breaker + in-memory buffering |
+
+---
+
+## Install
+
+```bash
+pip install reskpoints
+pip install reskpoints[datadog,prometheus,opentelemetry]  # with extras
+```
+
+---
+
+## Features
+
+- **AgentLogger** — sync `log()` and async `alog()` with auto-enrichment (timestamp, host, env, UUID)
+- **Decorator** — `@log_action` logs every call automatically with params + result + duration
+- **Sampling** — per-action probabilistic rate (`tool_call: 100%`, `heartbeat: 1%`)
+- **Masking** — automatic redaction of sensitive fields (`api_key`, `token`, `password`, regex patterns)
+- **7 platforms** — Console, File (JSONL), Webhook (HMAC-signed), Datadog, Prometheus, OpenTelemetry, Mock
+- **Reliability** — exponential backoff retry, circuit breaker, buffering, batching
+- **CLI** — `reskpoints log`, `test`, `status`, `tail`, `replay`
+- **Config** — YAML-driven with `${ENV_VAR:default}` interpolation
+
+---
+
+## Platforms
+
+| Platform | Extra | Use case |
+|----------|-------|----------|
+| Console | *built-in* | Dev/debug |
+| File (JSONL) | *built-in* | Local storage, replay |
+| Webhook | *built-in* | Custom endpoints, Zapier, N8n |
+| Datadog | `[datadog]` | Datadog Logs + Metrics |
+| Prometheus | `[prometheus]` | Pushgateway metrics |
+| OpenTelemetry | `[opentelemetry]` | OTLP spans → any backend |
+| Mock | *built-in* | Testing |
+
+---
+
+## Architecture
+
+```
+Agent code                         ReskPoints                     Your observability stack
+─────────────────────────────────────────────────────────────────────────────────────
+
+@log_action                          ┌─────────────┐                ┌──────────┐
+def search(q):         ───────────▶  │  Sampler    │                │  Console │
+  ...                                │  (rate per  │                ├──────────┤
+                                     │   action)   │                │  File    │
+logger.log(                          └──────┬──────┘                ├──────────┤
+  agent_id="agent-1",                       │                       │  Webhook │
+  action="tool_call",              ┌────────▼───────┐               ├──────────┤
+  probability=0.95,                │   FieldMasker  │               │  Datadog │
+  params={...},                    │  (auto-redact  │               ├──────────┤
+  result="ok",                     │   secrets)     │               │Prometheus│
+)                                  └────────┬───────┘               ├──────────┤
+                                           │                       │  OTel    │
+                                   ┌───────▼────────┐              └──────────┘
+                                   │   MultiPlatform │
+                                   │  ┌──────────┐  │
+                                   │  │  retry   │  │
+                                   │  │  circuit │  │
+                                   │  │  buffer  │  │
+                                   │  └──────────┘  │
+                                   └────────────────┘
+```
+
+Each platform is wrapped with retry (exp backoff), circuit breaker (5 fails → 30s recovery), and buffering (1000 entries).
+
+---
+
+## Quick tour
+
+```python
+# Minimal
+logger.log("agent-1", "search", 0.95, {"q": "papers"}, "3 results")
+
+# Full
+logger.log(
+    agent_id="agent-1",
+    action="tool_call",
+    probability=0.95,
+    params={"tool": "search", "query": "RAG papers 2025"},
+    result=["paper1", "paper2"],
+    success=True,
+    duration_ms=1240.5,
+    session_id="sess_abc123",
+    correlation_id="req_xyz789",
+)
+
+# Async
+results = await logger.alog("agent-1", "search", 0.95, {"q": "papers"}, "3 results")
+
+# Decorator
+@log_action(agent_id="coder")
+def execute_python(code: str) -> str: ...
+
+# Check health
+logger.health()
+# → {"console": {"status": "ok"}, "datadog": {"status": "degraded", "error": ...}}
+```
+
+---
+
+## CLI
+
+```bash
+reskpoints log --agent-id agent-1 --action tool_call --params '{"tool":"search"}'
+reskpoints test                    # Test all platforms
+reskpoints status                  # Platform health
+reskpoints tail                    # Live log stream
+reskpoints replay logs.jsonl       # Replay from file
+```
+
+---
+
+## Config (`reskpoints.yaml`)
+
+```yaml
+agent_logger:
+  sampling:
+    default_rate: 1.0
+    rules:
+      - action: "heartbeat"   rate: 0.01
+      - action: "tool_*"      rate: 1.0
+  masking:
+    enabled: true
+    sensitive_fields: [api_key, token, secret, password]
+  platforms:
+    console:
+      enabled: true
+      format: "human"
+    webhook:
+      enabled: false
+      url: "${WEBHOOK_URL}"
+      signing_secret: "${WEBHOOK_SECRET}"
+    datadog:
+      enabled: false
+      api_key: "${DD_API_KEY}"
+      site: "datadoghq.eu"
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/Resk-Security/ReskPoints.git
+cd ReskPoints
+pip install -e ".[all,dev]"
+pytest tests/ -v     # 26 tests
+ruff check src/      # clean
+mypy src/            # passes
+```
+
+---
+
+## License
+
+MIT. Built with [resklogits](https://github.com/Resk-Security/resk-logits).

reskpoints-0.1.0/README.md

@@ -0,0 +1,214 @@
+# ReskPoints
+
+> **The AI Agent Logger** — track every action your agents take, with probability, parameters, and results. Ship to any platform.
+
+[![PyPI version](https://img.shields.io/pypi/v/reskpoints.svg)](https://pypi.org/project/reskpoints/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/reskpoints.svg)](https://pypi.org/project/reskpoints/)
+[![License](https://img.shields.io/pypi/l/reskpoints.svg)](https://github.com/Resk-Security/ReskPoints/blob/main/LICENSE)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+
+---
+
+You have **AI agents** making decisions — calling tools, executing code, sending messages, searching databases.  
+**ReskPoints** captures every action: *what* the agent did, *how confident* it was, *what parameters* it used, and *what happened*.  
+
+Pipe it to **Datadog, Prometheus, OpenTelemetry, webhooks, JSON files, or your console** — all from a single logger.
+
+---
+
+## One line, full trace
+
+```python
+from reskpoints import AgentLogger
+
+logger = AgentLogger()
+
+logger.log("agent-1", "tool_call", 0.95, {"tool": "search", "query": "RAG papers"}, "3 results")
+```
+
+Async? Same API:
+
+```python
+await logger.alog("agent-1", "tool_call", 0.95, {"tool": "search"}, "3 results")
+```
+
+Decorator? Wrap any function:
+
+```python
+@log_action(agent_id="coder")
+def execute_python(code: str) -> str:
+    ...
+```
+
+---
+
+## Why ReskPoints?
+
+| Problem | ReskPoints |
+|---------|------------|
+| **"I don't know what my agent is doing"** | Every tool call, API request, and decision is logged with full context |
+| **"It's too slow to add logging"** | One decorator, one line of code. Done. |
+| **"My logs go everywhere and nowhere"** | Ship to Console, File, Webhook, Datadog, Prometheus, OpenTelemetry — or all at once |
+| **"Sensitive data leaks in params"** | Auto-mask api_key, token, password, and custom fields before they leave your app |
+| **"I log too much / too little"** | Probabilistic sampling per action pattern (`heartbeat: 1%`, `tool_*: 100%`) |
+| **"One platform going down kills my logs"** | Retry + backoff + circuit breaker + in-memory buffering |
+
+---
+
+## Install
+
+```bash
+pip install reskpoints
+pip install reskpoints[datadog,prometheus,opentelemetry]  # with extras
+```
+
+---
+
+## Features
+
+- **AgentLogger** — sync `log()` and async `alog()` with auto-enrichment (timestamp, host, env, UUID)
+- **Decorator** — `@log_action` logs every call automatically with params + result + duration
+- **Sampling** — per-action probabilistic rate (`tool_call: 100%`, `heartbeat: 1%`)
+- **Masking** — automatic redaction of sensitive fields (`api_key`, `token`, `password`, regex patterns)
+- **7 platforms** — Console, File (JSONL), Webhook (HMAC-signed), Datadog, Prometheus, OpenTelemetry, Mock
+- **Reliability** — exponential backoff retry, circuit breaker, buffering, batching
+- **CLI** — `reskpoints log`, `test`, `status`, `tail`, `replay`
+- **Config** — YAML-driven with `${ENV_VAR:default}` interpolation
+
+---
+
+## Platforms
+
+| Platform | Extra | Use case |
+|----------|-------|----------|
+| Console | *built-in* | Dev/debug |
+| File (JSONL) | *built-in* | Local storage, replay |
+| Webhook | *built-in* | Custom endpoints, Zapier, N8n |
+| Datadog | `[datadog]` | Datadog Logs + Metrics |
+| Prometheus | `[prometheus]` | Pushgateway metrics |
+| OpenTelemetry | `[opentelemetry]` | OTLP spans → any backend |
+| Mock | *built-in* | Testing |
+
+---
+
+## Architecture
+
+```
+Agent code                         ReskPoints                     Your observability stack
+─────────────────────────────────────────────────────────────────────────────────────
+
+@log_action                          ┌─────────────┐                ┌──────────┐
+def search(q):         ───────────▶  │  Sampler    │                │  Console │
+  ...                                │  (rate per  │                ├──────────┤
+                                     │   action)   │                │  File    │
+logger.log(                          └──────┬──────┘                ├──────────┤
+  agent_id="agent-1",                       │                       │  Webhook │
+  action="tool_call",              ┌────────▼───────┐               ├──────────┤
+  probability=0.95,                │   FieldMasker  │               │  Datadog │
+  params={...},                    │  (auto-redact  │               ├──────────┤
+  result="ok",                     │   secrets)     │               │Prometheus│
+)                                  └────────┬───────┘               ├──────────┤
+                                           │                       │  OTel    │
+                                   ┌───────▼────────┐              └──────────┘
+                                   │   MultiPlatform │
+                                   │  ┌──────────┐  │
+                                   │  │  retry   │  │
+                                   │  │  circuit │  │
+                                   │  │  buffer  │  │
+                                   │  └──────────┘  │
+                                   └────────────────┘
+```
+
+Each platform is wrapped with retry (exp backoff), circuit breaker (5 fails → 30s recovery), and buffering (1000 entries).
+
+---
+
+## Quick tour
+
+```python
+# Minimal
+logger.log("agent-1", "search", 0.95, {"q": "papers"}, "3 results")
+
+# Full
+logger.log(
+    agent_id="agent-1",
+    action="tool_call",
+    probability=0.95,
+    params={"tool": "search", "query": "RAG papers 2025"},
+    result=["paper1", "paper2"],
+    success=True,
+    duration_ms=1240.5,
+    session_id="sess_abc123",
+    correlation_id="req_xyz789",
+)
+
+# Async
+results = await logger.alog("agent-1", "search", 0.95, {"q": "papers"}, "3 results")
+
+# Decorator
+@log_action(agent_id="coder")
+def execute_python(code: str) -> str: ...
+
+# Check health
+logger.health()
+# → {"console": {"status": "ok"}, "datadog": {"status": "degraded", "error": ...}}
+```
+
+---
+
+## CLI
+
+```bash
+reskpoints log --agent-id agent-1 --action tool_call --params '{"tool":"search"}'
+reskpoints test                    # Test all platforms
+reskpoints status                  # Platform health
+reskpoints tail                    # Live log stream
+reskpoints replay logs.jsonl       # Replay from file
+```
+
+---
+
+## Config (`reskpoints.yaml`)
+
+```yaml
+agent_logger:
+  sampling:
+    default_rate: 1.0
+    rules:
+      - action: "heartbeat"   rate: 0.01
+      - action: "tool_*"      rate: 1.0
+  masking:
+    enabled: true
+    sensitive_fields: [api_key, token, secret, password]
+  platforms:
+    console:
+      enabled: true
+      format: "human"
+    webhook:
+      enabled: false
+      url: "${WEBHOOK_URL}"
+      signing_secret: "${WEBHOOK_SECRET}"
+    datadog:
+      enabled: false
+      api_key: "${DD_API_KEY}"
+      site: "datadoghq.eu"
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/Resk-Security/ReskPoints.git
+cd ReskPoints
+pip install -e ".[all,dev]"
+pytest tests/ -v     # 26 tests
+ruff check src/      # clean
+mypy src/            # passes
+```
+
+---
+
+## License
+
+MIT. Built with [resklogits](https://github.com/Resk-Security/resk-logits).

reskpoints-0.1.0/pyproject.toml

@@ -0,0 +1,85 @@
+[project]
+name = "reskpoints"
+version = "0.1.0"
+description = "Agent Action Logging Platform — log all AI/LLM agent actions to any platform"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{name = "RESK Security"}]
+keywords = ["agent", "llm", "ai", "logging", "monitoring", "observability"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Monitoring",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+dependencies = [
+    "resklogits>=0.2.0",
+    "pyyaml>=6.0",
+    "httpx>=0.27.0",
+    "pydantic>=2.0.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.optional-dependencies]
+all = ["reskpoints[webhook,datadog,prometheus,opentelemetry]"]
+webhook = []
+datadog = ["datadog-api-client>=2.0"]
+prometheus = ["prometheus-client>=0.19"]
+opentelemetry = ["opentelemetry-api>=1.20", "opentelemetry-sdk>=1.20"]
+slack = ["httpx>=0.27.0"]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.23",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+    "types-PyYAML>=6.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Resk-Security/ReskPoints"
+Repository = "https://github.com/Resk-Security/ReskPoints"
+
+[project.scripts]
+reskpoints = "reskpoints.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/reskpoints"]
+include = [
+    "/src/reskpoints/**/*.py",
+    "/src/reskpoints/py.typed",
+    "reskpoints.yaml",
+]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+    "/LICENSE",
+    "/pyproject.toml",
+    "/reskpoints.yaml",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "B", "C4"]
+ignore = ["E501", "B008"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+disallow_untyped_defs = false

reskpoints-0.1.0/reskpoints.yaml

@@ -0,0 +1,67 @@
+agent_logger:
+  environment: "${ENV:development}"
+
+  masking:
+    enabled: true
+    sensitive_fields:
+      - api_key
+      - password
+      - token
+      - secret
+      - authorization
+      - auth_token
+      - access_token
+      - refresh_token
+      - private_key
+      - session_id
+
+  sampling:
+    default_rate: 1.0
+    rules:
+      - action: "heartbeat"
+        rate: 0.01
+      - action: "status_check"
+        rate: 0.05
+      - action: "tool_*"
+        rate: 1.0
+      - action: "message_*"
+        rate: 0.5
+
+  buffering:
+    max_size: 1000
+    flush_interval: 5.0
+
+  retry:
+    max_attempts: 3
+    backoff: [0.5, 1.5, 4.5]
+    circuit_breaker:
+      threshold: 5
+      recovery_time: 30
+
+  platforms:
+    console:
+      enabled: true
+      format: "human"
+
+    webhook:
+      enabled: false
+      url: "${WEBHOOK_URL}"
+      signing_secret: "${WEBHOOK_SECRET}"
+      timeout: 10.0
+
+    file:
+      enabled: false
+      path: "/var/log/agent_actions.jsonl"
+
+    datadog:
+      enabled: false
+      api_key: "${DD_API_KEY}"
+      site: "datadoghq.eu"
+      tags:
+        team: "resk"
+        project: "reskpoints"
+
+    prometheus:
+      enabled: false
+      pushgateway_url: "http://localhost:9091"
+      job_name: "agent_actions"

reskpoints-0.1.0/src/reskpoints/__init__.py

@@ -0,0 +1,29 @@
+from .agent_logger import AgentLogger
+from .config import AgentLoggerConfig
+from .decorator import log_action
+from .masking import FieldMasker
+from .models import ActionLog, LogResult
+from .platforms import (
+    BasePlatform,
+    ConsolePlatform,
+    FilePlatform,
+    MockPlatform,
+    WebhookPlatform,
+)
+
+__version__ = "0.1.0"
+__author__ = "RESK Security"
+
+__all__ = [
+    "AgentLogger",
+    "AgentLoggerConfig",
+    "log_action",
+    "FieldMasker",
+    "ActionLog",
+    "LogResult",
+    "BasePlatform",
+    "ConsolePlatform",
+    "FilePlatform",
+    "MockPlatform",
+    "WebhookPlatform",
+]