xpander-sdk 1.60.4__py3-none-any.whl → 2.0.155__py3-none-any.whl

xpander_sdk-2.0.155.dist-info/RECORD

@@ -0,0 +1,85 @@
+xpander_sdk/__init__.py,sha256=subqRII3DHqi4FYdWS11fuliCXiOttOrd57m6zTW7pY,2671
+xpander_sdk/consts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/consts/api_routes.py,sha256=dKUruLanvprTxZO15fR4OWe6ck8JQ8y64XmUJxsbeJY,2278
+xpander_sdk/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/core/module_base.py,sha256=YiUonUBXnXqa9wms5O8C9tEfQeWBJCIZg6xzEorV8gI,5480
+xpander_sdk/core/state.py,sha256=GKGJaMALpTGVV2-iPV3cPrQW4dNdFoZPv3oXBjHDhIY,214
+xpander_sdk/core/xpander_api_client.py,sha256=pT2Bsis0wZ96B7i6Dm6tcGEgPTkhY3vl9aq-_0Rk30E,4121
+xpander_sdk/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/exceptions/module_exception.py,sha256=2Urni1QEdzOrCdYSRc5eLpuz8aDlvRcn8KNejo_2nGc,1687
+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/events.py,sha256=bkMl1MX43tKKfOx-Mer1hUOjIGywewc5Y8_2ajh4iu8,2177
+xpander_sdk/models/frameworks.py,sha256=Ptf4aMjZ44L_x8WsCc5X0kjsJObv4dwgSM61no0aW6E,2937
+xpander_sdk/models/shared.py,sha256=gW88kA_UslNinUjtQKpLVF0sHDZnckwLWexRapxPivU,3125
+xpander_sdk/models/user.py,sha256=_FTG0JO6iTrbcvJp-BBJ6nuj281zhyQB5ldQkBCyYDU,749
+xpander_sdk/modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/agents/agents_module.py,sha256=3EhKOIPb4c39GOrNt4zU4V6WbsGj7W_yWwRNSJBKmfc,6419
+xpander_sdk/modules/agents/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/agents/models/agent.py,sha256=tJXNogRjvwlxzJPzesdHm-NBhMOzDnWImC0ndWhyjx4,14969
+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=CKMIlytfDStAoCBzOeJp7VGK6Ti5523TLxK60ZxKink,36098
+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=E4_z5Po2uQ9rij22NNX5yBgTDIcbBOD7AHpeZTpWA1c,23828
+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
+xpander_sdk/modules/events/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/events/events_module.py,sha256=QQJ9EjCpmyAje4KkYTXXqXpvjQNXDfMkYr6WcBW1ZNg,24290
+xpander_sdk/modules/events/decorators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/events/decorators/on_boot.py,sha256=VGtoQcgs3g5bmx3Ze4QB_-ZwBESATYYVR0oZe35eCww,3076
+xpander_sdk/modules/events/decorators/on_shutdown.py,sha256=rFgChspnLDnZm9FS1K636dvZSQDkeugf2e3M83SDgAY,3127
+xpander_sdk/modules/events/decorators/on_task.py,sha256=G3jk0xzi3pqH96Bbut_GMJKExIlyyMYk4PbKfc6koa4,8551
+xpander_sdk/modules/events/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/events/models/deployments.py,sha256=6uwxFsybrZ-eHeohJzkm2RtQq4Eo_0xjHk7QouvszxU,1335
+xpander_sdk/modules/events/models/events.py,sha256=T_89pq48e7fMIbJcCbtM9Ocb6YKXQP7pbF6VbECiGcI,1550
+xpander_sdk/modules/events/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/events/utils/generic.py,sha256=JsuGSQPRqHYoMC6Ki3isb6405ijZBb1izkghyiq-elk,1812
+xpander_sdk/modules/events/utils/git_init.py,sha256=e5hx7RSq8ea0lhSWr3OsioV78w9DVgxdorVBGJyGlOo,1225
+xpander_sdk/modules/knowledge_bases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/knowledge_bases/knowledge_bases_module.py,sha256=x-fvEs7dK1rn3bWGjl4a55UOv6T8k5QgS9j0reKlgpg,8778
+xpander_sdk/modules/knowledge_bases/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/knowledge_bases/models/knowledge_bases.py,sha256=pL7VoPhwy1yHQwSB1H5EnRsSCPfc2ItP6UlijieJ9Ho,219
+xpander_sdk/modules/knowledge_bases/sub_modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/knowledge_bases/sub_modules/knowledge_base.py,sha256=0HTUYjC4XfPGa0jBd5UiUhDzDDIrL4Rl-2xw884rjkc,5342
+xpander_sdk/modules/knowledge_bases/sub_modules/knowledge_base_document_item.py,sha256=oLQApvsd573ZfYGV7Ji4XB5bNUyUFIeZWPIhZS1DIM4,1815
+xpander_sdk/modules/knowledge_bases/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/tasks/tasks_module.py,sha256=wOMegfNQ4qoY7PEII5828SjWrP0Jocg2TRsFOaaCmW0,20444
+xpander_sdk/modules/tasks/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+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=DcsN9_Lt8jUzEWwNeodnAnt2M9CAk0poEl2KBP15esc,32657
+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
+xpander_sdk/modules/tools_repository/tools_repository_module.py,sha256=HpiOtsJwIeyDqb1499X4FuRUdh8v-mQZQlQ2Zlgq1lY,9557
+xpander_sdk/modules/tools_repository/decorators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/tools_repository/decorators/register_tool.py,sha256=ep-BlJHmqvG7zcW6l-hz_V0ZJx3PGfNqdijw6VjUGek,4078
+xpander_sdk/modules/tools_repository/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/tools_repository/models/mcp.py,sha256=qGpaiXKiuXw6gAcK8CW6ek6FkZNbBxDXUf1PWF6Tenw,1863
+xpander_sdk/modules/tools_repository/models/tool_invocation_result.py,sha256=Dhowt_fv8v8xWv7xMRJxo6hA8DawXKbWIrsJFMpt5H4,447
+xpander_sdk/modules/tools_repository/sub_modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/tools_repository/sub_modules/tool.py,sha256=YUf267PRXtctpPydpQTTnaO3aliSJwapM3WsdGG06Pw,22365
+xpander_sdk/modules/tools_repository/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xpander_sdk/modules/tools_repository/utils/generic.py,sha256=m9FRaVGzRUj23tB52rP9K4O-nTsMSt9iwMxMcYsqfiY,1770
+xpander_sdk/modules/tools_repository/utils/local_tools.py,sha256=zp5P8hVnRUJQb-w-2jCEMV5eUB_awmvYfY_rin5qvEw,1875
+xpander_sdk/modules/tools_repository/utils/schemas.py,sha256=EUi35h7CRrOVXV-TH-lyCpOdK5pu1uODDxvGB1JGDXY,13734
+xpander_sdk/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+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.155.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+xpander_sdk-2.0.155.dist-info/METADATA,sha256=lSJJ6nNbtBRjgstqqxlC31oMzsAifZWajwAHIZnStb0,15312
+xpander_sdk-2.0.155.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+xpander_sdk-2.0.155.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
+xpander_sdk-2.0.155.dist-info/RECORD,,

{xpander_sdk-1.60.4.dist-info → xpander_sdk-2.0.155.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.45.1)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{xpander_sdk-1.60.4.dist-info → xpander_sdk-2.0.155.dist-info/licenses}/LICENSE

@@ -1,4 +1,3 @@
-
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/

xpander_sdk/_jsii/__init__.py

@@ -1,39 +0,0 @@
-from pkgutil import extend_path
-__path__ = extend_path(__path__, __name__)
-
-import abc
-import builtins
-import datetime
-import enum
-import typing
-
-import jsii
-import publication
-import typing_extensions
-
-import typeguard
-from importlib.metadata import version as _metadata_package_version
-TYPEGUARD_MAJOR_VERSION = int(_metadata_package_version('typeguard').split('.')[0])
-
-def check_type(argname: str, value: object, expected_type: typing.Any) -> typing.Any:
-    if TYPEGUARD_MAJOR_VERSION <= 2:
-        return typeguard.check_type(argname=argname, value=value, expected_type=expected_type) # type:ignore
-    else:
-        if isinstance(value, jsii._reference_map.InterfaceDynamicProxy): # pyright: ignore [reportAttributeAccessIssue]
-           pass
-        else:
-            if TYPEGUARD_MAJOR_VERSION == 3:
-                typeguard.config.collection_check_strategy = typeguard.CollectionCheckStrategy.ALL_ITEMS # type:ignore
-                typeguard.check_type(value=value, expected_type=expected_type) # type:ignore
-            else:
-                typeguard.check_type(value=value, expected_type=expected_type, collection_check_strategy=typeguard.CollectionCheckStrategy.ALL_ITEMS) # type:ignore
-
-__jsii_assembly__ = jsii.JSIIAssembly.load(
-    "xpander-sdk", "1.60.4", __name__[0:-6], "xpander-sdk@1.60.4.jsii.tgz"
-)
-
-__all__ = [
-    "__jsii_assembly__",
-]
-
-publication.publish()

xpander_sdk/py.typed

@@ -1 +0,0 @@
-

xpander_sdk-1.60.4.dist-info/METADATA

@@ -1,368 +0,0 @@
-Metadata-Version: 2.1
-Name: xpander-sdk
-Version: 1.60.4
-Summary: xpander-sdk
-Home-page: https://github.com/xpander-ai/xpander-sdk.git
-Author: xpander.ai<opensource@xpander.ai>
-License: Apache-2.0
-Project-URL: Source, https://github.com/xpander-ai/xpander-sdk.git
-Classifier: Intended Audience :: Developers
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: JavaScript
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Typing :: Typed
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: OSI Approved
-Requires-Python: ~=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: jsii<2.0.0,>=1.108.0
-Requires-Dist: publication>=0.0.3
-Requires-Dist: typeguard<4.3.0,>=2.13.3
-
-# Xpander SDK
-
-**Xpander Open Source SDK** empowers developers to build intelligent and reliable AI Agents capable of managing complex, multi‑step tasks across diverse systems and platforms. The SDK simplifies challenges like function calling, schema definition, graph enforcement, and prompt group management.
-
-With first‑class support for leading LLM providers such as **OpenAI**, **Amazon Bedrock**, **Google Gemini**, **Anthropic Claude**, and **NVIDIA NIM**, the **Xpander SDK** seamlessly integrates into your existing systems.
-
-![ai-agents-with-xpander](https://assets.xpanderai.io/xpander-sdk-readme.png)
-
----
-
-
-## 📦 Installation
-
-Choose your preferred package manager:
-
-### npm
-
-```bash
-npm install xpander-sdk
-```
-
-### pip
-
-```bash
-pip install xpander-sdk
-```
-
----
-
-
-## 🚀 Getting Started
-
-### Prerequisites
-
-1. Sign in to [app.xpander.ai](https://app.xpander.ai) and create (or pick) an **Agent**.
-2. Copy the **Agent Key** and **Agent ID** from the Agent → **Settings** page.
-3. Grab the API key for your preferred LLM provider (e.g. `OPENAI_API_KEY`, `GEMINI_API_KEY`, etc.).
-4. Install the SDK (see above) **and** make sure you have Node.js installed – the SDK runs a tiny Node.js runtime under the hood.
-
----
-
-
-## 🏁 Usage Patterns
-
-Below are the canonical patterns taken from the official documentation for working with LLMs through the Xpander SDK.
-
-### 1. Single Query (Quick Start)
-
-```python
-from xpander_sdk import XpanderClient, LLMProvider
-from openai import OpenAI
-from dotenv import load_dotenv
-import os
-
-load_dotenv()
-
-xpander_client = XpanderClient(api_key=os.getenv("XPANDER_API_KEY"))
-agent          = xpander_client.agents.get(agent_id=os.getenv("XPANDER_AGENT_ID"))
-openai_client  = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
-
-# A one‑off prompt handled by the agent + tools
-response = openai_client.chat.completions.create(
-    model="gpt-4o",
-    messages=agent.messages,  # current conversation state
-    tools=agent.get_tools(llm_provider=LLMProvider.OPEN_AI),
-    tool_choice="auto",
-    temperature=0.0,
-)
-
-# Let the SDK execute the tool calls & keep state in sync
-agent.process_llm_response(response.model_dump(), llm_provider=LLMProvider.OPEN_AI)
-```
-
-> **Tip:** `agent.process_llm_response(...)` is the easiest way to both *store* the assistant message **and** immediately run any tool calls it contains – perfect for serverless single‑turn workflows.
-
----
-
-
-### 2. Real‑Time Event Listener (xpander‑utils)
-
-```python
-from xpander_utils.events import (
-    XpanderEventListener,
-    AgentExecutionResult,
-    ExecutionStatus,
-    AgentExecution,
-
-)
-from xpander_sdk import XpanderClient, LLMProvider
-from openai import OpenAI
-from dotenv import load_dotenv
-import os
-
-load_dotenv()
-
-listener = XpanderEventListener(
-    api_key=os.getenv("XPANDER_API_KEY"),
-    organization_id=os.getenv("XPANDER_ORG_ID"),
-    agent_id=os.getenv("XPANDER_AGENT_ID"),
-)
-
-# Optional helper clients (LLM + Agent)
-openai_client   = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
-xpander_client  = XpanderClient(api_key=os.getenv("XPANDER_API_KEY"))
-agent           = xpander_client.agents.get(agent_id=os.getenv("XPANDER_AGENT_ID"))
-
-def on_execution_request(execution_task: AgentExecution) -> AgentExecutionResult:
-    """Runs each time your cloud Agent triggers an execution request."""
-    # (1) Ask the LLM what to do next
-    response = openai_client.chat.completions.create(
-        model="gpt-4o",
-        messages=agent.messages,
-        tools=agent.get_tools(llm_provider=LLMProvider.OPEN_AI),
-        tool_choice="auto",
-        temperature=0.0,
-    )
-
-    # (2) Persist the assistant message *and* execute any tool calls
-    agent.process_llm_response(response.model_dump(), llm_provider=LLMProvider.OPEN_AI)
-
-    # (3) Return the final result back to the platform
-    return AgentExecutionResult(
-        result=execution_status.result,
-        is_success=True if execution_status.status == ExecutionStatus.COMPLETED else False,
-    )
-
-# Block forever, listening for events via SSE
-listener.register(on_execution_request=on_execution_request)
-```
-
-> **Why `xpander-utils`?** The `XpanderEventListener` uses a lightweight Server‑Sent Events (SSE) channel to deliver execution requests to your code with sub‑second latency—perfect for Slack, Teams, and other real‑time chat surfaces. ([pypi.org](https://pypi.org/project/xpander-utils/?utm_source=chatgpt.com))
-
----
-
-
-### 3. Multi‑Step Tasks (Long‑running autonomous workflows)
-
-```python
-# Describe a complex objective for the agent
-multi_step_task = """
-Find employees of xpander.ai and their roles.
-Then check their LinkedIn profiles for recent updates.
-"""
-
-agent.add_task(multi_step_task)  # automatically initialises memory
-
-while not agent.is_finished():
-    response = openai_client.chat.completions.create(
-        model="gpt-4o",
-        messages=agent.messages,
-        tools=agent.get_tools(llm_provider=LLMProvider.OPEN_AI),
-        tool_choice="auto",
-        temperature=0.0,
-    )
-
-    agent.process_llm_response(response.model_dump(), llm_provider=LLMProvider.OPEN_AI)
-
-# 🚀 Grab the final result once the agent marks itself as finished
-execution_result = agent.retrieve_execution_result()
-print(execution_result.status)  # e.g. "SUCCEEDED"
-print(execution_result.result)  # your task output
-```
-
-This loop lets the LLM break the objective into sub‑steps, call tools, update memory and eventually mark the task as **finished**.
-
----
-
-
-### 4. Complete Example – Gemini via the OpenAI‑compatible API
-
-```python
-from xpander_sdk import XpanderClient, LLMProvider
-from openai import OpenAI
-from dotenv import load_dotenv
-from os import environ
-
-load_dotenv()
-
-xpander_client = XpanderClient(api_key=environ["XPANDER_API_KEY"])
-gemini_client  = OpenAI(
-    api_key=environ["GEMINI_API_KEY"],
-    base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
-)
-
-agent = xpander_client.agents.get(agent_id=environ["XPANDER_AGENT_ID"])
-agent.add_task("Find employees of xpander.ai.")
-
-while not agent.is_finished():
-    response = gemini_client.chat.completions.create(
-        model="gemini-2.0-flash",
-        messages=agent.messages,
-        tools=agent.get_tools(llm_provider=LLMProvider.GEMINI_OPEN_AI),
-        tool_choice=agent.tool_choice,
-        temperature=0.0,
-    )
-
-    agent.add_messages(response.model_dump())
-
-    tool_calls = XpanderClient.extract_tool_calls(
-        llm_response=response.model_dump(),
-        llm_provider=LLMProvider.GEMINI_OPEN_AI,
-    )
-
-    agent.run_tools(tool_calls)
-
-print(agent.retrieve_execution_result().result)
-```
-
-This demo showcases full multi‑step orchestration **without** writing any provider‑specific glue code.
-
----
-
-
-### 5. Local Tools (developer‑executed)
-
-Local tools let you register **your own** functions (Python, TS, C#, …) so the LLM can *request* them. **Important:** the SDK does **not** execute local tools for you. Your code must:
-
-1. Register the tool schema with `agent.add_local_tools()`.
-2. Inspect each LLM response with `XpanderClient.extract_tool_calls(...)`.
-3. Pick out the pending local calls via `retrieve_pending_local_tool_calls(...)`.
-4. Invoke the matching Python/TS function(s).
-5. Feed a `ToolCallResult` back with `agent.memory.add_tool_call_results([...])`.
-
----
-
-
-#### 5‑a. Python quick path
-
-```python
-from xpander_sdk import XpanderClient, LLMProvider, ToolCallResult
-from openai import OpenAI
-from local_tools import local_tools_declarations, local_tools_by_name
-
-client = XpanderClient(api_key=XPANDER_API_KEY)
-agent  = client.agents.get(agent_id=XPANDER_AGENT_ID)
-openai = OpenAI(api_key=OPENAI_API_KEY)
-
-# 1️⃣  Tell the agent about your local tools
-agent.add_local_tools(local_tools_declarations)
-
-# 2️⃣  Normal chat ‑ the LLM may now reference those tools
-response = openai.chat.completions.create(
-    model="gpt-4o",
-    messages=agent.messages,
-    tools=agent.get_tools(llm_provider=LLMProvider.OPEN_AI),
-    tool_choice="auto",
-    temperature=0.0,
-)
-
-# 3️⃣  Extract *all* tool calls & isolate locals
-all_calls     = XpanderClient.extract_tool_calls(response.model_dump(), llm_provider=LLMProvider.OPEN_AI)
-pending_local = XpanderClient.retrieve_pending_local_tool_calls(all_calls)
-
-# 4️⃣  Run each local call
-results = []
-for call in pending_local:
-    fn   = local_tools_by_name[call.name]
-    output_payload = fn(**call.payload)  # your function runs here
-    results.append(
-        ToolCallResult(
-            function_name=call.name,
-            tool_call_id=call.tool_call_id,
-            payload=call.payload,
-            status_code=200,
-            result=output_payload,
-            is_success=True,
-            is_retryable=False,
-        )
-    )
-
-# 5️⃣  Write the results back so the LLM can continue
-agent.memory.add_tool_call_results(results)
-```
-
-#### 5‑b. TypeScript pattern (excerpt from SDK tests)
-
-```python
-// localTools array holds { decleration, fn }
-agent.addLocalTools(localToolsDecleration);
-
-const response = await openai.chat.completions.create({
-  model: 'gpt-4o',
-  messages: agent.messages,
-  tools: agent.getTools(),
-  tool_choice: agent.toolChoice,
-});
-
-const toolCalls          = XpanderClient.extractToolCalls(response);
-const pendingLocalCalls  = XpanderClient.retrievePendingLocalToolCalls(toolCalls);
-
-for (const call of pendingLocalCalls) {
-  const resultPayload = localToolsByName[call.name](...Object.values(call.payload));
-  agent.memory.addToolCallResults([
-    new ToolCallResult(
-      call.name,
-      call.toolCallId,
-      call.payload,
-      200,
-      resultPayload,
-      true,
-      false,
-    ),
-  ]);
-}
-```
-
-The LLM will then see the tool responses in its context and proceed to the next reasoning step. This mirrors the official test‑suite workflow.
-
----
-
-
-## 🏆 Best Practices (Provider‑agnostic) (Provider-agnostic) (Provider‑agnostic)
-
-1. **Create a task first** – `agent.add_task()` automatically initialises the agent’s memory and system messages.
-2. **Always pass `llm_provider`** when calling `agent.get_tools()` so the SDK can return the correct schema for the target provider.
-3. **Store the raw LLM response** with `agent.add_messages(...)` (or implicitly via `agent.process_llm_response`). The SDK will convert fields as required.
-4. **Extract tool calls with the same provider flag** you used for `get_tools`: `XpanderClient.extract_tool_calls(llm_response, llm_provider=...)`.
-
-Following these rules ensures your code works consistently across OpenAI, Claude, Gemini, Bedrock, and more.
-
----
-
-
-## 📚 Further Reading
-
-* **Official Documentation:** [https://docs.xpander.ai/userguides/overview/introduction](https://docs.xpander.ai/userguides/overview/introduction)
-* **LLM SDK Guide:** [https://docs.xpander.ai/docs/01-get-started/03-llm-models](https://docs.xpander.ai/docs/01-get-started/03-llm-models)
-* **API Reference:** [https://docs.xpander.ai/api-reference/SDK/getting-started](https://docs.xpander.ai/api-reference/SDK/getting-started)
-
----
-
-
-## ⚙️ Technical Note
-
-The library is generated with **Projen** and runs inside a tiny Node.js runtime. Ensure you have a recent **Node.js** version installed for optimal performance.
-
----
-
-
-## 🤝 Contributing
-
-We welcome contributions to improve the SDK. Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to submit improvements and bug fixes.

xpander_sdk-1.60.4.dist-info/RECORD

@@ -1,9 +0,0 @@
-xpander_sdk/__init__.py,sha256=6g6hJLlHwNMJdH20VjScZtLEzJCJw_Vtkh5ao06HMcc,318223
-xpander_sdk/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-xpander_sdk/_jsii/__init__.py,sha256=Qk4Ec4NsdP4ECaIp2PNVt2avY444cTdpPORxtfzXusI,1389
-xpander_sdk/_jsii/xpander-sdk@1.60.4.jsii.tgz,sha256=4w-Qlb0wzWX13HbfDuIV_ES0aeAF1uijN11u0zuA8Vk,1473280
-xpander_sdk-1.60.4.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-xpander_sdk-1.60.4.dist-info/METADATA,sha256=DCH3Zwb1jUlk61-TtHYM6uLHp_b8nCH_fFvrmsvOK9E,12360
-xpander_sdk-1.60.4.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-xpander_sdk-1.60.4.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
-xpander_sdk-1.60.4.dist-info/RECORD,,