Merge pull request #125 from tower/develop

v0.3.33 release

Author: bradhe

.github/workflows/build-binaries.yml

@@ -254,7 +254,7 @@ jobs:
           githubToken: ${{ github.token }}
           install: |
             apt-get update
-            apt-get install -y --no-install-recommends python3 python3-pip python3-venv python3-dev cargo
+            apt-get install -y --no-install-recommends python3 python3-pip python3-venv python3-dev cargo libffi-dev
             pip3 install -U pip
           # Create and use a virtual environment to avoid the externally-managed-environment error
           run: |

.github/workflows/test-python.yml

@@ -38,5 +38,8 @@ jobs:
       - name: Check Python formatting with Black
         run: uv run --group dev black --check --diff .
 
+      - name: Check types with mypy
+        run: uv run --group dev mypy src/tower/__init__.py --no-error-summary
+
       - name: Run tests
         run: uv run pytest tests

.gitignore

@@ -19,3 +19,8 @@ pytest.ini
 /scripts/openapi-generator-cli-*.jar
 
 .idea
+
+.DS_Store
+
+# from nix builds
+/result

Cargo.lock

@@ -4,7 +4,7 @@ resolver = "2"
 
 [workspace.package]
 edition = "2021"
-version = "0.3.32"
+version = "0.3.33"
 
 
 

Cargo.toml

@@ -122,9 +122,39 @@ pip install "tower[iceberg]"
 ```
 
 Provides Apache Iceberg table support:
-
 - `tower.create_table`: Create Iceberg tables
 - `tower.load_table`: Load data from Iceberg tables
+- `tower.tables`: Access Iceberg table functionality
+
+#### dbt Core Support
+
+```bash
+pip install "tower[dbt]"
+```
+
+Provides dbt Core integration for running dbt workflows:
+
+```python
+import tower
+
+# Configure and run a dbt workflow
+workflow = tower.dbt(
+    project_path="path/to/dbt_project",
+    profile_payload=tower.dbt.load_profile_from_env("DBT_PROFILE_YAML"),
+    commands="deps,seed,build",
+)
+
+results = workflow.run()
+```
+
+Available helper functions and classes:
+- `tower.dbt.load_profile_from_env()`: Load dbt profile from environment variables
+- `tower.dbt.parse_command_plan()`: Parse comma-separated commands into a command plan
+- `tower.dbt.DbtCommand`: Represents a dbt CLI command invocation
+- `tower.dbt.DbtRunnerConfig`: Low-level configuration class
+- `tower.dbt.run_dbt_workflow()`: Low-level execution function
+
+For a complete example, see the [dbt Core Ecommerce Analytics app](https://github.com/tower/tower-examples/tree/main/14-dbt-core-ecommerce-analytics).
 
 #### Install All Optional Features
 
@@ -151,6 +181,17 @@ print(tower.is_feature_enabled("ai"))
 
 Tower CLI includes an MCP (Model Context Protocol) server that allows AI assistants and editors to interact with your Tower account directly. The MCP server provides tools for managing apps, secrets, teams, and deployments.
 
+#### Prerequisites
+
+Before using the MCP server, ensure you're logged into Tower:
+
+```bash
+tower login
+```
+
+The MCP server will use your existing Tower CLI authentication and configuration.
+
+
 #### Available Tools
 
 The MCP server exposes the following tools:
@@ -186,7 +227,15 @@ The server will display a message showing the URL it's running on:
 SSE server running on http://127.0.0.1:34567
 ```
 
-#### Editor Configuration
+It's important to keep the terminal with the MCP server open until you're finished. Alternatively, you can launch it in the background with:
+
+``` bash
+tower mcp-server &
+```
+
+It's also important to be logged in. If you haven't already, you can open another terminal window and type `tower login` in order to open the login in a browser window.
+
+#### Client Configuration
 
 ##### Claude Code
 
@@ -196,7 +245,7 @@ Add the Tower MCP server to Claude Code using SSE transport:
 claude mcp add tower http://127.0.0.1:34567/sse --transport sse
 ```
 
-Or using JSON configuration with SSE:
+Or with the JSON configuration directly:
 
 ```json
 {
@@ -213,78 +262,61 @@ For custom ports, adjust the URL accordingly (e.g., `http://127.0.0.1:8080/sse`)
 
 ##### Cursor
 
-Add this to your Cursor settings (`settings.json`):
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=tower&config=eyJ1cmwiOiJodHRwOi8vMTI3LjAuMC4xOjM0NTY3L3NzZSJ9)
+
+If that doesn't work, try opening the following link in your browser or in your terminal with `open` on macOS, or `xdg-open` on Linux: 
+```
+cursor://anysphere.cursor-deeplink/mcp/install?name=tower&config=eyJ1cmwiOiJodHRwOi8vMTI3LjAuMC4xOjM0NTY3L3NzZSJ9
+```
+
+Or manually, add this to your Cursor MCP settings (`mcp.json`):
 
 ```json
 {
-  "mcp.servers": {
+  "mcpServers": {
     "tower": {
-      "url": "http://127.0.0.1:34567/sse",
-      "transport": "sse"
+      "url": "http://127.0.0.1:34567/sse"
     }
   }
 }
 ```
 
-##### Windsurf
+##### VS Code
 
-Configure in Windsurf settings:
+In VS Code, first you should enable MCP integrations by setting `Chat>MCP:Enabled` to true in your settings.
 
-```json
-{
-  "mcp": {
-    "servers": {
-      "tower": {
-        "url": "http://127.0.0.1:34567/sse",
-        "transport": "sse"
-      }
-    }
-  }
-}
+For adding the server, you can try copying and pasting the following link into your URL bar:
+```
+vscode:mcp/install?%7B%22name%22%3A%22tower%22%2C%22type%22%3A%22sse%22%2C%22url%22%3A%22http%3A%2F%2F127.0.0.1%3A34567%2Fsse%22%7D
 ```
 
-##### Zed
-
-Add to your Zed `settings.json`:
+Alternatively, you can add the following to your `mcp.json`:
 
 ```json
 {
-  "assistant": {
-    "mcp_servers": {
-      "tower": {
-        "url": "http://127.0.0.1:34567/sse",
-        "transport": "sse"
-      }
+  "servers": {
+    "tower": {
+      "type": "sse",
+      "url": "http://127.0.0.1:34567/sse"
     }
   }
 }
 ```
 
-##### VS Code
+##### Gemini CLI
 
-For VS Code with MCP extensions, add to your `settings.json`:
+In your `settings.json`, add the following:
 
-```json
+``` json
 {
-  "mcp.servers": {
+  "mcpServers": {
     "tower": {
-      "url": "http://127.0.0.1:34567/sse",
-      "transport": "sse"
+        "url": "http://127.0.0.1:34567/sse"
     }
   }
 }
 ```
 
-#### Prerequisites
-
-Before using the MCP server, ensure you're logged into Tower:
-
-```bash
-tower login
-```
-
-The MCP server will use your existing Tower CLI authentication and configuration.
-
 ### About the runtime environment
 
 The [tower-runtime](crates/tower-runtime) crate has the Rust library that makes

README.md

@@ -33,7 +33,7 @@ tower-runtime = { workspace = true }
 tower-telemetry = { workspace = true }
 tower-version = { path = "../tower-version" }
 webbrowser = { workspace = true }
-rmcp = { version = "0.5.0", features = ["server", "transport-io", "schemars", "transport-sse-server"] }
+rmcp = { version = "0.5.0", features = ["server", "transport-io", "schemars", "transport-sse-server", "transport-streamable-http-server"] }
 schemars = "1.0"
 toml = { workspace = true }
 toml_edit = { workspace = true }

crates/tower-cmd/Cargo.toml

@@ -3,7 +3,7 @@ use config::Config;
 
 use tower_api::models::Run;
 
-use crate::{api, output, util::dates};
+use crate::{api, output};
 
 pub fn apps_cmd() -> Command {
     Command::new("apps")
@@ -51,8 +51,7 @@ pub async fn do_logs(config: Config, cmd: &ArgMatches) {
 
     if let Ok(resp) = api::describe_run_logs(&config, &name, seq).await {
         for line in resp.log_lines {
-            let ts = dates::format_str(&line.reported_at);
-            output::log_line(&ts, &line.content, output::LogLineType::Remote);
+            output::remote_log_event(&line);
         }
     }
 }
@@ -62,7 +61,7 @@ pub async fn do_show(config: Config, cmd: &ArgMatches) {
 
     match api::describe_app(&config, &name).await {
         Ok(app_response) => {
-            if output::is_json_mode_set() {
+            if output::get_output_mode().is_json() {
                 output::json(&app_response);
                 return;
             }

crates/tower-cmd/src/apps.rs

@@ -63,7 +63,7 @@ impl App {
         };
 
         if config.json {
-            output::set_json_mode();
+            output::set_output_mode(output::OutputMode::Json);
         }
 
         if config.debug {