iricity-sdk 0.1.0__tar.gz

iricity_sdk-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 IRICITY LEADERSHIP PRIVATE LIMITED (OPC)
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

iricity_sdk-0.1.0/NOTICE

@@ -0,0 +1,3 @@
+Copyright 2026 IRICITY LEADERSHIP PRIVATE LIMITED (OPC)
+
+This package is distributed under the Apache License, Version 2.0.

iricity_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: iricity-sdk
+Version: 0.1.0
+Summary: Thin Python client for Iricity machine-payment flows.
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://iricity.com/developer.html
+Project-URL: Documentation, https://iricity.com/api-docs.html
+Project-URL: Repository, https://github.com/parthod0x/iricity-webapp
+Keywords: iricity,sdk,payments,ai
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Dynamic: license-file
+
+# iricity-sdk
+
+Thin Python client for:
+- catalog
+- quote
+- execute
+- wait
+- provenance-aware settled responses
+
+## Install from repo
+
+```bash
+pip install ./apps/sdk-python
+```
+
+## Publish-ready install target
+
+```bash
+pip install iricity-sdk
+```
+
+## Example
+
+```python
+from iricity_sdk import IricityClient
+
+client = IricityClient(api_key="your_api_key")
+
+result = client.run(
+    "analysis-job",
+    {
+        "primary": {
+            "documentText": "Paste your source text here...",
+            "goal": "Summarize key points and actions",
+            "audience": "Operations leadership",
+        },
+        "options": {
+            "outputMode": "brief",
+            "urgency": "normal",
+            "includeArtifacts": False,
+        },
+    },
+    wait=True,
+)
+
+print(result)
+```

iricity_sdk-0.1.0/README.md

@@ -0,0 +1,47 @@
+# iricity-sdk
+
+Thin Python client for:
+- catalog
+- quote
+- execute
+- wait
+- provenance-aware settled responses
+
+## Install from repo
+
+```bash
+pip install ./apps/sdk-python
+```
+
+## Publish-ready install target
+
+```bash
+pip install iricity-sdk
+```
+
+## Example
+
+```python
+from iricity_sdk import IricityClient
+
+client = IricityClient(api_key="your_api_key")
+
+result = client.run(
+    "analysis-job",
+    {
+        "primary": {
+            "documentText": "Paste your source text here...",
+            "goal": "Summarize key points and actions",
+            "audience": "Operations leadership",
+        },
+        "options": {
+            "outputMode": "brief",
+            "urgency": "normal",
+            "includeArtifacts": False,
+        },
+    },
+    wait=True,
+)
+
+print(result)
+```

iricity_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "iricity-sdk"
+version = "0.1.0"
+description = "Thin Python client for Iricity machine-payment flows."
+readme = "README.md"
+license = "Apache-2.0"
+license-files = ["LICENSE", "NOTICE"]
+keywords = ["iricity", "sdk", "payments", "ai"]
+requires-python = ">=3.10"
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Operating System :: OS Independent"
+]
+
+[project.urls]
+Homepage = "https://iricity.com/developer.html"
+Documentation = "https://iricity.com/api-docs.html"
+Repository = "https://github.com/parthod0x/iricity-webapp"
+
+[tool.setuptools.packages.find]
+where = ["src"]

iricity_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

iricity_sdk-0.1.0/src/iricity_sdk/__init__.py

@@ -0,0 +1,3 @@
+from .client import IricityClient, IricitySdkError
+
+__all__ = ["IricityClient", "IricitySdkError"]

iricity_sdk-0.1.0/src/iricity_sdk/client.py

