abto 0.0.1__tar.gz

abto-0.0.1/.gitignore

@@ -0,0 +1,46 @@
+# Go
+/bin/
+*.exe
+*.test
+*.out
+# ad-hoc `go build ./cmd/<x>` 산출물(정규 빌드는 bin/). 경로 앵커라 cmd/smoke 소스 디렉토리는 건드리지 않는다.
+/apps/gateway/smoke
+/apps/gateway/gateway
+
+# macOS
+.DS_Store
+
+# Editor
+.idea/
+.vscode/
+
+# Agent-local worktrees and planning artifacts
+/.claude/
+/docs/superpowers/
+
+# Local release credentials (never commit)
+/.env.sdk-release
+
+# Prod 외부 시드 시크릿의 로컬 원본 (never commit)
+/infra/terraform/envs/prod/.env.secrets
+# Terraform 로컬 계획 산출물
+/infra/terraform/**/tfplan*
+
+# Node / TypeScript
+node_modules/
+dist/
+.astro/
+coverage/
+# per-package pnpm lock (workspace uses a single root lock if any)
+packages/*/pnpm-lock.yaml
+
+# Python
+__pycache__/
+*.pyc
+*.egg-info/
+.pytest_cache/
+build/
+.venv/
+
+# 로컬 전용 compose override (시드 DB 연결)
+docker-compose.override.yml

abto-0.0.1/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: abto
+Version: 0.0.1
+Summary: ABTO server-side SDK for Python — gateway baseURL + x-abto-* header injection via contextvars and httpx event hooks.
+Project-URL: Homepage, https://github.com/greedy-co/abto
+Project-URL: Issues, https://github.com/greedy-co/abto/issues
+License-Expression: MIT
+Keywords: abto,analytics,autocapture,llm,observability
+Requires-Python: >=3.9
+Provides-Extra: httpx
+Requires-Dist: httpx>=0.24; extra == 'httpx'
+Provides-Extra: openai
+Requires-Dist: httpx>=0.24; extra == 'openai'
+Requires-Dist: openai>=1.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# abto (Python)
+
+ABTO server-side SDK for Python. 얇은 gateway 헤더 helper로, `contextvars`로 `x-abto-*` 식별자를 운반하고 `httpx` event hook으로 outbound provider 호출에 주입한다. token·cost·latency·`request_id`·variant는 gateway가 소유한다.
+
+`@abto-app/sdk/server`(Node)의 Python 대응이다. npm과 PyPI는 다른 레지스트리라 언어별로 분리 배포한다.
+
+## Install
+
+```bash
+pip install abto                 # 코어(contextvars 헤더 helper)
+pip install "abto[openai]"       # openai + httpx 통합까지
+```
+
+## Quick Start
+
+```python
+from abto import create_abto
+
+abto = create_abto(
+    api_key="ABTO_API_KEY",
+    gateway_base_url="https://gateway.abto.ai/v1",
+)
+openai = abto.openai()  # base_url=gateway + 요청마다 x-abto-* 주입
+
+def generate(user_id: str, trace_id: str):
+    with abto.with_context(user_id=user_id, node_id="resume.make", trace_id=trace_id):
+        return openai.chat.completions.create(
+            model="gpt-4.1",
+            messages=[{"role": "user", "content": "Create a resume draft"}],
+        )
+```
+
+## httpx 직접 사용
+
+```python
+import httpx
+from abto import abto_request_hook, with_context
+
+client = httpx.Client(event_hooks={"request": [abto_request_hook()]})
+
+with with_context(user_id="u1", node_id="resume.make"):
+    client.post("https://gateway.abto.ai/v1/...")  # x-abto-* 자동 첨부
+```
+
+## Public API
+
+- `create_abto(api_key=None, gateway_base_url=None) -> Abto`
+- `abto.openai(**kwargs)` — gateway baseURL + 헤더 주입된 OpenAI client (extra: `openai`)
+- `abto.with_context(user_id=?, node_id=?, trace_id=?)` — 요청 단위 context (context manager)
+- `abto.get_headers(ctx=None)` / `abto.create_trace_id()` / `abto.httpx_event_hooks()`
+- 하위 helper: `with_context`, `get_context`, `set_context`, `get_headers`, `create_trace_id`, `create_traceparent`, `abto_request_hook`, `ABTO_HEADER`, `AbtoContext`
+
+## Header Contract
+
+```text
+x-abto-device-id     (required)
+x-abto-node-key     (required; "feature.node" dot notation, e.g. resume.make)
+traceparent        (trace_id; gateway-deferred in Round1)
+```
+
+Gateway는 API key를 `tenant_id`로 매핑하고 `request_id`(응답 `x-request-id`)를 발급하며 `variant_id`를 배정하고, provider 전달 전 `x-abto-*`를 strip한다.
+
+## Test
+
+```bash
+pip install pytest && pytest
+```

abto-0.0.1/README.md

@@ -0,0 +1,67 @@
+# abto (Python)
+
+ABTO server-side SDK for Python. 얇은 gateway 헤더 helper로, `contextvars`로 `x-abto-*` 식별자를 운반하고 `httpx` event hook으로 outbound provider 호출에 주입한다. token·cost·latency·`request_id`·variant는 gateway가 소유한다.
+
+`@abto-app/sdk/server`(Node)의 Python 대응이다. npm과 PyPI는 다른 레지스트리라 언어별로 분리 배포한다.
+
+## Install
+
+```bash
+pip install abto                 # 코어(contextvars 헤더 helper)
+pip install "abto[openai]"       # openai + httpx 통합까지
+```
+
+## Quick Start
+
+```python
+from abto import create_abto
+
+abto = create_abto(
+    api_key="ABTO_API_KEY",
+    gateway_base_url="https://gateway.abto.ai/v1",
+)
+openai = abto.openai()  # base_url=gateway + 요청마다 x-abto-* 주입
+
+def generate(user_id: str, trace_id: str):
+    with abto.with_context(user_id=user_id, node_id="resume.make", trace_id=trace_id):
+        return openai.chat.completions.create(
+            model="gpt-4.1",
+            messages=[{"role": "user", "content": "Create a resume draft"}],
+        )
+```
+
+## httpx 직접 사용
+
+```python
+import httpx
+from abto import abto_request_hook, with_context
+
+client = httpx.Client(event_hooks={"request": [abto_request_hook()]})
+
+with with_context(user_id="u1", node_id="resume.make"):
+    client.post("https://gateway.abto.ai/v1/...")  # x-abto-* 자동 첨부
+```
+
+## Public API
+
+- `create_abto(api_key=None, gateway_base_url=None) -> Abto`
+- `abto.openai(**kwargs)` — gateway baseURL + 헤더 주입된 OpenAI client (extra: `openai`)
+- `abto.with_context(user_id=?, node_id=?, trace_id=?)` — 요청 단위 context (context manager)
+- `abto.get_headers(ctx=None)` / `abto.create_trace_id()` / `abto.httpx_event_hooks()`
+- 하위 helper: `with_context`, `get_context`, `set_context`, `get_headers`, `create_trace_id`, `create_traceparent`, `abto_request_hook`, `ABTO_HEADER`, `AbtoContext`
+
+## Header Contract
+
+```text
+x-abto-device-id     (required)
+x-abto-node-key     (required; "feature.node" dot notation, e.g. resume.make)
+traceparent        (trace_id; gateway-deferred in Round1)
+```
+
+Gateway는 API key를 `tenant_id`로 매핑하고 `request_id`(응답 `x-request-id`)를 발급하며 `variant_id`를 배정하고, provider 전달 전 `x-abto-*`를 strip한다.
+
+## Test
+
+```bash
+pip install pytest && pytest
+```

abto-0.0.1/abto/__init__.py

@@ -0,0 +1,35 @@
+"""`abto` — ABTO server-side SDK for Python.
+
+Thin gateway header helper: carries x-abto-* identifiers via contextvars and
+injects them into outbound provider calls (httpx event hooks). The gateway owns
+token, cost, latency, request_id, and variant assignment.
+"""
+
+from .client import Abto, abto_request_hook, create_abto
+from .context import (
+    ABTO_HEADER,
+    AbtoContext,
+    create_trace_id,
+    create_traceparent,
+    get_context,
+    get_headers,
+    set_context,
+    with_context,
+)
+
+__version__ = "0.0.1"
+
+__all__ = [
+    "Abto",
+    "create_abto",
+    "abto_request_hook",
+    "AbtoContext",
+    "ABTO_HEADER",
+    "with_context",
+    "get_context",
+    "set_context",
+    "get_headers",
+    "create_trace_id",
+    "create_traceparent",
+    "__version__",
+]

abto-0.0.1/abto/client.py

@@ -0,0 +1,62 @@
+"""Thin server facade: gateway baseURL + ABTO header injection.
+
+It does not compute token/cost/latency. It routes provider SDK calls through the
+ABTO Gateway and carries the x-abto-* identifiers from the current context.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Callable, Dict, List, Optional
+
+from .context import AbtoContext, create_trace_id, get_headers, with_context
+
+
+def abto_request_hook() -> Callable[[Any], None]:
+    """httpx request event hook: inject ABTO headers from the current context."""
+
+    def hook(request: Any) -> None:
+        for key, value in get_headers().items():
+            request.headers.setdefault(key, value)
+
+    return hook
+
+
+class Abto:
+    def __init__(self, api_key: Optional[str] = None, gateway_base_url: Optional[str] = None) -> None:
+        self.api_key = api_key
+        self.gateway_base_url = gateway_base_url
+
+    def get_headers(self, ctx: Optional[AbtoContext] = None) -> Dict[str, str]:
+        return get_headers(ctx)
+
+    def with_context(self, **kwargs: Optional[str]):
+        return with_context(**kwargs)
+
+    def create_trace_id(self) -> str:
+        return create_trace_id()
+
+    def httpx_event_hooks(self) -> Dict[str, List[Callable[[Any], None]]]:
+        return {"request": [abto_request_hook()]}
+
+    def openai(self, **client_kwargs: Any) -> Any:
+        """Construct an OpenAI client pointed at the gateway with header injection.
+
+        Requires the optional `openai` and `httpx` extras.
+        """
+        try:
+            import httpx
+            from openai import OpenAI
+        except ImportError as exc:  # pragma: no cover - optional dependency
+            raise ImportError("abto.openai() requires the 'openai' extra: pip install 'abto[openai]'") from exc
+
+        http_client = httpx.Client(event_hooks=self.httpx_event_hooks())
+        return OpenAI(
+            api_key=self.api_key,
+            base_url=self.gateway_base_url,
+            http_client=http_client,
+            **client_kwargs,
+        )
+
+
+def create_abto(api_key: Optional[str] = None, gateway_base_url: Optional[str] = None) -> Abto:
+    return Abto(api_key=api_key, gateway_base_url=gateway_base_url)

abto-0.0.1/abto/context.py

@@ -0,0 +1,83 @@
+"""Request-scoped ABTO identifier context for the `abto` Python package.
+
+Mirrors @abto-app/sdk/server: carries the gateway identifier headers via
+contextvars so outbound provider calls can attach them. The gateway remains the
+source of truth for token, cost, latency, request_id, and variant assignment.
+"""
+
+from __future__ import annotations
+
+import contextvars
+import secrets
+from contextlib import contextmanager
+from dataclasses import dataclass, replace
+from typing import Dict, Iterator, Optional
+
+ABTO_HEADER = {
+    "user_id": "x-abto-device-id",
+    "node_id": "x-abto-node-key",
+    "traceparent": "traceparent",
+}
+
+
+@dataclass(frozen=True)
+class AbtoContext:
+    """End-user id, "feature.node" node id, and end-user action trace id."""
+
+    user_id: Optional[str] = None
+    node_id: Optional[str] = None
+    trace_id: Optional[str] = None
+
+
+_current: contextvars.ContextVar[AbtoContext] = contextvars.ContextVar(
+    "abto_context", default=AbtoContext()
+)
+
+
+def get_context() -> AbtoContext:
+    return _current.get()
+
+
+def set_context(
+    user_id: Optional[str] = None,
+    node_id: Optional[str] = None,
+    trace_id: Optional[str] = None,
+) -> None:
+    patch = {k: v for k, v in dict(user_id=user_id, node_id=node_id, trace_id=trace_id).items() if v is not None}
+    _current.set(replace(_current.get(), **patch))
+
+
+@contextmanager
+def with_context(
+    user_id: Optional[str] = None,
+    node_id: Optional[str] = None,
+    trace_id: Optional[str] = None,
+) -> Iterator[AbtoContext]:
+    patch = {k: v for k, v in dict(user_id=user_id, node_id=node_id, trace_id=trace_id).items() if v is not None}
+    merged = replace(_current.get(), **patch)
+    token = _current.set(merged)
+    try:
+        yield merged
+    finally:
+        _current.reset(token)
+
+
+def create_trace_id() -> str:
+    """32-hex-char trace id, per W3C trace-context."""
+    return secrets.token_hex(16)
+
+
+def create_traceparent(trace_id: str) -> str:
+    return f"00-{trace_id}-{secrets.token_hex(8)}-01"
+
+
+def get_headers(ctx: Optional[AbtoContext] = None) -> Dict[str, str]:
+    c = ctx if ctx is not None else _current.get()
+    headers: Dict[str, str] = {}
+    if c.user_id:
+        headers[ABTO_HEADER["user_id"]] = c.user_id
+    if c.node_id:
+        headers[ABTO_HEADER["node_id"]] = c.node_id
+    if c.trace_id:
+        headers[ABTO_HEADER["traceparent"]] = create_traceparent(c.trace_id)
+    return headers