contractlane-operator-sdk 0.1.0__tar.gz

contractlane_operator_sdk-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+# local integration environment overrides
+env/.env.integration
+
+# local caches/artifacts
+.gocache/
+sdk-typescript/node_modules/
+sdk-typescript/dist/
+sdk-python/.venv/
+sdk-python/.pytest_cache/

contractlane_operator_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: contractlane-operator-sdk
+Version: 0.1.0
+Summary: Python SDK for Contract Lane Operator API
+Author: Contract Lane
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.2
+Requires-Dist: pydantic>=2.10.3
+Provides-Extra: dev
+Requires-Dist: mypy>=1.14.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.4; extra == 'dev'
+Requires-Dist: ruff>=0.8.2; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# contractlane-operator-sdk
+
+Python SDK for the Contract Lane Operator API.
+
+## Install
+```bash
+pip install contractlane-operator-sdk
+```
+
+## Quickstart
+```python
+from contractlane_operator_sdk import ClientOptions, OperatorClient
+
+client = OperatorClient(
+    ClientOptions(
+        base_url="https://localhost",
+        session_token=lambda: "session-token",
+        operator_token=lambda: "operator-token",
+        challenge_headers=lambda _: {
+            "X-Signup-Challenge": "signup-challenge-token",
+            "X-Operator-Challenge": "proof-challenge",
+            "X-Operator-Challenge-Token": "challenge-provider-token",
+        },
+    )
+)
+```
+
+### 1) Human signup/auth
+```python
+start = client.public.signup.start({"email": "owner@example.com", "org_name": "Acme"})
+session_id = start.data["signup_session"]["session_id"]
+
+client.public.signup.verify({"session_id": session_id, "verification_code": "123456"})
+client.public.signup.complete({"session_id": session_id, "project_name": "Default", "agent_name": "Primary"})
+```
+
+### 2) Admin actor + credential issue
+```python
+org = client.operator.admin.create_org({"name": "Acme", "admin_email": "owner@example.com"})
+org_id = org.data["org"]["org_id"]
+project = client.operator.admin.create_project(org_id, {"name": "Project A"})
+project_id = project.data["project"]["project_id"]
+actor = client.operator.admin.create_actor(project_id, {"name": "Bot", "scopes": ["cel.contracts:write"]})
+actor_id = actor.data["actor"]["actor_id"]
+client.operator.admin.issue_credential({"actor_id": actor_id, "upstream_token": "upstream-token"})
+```
+
+### 3) Agent-first enrollment
+```python
+challenge = client.public.agent_enrollment.challenge(
+    {"public_key_jwk": {"kty": "OKP", "crv": "Ed25519", "x": "..."}}
+)
+challenge_id = challenge.data["challenge"]["challenge_id"]
+client.public.agent_enrollment.start(
+    {
+        "challenge_id": challenge_id,
+        "signature": "base64url-signature",
+        "sponsor_email": "owner@example.com",
+        "requested_scopes": ["cel.contracts:write"],
+    }
+)
+```
+
+### 4) Gateway contract action
+```python
+client.gateway.cel.create_contract({"template_id": "tpl_123", "payload": {}})
+client.gateway.cel.contract_action("ctr_123", "send", {"note": "go"})
+```
+
+## Notes
+- Mutating operator/public endpoints auto-inject `Idempotency-Key`.
+- `request_id` is available via `response.meta.request_id`.
+- Challenge hooks can provide `X-Signup-Challenge`, `X-Operator-Challenge`, and `X-Operator-Challenge-Token`; per-request headers can override hook values.
+- Failures raise `APIError` with `status`, `code`, `message`, `request_id`, `meta`, `raw_body`.
+
+## Integration Tests
+Run against a live operator stack:
+```bash
+python -m pytest tests/integration -m integration
+```

contractlane_operator_sdk-0.1.0/README.md

