infralo 0.1.0.dev2__tar.gz → 0.1.0.dev3__tar.gz

{infralo-0.1.0.dev2 → infralo-0.1.0.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: infralo
-Version: 0.1.0.dev2
+Version: 0.1.0.dev3
 Summary: Infralo SDK
 License: MIT
 Keywords: agents,ai,llm,observability,tracing
@@ -248,6 +248,41 @@ inside inherit it automatically.
 
 ---
 
+## Human-in-the-Loop Approvals
+
+Pause sensitive agent operations until human reviewers authorize them in the Infralo dashboard.
+
+```python
+# Initiate an approval request inside an active trace
+approval = await infralo.acreate_approval(
+    title="Publish Stock Recap to Threads",
+    description="Please review content before publishing.",
+    review_data={"recap": "Today's stock market summary..."},
+    callback_url="https://agent.example.com/api/callback/approval",
+    client_reference_id="run_1024",
+)
+```
+
+### Trace Linkage & Webhook Resumption
+
+- Calling `create_approval()` / `acreate_approval()` inside a trace automatically attaches `trace_id` and sets the approval `span_id` as the current parent span.
+- When reviewed, Infralo POSTs a webhook payload containing `approval_id`, `span_id`, and `trace_id` to your `callback_url`.
+- Resume trace context in your webhook handler so subsequent tasks nest under the approval span:
+
+```python
+@app.post("/api/callback/approval")
+async def on_approval_callback(payload: dict):
+    with infralo.start_trace(trace_id=payload.get("trace_id")) as trace:
+        if payload.get("span_id"):
+            trace.set_parent_span_id(payload["span_id"])
+
+        if payload.get("status") == "approved":
+            # Decorated tool calls or LLM gateway calls here will nest under the approval span
+            await post_to_destination()
+```
+
+---
+
 ## Edge Cases
 
 ### Header Propagation Failure

{infralo-0.1.0.dev2 → infralo-0.1.0.dev3}/README.md

@@ -229,6 +229,41 @@ inside inherit it automatically.
 
 ---
 
+## Human-in-the-Loop Approvals
+
+Pause sensitive agent operations until human reviewers authorize them in the Infralo dashboard.
+
+```python
+# Initiate an approval request inside an active trace
+approval = await infralo.acreate_approval(
+    title="Publish Stock Recap to Threads",
+    description="Please review content before publishing.",
+    review_data={"recap": "Today's stock market summary..."},
+    callback_url="https://agent.example.com/api/callback/approval",
+    client_reference_id="run_1024",
+)
+```
+
+### Trace Linkage & Webhook Resumption
+
+- Calling `create_approval()` / `acreate_approval()` inside a trace automatically attaches `trace_id` and sets the approval `span_id` as the current parent span.
+- When reviewed, Infralo POSTs a webhook payload containing `approval_id`, `span_id`, and `trace_id` to your `callback_url`.
+- Resume trace context in your webhook handler so subsequent tasks nest under the approval span:
+
+```python
+@app.post("/api/callback/approval")
+async def on_approval_callback(payload: dict):
+    with infralo.start_trace(trace_id=payload.get("trace_id")) as trace:
+        if payload.get("span_id"):
+            trace.set_parent_span_id(payload["span_id"])
+
+        if payload.get("status") == "approved":
+            # Decorated tool calls or LLM gateway calls here will nest under the approval span
+            await post_to_destination()
+```
+
+---
+
 ## Edge Cases
 
 ### Header Propagation Failure

{infralo-0.1.0.dev2 → infralo-0.1.0.dev3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "infralo"
-version = "0.1.0.dev2"
+version = "0.1.0.dev3"
 description = "Infralo SDK"
 readme = "README.md"
 requires-python = ">=3.10"

{infralo-0.1.0.dev2 → infralo-0.1.0.dev3}/src/infralo/client.py

@@ -292,9 +292,17 @@ class Infralo:
         )
         resp.raise_for_status()
         resp_json = resp.json()
-        if isinstance(resp_json, dict) and "data" in resp_json:
-            return resp_json["data"]
-        return resp_json
+        result: dict = (
+            resp_json["data"] if isinstance(resp_json, dict) and "data" in resp_json else resp_json
+        )
+
+        active_trace = get_active_trace()
+        if active_trace is not None:
+            span_id: str | None = result.get("span_id")
+            if span_id:
+                active_trace.set_parent_span_id(span_id)
+
+        return result
 
     async def acreate_approval(
         self,
@@ -343,9 +351,19 @@ class Infralo:
             )
             resp.raise_for_status()
             resp_json = resp.json()
-            if isinstance(resp_json, dict) and "data" in resp_json:
-                return resp_json["data"]
-            return resp_json
+            result: dict = (
+                resp_json["data"]
+                if isinstance(resp_json, dict) and "data" in resp_json
+                else resp_json
+            )
+
+        active_trace = get_active_trace()
+        if active_trace is not None:
+            span_id: str | None = result.get("span_id")
+            if span_id:
+                active_trace.set_parent_span_id(span_id)
+
+        return result
 
     request_approval = create_approval
     arequest_approval = acreate_approval

{infralo-0.1.0.dev2 → infralo-0.1.0.dev3}/uv.lock

@@ -1499,7 +1499,7 @@ wheels = [
 
 [[package]]
 name = "infralo"
-version = "0.1.0.dev2"
+version = "0.1.0.dev3"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },