tinybird 0.0.1.dev280__py3-none-any.whl → 0.0.1.dev282__py3-none-any.whl

tinybird/tb/__cli__.py

@@ -4,5 +4,5 @@ __description__ = 'Tinybird Command Line Tool'
 __url__ = 'https://www.tinybird.co/docs/forward/commands'
 __author__ = 'Tinybird'
 __author_email__ = 'support@tinybird.co'
-__version__ = '0.0.1.dev280'
-__revision__ = 'e419ff7'
+__version__ = '0.0.1.dev282'
+__revision__ = '77eb85f'

tinybird/tb/modules/agent/agent.py

@@ -16,7 +16,7 @@ from requests import Response
 
 from tinybird.tb.check_pypi import CheckPypi
 from tinybird.tb.client import TinyB
-from tinybird.tb.config import CURRENT_VERSION
+from tinybird.tb.config import CURRENT_VERSION, get_display_cloud_host
 from tinybird.tb.modules.agent.animations import ThinkingAnimation
 from tinybird.tb.modules.agent.banner import display_banner
 from tinybird.tb.modules.agent.command_agent import CommandAgent
@@ -212,7 +212,12 @@ class TinybirdAgent:
 
         @self.agent.instructions
         def get_local_host(ctx: RunContext[TinybirdAgentContext]) -> str:
-            return f"Tinybird Local host: {ctx.deps.local_host}"
+            return f"""
+# Tinybird Local info:
+- API Host: {ctx.deps.local_host}
+- Token: {ctx.deps.local_token}
+- UI Dashboard URL: {get_display_cloud_host(ctx.deps.local_host)}/{ctx.deps.workspace_name}
+            """
 
         @self.agent.instructions
         def get_cloud_host(ctx: RunContext[TinybirdAgentContext]) -> str:
@@ -230,12 +235,14 @@ class TinybirdAgent:
 
             region_provider = region["provider"]
             region_name = region["name"]
-            return f"""Tinybird Cloud info (region details):
+            return f"""
+# Tinybird Cloud info (region details):
 - API Host: {ctx.deps.host}
 - Workspace ID: {ctx.deps.workspace_id}
 - Workspace Name: {project.workspace_name} (in Tinybird Local the workspace name is the same because it is synced with Cloud)
 - Region provider: {region_provider}
 - Region name: {region_name}
+- UI Dashboard URL: {get_display_cloud_host(ctx.deps.host)}/{ctx.deps.workspace_name}
 """
 
         @self.agent.instructions

tinybird/tb/modules/agent/models.py

@@ -1,9 +1,35 @@
 from typing import Optional
 
 from anthropic import AsyncAnthropic
-from httpx import AsyncClient
+from httpx import AsyncClient, HTTPStatusError
 from pydantic_ai.models.anthropic import AnthropicModel, AnthropicModelName
 from pydantic_ai.providers.anthropic import AnthropicProvider
+from pydantic_ai.retries import AsyncTenacityTransport, wait_retry_after
+from tenacity import AsyncRetrying, retry_if_exception_type, stop_after_attempt, wait_exponential
+
+
+def create_retrying_client(token: str, workspace_id: str):
+    """Create a client with smart retry handling for multiple error types."""
+
+    def should_retry_status(response):
+        """Raise exceptions for retryable HTTP status codes."""
+        if response.status_code in (400, 429, 502, 503, 504):
+            response.raise_for_status()  # This will raise HTTPStatusError
+
+    transport = AsyncTenacityTransport(
+        controller=AsyncRetrying(
+            # Retry on HTTP errors and connection issues
+            retry=retry_if_exception_type((HTTPStatusError, ConnectionError)),
+            # Smart waiting: respects Retry-After headers, falls back to exponential backoff
+            wait=wait_retry_after(fallback_strategy=wait_exponential(multiplier=1, max=60), max_wait=300),
+            # Stop after 5 attempts
+            stop=stop_after_attempt(5),
+            # Re-raise the last exception if all retries fail
+            reraise=True,
+        ),
+        validate_response=should_retry_status,
+    )
+    return AsyncClient(transport=transport, params={"token": token, "workspace_id": workspace_id})
 
 
 def create_model(
@@ -19,7 +45,7 @@ def create_model(
 
     client = AsyncAnthropic(
         base_url=base_url,
-        http_client=AsyncClient(params={"token": token, "workspace_id": workspace_id}),
+        http_client=create_retrying_client(token, workspace_id),
         auth_token=token,
         default_headers=default_headers,
     )

tinybird/tb/modules/agent/prompts.py

@@ -5,7 +5,6 @@ from typing import Any
 from pydantic_ai import format_as_xml
 
 from tinybird.prompts import (
-    copy_pipe_instructions,
     datasource_example,
     datasource_instructions,
     materialized_pipe_instructions,
@@ -35,6 +34,8 @@ available_commands = [
     "`tb sink ls`: List all sinks",
     "`tb workspace current`: Show the current workspace",
     "`tb workspace clear --yes`: Delete all resources in the workspace (Only available in Tinybird Local)",
+    "`tb local start --skip-new-version`: Start Tinybird Local container in non-interactive mode",
+    "`tb local restart --skip-new-version --yes`: Restart Tinybird Local container in non-interactive mode",
 ]
 
 plan_instructions = """