@@ -0,0 +1,80 @@
+# contractlane-operator-sdk
+
+Python SDK for the Contract Lane Operator API.
+
+## Install
+```bash
+pip install contractlane-operator-sdk
+```
+
+## Quickstart
+```python
+from contractlane_operator_sdk import ClientOptions, OperatorClient
+
+client = OperatorClient(
+    ClientOptions(
+        base_url="https://localhost",
+        session_token=lambda: "session-token",
+        operator_token=lambda: "operator-token",
+        challenge_headers=lambda _: {
+            "X-Signup-Challenge": "signup-challenge-token",
+            "X-Operator-Challenge": "proof-challenge",
+            "X-Operator-Challenge-Token": "challenge-provider-token",
+        },
+    )
+)
+```
+
+### 1) Human signup/auth
+```python
+start = client.public.signup.start({"email": "owner@example.com", "org_name": "Acme"})
+session_id = start.data["signup_session"]["session_id"]
+
+client.public.signup.verify({"session_id": session_id, "verification_code": "123456"})
+client.public.signup.complete({"session_id": session_id, "project_name": "Default", "agent_name": "Primary"})
+```
+
+### 2) Admin actor + credential issue
+```python
+org = client.operator.admin.create_org({"name": "Acme", "admin_email": "owner@example.com"})
+org_id = org.data["org"]["org_id"]
+project = client.operator.admin.create_project(org_id, {"name": "Project A"})
+project_id = project.data["project"]["project_id"]
+actor = client.operator.admin.create_actor(project_id, {"name": "Bot", "scopes": ["cel.contracts:write"]})
+actor_id = actor.data["actor"]["actor_id"]
+client.operator.admin.issue_credential({"actor_id": actor_id, "upstream_token": "upstream-token"})
+```
+
+### 3) Agent-first enrollment
+```python
+challenge = client.public.agent_enrollment.challenge(
+    {"public_key_jwk": {"kty": "OKP", "crv": "Ed25519", "x": "..."}}
+)
+challenge_id = challenge.data["challenge"]["challenge_id"]
+client.public.agent_enrollment.start(
+    {
+        "challenge_id": challenge_id,
+        "signature": "base64url-signature",
+        "sponsor_email": "owner@example.com",
+        "requested_scopes": ["cel.contracts:write"],
+    }
+)
+```
+
+### 4) Gateway contract action
+```python
+client.gateway.cel.create_contract({"template_id": "tpl_123", "payload": {}})
+client.gateway.cel.contract_action("ctr_123", "send", {"note": "go"})
+```
+
+## Notes
+- Mutating operator/public endpoints auto-inject `Idempotency-Key`.
+- `request_id` is available via `response.meta.request_id`.
+- Challenge hooks can provide `X-Signup-Challenge`, `X-Operator-Challenge`, and `X-Operator-Challenge-Token`; per-request headers can override hook values.
+- Failures raise `APIError` with `status`, `code`, `message`, `request_id`, `meta`, `raw_body`.
+
+## Integration Tests
+Run against a live operator stack:
+```bash
+python -m pytest tests/integration -m integration
+```

contractlane_operator_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling>=1.26.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "contractlane-operator-sdk"
+version = "0.1.0"
+description = "Python SDK for Contract Lane Operator API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Contract Lane" }]
+dependencies = [
+  "httpx>=0.27.2",
+  "pydantic>=2.10.3"
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.3.4",
+  "pytest-asyncio>=0.24.0",
+  "ruff>=0.8.2",
+  "mypy>=1.14.0"
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/contractlane_operator_sdk"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+asyncio_mode = "auto"
+markers = [
+  "integration: live integration tests against a running operator stack"
+]

contractlane_operator_sdk-0.1.0/src/contractlane_operator_sdk/__init__.py

@@ -0,0 +1,22 @@
+from .client import AsyncOperatorClient, OperatorClient
+from .errors import APIError
+from .models import (
+    APIResponse,
+    AuthMode,
+    ClientOptions,
+    RequestOptions,
+    ResponseMeta,
+    RetryOptions,
+)
+
+__all__ = [
+    "APIError",
+    "APIResponse",
+    "AuthMode",
+    "ClientOptions",
+    "RequestOptions",
+    "ResponseMeta",
+    "RetryOptions",
+    "OperatorClient",
+    "AsyncOperatorClient",
+]