bylaw-python 0.4.0__py3-none-any.whl

bylaw_python-0.4.0.dist-info/METADATA

@@ -0,0 +1,227 @@
+Metadata-Version: 2.4
+Name: bylaw-python
+Version: 0.4.0
+Summary: Agent-agnostic compliance shim for SOX 404 policy enforcement via the ALCV Vault
+Project-URL: Homepage, https://github.com/bylaw-dev/python-sdk
+Project-URL: Documentation, https://docs.bylaw.dev
+Project-URL: Repository, https://github.com/bylaw-dev/python-sdk
+Author-email: Bylaw <team@bylaw.dev>
+License: MIT
+Keywords: agents,ai,compliance,security,sox404,vault
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: cachetools>=5.3.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyjwt[crypto]>=2.8.0
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.1.0; extra == 'crewai'
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: respx>=0.21.0; extra == 'dev'
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.1.0; extra == 'langchain'
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-core>=0.10.0; extra == 'llamaindex'
+Provides-Extra: yaml
+Requires-Dist: pyyaml>=6.0; extra == 'yaml'
+Description-Content-Type: text/markdown
+
+# Ledgix ALCV — Python SDK
+
+[![PyPI](https://img.shields.io/badge/pypi-v0.1.13-blue)](https://pypi.org/project/bylaw-python/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+Agent-agnostic compliance shim for SOX 404 policy enforcement. Intercepts AI agent tool calls, validates them against your policies via the ALCV Vault, and ensures only approved actions receive a cryptographically signed A-JWT (Agentic JSON Web Token).
+
+## Quick Start
+
+```bash
+pip install bylaw-python
+```
+
+```python
+# ledgix.yaml
+# enforce:
+#   - tool: "stripe_*"
+#     policy_id: "financial-high-risk"
+#   - tool: "*"
+#     policy_id: "default"
+
+import tools
+import bylaw_python as ledgix
+
+ledgix.configure(agent_id="payments-agent")
+ledgix.auto_instrument(tools)
+
+result = tools.stripe_refund(45, "Late package")
+print(result)
+```
+
+`auto_instrument()` reads `ledgix.yaml`, `ledgix.yml`, or `ledgix.json` from the current working directory by default, wraps matching functions in place, and leaves unmatched functions alone.
+
+## Configuration
+
+Set environment variables (prefix: `LEDGIX_`):
+
+| Variable | Default | Description |
+|---|---|---|
+| `LEDGIX_VAULT_URL` | `http://localhost:8000` | Vault server URL |
+| `LEDGIX_VAULT_API_KEY` | `""` | API key for Vault auth |
+| `LEDGIX_VAULT_TIMEOUT` | `30.0` | Request timeout (seconds) |
+| `LEDGIX_VERIFY_JWT` | `true` | Verify A-JWT signatures |
+| `LEDGIX_JWT_ISSUER` | `alcv-vault` | Expected A-JWT issuer |
+| `LEDGIX_JWT_AUDIENCE` | `ledgix-sdk` | Expected A-JWT audience |
+| `LEDGIX_AGENT_ID` | `default-agent` | Agent identifier |
+
+Or pass a `VaultConfig` directly:
+
+```python
+from bylaw_python import LedgixClient, VaultConfig
+
+config = VaultConfig(vault_url="https://vault.mycompany.com", vault_api_key="sk-...")
+client = LedgixClient(config=config)
+```
+
+## Manifest-driven auto-instrumentation
+
+```python
+import tools
+import bylaw_python as ledgix
+
+ledgix.configure(agent_id="payments-agent")
+
+# Auto-discover ledgix.yaml / ledgix.yml / ledgix.json from the CWD
+wrapped = ledgix.auto_instrument(tools)
+
+# Or pass an inline manifest
+ledgix.auto_instrument(
+    tools,
+    manifest={"enforce": [{"tool": "stripe_*", "policy_id": "financial-high-risk"}]},
+)
+```
+
+YAML manifests require `pyyaml`:
+
+```bash
+pip install bylaw-python[yaml]
+```
+
+### Escape hatch
+
+```python
+@ledgix.tool
+def special_refund(amount: float):
+    return ledgix.current_token()
+
+@ledgix.tool(policy_id="override-policy")
+def stripe_charge(amount: float):
+    return ledgix.current_token()
+```
+
+## Framework Adapters
+
+### LangChain
+
+```bash
+pip install bylaw-python[langchain]
+```
+
+```python
+from bylaw_python.adapters.langchain import LedgixCallbackHandler, LedgixTool
+
+# Option 1: Callback handler (intercepts ALL tool calls)
+handler = LedgixCallbackHandler(client)
+agent = create_agent(callbacks=[handler])
+
+# Option 2: Wrap individual tools
+guarded_tool = LedgixTool.wrap(client, my_tool, policy_id="refund-policy")
+```
+
+### LlamaIndex
+
+```bash
+pip install bylaw-python[llamaindex]
+```
+
+```python
+from bylaw_python.adapters.llamaindex import wrap_tool
+
+guarded_tool = wrap_tool(client, my_function_tool, policy_id="refund-policy")
+```
+
+### CrewAI
+
+```bash
+pip install bylaw-python[crewai]
+```
+
+```python
+from bylaw_python.adapters.crewai import LedgixCrewAITool
+
+guarded_tool = LedgixCrewAITool.wrap(client, my_tool, policy_id="refund-policy")
+```
+
+## Context Manager
+
+```python
+from bylaw_python import VaultContext
+
+with VaultContext(client, "stripe_refund", {"amount": 45}) as ctx:
+    print(ctx.clearance.token)  # Use the A-JWT
+
+# Async
+async with VaultContext(client, "stripe_refund", {"amount": 45}) as ctx:
+    print(ctx.clearance.token)
+```
+
+## Error Handling
+
+```python
+from bylaw_python import ClearanceDeniedError, VaultConnectionError, TokenVerificationError
+
+try:
+    result = process_refund(amount=5000, reason="...")
+except ClearanceDeniedError as e:
+    print(f"Blocked: {e.reason} (request: {e.request_id})")
+except VaultConnectionError:
+    print("Cannot reach Vault — fail-closed")
+except TokenVerificationError:
+    print("A-JWT signature invalid")
+```
+
+## Development
+
+```bash
+git clone https://github.com/ledgix-dev/python-sdk.git
+cd python-sdk
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest tests/ -v --cov
+```
+
+## Demo
+
+```bash
+python demo.py
+```
+
+## License
+
+MIT

bylaw_python-0.4.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+bylaw_python/__init__.py,sha256=9kaXSZVekS5yOmHphhZgv6KteAvH_oK37G3bQsYzALE,2669
+bylaw_python/cli.py,sha256=QfXMCjtLljc7K6V2KfZsgyxw0_q4-k_DCfbEjMbhp6I,11601
+bylaw_python/client.py,sha256=_6XBbWrEYeEOYEsp2H_JyTcUgM9UU612G5zDLZeGS3s,70427
+bylaw_python/config.py,sha256=Mw9h5hIPyMhxx55a3E0PaICNhJNrEtu3gdYBkjhS06k,3630
+bylaw_python/counterparty.py,sha256=nEBLkQexndU1LPwbbblroVhWMEVFdh24kF-xdIDJtXs,4774
+bylaw_python/enforce.py,sha256=TcPiyK35ouB5-iCpVGOeitHGjvsdWI5NCr7o0cXhswM,20827
+bylaw_python/exceptions.py,sha256=gXXOxlaQFAnbTjRNJqPDJt1L7yHY1E7kgDQjbqSNEW0,3957
+bylaw_python/manifest.py,sha256=WXuM9pYOyq-PHFqqgmVuDd4yDHYyJu5ObwyFnAU8-kA,4834
+bylaw_python/models.py,sha256=Lbb5JpvWDzfxa-8iEuSslJpqu3apKPkYcITgHmF1Nqk,12940
+bylaw_python/pending.py,sha256=pLvyHQO6jb9sJK7SeeRO2wvKRC6K-EkzERC_krJKN70,4697
+bylaw_python/webhook.py,sha256=MD8dZZTPJ9xvk1e6isu26E7gt4goLxukLzTOAFAzWNc,1523
+bylaw_python/adapters/__init__.py,sha256=qI-boxRb6Qgy7SkC3cTt1rXEH7geZzzV7ynNje-W6iQ,37
+bylaw_python/adapters/_core.py,sha256=0LJmcbjzKaCJhFcYA7FTsj5oiAR6-LFIrU57XOBKNu8,2025
+bylaw_python/adapters/crewai.py,sha256=I1VKAHg8Fuo2Ip7HHD1EyZDqPCq4wHbwjVK_Cp2K_sA,2981
+bylaw_python/adapters/langchain.py,sha256=l-LO1cEUg82lKdLvDjaLOGyWsjS_9_e-_Di5EwLvzDA,5418
+bylaw_python/adapters/llamaindex.py,sha256=z1uz-hGPEnNO34K_TLEnJP8y4HNLCiKkTwP01EAWH2g,2924
+bylaw_python-0.4.0.dist-info/METADATA,sha256=Ovxx76HNp1g5PWkGV_g37Vx3Q8b9-1NQe5aL99R79L8,6227
+bylaw_python-0.4.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+bylaw_python-0.4.0.dist-info/entry_points.txt,sha256=89hNo5_9O_5XXVkHOG2urhQEp_KiSnq87vk4MMa8vD0,48
+bylaw_python-0.4.0.dist-info/RECORD,,

bylaw_python-0.4.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

bylaw_python-0.4.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bylaw = bylaw_python.cli:main