xpander-sdk 2.0.159__py3-none-any.whl → 2.0.160__py3-none-any.whl

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/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/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/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.dist-info → xpander_sdk-2.0.160.dist-info}/METADATA

@@ -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.dist-info → xpander_sdk-2.0.160.dist-info}/RECORD

@@ -10,7 +10,7 @@ xpander_sdk/exceptions/module_exception.py,sha256=2Urni1QEdzOrCdYSRc5eLpuz8aDlvR
 xpander_sdk/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/models/activity.py,sha256=I3CxOzUNbrKwHqynCbm7FJja6vanVkCzwwBwET7qvzA,2085
 xpander_sdk/models/configuration.py,sha256=Un8p3C3p3eMiqKK5VsHaZdWhZTRYHbrw2aPUMV8lJSc,3370
-xpander_sdk/models/deep_planning.py,sha256=Z7E55ORBvxRZM6zo3V0rkHZPNhVsRP9wYN3H8p-EKtY,438
+xpander_sdk/models/deep_planning.py,sha256=pCFV5iNSfT99ap1-09k7oO_DIwXx2vPJ3aVM472xL4w,554
 xpander_sdk/models/events.py,sha256=2vIkuPGAbntN_7xggJRw5sMJ1_EzcXyljxPH0ekISlw,2235
 xpander_sdk/models/frameworks.py,sha256=Ptf4aMjZ44L_x8WsCc5X0kjsJObv4dwgSM61no0aW6E,2937
 xpander_sdk/models/shared.py,sha256=gW88kA_UslNinUjtQKpLVF0sHDZnckwLWexRapxPivU,3125
@@ -23,13 +23,13 @@ xpander_sdk/modules/agents/models/agent.py,sha256=tJXNogRjvwlxzJPzesdHm-NBhMOzDn
 xpander_sdk/modules/agents/models/agent_list.py,sha256=byEayS2uLwDKaVT3lAHltrFocQFKpr8XEwQ6NTEEEMo,4081
 xpander_sdk/modules/agents/models/knowledge_bases.py,sha256=YimpjVJxWe8YTbGMD6oGQOA_YV8ztHQHTTBOaBB44ZM,1037
 xpander_sdk/modules/agents/sub_modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/agents/sub_modules/agent.py,sha256=T45T1KkR2OfdEdOmu7Ikf6eiV9pYJMz-uH1Xtm_3XJU,36190
+xpander_sdk/modules/agents/sub_modules/agent.py,sha256=HHVz00hrRCFZV9uj8Q5TvZHO_ObijMwQw5Gqdwa_nDY,36298
 xpander_sdk/modules/agents/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/modules/agents/utils/generic.py,sha256=XbG4OeHMQo4gVYCsasMlW_b8OoqS1xL3MlUZSjXivu0,81
 xpander_sdk/modules/backend/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/modules/backend/backend_module.py,sha256=wYghMuNXEtXgoyMXBgbMhgE7wYcbRwXJcpEyybF30kA,18927
 xpander_sdk/modules/backend/frameworks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/backend/frameworks/agno.py,sha256=tuw_2mYA_7DsFpIPpoeY4w_qpK5iAGgaooZ9d4fN3KA,30435
+xpander_sdk/modules/backend/frameworks/agno.py,sha256=VDrNb2M2RaKDPjlmc-yQeXJZVDpTifF4zl2xaLXvDeg,32538
 xpander_sdk/modules/backend/frameworks/dispatch.py,sha256=5dP4c37C42U53VjM2kkwIRwEw1i0IN3G0YESHH7J3OE,1557
 xpander_sdk/modules/backend/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/modules/backend/utils/mcp_oauth.py,sha256=a4xQGQwRGf2T9h38Vc9VNUwpIeY9y7Mn6B4D2G3tMQM,4387
@@ -59,7 +59,7 @@ xpander_sdk/modules/tasks/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRk
 xpander_sdk/modules/tasks/models/task.py,sha256=B0_fwzQEkRE_pZMSLnWuXsUBMdy8HEIxm1FfRpCQma0,5000
 xpander_sdk/modules/tasks/models/tasks_list.py,sha256=8V1T0vCtGN79qLMPwe37pOA7Wvuf8pbJNOhWL0BPo-8,5126
 xpander_sdk/modules/tasks/sub_modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xpander_sdk/modules/tasks/sub_modules/task.py,sha256=C6cHx4tHhbnfrDqiLkrWr7AB5H8V8mmy4snOXMnP6TA,35886
+xpander_sdk/modules/tasks/sub_modules/task.py,sha256=RlYe4XAhWeUGk2JwlRC__SWP7OFoym8fnCTluYrhHLg,36135
 xpander_sdk/modules/tasks/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/modules/tasks/utils/files.py,sha256=KqqwSQSrwim2-H3XP5wOadDDfngAyEI034tA7Oon-vc,3631
 xpander_sdk/modules/tools_repository/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -79,8 +79,8 @@ xpander_sdk/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU
 xpander_sdk/utils/env.py,sha256=U_zIhqWgKs5fk2-HXjAaODj4oWMc5dRQ0fvw6fqVcFk,1522
 xpander_sdk/utils/event_loop.py,sha256=kJrN0upgBhyI86tkTdfHeajznrIZl44Rl6WDiDG3GHE,2516
 xpander_sdk/utils/tools.py,sha256=lyFkq2yP7DxBkyXYVlnFRwDhQCvf0fZZMDm5fBycze4,1244
-xpander_sdk-2.0.159.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-xpander_sdk-2.0.159.dist-info/METADATA,sha256=5YTQaIhI5xOl_RAQEi9LLE1tO0p-GBvXTXohwIby_gg,15312
-xpander_sdk-2.0.159.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-xpander_sdk-2.0.159.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
-xpander_sdk-2.0.159.dist-info/RECORD,,
+xpander_sdk-2.0.160.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+xpander_sdk-2.0.160.dist-info/METADATA,sha256=KRfnTL_z2awclUG4SAg_LCOGdPkYoQl8F4AxVLD6nBI,15312
+xpander_sdk-2.0.160.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+xpander_sdk-2.0.160.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
+xpander_sdk-2.0.160.dist-info/RECORD,,