xpander-sdk 2.0.159__tar.gz → 2.0.160__tar.gz

{xpander_sdk-2.0.159 → xpander_sdk-2.0.160}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xpander-sdk
-Version: 2.0.159
+Version: 2.0.160
 Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
 Home-page: https://www.xpander.ai
 Author: xpanderAI

{xpander_sdk-2.0.159 → xpander_sdk-2.0.160}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="xpander-sdk",
-    version="2.0.159",
+    version="2.0.160",
     author="xpanderAI",
     author_email="dev@xpander.ai",
     description="xpander.ai Backend-as-a-service for AI Agents - SDK",

{xpander_sdk-2.0.159 → xpander_sdk-2.0.160}/src/xpander_sdk/models/deep_planning.py

@@ -8,6 +8,9 @@ class DeepPlanningItem(XPanderSharedModel):
 
 class DeepPlanning(XPanderSharedModel):
     enabled: Optional[bool] = False
+    enforce: Optional[bool] = False
+    started: Optional[bool] = False
+    question_raised: Optional[bool] = False
     tasks: Optional[List[DeepPlanningItem]] = []
 
 class PlanFollowingStatus(XPanderSharedModel):

{xpander_sdk-2.0.159 → xpander_sdk-2.0.160}/src/xpander_sdk/modules/agents/sub_modules/agent.py

@@ -154,6 +154,7 @@ class Agent(XPanderSharedModel):
             model_name: str
             llm_reasoning_effort: Optional[LLMReasoningEffort] = LLMReasoningEffort.Medium
             deep_planning: Optional[bool] = False
+            enforce_deep_planning: Optional[bool] = False
             llm_api_base: Optional[str]
             webhook_url: Optional[str]
             created_at: Optional[datetime]
@@ -197,6 +198,7 @@ class Agent(XPanderSharedModel):
     model_name: str
     llm_reasoning_effort: Optional[LLMReasoningEffort] = LLMReasoningEffort.Medium
     deep_planning: Optional[bool] = False
+    enforce_deep_planning: Optional[bool] = False
     llm_api_base: Optional[str] = None
     webhook_url: Optional[str] = None
     created_at: Optional[datetime] = None

{xpander_sdk-2.0.159 → xpander_sdk-2.0.160}/src/xpander_sdk/modules/backend/frameworks/agno.py

@@ -231,9 +231,11 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
 
             ### **Core Workflow**
             1. **CREATE** plan at the start (`xpcreate-agent-plan`)
-            2. **CHECK** plan before each action (`xpget-agent-plan`)
-            3. **COMPLETE** task immediately after finishing it (`xpcomplete-agent-plan-item`)
-            4. Repeat steps 2-3 until all tasks are done
+            2. **START** plan execution (`xpstart-execution-plan`) - MANDATORY to enable enforcement
+            3. **CHECK** plan before each action (`xpget-agent-plan`)
+            4. **COMPLETE** task immediately after finishing it (`xpcomplete-agent-plan-item`)
+            5. **ASK** user for info if needed (`xpask-for-information`)
+            6. Repeat steps 3-5 until all tasks are done
 
             ---
 
@@ -241,6 +243,7 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
 
             #### **1. xpcreate-agent-plan** - Create Initial Plan
             **When to use**: At the very start of any multi-step task, ONLY if no plan exists yet
+            **Note**: After creating a plan, you MUST call `xpstart-execution-plan` to begin enforcement
 
             **How to use**:
             - Pass an array of task objects (NOT strings)
@@ -339,13 +342,55 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
             ```
             ---
 
+            #### **7. xpstart-execution-plan** - Start Plan Execution
+            **When to use**: Immediately after creating a plan with `xpcreate-agent-plan`
+            **CRITICAL**: Must be called to enable enforcement mode before executing tasks
+
+            **How to use**:
+            ```json
+            {
+            "body_params": {}
+            }
+            ```
+            **No parameters needed** - just call after plan creation
+
+            **What it does**:
+            - Marks plan as "started" 
+            - Enables enforcement mode if `enforce` flag is true
+            - Allows plan execution to proceed
+
+            ---
+
+            #### **8. xpask-for-information** - Ask User a Question
+            **When to use**: When you need information from the user during plan execution
+            **PREREQUISITE**: Plan must be started (running) first
+
+            **How to use**:
+            ```json
+            {
+            "body_params": {
+                "question": "What is the customer email address?"
+            }
+            }
+            ```
+
+            **What it does**:
+            - Sets `question_raised` flag to true
+            - Prints the question for the user
+            - Keeps enforcement active (does NOT pause execution)
+            - Returns waiting status
+
+            ---
+
             ### **Best Practices**
 
             ✅ **DO:**
             - Create comprehensive plans with ALL necessary steps
+            - **START** the plan with `xpstart-execution-plan` after creating it
             - Use descriptive, actionable task titles
             - Check plan before each action to stay oriented
             - Mark tasks complete immediately after finishing them
+            - Ask for user information when needed with `xpask-for-information`
             - Call plan tools **sequentially** (one at a time, never in parallel)
 
             ❌ **DON'T:**
@@ -371,18 +416,25 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
                 {"title": "Write integration tests"}
             ]
 
-            3. Call: xpget-agent-plan
+            3. Call: xpstart-execution-plan
+            → Plan now started, enforcement enabled (if enforce=true)
+
+            4. Call: xpget-agent-plan
             → See: Task 1 (ID: abc-123) - Design user schema - Not complete
 
-            4. [Do the work: Design schema]
+            5. [Realize need user input] Call: xpask-for-information
+            question: "Which database should we use - PostgreSQL or MySQL?"
+            → question_raised=true, waiting for response
+
+            6. [After user responds, do the work: Design schema]
 
-            5. Call: xpcomplete-agent-plan-item
+            7. Call: xpcomplete-agent-plan-item
             id: "abc-123"
 
-            6. Call: xpget-agent-plan
+            8. Call: xpget-agent-plan
             → See: Task 1 ✓ complete, Task 2 next...
 
-            7. [Continue through remaining tasks]
+            9. [Continue through remaining tasks]
             ```
             **Remember**: The plan is your roadmap. Check it often, update it as needed, and always mark tasks complete when done!
             </important_planning_instructions>

{xpander_sdk-2.0.159 → xpander_sdk-2.0.160}/src/xpander_sdk/modules/tasks/sub_modules/task.py

@@ -785,8 +785,12 @@ class Task(XPanderSharedModel):
             ...     print(f"Remaining tasks: {len(status.uncompleted_tasks)}")
         """
         try:
-            if self.deep_planning and self.deep_planning.enabled:
+            if self.deep_planning and self.deep_planning.enabled and self.deep_planning.started and self.deep_planning.enforce:
                 await self.areload()
+                
+                # allow early exit to ask question
+                if self.deep_planning.question_raised:
+                    return PlanFollowingStatus(can_finish=True)
 
                 uncompleted_tasks = [
                     task for task in self.deep_planning.tasks if not task.completed

{xpander_sdk-2.0.159 → xpander_sdk-2.0.160}/src/xpander_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xpander-sdk
-Version: 2.0.159
+Version: 2.0.160
 Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
 Home-page: https://www.xpander.ai
 Author: xpanderAI