timbal 2.2.4__tar.gz → 2.2.6__tar.gz

{timbal-2.2.4 → timbal-2.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: timbal
-Version: 2.2.4
+Version: 2.2.6
 Summary: Simple, performant, battle-tested framework for building reliable AI applications
 Project-URL: Source, https://github.com/timbal-ai/timbal
 Author-email: Timbal <team@timbal.ai>

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.2.4'
-__version_tuple__ = version_tuple = (2, 2, 4)
+__version__ = version = '2.2.6'
+__version_tuple__ = version_tuple = (2, 2, 6)
 
 __commit_id__ = commit_id = None

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/__init__.py

@@ -493,6 +493,7 @@ if TYPE_CHECKING:
         OutlookTrash,
         OutlookUpdateEmail,
     )
+    from .parallel import ParallelExtract, ParallelSearch, ParallelTaskRun
     from .pinecone import (
         PineconeCreateIndex,
         PineconeDeleteVectors,
@@ -1330,6 +1331,9 @@ __all__ = [
     "TavilyExtract",
     "TavilyMap",
     "TavilySearch",
+    "ParallelSearch",
+    "ParallelExtract",
+    "ParallelTaskRun",
     "WebSearch",
     "Write",
     "XSearch",
@@ -2400,6 +2404,9 @@ _LAZY_IMPORTS = {
     "TavilyExtract": ".tavily",
     "TavilyMap": ".tavily",
     "TavilySearch": ".tavily",
+    "ParallelSearch": ".parallel",
+    "ParallelExtract": ".parallel",
+    "ParallelTaskRun": ".parallel",
     "WebSearch": ".web_search",
     "Write": ".write",
     "XSearch": ".xai",

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/elasticsearch.py

@@ -33,8 +33,11 @@ async def _resolve_credentials(tool: Any) -> tuple[str, str | None]:
 class ElasticsearchIngestAttachment(Tool):
     name: str = "elasticsearch_ingest_attachment"
     description: str | None = (
-        "Ingest a base64-encoded file attachment into an Elasticsearch index "
-        "using the ingest-attachment pipeline to extract text content."
+        "Ingest and parse a file attachment — PDF, Word DOCX, PowerPoint PPTX, "
+        "Excel, HTML, RTF, or plain text document — into searchable full text in "
+        "an Elasticsearch index using the ingest-attachment (Apache Tika) pipeline. "
+        "Extract text and metadata from a base64-encoded document or file for "
+        "full-text search."
     )
     integration: Annotated[str, Integration("elasticsearch")] | None = None
     api_key: SecretStr | None = None

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/elevenlabs.py

@@ -13,8 +13,9 @@ _ELEVENLABS_BASE = "https://api.elevenlabs.io/v1"
 class ElevenLabsTextToSpeech(Tool):
     name: str = "elevenlabs_text_to_speech"
     description: str | None = (
-        "Convert text to speech using a specified ElevenLabs voice. "
-        "Returns the audio encoded as a base64 string."
+        "Generate a voiceover or narration from text: text-to-speech (TTS) that "
+        "produces natural spoken audio in a chosen ElevenLabs voice. Returns the "
+        "audio as a base64 string."
     )
     integration: Annotated[str, Integration("elevenlabs")] | None = None
     api_key: SecretStr | None = None

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/fal.py

@@ -37,12 +37,15 @@ def _queue_model_path_from_submit_response(data: dict[str, Any]) -> str | None:
 class FalQueueSubmit(Tool):
     name: str = "fal_queue_submit"
     description: str | None = (
-        "Submit an async inference job to fal's queue for a model (e.g. fal-ai/flux/schnell). "
-        "Returns request_id, status_url, response_url, cancel_url, and queue_model_path (canonical path for "
-        "follow-up calls). Important: fal may rewrite the route—e.g. you submit fal-ai/flux/schnell but URLs use "
-        "fal-ai/flux. For fal_queue_status, fal_queue_result, and fal_queue_cancel always pass model_id="
-        "queue_model_path from this response (or the path segment from status_url before /requests/), not the "
-        "original submit string, or status polling can return HTTP 405."
+        "Run an AI model on fal (e.g. FLUX) to generate images, video, or audio — "
+        "submits an async inference/generation job to fal's queue. General-purpose "
+        "model runner. Returns request_id, status_url, response_url, cancel_url, and "
+        "queue_model_path (canonical path for follow-up calls). Important: fal may "
+        "rewrite the route—e.g. you submit fal-ai/flux/schnell but URLs use fal-ai/flux. "
+        "For fal_queue_status, fal_queue_result, and fal_queue_cancel always pass "
+        "model_id=queue_model_path from this response (or the path segment from "
+        "status_url before /requests/), not the original submit string, or status "
+        "polling can return HTTP 405."
     )
     integration: Annotated[str, Integration("fal")] | None = None
     api_key: SecretStr | None = None

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/gemini_images.py

@@ -148,8 +148,9 @@ class GeminiImagesGenerateImage(Tool):
 class GeminiImagesAnalyzeImage(Tool):
     name: str = "gemini_analyze_image"
     description: str | None = (
-        "Analyze, describe, or extract information from an image using Gemini vision. "
-        "Returns a text response based on your question or instruction."
+        "Analyze an image with the Gemini vision model: describe a picture, photo, "
+        "or screenshot, answer questions about its contents, and OCR — read, "
+        "extract, and transcribe text from an image."
     )
     integration: Annotated[str, Integration("gemini")] | None = None
     api_key: SecretStr | None = None

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/google_analytics.py

@@ -74,7 +74,10 @@ class GoogleAnalyticsListAccountSummaries(Tool):
 
 class GoogleAnalyticsRunReport(Tool):
     name: str = "google_analytics_run_report"
-    description: str | None = "Run a standard GA4 report with dimensions, metrics, and date ranges."
+    description: str | None = (
+        "Run a standard GA4 analytics report — website traffic, visitors, sessions, "
+        "pageviews, and conversions — with dimensions, metrics, and date ranges."
+    )
     integration: Annotated[str, Integration("google_analytics")] | None = None
     token: SecretStr | None = None
     default_property_id: str | None = None
@@ -131,7 +134,10 @@ class GoogleAnalyticsRunReport(Tool):
 
 class GoogleAnalyticsRunRealtimeReport(Tool):
     name: str = "google_analytics_run_realtime_report"
-    description: str | None = "Run a GA4 realtime report for active users and events."
+    description: str | None = (
+        "Run a GA4 realtime report: active users and visitors on your site right "
+        "now — live website traffic and events."
+    )
     integration: Annotated[str, Integration("google_analytics")] | None = None
     token: SecretStr | None = None
     default_property_id: str | None = None

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/google_docs.py

@@ -505,7 +505,7 @@ class GoogleDocsGetTabContent(Tool):
 class GoogleDocsGetDocument(Tool):
     name: str = "google_docs_get_document"
     description: str | None = (
-        "Get the contents of the latest version of a Google Doc. "
+        "Read and return the text contents of a Google Docs document. "
         "Set include_tabs_content=true for multi-tab documents."
     )
     integration: Annotated[str, Integration("google_docs")] | None = None

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/google_drive.py

@@ -143,7 +143,7 @@ class GoogleDriveGetDownloadLink(Tool):
 
 class GoogleDriveGetFile(Tool):
     name: str = "google_drive_get_file"
-    description: str | None = "Download and return content of a Google Drive file."
+    description: str | None = "Download and return the content of a Google Drive file or document (PDF, Word, etc.) by id."
     integration: Annotated[str, Integration("google_drive")] | None = None
     token: SecretStr | None = None
 
@@ -308,7 +308,7 @@ class GoogleDriveSearchFolders(Tool):
 
 class GoogleDriveSearchFiles(Tool):
     name: str = "google_drive_search_files"
-    description: str | None = "Search for files in Google Drive with optional query. Supports pagination, filtering by folder, name, and trashed status."
+    description: str | None = "Search Google Drive to find a file, document, or folder by name or query. Locate documents in Drive. Supports pagination, filtering by folder, name, and trashed status."
     integration: Annotated[str, Integration("google_drive")] | None = None
     token: SecretStr | None = None
 

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/higgsfield.py

@@ -653,7 +653,11 @@ class HiggsfieldSoulTrain(_HiggsfieldTool):
 
 class HiggsfieldSoulGenerate(_HiggsfieldTool):
     name: str = "higgsfield_soul_generate"
-    description: str | None = "Generate image or video using a trained Soul character."
+    description: str | None = (
+        "Generate photorealistic images of a person or character with Higgsfield "
+        "Soul — UGC-style content, avatars, and character image generation from a "
+        "prompt, using a trained Soul character."
+    )
 
     def __init__(self, **kwargs: Any) -> None:
         async def _soul_generate(

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/jira.py

@@ -495,7 +495,10 @@ class JiraGetIssueTypesForProject(Tool):
 
 class JiraCreateIssue(Tool):
     name: str = "jira_create_issue"
-    description: str | None = "Create an issue with a Jira fields payload (project, issuetype, summary, etc.)."
+    description: str | None = (
+        "Create a Jira issue — a bug, task, story, or ticket — from a fields "
+        "payload (project, issuetype, summary, etc.)."
+    )
     integration: Annotated[str, Integration("jira")] | None = None
     token: SecretStr | None = None
 

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/netsuite.py

@@ -29,6 +29,8 @@ def _netsuite_auth_header(
     consumer_secret: str,
     token_id: str,
     token_secret: str,
+    query_params: dict[str, Any] | None = None,
+    body: str | None = None,
 ) -> str:
     """Generate OAuth 1.0a Token-Based Authentication (TBA) header for NetSuite."""
     import base64
@@ -41,7 +43,7 @@ def _netsuite_auth_header(
     nonce = uuid.uuid4().hex
     timestamp = str(int(time.time()))
 
-    params: dict[str, str] = {
+    oauth_params: dict[str, str] = {
         "oauth_consumer_key": consumer_key,
         "oauth_nonce": nonce,
         "oauth_signature_method": "HMAC-SHA256",
@@ -49,10 +51,21 @@ def _netsuite_auth_header(
         "oauth_token": token_id,
         "oauth_version": "1.0",
     }
+    if body is not None:
+        # NetSuite requires oauth_body_hash for non-form POST/PATCH/PUT bodies.
+        oauth_params["oauth_body_hash"] = base64.b64encode(
+            hashlib.sha1(body.encode(), usedforsecurity=False).digest()
+        ).decode()
+
+    signature_params = dict(oauth_params)
+    if query_params:
+        for key, value in query_params.items():
+            if value is not None:
+                signature_params[str(key)] = str(value)
 
     sorted_params = "&".join(
         f"{urllib.parse.quote(k, safe='')}={urllib.parse.quote(v, safe='')}"
-        for k, v in sorted(params.items())
+        for k, v in sorted(signature_params.items())
     )
     base_string = (
         f"{method.upper()}&"
@@ -64,11 +77,11 @@ def _netsuite_auth_header(
         hmac.new(signing_key.encode(), base_string.encode(), hashlib.sha256).digest()
     ).decode()
 
-    params["oauth_signature"] = signature
+    oauth_params["oauth_signature"] = signature
     realm = account_id.strip().upper()
 
     header_parts = [f'realm="{urllib.parse.quote(realm, safe="")}"'] + [
-        f'{k}="{urllib.parse.quote(v, safe="")}"' for k, v in sorted(params.items())
+        f'{k}="{urllib.parse.quote(v, safe="")}"' for k, v in sorted(oauth_params.items())
     ]
     return "OAuth " + ", ".join(header_parts)
 
@@ -273,7 +286,9 @@ class NetSuiteGetAccount(Tool):
             if fields:
                 params["fields"] = fields
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(
                     url,
@@ -328,7 +343,9 @@ class NetSuiteListAccounts(Tool):
             if query:
                 params["q"] = query
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(url, headers={"Authorization": auth, "Content-Type": "application/json"}, params=params)
                 response.raise_for_status()
@@ -492,7 +509,9 @@ class NetSuiteGetAssemblyBuild(Tool):
             if fields:
                 params["fields"] = fields
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(
                     url,
@@ -547,7 +566,9 @@ class NetSuiteListAssemblyBuilds(Tool):
             if query:
                 params["q"] = query
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(url, headers={"Authorization": auth, "Content-Type": "application/json"}, params=params)
                 response.raise_for_status()
@@ -952,7 +973,9 @@ class NetSuiteGetAssemblyItem(Tool):
             if fields:
                 params["fields"] = fields
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(
                     url,
@@ -1007,7 +1030,9 @@ class NetSuiteListAssemblyItems(Tool):
             if query:
                 params["q"] = query
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(url, headers={"Authorization": auth, "Content-Type": "application/json"}, params=params)
                 response.raise_for_status()
@@ -1108,7 +1133,9 @@ class NetSuiteSuiteQL(Tool):
 
             payload = {"q": query}
             params = {"limit": min(limit, 1000), "offset": offset}
-            auth = _netsuite_auth_header("POST", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "POST", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
 
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.post(
@@ -1284,7 +1311,9 @@ class NetSuiteGetBillingAccount(Tool):
             if fields:
                 params["fields"] = fields
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(
                     url,
@@ -1339,7 +1368,9 @@ class NetSuiteListBillingAccounts(Tool):
             if query:
                 params["q"] = query
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(url, headers={"Authorization": auth, "Content-Type": "application/json"}, params=params)
                 response.raise_for_status()
@@ -1552,7 +1583,9 @@ class NetSuiteGetBillingSchedule(Tool):
             if fields:
                 params["fields"] = fields
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(
                     url,
@@ -1607,7 +1640,9 @@ class NetSuiteListBillingSchedules(Tool):
             if query:
                 params["q"] = query
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(url, headers={"Authorization": auth, "Content-Type": "application/json"}, params=params)
                 response.raise_for_status()
@@ -1916,7 +1951,9 @@ class NetSuiteGetCalendarEvent(Tool):
             if fields:
                 params["fields"] = fields
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(
                     url,
@@ -1971,7 +2008,9 @@ class NetSuiteListCalendarEvents(Tool):
             if query:
                 params["q"] = query
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(url, headers={"Authorization": auth, "Content-Type": "application/json"}, params=params)
                 response.raise_for_status()
@@ -2118,7 +2157,9 @@ class NetSuiteCustomSuiteQL(Tool):
 
             payload = {"q": query}
             params = {"limit": min(limit, 1000), "offset": offset}
-            auth = _netsuite_auth_header("POST", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "POST", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
 
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.post(
@@ -2287,7 +2328,9 @@ class NetSuiteGetIntercompanyJournalEntry(Tool):
             if fields:
                 params["fields"] = fields
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(
                     url,
@@ -2342,7 +2385,9 @@ class NetSuiteListIntercompanyJournalEntries(Tool):
             if query:
                 params["q"] = query
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(url, headers={"Authorization": auth, "Content-Type": "application/json"}, params=params)
                 response.raise_for_status()
@@ -2557,7 +2602,9 @@ class NetSuiteGetBinTransfer(Tool):
             if fields:
                 params["fields"] = fields
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(
                     url,
@@ -2612,7 +2659,9 @@ class NetSuiteListBinTransfers(Tool):
             if query:
                 params["q"] = query
 
-            auth = _netsuite_auth_header("GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret)
+            auth = _netsuite_auth_header(
+                "GET", url, account_id, consumer_key, consumer_secret, token_id, token_secret, query_params=params
+            )
             async with httpx.AsyncClient(timeout=httpx.Timeout(30.0, connect=10.0)) as client:
                 response = await client.get(url, headers={"Authorization": auth, "Content-Type": "application/json"}, params=params)
                 response.raise_for_status()

{timbal-2.2.4 → timbal-2.2.6}/python/timbal/tools/onedrive.py

@@ -127,7 +127,7 @@ class OneDriveListFiles(Tool):
 
 class OneDriveGetFile(Tool):
     name: str = "onedrive_get_file"
-    description: str | None = "Get file metadata and content by file ID from OneDrive."
+    description: str | None = "Get the content and metadata of a OneDrive file or document by id."
     integration: Annotated[str, Integration("onedrive")] | None = None
 
     def get_config(self) -> dict[str, Any]:
@@ -210,7 +210,7 @@ class OneDriveFindFile(Tool):
 
 class OneDriveDownloadFile(Tool):
     name: str = "onedrive_download_file"
-    description: str | None = "Download a file from OneDrive by file ID."
+    description: str | None = "Download a OneDrive file or document (Word, Excel, PDF, etc.) by id."
     integration: Annotated[str, Integration("onedrive")] | None = None
 
     def get_config(self) -> dict[str, Any]: