onceonly-sdk 2.0.2__py3-none-any.whl → 3.0.1__py3-none-any.whl

onceonly_sdk-3.0.1.dist-info/RECORD

@@ -0,0 +1,18 @@
+onceonly/__init__.py,sha256=plE3kBjpF0ssmwiiL1R2EmmlKqbyNhL2nCJHiHi6QSw,855
+onceonly/_http.py,sha256=ijzYTtgz2jSN8j1wKJx6MPbeo8CAG9iWrKAdqnIVwsU,3937
+onceonly/_util.py,sha256=-qVpRL7-IsAM-PgIACujY5WR_aDu9Yz10J_qQCmeYWI,1343
+onceonly/ai.py,sha256=F5tIPvHvkbMyXFnWG0MUio867MpFky8HsZgbEV-cGi8,26101
+onceonly/ai_models.py,sha256=H6nB5GaS-RTo2wRAOxZjS1_5eS-UttatuzbGtu9gJt0,3753
+onceonly/client.py,sha256=veOARzvA3YxOsBEgBjlvVpqfSb1dEI1lAR1iTO_Zzn8,15733
+onceonly/decorators.py,sha256=XTL3BITgVmCDRc4hrzyTNCpQyafvlFAQnjsN1EtEc7Y,8036
+onceonly/exceptions.py,sha256=Issh08A4IHSDaysJhVZNRCU9W_9BfiGt65UHaMhDCs4,1156
+onceonly/governance.py,sha256=-LRkX6kd8CfInlA3TQtLmWmOf5fCZmYQT0o_jQSq_58,19536
+onceonly/models.py,sha256=rdZGQSYX-gzg0nRv2YUALGX5fv4iDw8gWleFABG9QQY,1990
+onceonly/version.py,sha256=E3P6AbnCwaWk6ndR1zNqlOTVebX9z5rv9voltc71dos,22
+onceonly/integrations/__init__.py,sha256=0tk-2HTTsmc42NhWuR_G_Afmz5-5WG8NvmlO7iIPkIY,34
+onceonly/integrations/langchain.py,sha256=cdpHIluddX48uYeDeE1cxmn-arruVdE3k6gvZxYC9z4,5821
+onceonly_sdk-3.0.1.dist-info/licenses/LICENSE,sha256=YQQ8IT_P7hcGmmLFFuOy3eKDZ90e1cqef_okg85oAiQ,129
+onceonly_sdk-3.0.1.dist-info/METADATA,sha256=KmQC-EX4MU1L2IYpM2XPujahV4gwKcTYCt2D4jhW2fw,28163
+onceonly_sdk-3.0.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+onceonly_sdk-3.0.1.dist-info/top_level.txt,sha256=lvz-sHerZcTwlZW-uYoda_wgx62kY07GdtzIdw89hnU,9
+onceonly_sdk-3.0.1.dist-info/RECORD,,