@@ -0,0 +1,104 @@
+import json
+import time
+import urllib.error
+import urllib.request
+
+
+DEFAULT_API_BASE = "https://iricity-webapp-api.onrender.com"
+TERMINAL_STATUSES = {"completed", "failed", "canceled", "timed_out"}
+
+
+class IricitySdkError(RuntimeError):
+    def __init__(self, message, status=None, payload=None):
+        super().__init__(message)
+        self.status = status
+        self.payload = payload
+
+
+class IricityClient:
+    def __init__(self, api_key, api_base=DEFAULT_API_BASE, poll_interval_seconds=1.5, wait_timeout_seconds=180):
+        if not api_key:
+            raise IricitySdkError("Missing api_key.")
+        self.api_key = api_key
+        self.api_base = api_base.rstrip("/")
+        self.poll_interval_seconds = poll_interval_seconds
+        self.wait_timeout_seconds = wait_timeout_seconds
+
+    def _request_json(self, path, method="GET", headers=None, body=None):
+        request = urllib.request.Request(f"{self.api_base}{path}", method=method)
+        request.add_header("Authorization", f"Bearer {self.api_key}")
+        request.add_header("Content-Type", "application/json")
+        for key, value in (headers or {}).items():
+            request.add_header(key, value)
+
+        payload = None if body is None else json.dumps(body).encode("utf-8")
+        try:
+            with urllib.request.urlopen(request, data=payload) as response:
+                text = response.read().decode("utf-8")
+                return json.loads(text) if text else {}
+        except urllib.error.HTTPError as exc:
+            text = exc.read().decode("utf-8") if exc.fp else ""
+            payload = json.loads(text) if text else {}
+            message = payload.get("error") if isinstance(payload, dict) else None
+            raise IricitySdkError(message or f"Request failed with {exc.code}", exc.code, payload) from exc
+
+    def catalog(self):
+        return self._request_json("/v1/internet-payments/catalog")
+
+    def quote(self, feature_id, input_payload):
+        return self._request_json(
+            "/v1/internet-payments/quotes/execution",
+            method="POST",
+            body={"featureId": feature_id, "input": input_payload},
+        )
+
+    def execute(self, feature_id, input_payload, idempotency_key=None, allow_fallback=True, receipt_token=None):
+        receipt = receipt_token or self.quote(feature_id, input_payload).get("paymentRequired", {}).get("receiptToken")
+        if not receipt:
+            raise IricitySdkError("Quote did not return a payment receipt.")
+
+        return self._request_json(
+            "/v1/internet-payments/execute",
+            method="POST",
+            headers={"x-iricity-payment-receipt": receipt},
+            body={
+                "featureId": feature_id,
+                "input": input_payload,
+                "idempotencyKey": idempotency_key or f"sdk-py-{int(time.time())}",
+                "allowFallback": allow_fallback,
+            },
+        )
+
+    def get_job(self, job_id):
+        data = self._request_json(f"/v1/execution/jobs/{job_id}")
+        return data.get("job")
+
+    def wait_for_job(self, job_id, timeout_seconds=None, poll_interval_seconds=None):
+        timeout_seconds = timeout_seconds or self.wait_timeout_seconds
+        poll_interval_seconds = poll_interval_seconds or self.poll_interval_seconds
+        started = time.time()
+
+        while time.time() - started <= timeout_seconds:
+            job = self.get_job(job_id)
+            if job and job.get("status") in TERMINAL_STATUSES:
+                return job
+            time.sleep(poll_interval_seconds)
+
+        raise IricitySdkError(f"Timed out waiting for job {job_id}.")
+
+    def run(self, feature_id, input_payload, idempotency_key=None, wait=False, allow_fallback=True):
+        quote = self.quote(feature_id, input_payload)
+        execute = self.execute(
+            feature_id,
+            input_payload,
+            idempotency_key=idempotency_key,
+            allow_fallback=allow_fallback,
+            receipt_token=quote.get("paymentRequired", {}).get("receiptToken"),
+        )
+        job_id = (execute.get("settled") or {}).get("job", {}).get("id") or (execute.get("execute") or {}).get("id")
+        settled = (
+            {"job": self.wait_for_job(job_id), "initial": execute.get("settled")}
+            if wait and job_id
+            else execute.get("settled")
+        )
+        return {"quote": quote.get("quote"), "execute": execute.get("execute"), "settled": settled}

iricity_sdk-0.1.0/src/iricity_sdk.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: iricity-sdk
+Version: 0.1.0
+Summary: Thin Python client for Iricity machine-payment flows.
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://iricity.com/developer.html
+Project-URL: Documentation, https://iricity.com/api-docs.html
+Project-URL: Repository, https://github.com/parthod0x/iricity-webapp
+Keywords: iricity,sdk,payments,ai
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Dynamic: license-file
+
+# iricity-sdk
+
+Thin Python client for:
+- catalog
+- quote
+- execute
+- wait
+- provenance-aware settled responses
+
+## Install from repo
+
+```bash
+pip install ./apps/sdk-python
+```
+
+## Publish-ready install target
+
+```bash
+pip install iricity-sdk
+```
+
+## Example
+
+```python
+from iricity_sdk import IricityClient
+
+client = IricityClient(api_key="your_api_key")
+
+result = client.run(
+    "analysis-job",
+    {
+        "primary": {
+            "documentText": "Paste your source text here...",
+            "goal": "Summarize key points and actions",
+            "audience": "Operations leadership",
+        },
+        "options": {
+            "outputMode": "brief",
+            "urgency": "normal",
+            "includeArtifacts": False,
+        },
+    },
+    wait=True,
+)
+
+print(result)
+```

iricity_sdk-0.1.0/src/iricity_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+NOTICE
+README.md
+pyproject.toml
+src/iricity_sdk/__init__.py
+src/iricity_sdk/client.py
+src/iricity_sdk.egg-info/PKG-INFO
+src/iricity_sdk.egg-info/SOURCES.txt
+src/iricity_sdk.egg-info/dependency_links.txt
+src/iricity_sdk.egg-info/top_level.txt

iricity_sdk-0.1.0/src/iricity_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

iricity_sdk-0.1.0/src/iricity_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+iricity_sdk