xpander-sdk 2.0.219__tar.gz → 2.0.221__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (113) hide show
  1. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/PKG-INFO +1 -1
  2. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/setup.py +1 -1
  3. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/orchestrations.py +13 -0
  4. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/agents/sub_modules/agent.py +3 -0
  5. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/backend/frameworks/agno.py +1 -1
  6. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tasks/sub_modules/task.py +2 -0
  7. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tasks/tasks_module.py +3 -0
  8. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk.egg-info/PKG-INFO +1 -1
  9. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/LICENSE +0 -0
  10. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/README.md +0 -0
  11. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/pyproject.toml +0 -0
  12. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/setup.cfg +0 -0
  13. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/__init__.py +0 -0
  14. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/consts/__init__.py +0 -0
  15. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/consts/api_routes.py +0 -0
  16. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/core/__init__.py +0 -0
  17. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/core/module_base.py +0 -0
  18. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/core/state.py +0 -0
  19. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/core/xpander_api_client.py +0 -0
  20. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/exceptions/__init__.py +0 -0
  21. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/exceptions/module_exception.py +0 -0
  22. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/__init__.py +0 -0
  23. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/activity.py +0 -0
  24. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/compactization.py +0 -0
  25. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/configuration.py +0 -0
  26. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/deep_planning.py +0 -0
  27. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/events.py +0 -0
  28. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/frameworks.py +0 -0
  29. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/generic.py +0 -0
  30. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/notifications.py +0 -0
  31. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/shared.py +0 -0
  32. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/models/user.py +0 -0
  33. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/__init__.py +0 -0
  34. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/agents/__init__.py +0 -0
  35. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/agents/agents_module.py +0 -0
  36. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/agents/models/__init__.py +0 -0
  37. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/agents/models/agent.py +0 -0
  38. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/agents/models/agent_list.py +0 -0
  39. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/agents/models/knowledge_bases.py +0 -0
  40. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/agents/sub_modules/__init__.py +0 -0
  41. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/agents/utils/__init__.py +0 -0
  42. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/agents/utils/generic.py +0 -0
  43. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/backend/__init__.py +0 -0
  44. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/backend/backend_module.py +0 -0
  45. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/backend/decorators/__init__.py +0 -0
  46. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/backend/decorators/on_auth_event.py +0 -0
  47. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/backend/events_registry.py +0 -0
  48. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/backend/frameworks/__init__.py +0 -0
  49. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/backend/frameworks/dispatch.py +0 -0
  50. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/backend/utils/__init__.py +0 -0
  51. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/backend/utils/mcp_oauth.py +0 -0
  52. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/__init__.py +0 -0
  53. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/decorators/__init__.py +0 -0
  54. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/decorators/on_boot.py +0 -0
  55. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/decorators/on_shutdown.py +0 -0
  56. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/decorators/on_task.py +0 -0
  57. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/decorators/on_tool.py +0 -0
  58. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/events_module.py +0 -0
  59. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/models/__init__.py +0 -0
  60. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/models/deployments.py +0 -0
  61. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/models/events.py +0 -0
  62. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/utils/__init__.py +0 -0
  63. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/utils/generic.py +0 -0
  64. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/events/utils/git_init.py +0 -0
  65. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/knowledge_bases/__init__.py +0 -0
  66. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/knowledge_bases/knowledge_bases_module.py +0 -0
  67. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/knowledge_bases/models/__init__.py +0 -0
  68. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/knowledge_bases/models/knowledge_bases.py +0 -0
  69. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/knowledge_bases/sub_modules/__init__.py +0 -0
  70. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/knowledge_bases/sub_modules/knowledge_base.py +0 -0
  71. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/knowledge_bases/sub_modules/knowledge_base_document_item.py +0 -0
  72. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/knowledge_bases/utils/__init__.py +0 -0
  73. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tasks/__init__.py +0 -0
  74. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tasks/models/__init__.py +0 -0
  75. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tasks/models/task.py +0 -0
  76. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tasks/models/tasks_list.py +0 -0
  77. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tasks/sub_modules/__init__.py +0 -0
  78. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tasks/utils/__init__.py +0 -0
  79. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tasks/utils/files.py +0 -0
  80. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/__init__.py +0 -0
  81. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/decorators/__init__.py +0 -0
  82. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/decorators/register_tool.py +0 -0
  83. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/models/__init__.py +0 -0
  84. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/models/mcp.py +0 -0
  85. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/models/tool_invocation_result.py +0 -0
  86. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/sub_modules/__init__.py +0 -0
  87. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/sub_modules/tool.py +0 -0
  88. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/tools_repository_module.py +0 -0
  89. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/utils/__init__.py +0 -0
  90. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/utils/generic.py +0 -0
  91. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/utils/local_tools.py +0 -0
  92. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/modules/tools_repository/utils/schemas.py +0 -0
  93. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/utils/__init__.py +0 -0
  94. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/utils/agents/__init__.py +0 -0
  95. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/utils/agents/compactization_agent.py +0 -0
  96. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/utils/env.py +0 -0
  97. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/utils/event_loop.py +0 -0
  98. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/utils/generic.py +0 -0
  99. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk/utils/tools.py +0 -0
  100. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk.egg-info/SOURCES.txt +0 -0
  101. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk.egg-info/dependency_links.txt +0 -0
  102. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk.egg-info/requires.txt +0 -0
  103. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/src/xpander_sdk.egg-info/top_level.txt +0 -0
  104. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/tests/test_agents_module.py +0 -0
  105. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/tests/test_api_client.py +0 -0
  106. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/tests/test_backend_module.py +0 -0
  107. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/tests/test_boot_shutdown_handlers.py +0 -0
  108. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/tests/test_configuration.py +0 -0
  109. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/tests/test_final_validation.py +0 -0
  110. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/tests/test_knowledge_bases_module.py +0 -0
  111. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/tests/test_tasks_module.py +0 -0
  112. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/tests/test_tool_schema_enhancements.py +0 -0
  113. {xpander_sdk-2.0.219 → xpander_sdk-2.0.221}/tests/test_tools_repository.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: xpander-sdk
3
- Version: 2.0.219
3
+ Version: 2.0.221
4
4
  Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
5
5
  Home-page: https://www.xpander.ai
6
6
  Author: xpanderAI
@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
5
5
 
6
6
  setup(
7
7
  name="xpander-sdk",
8
- version="2.0.219",
8
+ version="2.0.221",
9
9
  author="xpanderAI",
10
10
  author_email="dev@xpander.ai",
11
11
  description="xpander.ai Backend-as-a-service for AI Agents - SDK",
@@ -45,6 +45,17 @@ class OrchestrationNodeType(str, Enum):
45
45
  Summarizer = "summarizer"
46
46
  SendToEnd = "send_to_end"
47
47
 
48
+ class OrchestrationPointerNodeInstructionsMode(str, Enum):
49
+ """Modes for instruction usage in pointer node.
50
+
51
+ Attributes:
52
+ Replace: Replaces the traget asset instructions.
53
+ Append: Appends to the traget asset instructions.
54
+ """
55
+
56
+ Replace = "replace"
57
+ Append = "append"
58
+
48
59
  class OrchestrationConditionType(str, Enum):
49
60
  """Types of conditions for orchestration control flow.
50
61
 
@@ -186,6 +197,7 @@ class OrchestrationPointerNode(XPanderSharedModel):
186
197
  output_type: Expected output format. Defaults to Text.
187
198
  output_schema: JSON schema for structured output validation.
188
199
  instructions: Optional instructions for the pointer node (Action only).
200
+ instructions_mode: Mode to use for pointer node, specifically for agent nodes.
189
201
  ignore_response: Should ignore the node result and proceed with previous result?.
190
202
  schema_override: Optional schema override with permanentValue fields for fixed values.
191
203
  """
@@ -201,6 +213,7 @@ class OrchestrationPointerNode(XPanderSharedModel):
201
213
  output_type: Optional[OutputFormat] = OutputFormat.Text
202
214
  output_schema: Optional[Dict] = None
203
215
  instructions: Optional[str] = None
216
+ instructions_mode: Optional[OrchestrationPointerNodeInstructionsMode] = OrchestrationPointerNodeInstructionsMode.Append
204
217
  ignore_response: Optional[bool] = False
205
218
  schema_override: Optional[SchemaOverride] = None
206
219
 
@@ -413,6 +413,7 @@ class Agent(XPanderSharedModel):
413
413
  output_schema: Optional[Dict] = None,
414
414
  events_streaming: Optional[bool] = False,
415
415
  additional_context: Optional[str] = None,
416
+ additional_instructions: Optional[str] = None,
416
417
  expected_output: Optional[str] = None,
417
418
  mcp_servers: Optional[List[MCPServerDetails]] = [],
418
419
  triggering_agent_id: Optional[str] = None,
@@ -438,6 +439,7 @@ class Agent(XPanderSharedModel):
438
439
  output_schema (Optional[Dict]): Schema defining structure of output.
439
440
  events_streaming (Optional[bool]): Flag idicating for events are required for this task.
440
441
  additional_context (Optional[str]): Additional context to be passed to the agent.
442
+ additional_instructions (Optional[str]): Additional instructions to be appended to the agent's system prompt.
441
443
  expected_output (Optional[str]): Expected output of the execution.
442
444
  mcp_servers (Optional[List[MCPServerDetails]]): Optional list of mcp servers to use.
443
445
  triggering_agent_id (Optional[str]): Optional triggering agent id.
@@ -473,6 +475,7 @@ class Agent(XPanderSharedModel):
473
475
  "run_locally": run_locally,
474
476
  "events_streaming": events_streaming,
475
477
  "additional_context": additional_context,
478
+ "additional_instructions": additional_instructions,
476
479
  "expected_output": expected_output,
477
480
  "mcp_servers": [server.model_dump() for server in mcp_servers],
478
481
  "triggering_agent_id": triggering_agent_id,
@@ -130,7 +130,7 @@ async def build_agent_args(
130
130
  "name": xpander_agent.name,
131
131
  "model": model,
132
132
  "description": xpander_agent.instructions.description,
133
- "instructions": xpander_agent.instructions.instructions,
133
+ "instructions": task.additional_instructions if task.additional_instructions else xpander_agent.instructions.instructions,
134
134
  "expected_output": (
135
135
  task.expected_output
136
136
  if task and task.expected_output
@@ -132,6 +132,7 @@ class Task(XPanderSharedModel):
132
132
  output_schema (Optional[Dict]): Schema for the task's output.
133
133
  events_streaming (Optional[bool]): Flag indicating if the task has events streaming.
134
134
  additional_context (Optional[str]): Additional context to be passed to the agent.
135
+ additional_instructions (Optional[str]): Additional instructions to be appended to the agent's system prompt.
135
136
  expected_output (Optional[str]): Expected output of the execution.
136
137
  mcp_servers (Optional[List[MCPServerDetails]]): Optional list of mcp servers to use.
137
138
  triggering_agent_id (Optional[str]): Optional triggering agent id.
@@ -180,6 +181,7 @@ class Task(XPanderSharedModel):
180
181
  events_streaming: Optional[bool] = False
181
182
  is_orchestration: Optional[bool] = False
182
183
  additional_context: Optional[str] = None
184
+ additional_instructions: Optional[str] = None
183
185
  expected_output: Optional[str] = (None,)
184
186
  mcp_servers: Optional[List[MCPServerDetails]] = ([],)
185
187
  triggering_agent_id: Optional[str] = (None,)
@@ -234,6 +234,7 @@ class Tasks(ModuleBase):
234
234
  output_schema: Optional[Dict] = None,
235
235
  events_streaming: Optional[bool] = False,
236
236
  additional_context: Optional[str] = None,
237
+ additional_instructions: Optional[str] = None,
237
238
  expected_output: Optional[str] = None,
238
239
  mcp_servers: Optional[List[MCPServerDetails]] = [],
239
240
  triggering_agent_id: Optional[str] = None,
@@ -263,6 +264,7 @@ class Tasks(ModuleBase):
263
264
  output_schema (Optional[Dict]): Schema defining the expected output structure.
264
265
  events_streaming (Optional[bool]): Flag idicating for events are required for this task.
265
266
  additional_context (Optional[str]): Additional context to be passed to the agent.
267
+ additional_instructions (Optional[str]): Additional instructions to be appended to the agent's system prompt.
266
268
  expected_output (Optional[str]): Expected output of the execution.
267
269
  mcp_servers (Optional[List[MCPServerDetails]]): Optional list of mcp servers to use.
268
270
  triggering_agent_id (Optional[str]): Optional triggering agent id.
@@ -309,6 +311,7 @@ class Tasks(ModuleBase):
309
311
  "run_locally": run_locally,
310
312
  "events_streaming": events_streaming,
311
313
  "additional_context": additional_context,
314
+ "additional_instructions": additional_instructions,
312
315
  "expected_output": expected_output,
313
316
  "mcp_servers": [server.model_dump() for server in mcp_servers],
314
317
  "triggering_agent_id": triggering_agent_id,
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: xpander-sdk
3
- Version: 2.0.219
3
+ Version: 2.0.221
4
4
  Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
5
5
  Home-page: https://www.xpander.ai
6
6
  Author: xpanderAI
File without changes
File without changes
File without changes