{onceonly_sdk-2.0.2.dist-info → onceonly_sdk-3.0.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

onceonly_sdk-2.0.2.dist-info/METADATA

@@ -1,216 +0,0 @@
-Metadata-Version: 2.4
-Name: onceonly-sdk
-Version: 2.0.2
-Summary: Python SDK for OnceOnly idempotency API
-Author-email: OnceOnly <support@onceonly.tech>
-License: MIT
-Project-URL: Homepage, https://onceonly.tech/
-Project-URL: Documentation, https://onceonly.tech/docs/
-Project-URL: Repository, https://github.com/mykolademyanov/onceonly-python
-Keywords: idempotency,automation,zapier,make,ai-agents
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: httpx>=0.25
-Provides-Extra: test
-Requires-Dist: pytest>=7.0; extra == "test"
-Requires-Dist: pytest-asyncio>=0.23; extra == "test"
-Requires-Dist: anyio>=4.0; extra == "test"
-Provides-Extra: langchain
-Requires-Dist: langchain-core>=0.1.0; extra == "langchain"
-Dynamic: license-file
-
-# OnceOnly Python SDK
-
-**The Idempotency Layer for AI Agents, Webhooks, and Distributed Systems.**
-
-OnceOnly is a high-performance Python SDK that ensures **exactly-once execution**.
-It prevents duplicate actions (payments, emails, tool calls) in unstable environments like
-AI agents, webhooks, retries, or background workers.
-
-
-Website: https://onceonly.tech/ai/  
-Documentation: https://onceonly.tech/docs/
-
-[![PyPI version](https://img.shields.io/pypi/v/onceonly-sdk.svg)](https://pypi.org/project/onceonly-sdk/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
----
-
-## Why duplicates happen
-
-Duplicate actions are common in modern systems because:
-- AI agents retry or re-plan tool calls
-- Webhooks are delivered more than once
-- Workers crash after side-effects
-- Distributed systems replay events
-
-Without an idempotency layer, the same action may run multiple times.
-
-OnceOnly is designed to guard side-effects in non-deterministic AI agent loops,
-where the same tool call may be executed multiple times.
-
----
-
-## Features
-
-- Sync + Async client (httpx-based)
-- Fail-open mode for production safety
-- Stable idempotency keys (supports Pydantic & dataclasses)
-- Decorators for zero-boilerplate usage
-- Native AI API (long-running jobs, local side-effects)
-- Optional AI / LangChain integrations
-
----
-
-## FAQ
-
-**Does this prevent duplicate payments or emails?**  
-Yes. OnceOnly guarantees exactly-once execution for side-effects.
-
-**Is this a retry library?**  
-No. Retries still happen — OnceOnly ensures the action itself runs only once.
-
-
----
-
-## Installation
-
-```bash
-pip install onceonly-sdk
-```
-
-### With LangChain support included:
-
-```bash
-pip install "onceonly-sdk[langchain]"
-```
-
----
-
-## Quick Start (Webhooks / Automations)
-
-```python
-from onceonly import OnceOnly
-
-client = OnceOnly(
-    api_key="once_live_...",
-    fail_open=True  # default: continues if API is down
-)
-
-res = client.check_lock(key="order:123", ttl=300)
-
-if res.duplicate:
-    print("Duplicate blocked")
-else:
-    print("First execution")
-```
-
-Use `check_lock()` for:
-- Webhooks
-- Make / Zapier scenarios
-- Cron jobs
-- Distributed workers
-
----
-
-## AI Jobs (Server-side)
-
-Use the AI API for long-running or asynchronous jobs.
-
-```python
-result = client.ai.run_and_wait(
-    key="ai:job:daily_summary:2026-01-09",
-    metadata={"task": "daily_summary", "model": "gpt-4.1"},
-    timeout=60,
-)
-
-print(result.status)
-print(result.result)
-```
-
-- Charged **once per key**
-- Polling is free
-- Safe across retries and restarts
-
----
-
-## AI Agents / Local Side-Effects
-
-Use the AI Lease API when your code performs the side-effect locally
-(payments, emails, webhooks) but still needs exactly-once guarantees.
-
-```python
-lease = client.ai.lease(key="ai:agent:charge:user_42:invoice_100", ttl=300)
-
-if lease["status"] == "acquired":
-    try:
-        do_side_effect()
-        client.ai.complete(key=KEY, lease_id=lease["lease_id"], result={"ok": True})
-    except Exception:
-        client.ai.fail(key=KEY, lease_id=lease["lease_id"], error_code="failed")
-```
-
----
-
-## LangChain Integration 🤖
-
-```python
-from onceonly.integrations.langchain import make_idempotent_tool
-
-tool = make_idempotent_tool(
-    original_tool,
-    client=client,
-    key_prefix="agent:tool"
-)
-```
-
-Repeated tool calls with the same inputs will execute **exactly once**,
-even across retries or agent restarts.
-
-See `examples/ai/` for canonical patterns.
-
----
-
-## Decorators
-
-```python
-from onceonly.decorators import idempotent
-
-@idempotent(client, ttl=3600)
-def process_order(order_id):
-    ...
-```
-
-Idempotency keys are generated automatically and remain stable across restarts.
-
----
-
-## Fail-Open Mode
-
-Fail-open is enabled by default.
-
-Network errors, timeouts, or server errors (5xx) will **not break your application**.
-The SDK will allow execution to continue safely.
-
-Fail-open never applies to:
-- Auth errors (401 / 403)
-- Plan limits (402)
-- Validation errors (422)
-- Rate limits (429)
-
----
-
-## Support
-
-Need help?  
-Email: support@onceonly.tech  
-Or open an issue on GitHub.
-
----
-
-## License
-
-MIT

onceonly_sdk-2.0.2.dist-info/RECORD

@@ -1,17 +0,0 @@
-onceonly/__init__.py,sha256=KMS6F4DejM5nI5-gw3UC8SvETnK90oUE9V5pskh--Uw,481
-onceonly/_http.py,sha256=bFAgrLv0T7cGFq3LqaQCwEiqx-VfKEiT8jUommmhRws,3240
-onceonly/_util.py,sha256=YVdEWn1bvipAzR3g3oXpHmgLiaODwGRB1IGA3gHZ2PM,1273
-onceonly/ai.py,sha256=-yaO1ZRlEO-Qqou4P_Q0cemZYwFSIRDM1Lu_AwfF5PY,14578
-onceonly/ai_models.py,sha256=7bHYnAavdb3c-4nlh9HgRY18949TgmU9XfXfv3PXQEE,2910
-onceonly/client.py,sha256=6DtLdWc-7_bAXsaaewUQUTHVnCkRZGsc-PByMVPRhYY,12838
-onceonly/decorators.py,sha256=nP7Wu-RAQQNaTwyOnibzClEgcBJvYheMrG3_KztdlG8,5171
-onceonly/exceptions.py,sha256=Issh08A4IHSDaysJhVZNRCU9W_9BfiGt65UHaMhDCs4,1156
-onceonly/models.py,sha256=hVEBPgIVZP3ELjWYIFSFCKPzI38t5DA0gio9FvrmHJg,678
-onceonly/version.py,sha256=tATvJM5shAzfspHYjdVwpV2w3-gDA119NlEYi5X2lFY,22
-onceonly/integrations/__init__.py,sha256=0tk-2HTTsmc42NhWuR_G_Afmz5-5WG8NvmlO7iIPkIY,34
-onceonly/integrations/langchain.py,sha256=cdpHIluddX48uYeDeE1cxmn-arruVdE3k6gvZxYC9z4,5821
-onceonly_sdk-2.0.2.dist-info/licenses/LICENSE,sha256=YQQ8IT_P7hcGmmLFFuOy3eKDZ90e1cqef_okg85oAiQ,129
-onceonly_sdk-2.0.2.dist-info/METADATA,sha256=WzkOQRSbp38Ot2NKPOAOEY8p-_5Wy298bREdx74uD4w,5041
-onceonly_sdk-2.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-onceonly_sdk-2.0.2.dist-info/top_level.txt,sha256=lvz-sHerZcTwlZW-uYoda_wgx62kY07GdtzIdw89hnU,9
-onceonly_sdk-2.0.2.dist-info/RECORD,,