qoni 0.1.0__py3-none-any.whl

qoni/__init__.py

@@ -0,0 +1,101 @@
+"""Qoni — unified Python SDK for Qoni Agent delegation, GenAuth user
+management, GUMem memory, and WebAgent automation.
+
+Quick start::
+
+    from qoni import Qoni
+
+    qoni = Qoni(access_key=..., secret_key=...)
+
+    delegation = qoni.delegate_token(user_id=..., products=["do_anything"])
+    run = qoni.do_anything.run(
+        token=delegation.data["token"],
+        prompt="Open example.com and summarize it.",
+    )
+    result = run.wait(timeout=600)
+    print(result.status, result.output)
+"""
+
+from .client import Qoni
+from .errors import (
+    QoniAuthError,
+    QoniDelegationRequiredError,
+    QoniError,
+    QoniPermissionDeniedError,
+    QoniRateLimitError,
+    QoniTimeoutError,
+    QoniTokenExpiredError,
+    QoniUpstreamError,
+    QoniValidationError,
+)
+from .interactions import (
+    Action,
+    ActionKinds,
+    Interaction,
+    InteractionHandle,
+    InteractionStatuses,
+    InteractionTypes,
+)
+from .run_events import QoniEventTypes, RunEvent, RunImage
+from .run_handle import (
+    Artifact,
+    CaptureOptions,
+    RunHandle,
+    RunLimits,
+    RunResult,
+    RunStatus,
+    SessionRef,
+)
+from .scopes import KNOWN_SCOPES, QONI_PRODUCT_SCOPES, QONI_SCOPE_BUNDLES, QoniScopes
+from .signature import build_authorization, build_signature, build_string_to_sign
+from .track import MonitorHandle
+from .types import QoniResponse, SSEEvent
+
+__version__ = "0.1.0"
+
+__all__ = [
+    # client
+    "Qoni",
+    "QoniResponse",
+    "SSEEvent",
+    # errors
+    "QoniError",
+    "QoniAuthError",
+    "QoniDelegationRequiredError",
+    "QoniPermissionDeniedError",
+    "QoniRateLimitError",
+    "QoniTimeoutError",
+    "QoniTokenExpiredError",
+    "QoniUpstreamError",
+    "QoniValidationError",
+    # scopes
+    "QoniScopes",
+    "QONI_PRODUCT_SCOPES",
+    "QONI_SCOPE_BUNDLES",
+    "KNOWN_SCOPES",
+    # runs
+    "RunHandle",
+    "RunStatus",
+    "RunResult",
+    "Artifact",
+    "SessionRef",
+    "CaptureOptions",
+    "RunLimits",
+    # events
+    "QoniEventTypes",
+    "RunEvent",
+    "RunImage",
+    # interactions
+    "Interaction",
+    "InteractionHandle",
+    "InteractionTypes",
+    "InteractionStatuses",
+    "ActionKinds",
+    "Action",
+    # track
+    "MonitorHandle",
+    # signature helpers
+    "build_authorization",
+    "build_signature",
+    "build_string_to_sign",
+]

qoni/auth.py

@@ -0,0 +1,45 @@
+"""Signed request headers for AK/SK control-plane calls."""
+
+from __future__ import annotations
+
+import threading
+import time
+from typing import Any, Dict, Mapping
+
+from .signature import build_authorization, build_string_to_sign
+
+_lock = threading.Lock()
+_last_signing_timestamp = 0
+
+
+def _next_signing_timestamp() -> int:
+    """Strictly monotonic millisecond timestamp.
+
+    GenAuth rejects an already-consumed signature, so otherwise identical
+    requests (retries, concurrent calls in the same millisecond) must stay
+    unique within a process.
+    """
+
+    global _last_signing_timestamp
+    with _lock:
+        now = int(time.time() * 1000)
+        _last_signing_timestamp = max(now, _last_signing_timestamp + 1)
+        return _last_signing_timestamp
+
+
+def build_signed_headers(
+    access_key: str,
+    secret_key: str,
+    method: str,
+    pathname: str,
+    payload: Mapping[str, Any],
+) -> Dict[str, str]:
+    headers: Dict[str, str] = {
+        "content-type": "application/json",
+        "x-authing-date": str(_next_signing_timestamp()),
+        "x-authing-signature-method": "HMAC-SHA1",
+        "x-authing-signature-version": "1.0",
+    }
+    string_to_sign = build_string_to_sign(method, pathname, headers, payload)
+    headers["authorization"] = build_authorization(access_key, secret_key, string_to_sign)
+    return headers