@@ -778,6 +779,37 @@ GCS_HMAC_SECRET {{ tb_secret("gcs_hmac_secret") }}
 ```
 """
 
+
+copy_pipe_instructions = """
+- Copy pipes should be created in the /copies folder.
+- In a .pipe file you can define how to export the result of a Pipe to a Data Source, optionally with a schedule.
+- Do not include `COPY_SCHEDULE` in the .pipe file unless is specifically requested by the user.
+- `COPY_SCHEDULE` is a cron expression that defines the schedule of the copy pipe.
+- `COPY_SCHEDULE` is optional and if not provided, the copy pipe will be executed only once.
+- `TARGET_DATASOURCE` is the name of the Data Source to export the result to.
+- `TYPE COPY` is the type of the pipe and it is mandatory for copy pipes.
+- If the copy pipe uses parameters, you must include the `%` character and a newline on top of every query to be able to use the parameters.
+- The content of the .pipe file must follow this format:
+
+<copy_pipe_example>
+DESCRIPTION Copy Pipe to export sales hour every hour to the sales_hour_copy Data Source
+
+NODE daily_sales
+SQL >
+    %
+    SELECT toStartOfDay(starting_date) day, country, sum(sales) as total_sales
+    FROM teams
+    WHERE
+    day BETWEEN toStartOfDay(now()) - interval 1 day AND toStartOfDay(now())
+    and country = {{ String(country, 'US')}}
+    GROUP BY day, country
+
+TYPE COPY
+TARGET_DATASOURCE sales_hour_copy
+COPY_SCHEDULE 0 * * * *
+</copy_pipe_example>
+"""
+
 agent_system_prompt = f"""
 You are a Tinybird Code, an agentic CLI that can help users to work with Tinybird.
 
@@ -867,6 +899,18 @@ where <scope> is one of the following: `TOKENS`, `ADMIN`, `ORG_DATASOURCES:READ`
 {sink_pipe_instructions}
 
 # Working with copy pipe files:
+
+## What are copy pipes?
+Copy pipes capture the result of a pipe at a moment in time and write the result into a target data source. 
+They can be run on a schedule, or executed on demand.
+
+## Use copy pipes for:
+- Event-sourced snapshots, such as change data capture (CDC).
+- Copy data from Tinybird to another location in Tinybird to experiment.
+- De-duplicate with snapshots.
+- Copy pipes should not be confused with materialized views. While materialized views continuously update as new events are inserted, copy pipes generate a single snapshot at a specific point in time.
+
+## Copy pipe instructions
 {copy_pipe_instructions}
 
 # Working with SQL queries:
@@ -913,6 +957,10 @@ where <scope> is one of the following: `TOKENS`, `ADMIN`, `ORG_DATASOURCES:READ`
 # When asked about the files in the project:
 - You can rely in your own context to answer the question.
 
+# When you need to copy/export data from the selected environment to a local file:
+- Use `explore_data` tool to export data from the selected environment to a local file.
+- Copy pipes do not copy data between environments, they are only used to copy data between data sources in the same environment.
+
 # Info
 Today is {datetime.now().strftime("%Y-%m-%d")}
 """

tinybird/tb/modules/local.py

@@ -119,7 +119,13 @@ def remove() -> None:
     default=None,
     help="Path to the volumes directory. If not provided, the container data won't be persisted.",
 )
-def start(use_aws_creds: bool, volumes_path: str) -> None:
+@click.option(
+    "--skip-new-version",
+    default=False,
+    is_flag=True,
+    help="Skip pulling the latest Tinybird Local image. Use directly your current local image.",
+)
+def start(use_aws_creds: bool, volumes_path: str, skip_new_version: bool) -> None:
     """Start Tinybird Local"""
     if volumes_path is not None:
         absolute_path = Path(volumes_path).absolute()
@@ -128,7 +134,7 @@ def start(use_aws_creds: bool, volumes_path: str) -> None:
 
     click.echo(FeedbackManager.highlight(message="» Starting Tinybird Local..."))
     docker_client = get_docker_client()
-    start_tinybird_local(docker_client, use_aws_creds, volumes_path)
+    start_tinybird_local(docker_client, use_aws_creds, volumes_path, skip_new_version)
     click.echo(FeedbackManager.success(message="✓ Tinybird Local is ready!"))
 
 
@@ -144,7 +150,19 @@ def start(use_aws_creds: bool, volumes_path: str) -> None:
     default=None,
     help="Path to the volumes directory. If not provided, the container data won't be persisted.",
 )
-def restart(use_aws_creds: bool, volumes_path: str) -> None:
+@click.option(
+    "--skip-new-version",
+    default=False,
+    is_flag=True,
+    help="Skip pulling the latest Tinybird Local image. Use directly your current local image.",
+)
+@click.option(
+    "--yes",
+    default=False,
+    is_flag=True,
+    help="Skip the confirmation prompt. If provided, the container will be restarted without asking for confirmation.",
+)
+def restart(use_aws_creds: bool, volumes_path: str, skip_new_version: bool, yes: bool) -> None:
     """Restart Tinybird Local"""
     if volumes_path is not None:
         absolute_path = Path(volumes_path).absolute()
@@ -153,9 +171,10 @@ def restart(use_aws_creds: bool, volumes_path: str) -> None:
 
     click.echo(FeedbackManager.highlight(message="» Restarting Tinybird Local..."))
     docker_client = get_docker_client()
-    remove_tinybird_local(docker_client, volumes_path is not None)
+    persist_data = volumes_path is not None or yes
+    remove_tinybird_local(docker_client, persist_data)
     click.echo(FeedbackManager.info(message="✓ Tinybird Local stopped"))
-    start_tinybird_local(docker_client, use_aws_creds, volumes_path)
+    start_tinybird_local(docker_client, use_aws_creds, volumes_path, skip_new_version)
     click.echo(FeedbackManager.success(message="✓ Tinybird Local is ready!"))
 
 

tinybird/tb/modules/local_common.py

@@ -220,29 +220,32 @@ def start_tinybird_local(
     docker_client: DockerClient,
     use_aws_creds: bool,
     volumes_path: Optional[str] = None,
+    skip_new_version: bool = False,
 ) -> None:
     """Start the Tinybird container."""
     pull_show_prompt = False
     pull_required = False
-    try:
-        local_image = docker_client.images.get(TB_IMAGE_NAME)
-        local_image_id = local_image.attrs["RepoDigests"][0].split("@")[1]
-        remote_image = docker_client.images.get_registry_data(TB_IMAGE_NAME)
-        pull_show_prompt = local_image_id != remote_image.id
-    except Exception:
-        pull_show_prompt = False
-        pull_required = True
-
-    if pull_show_prompt and click.confirm(
-        FeedbackManager.warning(message="△ New version detected, download? [y/N]:"),
-        show_default=False,
-        prompt_suffix="",
-    ):
-        click.echo(FeedbackManager.info(message="* Downloading latest version of Tinybird Local..."))
-        pull_required = True
-
-    if pull_required:
-        docker_client.images.pull(TB_IMAGE_NAME, platform="linux/amd64")
+
+    if not skip_new_version:
+        try:
+            local_image = docker_client.images.get(TB_IMAGE_NAME)
+            local_image_id = local_image.attrs["RepoDigests"][0].split("@")[1]
+            remote_image = docker_client.images.get_registry_data(TB_IMAGE_NAME)
+            pull_show_prompt = local_image_id != remote_image.id
+        except Exception:
+            pull_show_prompt = False
+            pull_required = True
+
+        if pull_show_prompt and click.confirm(
+            FeedbackManager.warning(message="△ New version detected, download? [y/N]:"),
+            show_default=False,
+            prompt_suffix="",
+        ):
+            click.echo(FeedbackManager.info(message="* Downloading latest version of Tinybird Local..."))
+            pull_required = True
+
+        if pull_required:
+            docker_client.images.pull(TB_IMAGE_NAME, platform="linux/amd64")
 
     environment = get_use_aws_creds() if use_aws_creds else {}
 

tinybird/tb/modules/login_common.py

@@ -257,19 +257,31 @@ def open_url(url: str, *, new_tab: bool = False) -> bool:
 
     # 2. Inside WSL, prefer `wslview` if the user has it (wslu package).
     if _running_in_wsl() and shutil.which("wslview"):
-        subprocess.Popen(["wslview", url])
-        return True
+        try:
+            subprocess.Popen(["wslview", url])
+            return True
+        except Exception:
+            # wslview not found, continue to next fallback
+            pass
 
     # 3. Secondary WSL fallback use Windows **start** through cmd.exe.
     #    Empty "" argument is required so long URLs are not treated as a window title.
     if _running_in_wsl():
-        subprocess.Popen(["cmd.exe", "/c", "start", "", url])
-        return True
+        try:
+            subprocess.Popen(["cmd.exe", "/c", "start", "", url])
+            return True
+        except Exception:
+            # cmd.exe not found, continue to next fallback
+            pass
 
     # 4. Unix last-ditch fallback xdg-open (most minimal container images have it)
     if shutil.which("xdg-open"):
-        subprocess.Popen(["xdg-open", url])
-        return True
+        try:
+            subprocess.Popen(["xdg-open", url])
+            return True
+        except Exception:
+            # xdg-open not found, continue to next fallback
+            pass
 
     # 5. If everything failed, let the caller know.
     return False

{tinybird-0.0.1.dev280.dist-info → tinybird-0.0.1.dev282.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: tinybird
-Version: 0.0.1.dev280
+Version: 0.0.1.dev282
 Summary: Tinybird Command Line Tool
 Home-page: https://www.tinybird.co/docs/forward/commands
 Author: Tinybird
@@ -22,7 +22,8 @@ Requires-Dist: humanfriendly~=8.2
 Requires-Dist: plotext==5.3.2
 Requires-Dist: prompt_toolkit==3.0.48
 Requires-Dist: pydantic~=2.11.7
-Requires-Dist: pydantic-ai-slim[anthropic]~=0.4.2
+Requires-Dist: pydantic-ai-slim[anthropic]~=0.5.0
+Requires-Dist: pydantic-ai-slim[retries]~=0.5.0
 Requires-Dist: pyperclip==1.8.2
 Requires-Dist: pyyaml<6.1,>=6.0
 Requires-Dist: requests<3,>=2.28.1

{tinybird-0.0.1.dev280.dist-info → tinybird-0.0.1.dev282.dist-info}/RECORD

@@ -17,7 +17,7 @@ tinybird/datafile/exceptions.py,sha256=8rw2umdZjtby85QbuRKFO5ETz_eRHwUY5l7eHsy1w
 tinybird/datafile/parse_connection.py,sha256=tRyn2Rpr1TeWet5BXmMoQgaotbGdYep1qiTak_OqC5E,1825
 tinybird/datafile/parse_datasource.py,sha256=ssW8QeFSgglVFi3sDZj_HgkJiTJ2069v2JgqnH3CkDE,1825
 tinybird/datafile/parse_pipe.py,sha256=xf4m0Tw44QWJzHzAm7Z7FwUoUUtr7noMYjU1NiWnX0k,3880
-tinybird/tb/__cli__.py,sha256=Np8R1vyZCw8RP4hNX8uKd29Sq7xRKM_5NOXdcYnx258,247
+tinybird/tb/__cli__.py,sha256=fmFyVdes693OS-QP_zm9KaWfwKBNHpRdThEjryzzN7s,247
 tinybird/tb/check_pypi.py,sha256=Gp0HkHHDFMSDL6nxKlOY51z7z1Uv-2LRexNTZSHHGmM,552
 tinybird/tb/cli.py,sha256=FdDFEIayjmsZEVsVSSvRiVYn_FHOVg_zWQzchnzfWho,1008
 tinybird/tb/client.py,sha256=IQRaInDjOwr9Fzaz3_xXc3aUGqh94tM2lew7IZbB9eM,53733
@@ -44,10 +44,10 @@ tinybird/tb/modules/infra.py,sha256=JE9oLIyF4bi_JBoe-BgZ5HhKp_lQgSihuSV1KIS02Qs,
 tinybird/tb/modules/job.py,sha256=wBsnu8UPTOha2rkLvucgmw4xYv73ubmui3eeSIF68ZM,3107
 tinybird/tb/modules/llm.py,sha256=fPBBCmM3KlCksLlgJkg4joDn6y3H5QjDzE-Pm4YNf7E,1782
 tinybird/tb/modules/llm_utils.py,sha256=nS9r4FAElJw8yXtmdYrx-rtI2zXR8qXfi1QqUDCfxvg,3469
-tinybird/tb/modules/local.py,sha256=L6YWHgzILAwe9s1ZqnP1usjgI1u-Hs9KzxnB5JCdwC0,5837
-tinybird/tb/modules/local_common.py,sha256=8cnBh3eoHRV6Ze7Rg9bueF3Zb_wYDe54bm5cGRvrwbY,17596
+tinybird/tb/modules/local.py,sha256=kW3IHwJPvhBsa1eMh_xzow9Az3yYpHthkzsLSHeP5HE,6512
+tinybird/tb/modules/local_common.py,sha256=mFhidxVeGnDA_UHss-bRY8_UzU0V5iZ3HGnVqlnMzY0,17730
 tinybird/tb/modules/login.py,sha256=zerXZqIv15pbFk5XRt746xGcVnp01YmL_403byBf4jQ,1245
-tinybird/tb/modules/login_common.py,sha256=IfthYbHmC7EtsCXCB1iF4TngPOwfaHJ6Dfi_t7oBXnI,11640
+tinybird/tb/modules/login_common.py,sha256=CKXD_BjivhGUmBtNbLTJwzQDr6885C72XPZjo0GLLvI,12010
 tinybird/tb/modules/logout.py,sha256=sniI4JNxpTrVeRCp0oGJuQ3yRerG4hH5uz6oBmjv724,1009
 tinybird/tb/modules/materialization.py,sha256=8fdbTTxFSk0Sjet3pcEk_x-cs4RGpgl6toN8vrMLXJE,5630
 tinybird/tb/modules/mock.py,sha256=ET8sRpmXnQsd2sSJXH_KCdREU1_XQgkORru6T357Akc,3260
@@ -69,15 +69,15 @@ tinybird/tb/modules/watch.py,sha256=No0bK1M1_3CYuMaIgylxf7vYFJ72lTJe3brz6xQ-mJo,
 tinybird/tb/modules/workspace.py,sha256=USsG8YEXlwf7F2PjTMCuQ2lB8ya-erbv8VywNJYq6mc,11173
 tinybird/tb/modules/workspace_members.py,sha256=5JdkJgfuEwbq-t6vxkBhYwgsiTDxF790wsa6Xfif9nk,8608
 tinybird/tb/modules/agent/__init__.py,sha256=i3oe3vDIWWPaicdCM0zs7D7BJ1W0k7th93ooskHAV00,54
-tinybird/tb/modules/agent/agent.py,sha256=g5jsJ_HHbfR5rn9AoNJdKdkk3fE_2vqBp0kSNMlG46w,33671
+tinybird/tb/modules/agent/agent.py,sha256=TWaYS5od0ns0XKu9UKURdzSmDKxQk-Dm0oxLO8PtLic,33940
 tinybird/tb/modules/agent/animations.py,sha256=4WOC5_2BracttmMCrV0H91tXfWcUzQHBUaIJc5FA7tE,3490
 tinybird/tb/modules/agent/banner.py,sha256=l6cO5Fi7lbVKp-GsBP8jf3IkjOWxg2jpAt9NBCy0WR8,4085
 tinybird/tb/modules/agent/command_agent.py,sha256=Wcdtmo7vJZ5EbBFW9J7zPCME0ShG_KqF6-qHmMB1XXk,3103
 tinybird/tb/modules/agent/compactor.py,sha256=BK5AxZFhrp3xWnsRnYaleiYoIWtVNc-_m650Hsopt8g,13841
 tinybird/tb/modules/agent/explore_agent.py,sha256=HkzKmggfSMz7S3RSeKnZXufq-z_U0tTQJpF7JfNIaGQ,3504
 tinybird/tb/modules/agent/memory.py,sha256=vBewB_64L_wHoT4tLT6UX2uxcHwSY880QZ26F9rPqXs,3793
-tinybird/tb/modules/agent/models.py,sha256=IAxqlnHy8c2OeSnDrrSp2Mg38W9_r0GsDM87Wv-YNfM,925
-tinybird/tb/modules/agent/prompts.py,sha256=TSzfK255Y6oBSOgy10hVU8TxalhJVcopT27hD4gELQU,37575
+tinybird/tb/modules/agent/models.py,sha256=eokO8XlY-kVJOsbqiVporGUAOCyKAXCO5xgTEK9SM6Y,2208
+tinybird/tb/modules/agent/prompts.py,sha256=kc_47G9iEyf2p7_C-71Fa5JEwyH2RSYc4vzBHCc1JKE,39971
 tinybird/tb/modules/agent/testing_agent.py,sha256=AtwtJViH7805i7djyBgDb7SSUtDyJnw0TWJu6lBFsrg,2953
 tinybird/tb/modules/agent/utils.py,sha256=4jsQCAH2zBx13w20DOBrrDnQq9n2rKG9sGhBkJYiPzs,31744
 tinybird/tb/modules/agent/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -117,8 +117,8 @@ tinybird/tb_cli_modules/config.py,sha256=IsgdtFRnUrkY8-Zo32lmk6O7u3bHie1QCxLwgp4
 tinybird/tb_cli_modules/exceptions.py,sha256=pmucP4kTF4irIt7dXiG-FcnI-o3mvDusPmch1L8RCWk,3367
 tinybird/tb_cli_modules/regions.py,sha256=QjsL5H6Kg-qr0aYVLrvb1STeJ5Sx_sjvbOYO0LrEGMk,166
 tinybird/tb_cli_modules/telemetry.py,sha256=Hh2Io8ZPROSunbOLuMvuIFU4TqwWPmQTqal4WS09K1A,10449
-tinybird-0.0.1.dev280.dist-info/METADATA,sha256=-f88Tb0lj6EhwYrZtnTE2YqLF3u_g_G0KNu2IW8KwqY,1763
-tinybird-0.0.1.dev280.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-tinybird-0.0.1.dev280.dist-info/entry_points.txt,sha256=LwdHU6TfKx4Qs7BqqtaczEZbImgU7Abe9Lp920zb_fo,43
-tinybird-0.0.1.dev280.dist-info/top_level.txt,sha256=VqqqEmkAy7UNaD8-V51FCoMMWXjLUlR0IstvK7tJYVY,54
-tinybird-0.0.1.dev280.dist-info/RECORD,,
+tinybird-0.0.1.dev282.dist-info/METADATA,sha256=zMcjvggtB0gbH4I8m8x4OSImErFK4X55gmDX2R7i9Y8,1811
+tinybird-0.0.1.dev282.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+tinybird-0.0.1.dev282.dist-info/entry_points.txt,sha256=LwdHU6TfKx4Qs7BqqtaczEZbImgU7Abe9Lp920zb_fo,43
+tinybird-0.0.1.dev282.dist-info/top_level.txt,sha256=VqqqEmkAy7UNaD8-V51FCoMMWXjLUlR0IstvK7tJYVY,54
+tinybird-0.0.1.dev282.dist-info/RECORD,,