xpander-sdk 2.0.170__py3-none-any.whl → 2.0.172__py3-none-any.whl

xpander_sdk/modules/backend/frameworks/agno.py

@@ -251,7 +251,7 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
             2. **START** plan execution (`xpstart_execution_plan`) - MANDATORY to enable enforcement
             3. **CHECK** plan before each action (`xpget_agent_plan`)
             4. **DO THE WORK** for one task
-            5. **COMPLETE** task IMMEDIATELY - call `xpcomplete_agent_plan_item` RIGHT AFTER finishing work (DO NOT DELAY!)
+            5. **COMPLETE** task IMMEDIATELY - call `xpcomplete_agent_plan_items` RIGHT AFTER finishing work (DO NOT DELAY!)
             6. **ASK** user for info if needed (`xpask_for_information`) - MANDATORY if you need input or want to pause
             7. Repeat steps 3-6 until all tasks are done
             
@@ -307,26 +307,35 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
 
             ---
 
-            #### **3. xpcomplete_agent_plan_item** - Mark Task Complete
-            **When to use**: **IMMEDIATELY** after finishing each task (NOT before, NOT later, RIGHT NOW!)
+            #### **3. xpcomplete_agent_plan_items** - Mark Task(s) Complete
+            **When to use**: **IMMEDIATELY** after finishing one or more tasks (NOT before, NOT later, RIGHT NOW!)
 
             **How to use**:
             ```json
+            // Single task
             {
             "body_params": {
-                "id": "task-uuid-from-plan"
+                "ids": ["task-uuid-from-plan"]
+            }
+            }
+            
+            // Multiple tasks (when finishing related tasks together)
+            {
+            "body_params": {
+                "ids": ["task-uuid-1", "task-uuid-2", "task-uuid-3"]
             }
             }
             ```
             **🚨 CRITICAL - NON-NEGOTIABLE RULES**: 
-            - Call THIS TOOL the INSTANT you finish a task
-            - DO NOT wait to mark multiple tasks at once
+            - Call THIS TOOL the INSTANT you finish task(s)
+            - Can mark single or multiple tasks complete in one call
+            - Use multiple IDs when finishing related tasks at the same time
             - DO NOT postpone marking completion
             - DO NOT be lazy - mark it complete RIGHT AFTER the work is done
             - This is MANDATORY for progress tracking and continuation
             - If you finish a task and don't mark it complete immediately, you are doing it WRONG
             
-            **Pattern**: Finish work → IMMEDIATELY call xpcomplete_agent_plan_item → Move to next task
+            **Pattern**: Finish work → IMMEDIATELY call xpcomplete_agent_plan_items → Move to next task
 
             ---
 
@@ -435,6 +444,7 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
             - Use descriptive, actionable task titles
             - Check plan before each action to stay oriented
             - **Mark tasks complete THE INSTANT you finish them - NO DELAYS, NO EXCEPTIONS**
+            - **Can mark multiple tasks at once if finished together** (e.g., related tasks done simultaneously)
             - **ALWAYS use `xpask_for_information` when you need user input or want to pause**
             - Call plan tools **sequentially** (one at a time, never in parallel)
             - Follow the pattern: DO WORK → MARK COMPLETE → NEXT TASK
@@ -442,7 +452,7 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
             ❌ **DON'T - THESE ARE FORBIDDEN:**
             - Mark tasks complete before they're actually done
             - **Be lazy and wait to mark tasks complete later** (FORBIDDEN!)
-            - **Batch mark multiple tasks at the end** (WRONG! Mark each immediately!)
+            - **Postpone marking completion to batch at the end** (WRONG! Mark immediately when done!)
             - **AFTER plan starts: NEVER write questions in your response text** ("Before I proceed...", "I need clarification...", etc.)
             - **AFTER plan starts: NEVER respond with questions - ONLY use xpask_for_information tool** (ABSOLUTE RULE!)
             - Pass plain string arrays - must be objects with `title` field
@@ -481,8 +491,8 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
 
             6. [After user responds, DO THE WORK: Design schema]
 
-            7. ⚠️ IMMEDIATELY Call: xpcomplete_agent_plan_item
-            id: "abc-123"
+            7. ⚠️ IMMEDIATELY Call: xpcomplete_agent_plan_items
+            ids: ["abc-123"]
             → MARKED COMPLETE RIGHT AFTER FINISHING - NOT DELAYED!
 
             8. Call: xpget_agent_plan
