guardianhub 0.1.330__tar.gz → 0.1.332__tar.gz

{guardianhub-0.1.330 → guardianhub-0.1.332}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: guardianhub
-Version: 0.1.330
+Version: 0.1.332
 Summary: Unified SDK for YantramOps Operating System
 Project-URL: Homepage, https://github.com/yantramai/guardianhub-sdk
 Project-URL: Source, https://github.com/yantramai/guardianhub-sdk
@@ -50,6 +50,7 @@ Requires-Dist: python-multipart>=0.0.6; extra == 'full'
 Requires-Dist: pytz>=2024.1; extra == 'full'
 Requires-Dist: sqlalchemy>=2.0.0; extra == 'full'
 Requires-Dist: temporalio>=1.5.0; extra == 'full'
+Requires-Dist: toposort>=1.0.0; extra == 'full'
 Requires-Dist: uvicorn>=0.23.0; extra == 'full'
 Provides-Extra: mind
 Requires-Dist: backoff>=2.2.1; extra == 'mind'
@@ -67,6 +68,7 @@ Requires-Dist: python-dateutil>=2.9.0; extra == 'mind'
 Requires-Dist: pytz>=2024.1; extra == 'mind'
 Provides-Extra: muscle
 Requires-Dist: temporalio>=1.5.0; extra == 'muscle'
+Requires-Dist: toposort>=1.0.0; extra == 'muscle'
 Provides-Extra: obs
 Requires-Dist: langfuse==3.10.1; extra == 'obs'
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.38.0; extra == 'obs'

{guardianhub-0.1.330 → guardianhub-0.1.332}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "guardianhub"
-version = "0.1.330"  # This will be overridden by Hatch's dynamic version
+version = "0.1.332"  # This will be overridden by Hatch's dynamic version
 # Note: Keep _version.py as the source of truth for version
 description = "Unified SDK for YantramOps Operating System"
 authors = [
@@ -72,7 +72,8 @@ mind = [
 ]
 # MUSCLE: Execution and Workflow
 muscle = [
-    "temporalio>=1.5.0"
+    "temporalio>=1.5.0",
+    "toposort>=1.0.0"
 ]
 # ALL: For local development convenience
 full = [

guardianhub-0.1.332/src/guardianhub/_version.py

@@ -0,0 +1 @@
+__version__ = '0.1.332'

{guardianhub-0.1.330 → guardianhub-0.1.332}/src/guardianhub/agents/specialist_base.py

@@ -78,6 +78,7 @@ class SovereignSpecialistBase:
 
         # 4. Domain Activity Instance (The Muscle)
         self.activities_instance = activities_instance
+        self.workflow_instance = kwargs.get('workflow_instance')
 
         # 🧬 THE FUSION MOVE
         if hasattr(self.activities_instance, "fuse_with_base"):
@@ -87,6 +88,15 @@ class SovereignSpecialistBase:
         self.router = APIRouter(prefix="/v1/mission")
         self._setup_routes()
 
+    def _get_val(self, obj: Any, key: str, default: Any = None) -> Any:
+        """Sovereign helper to extract values from Pydantic models or Dicts safely."""
+        if hasattr(obj, key):
+            return getattr(obj, key)
+        if isinstance(obj, dict):
+            return obj.get(key, default)
+        return default
+
+
     def get_client(self, client_name: str, client_type: Optional[T] = None) -> Optional[T]:
         """
         Retrieves an extension client from the custom registry.
@@ -96,6 +106,30 @@ class SovereignSpecialistBase:
             raise TypeError(f"Client {client_name} is not of type {client_type.__name__}")
         return client
 
+    def get_workflows(self) -> list:
+        """
+        Standardizes the discovery of the Agent's custom Intervention Workflow.
+        """
+        workflows = []
+
+        # 1. Harvest the Parent Skeleton (The SDK Law)
+        from .workflows.mission_skeleton import SpecialistMissionWorkflow
+        workflows.append(SpecialistMissionWorkflow)
+
+        # 2. Harvest the Agent's Muscle Workflow (The Specialist Expertise)
+        if self.workflow_instance:
+            # If the user passed a module or a class
+            import inspect
+            if inspect.isclass(self.workflow_instance):
+                workflows.append(self.workflow_instance)
+            else:
+                # Module scanning
+                for _, obj in inspect.getmembers(self.workflow_instance, inspect.isclass):
+                    if hasattr(obj, "__temporal_workflow_definition"):
+                        workflows.append(obj)
+
+        return workflows
+
 
     def get_activities(self) -> list:
         from temporalio import activity
@@ -520,24 +554,20 @@ class SovereignSpecialistBase:
             outcomes_str_list = []
 
             for report in brief.step_results:
-                # 🚀 OBJECT ACCESS: report is likely AttainmentReport
-                # Aggregate metrics safely
-                metrics = getattr(report, "telemetry", {})
+                # 🚀 FIX: Use the class-level helper
+                metrics = self._get_val(report, "telemetry", {})
                 for k, v in metrics.items():
                     if isinstance(v, (int, float)):
                         total_metrics[k] = total_metrics.get(k, 0.0) + v
 
-                # Build narrative strings using object attributes
-                status_label = "✅ SUCCESS" if getattr(report, "attained", False) else "❌ FAILED"
-
-                # Use getattr for maximum resilience if fields might be missing
-                step_id = getattr(report, "step_id", "unknown")
-                score = getattr(report, "certainty_score", 0.0)
+                attained = self._get_val(report, "attained", False)
+                status_label = "✅ SUCCESS" if attained else "❌ FAILED"
+                step_id = self._get_val(report, "step_id", "unknown")
+                score = self._get_val(report, "certainty_score", 0.0)
 
                 outcomes_str_list.append(
                     f"- Step ID: {step_id} | Status: {status_label} | Certainty: {score}"
                 )
-
             # 3. LLM Input Construction
             outcomes_str = "\n".join(outcomes_str_list)
             manual_user_input = f"""

{guardianhub-0.1.330 → guardianhub-0.1.332}/src/guardianhub/agents/workflows/mission_skeleton.py

@@ -10,7 +10,7 @@ from guardianhub.models.agent.contracts.action import ActionOutcome
 from guardianhub.models.agent.contracts.attainment import AttainmentCheck,AttainmentReport
 from guardianhub.models.agent.contracts.debrief import SummaryBrief,IntelligenceReport
 from guardianhub.models.agent.contracts.learning import AfterActionReport,LearningAnchor
-from guardianhub.models.agent.contracts.completion import MissionManifest,CallbackAck
+from guardianhub.models.agent.contracts.completion import MissionManifest, CallbackAck, TacticalExecutionReport
 
 from .agent_contract import ActivityRoles
 from .constants import get_activity_options
@@ -91,16 +91,24 @@ class SpecialistMissionWorkflow:
                 "reason": "Safety Audit Violation"
             }
 
-        # 5. 🚀 ITERATIVE INTERVENTION: The Hands (Vamana/Parashurama)
-        # SpecialistMissionWorkflow.run
-        # 5. 🚀 MISSION EXECUTION: The Hands (Universal Intervention)
-        # Instead of a loop, we pass the ENTIRE plan to the Agent once.
+        # Inside SpecialistMissionWorkflow.run (Step 5)
 
-        mission_outcome = await workflow.execute_activity(
-            mapping[ActivityRoles.INTERVENTION],
-            arg=request,  # 🎯 Pass the whole MissionRequest!
-            **get_activity_options(ActivityRoles.INTERVENTION)
-        )
+        # 🚀 THE MAGIC MOMENT
+        # Instead of execute_activity, we trigger the Agent's private Workflow.
+        workflow.logger.info(f"🛰️ Delegating intervention to Child Workflow: {request.effective_intervention_workflow}")
+
+        try:
+            mission_outcome: TacticalExecutionReport = await workflow.execute_child_workflow(
+                request.effective_intervention_workflow,
+                arg=request,
+                id=f"intervention-{request.session_id}",
+                # Ensures that if the Parent is cancelled, the Child is cleaned up.
+                parent_close_policy=workflow.ParentClosePolicy.TERMINATE
+            )
+        except Exception as e:
+            workflow.logger.error(f"❌ Child Workflow '{request.effective_intervention_workflow}' failed: {str(e)}")
+            # Fallback logic to continue the AAR/Debrief with failure state
+            mission_outcome = TacticalExecutionReport(status="FAILED", error_message=str(e))
 
         # Execution results are now synthesized inside the agent's response
         # 🚀 RESILIENT ACCESS

{guardianhub-0.1.330 → guardianhub-0.1.332}/src/guardianhub/config/settings.py

@@ -187,7 +187,7 @@ class ServiceEndpoints(BaseModel):
     TOOL_EXECUTOR_URL: str = "http://localhost:8003"
     VECTOR_SERVICE_URL: str = "http://localhost:8005"
     TEMPORAL_HOST_URL: str = "localhost:7233"
-    SUTRAM_CALLBACK_URL: str = "http://localhost:8000/v1/agent/callback"
+    SUTRAM_CALLBACK_URL: str = "http://localhost:7002/v1/agent/callback"
     CLASSIFICATION_SERVICE_URL: str = "http://localhost:8000/v1/agent/callback"
     METADATA_EXTRACTION_SERVICE_URL: str = "http://localhost:8000/v1/agent/callback"
     PAPERLESS_SERVICE_URL: str = "http://localhost:8000/v1/agent/callback"

{guardianhub-0.1.330 → guardianhub-0.1.332}/src/guardianhub/models/template/agent_plan.py

@@ -126,6 +126,11 @@ class MissionRequest(BaseModel):
     session_id: str
     trace_id: Optional[str] = None
     agent_name: str = "specialist"
+    # 🎯 THE DYNAMIC LINK:
+    # Allows the Parent to call the Agent's custom Child Workflow.
+    # Default follows the convention: {agent_name}_InterventionWorkflow
+    intervention_workflow_name: Optional[str] = None
+
     is_dry_run: bool = False
     template_id: str = "NO_TEMPLATE_ID"
     sub_objective: str = "NO_SUB_OBJECTIVE"
@@ -150,7 +155,13 @@ class MissionRequest(BaseModel):
             raise ValueError("Mission rejected: Sutram provided an empty MacroPlan.")
         return v
 
-        # 🚀 ADD THIS PROPERTY HERE
+    @property
+    def effective_intervention_workflow(self) -> str:
+        """Resolves the workflow name: explicit override > convention."""
+        if self.intervention_workflow_name:
+            return self.intervention_workflow_name
+        return f"{self.agent_name}_InterventionWorkflow"
+
     @property
     def technical_context(self) -> Dict[str, Any]:
         """Provides a unified bundle for activity arguments."""
@@ -159,6 +170,7 @@ class MissionRequest(BaseModel):
             "trace_id": self.trace_id,
             "template_id": self.active_template_id,
             "agent_name": self.agent_name,
-            "is_dry_run": self.is_dry_run
+            "is_dry_run": self.is_dry_run,
+            "workflow_name": self.effective_intervention_workflow  # 🚀 Carry the link
         }
 

guardianhub-0.1.330/src/guardianhub/_version.py

@@ -1 +0,0 @@
-__version__ = '0.1.330'