@@ -490,11 +500,17 @@ def _configure_deep_planning_guidance(args: Dict[str, Any], agent: Agent, task:
 
             9. [DO THE WORK: Create migration file]
 
-            10. ⚠️ IMMEDIATELY Call: xpcomplete_agent_plan_item
-            id: "def-456"
+            10. ⚠️ IMMEDIATELY Call: xpcomplete_agent_plan_items
+            ids: ["def-456"]
             → MARKED COMPLETE RIGHT AWAY!
+            
+            // Alternative: If tasks 3 and 4 are done together, can batch complete:
+            11a. [DO THE WORK: Implement endpoints AND add auth together]
+            11b. ⚠️ IMMEDIATELY Call: xpcomplete_agent_plan_items
+            ids: ["ghi-789", "jkl-012"]
+            → Both marked complete at once!
 
-            11. [Continue this pattern: GET PLAN → DO WORK → MARK COMPLETE IMMEDIATELY → REPEAT]
+            12. [Continue this pattern: GET PLAN → DO WORK → MARK COMPLETE IMMEDIATELY → REPEAT]
             ```
             
             ### **WRONG WAY - ANTI-PATTERN (DO NOT DO THIS)**

xpander_sdk/modules/tasks/sub_modules/task.py

@@ -560,6 +560,7 @@ class Task(XPanderSharedModel):
             # restore result and status
             self.result = task_backup.result
             self.status = task_backup.status
+            self.tokens = task_backup.tokens
             
             if not self.deep_planning.question_raised:
                 uncompleted_tasks = [task for task in self.deep_planning.tasks if not task.completed]
@@ -814,6 +815,7 @@ class Task(XPanderSharedModel):
             # restore result and status
             self.result = task_backup.result
             self.status = task_backup.status
+            self.tokens = task_backup.tokens
             
             if self.deep_planning and self.deep_planning.enabled and self.deep_planning.started and self.deep_planning.enforce:
                 

{xpander_sdk-2.0.170.dist-info → xpander_sdk-2.0.172.dist-info}/METADATA

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

{xpander_sdk-2.0.170.dist-info → xpander_sdk-2.0.172.dist-info}/RECORD

@@ -30,7 +30,7 @@ xpander_sdk/modules/agents/utils/generic.py,sha256=XbG4OeHMQo4gVYCsasMlW_b8OoqS1
 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=z8olkGD4QPMPX-g6Z-4E5n5Gxs8i1L8vbaKXKry7wjU,37881
+xpander_sdk/modules/backend/frameworks/agno.py,sha256=7nDuGVsl0DZlpm9o9vX6cKTU8dZq2iQHyiCYyCCuEis,38702
 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=slmrtpjGM__g7mkhvnY9yNRtGHS-fDcLH82rIkBKxkA,4527
@@ -60,7 +60,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=mQD3_fe4j0HnskahOmxVIsAbVh1czsn3W7nXF91_Zd0,37692
+xpander_sdk/modules/tasks/sub_modules/task.py,sha256=k9GjRmBCL8a2vXWa0TxOdNnjbUovok3ta939FfCOpv4,37782
 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
@@ -83,8 +83,8 @@ xpander_sdk/utils/generic.py,sha256=XrRj2-L8c0YWpfPdDyXE-pVL-6lKF9VpyZzKHQ4wuCc,
 xpander_sdk/utils/tools.py,sha256=lyFkq2yP7DxBkyXYVlnFRwDhQCvf0fZZMDm5fBycze4,1244
 xpander_sdk/utils/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/utils/agents/compactization_agent.py,sha256=iMViaUnpuZFMyo-pQCen9bAIADmFWV2yx3JuNaG5bx0,12815
-xpander_sdk-2.0.170.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-xpander_sdk-2.0.170.dist-info/METADATA,sha256=F97VFAV0KLgZgilAO42QBdAm_GOG1cKvRCRZoO5_NAo,15312
-xpander_sdk-2.0.170.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-xpander_sdk-2.0.170.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
-xpander_sdk-2.0.170.dist-info/RECORD,,
+xpander_sdk-2.0.172.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+xpander_sdk-2.0.172.dist-info/METADATA,sha256=ckb4CWMz2DIR2ixySj_g-JqenY0c7FxBT31hHME66iE,15312
+xpander_sdk-2.0.172.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+xpander_sdk-2.0.172.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
+xpander_sdk-2.0.172.dist-info/RECORD,,