ascend-tools 0.2.0__tar.gz

ascend_tools-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ascend Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ascend_tools-0.2.0/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: ascend-tools
+Version: 0.2.0
+License-File: LICENSE
+Summary: Ascend CLI, SDK, MCP.
+Home-Page: https://github.com/ascend-io/ascend-tools
+Author-email: Cody <cody.peterson@ascend.io>
+License-Expression: MIT
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/ascend-io/ascend-tools
+Project-URL: Repository, https://github.com/ascend-io/ascend-tools
+
+# ascend-tools
+
+CLI, SDK, and MCP server for the Ascend REST API.
+
+> Private preview: `ascend-tools` is currently in private preview. Contact your Ascend representative to request access via Service Accounts on your Instance.
+
+## Install
+
+Pre-built binaries are available for Linux and macOS. Windows users should use Linux/macOS.
+
+```bash
+uv tool install ascend-tools
+```
+
+## Authentication
+
+Set three environment variables (from Ascend UI > Settings > Users > Create Service Account):
+
+```bash
+export ASCEND_SERVICE_ACCOUNT_ID="asc-sa-..."
+export ASCEND_SERVICE_ACCOUNT_KEY="..."
+export ASCEND_INSTANCE_API_URL="https://<instance-name>.api.instance.ascend.io"
+```
+
+## CLI
+
+List runtimes:
+
+```bash
+ascend-tools runtime list
+```
+
+Get a runtime:
+
+```bash
+ascend-tools runtime get <UUID>
+```
+
+Resume a runtime:
+
+```bash
+ascend-tools runtime resume <UUID>
+```
+
+Pause a runtime:
+
+```bash
+ascend-tools runtime pause <UUID>
+```
+
+List flows:
+
+```bash
+ascend-tools flow list --runtime <UUID>
+```
+
+Run a flow:
+
+```bash
+ascend-tools flow run <FLOW_NAME> --runtime <UUID>
+```
+
+Run a flow and resume the runtime first if paused:
+
+```bash
+ascend-tools flow run <FLOW_NAME> --runtime <UUID> --resume
+```
+
+Run a flow with full refresh:
+
+```bash
+ascend-tools flow run <FLOW_NAME> --runtime <UUID> --spec '{"full_refresh": true}'
+```
+
+List flow runs:
+
+```bash
+ascend-tools flow list-runs --runtime <UUID>
+```
+
+Get a flow run:
+
+```bash
+ascend-tools flow get-run <RUN_NAME> --runtime <UUID>
+```
+
+JSON output:
+
+```bash
+ascend-tools -o json runtime list
+```
+
+## Python SDK
+
+```python
+from ascend_tools import Client
+
+client = Client()  # reads from env vars
+client.list_runtimes()
+client.run_flow(runtime_uuid="...", flow_name="sales")
+```
+
+## MCP server
+
+Start an MCP server for AI assistants (Claude Code, Claude Desktop, Cursor, etc.).
+
+Stdio transport (default):
+
+```bash
+ascend-tools mcp
+```
+
+HTTP transport:
+
+```bash
+ascend-tools mcp --http --bind 127.0.0.1:8000
+```
+
+### Claude Code setup
+
+```bash
+claude mcp add --transport stdio ascend-tools -- uvx --from ./ascend-tools ascend-tools mcp
+```
+
+The Ascend auth env vars are inherited from your shell. Verify with `/mcp` inside Claude Code.
+If Claude is launched without your shell env, add vars explicitly:
+
+```bash
+claude mcp add --transport stdio \
+  -e ASCEND_SERVICE_ACCOUNT_ID="$ASCEND_SERVICE_ACCOUNT_ID" \
+  -e ASCEND_SERVICE_ACCOUNT_KEY="$ASCEND_SERVICE_ACCOUNT_KEY" \
+  -e ASCEND_INSTANCE_API_URL="$ASCEND_INSTANCE_API_URL" \
+  ascend-tools -- uvx --from ./ascend-tools ascend-tools mcp
+```
+
+### Codex CLI setup
+
+```bash
+codex mcp add ascend-tools -- uvx --from "$(pwd)" ascend-tools mcp
+```
+
+If Codex is launched without your shell env, add vars explicitly:
+
+```bash
+codex mcp add \
+  --env "ASCEND_SERVICE_ACCOUNT_ID=$ASCEND_SERVICE_ACCOUNT_ID" \
+  --env "ASCEND_SERVICE_ACCOUNT_KEY=$ASCEND_SERVICE_ACCOUNT_KEY" \
+  --env "ASCEND_INSTANCE_API_URL=$ASCEND_INSTANCE_API_URL" \
+  ascend-tools -- uvx --from "$(pwd)" ascend-tools mcp
+```
+
+Inspect the MCP server config:
+
+```bash
+codex mcp get ascend-tools --json
+```
+
+List all configured MCP servers:
+
+```bash
+codex mcp list
+```
+
+Remove the config:
+
+```bash
+codex mcp remove ascend-tools
+```
+
+The Ascend auth env vars are inherited from your shell when Codex launches the server.
+If you have stale MCP behavior after updating code, run this once to refresh the uvx cache:
+
+```bash
+uvx --refresh --from "$(pwd)" ascend-tools --version
+```
+
+### Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_runtimes` | List runtimes with optional filters |
+| `get_runtime` | Get a runtime by UUID |
+| `resume_runtime` | Resume a paused runtime |
+| `pause_runtime` | Pause a running runtime |
+| `list_flows` | List flows in a runtime |
+| `run_flow` | Trigger a flow run (supports resume, full_refresh, components, parameters, etc.) |
+| `list_flow_runs` | List flow runs with filters |
+| `get_flow_run` | Get a flow run by name |
+

ascend_tools-0.2.0/README.md

@@ -0,0 +1,188 @@
+# ascend-tools
+
+CLI, SDK, and MCP server for the Ascend REST API.
+
+> Private preview: `ascend-tools` is currently in private preview. Contact your Ascend representative to request access via Service Accounts on your Instance.
+
+## Install
+
+Pre-built binaries are available for Linux and macOS. Windows users should use Linux/macOS.
+
+```bash
+uv tool install ascend-tools
+```
+
+## Authentication
+
+Set three environment variables (from Ascend UI > Settings > Users > Create Service Account):
+
+```bash
+export ASCEND_SERVICE_ACCOUNT_ID="asc-sa-..."
+export ASCEND_SERVICE_ACCOUNT_KEY="..."
+export ASCEND_INSTANCE_API_URL="https://<instance-name>.api.instance.ascend.io"
+```
+
+## CLI
+
+List runtimes:
+
+```bash
+ascend-tools runtime list
+```
+
+Get a runtime:
+
+```bash
+ascend-tools runtime get <UUID>
+```
+
+Resume a runtime:
+
+```bash
+ascend-tools runtime resume <UUID>
+```
+
+Pause a runtime:
+
+```bash
+ascend-tools runtime pause <UUID>
+```
+
+List flows:
+
+```bash
+ascend-tools flow list --runtime <UUID>
+```
+
+Run a flow:
+
+```bash
+ascend-tools flow run <FLOW_NAME> --runtime <UUID>
+```
+
+Run a flow and resume the runtime first if paused:
+
+```bash
+ascend-tools flow run <FLOW_NAME> --runtime <UUID> --resume
+```
+
+Run a flow with full refresh:
+
+```bash
+ascend-tools flow run <FLOW_NAME> --runtime <UUID> --spec '{"full_refresh": true}'
+```
+
+List flow runs:
+
+```bash
+ascend-tools flow list-runs --runtime <UUID>
+```
+
+Get a flow run:
+
+```bash
+ascend-tools flow get-run <RUN_NAME> --runtime <UUID>
+```
+
+JSON output:
+
+```bash
+ascend-tools -o json runtime list
+```
+
+## Python SDK
+
+```python
+from ascend_tools import Client
+
+client = Client()  # reads from env vars
+client.list_runtimes()
+client.run_flow(runtime_uuid="...", flow_name="sales")
+```
+
+## MCP server
+
+Start an MCP server for AI assistants (Claude Code, Claude Desktop, Cursor, etc.).
+
+Stdio transport (default):
+
+```bash
+ascend-tools mcp
+```
+
+HTTP transport:
+
+```bash
+ascend-tools mcp --http --bind 127.0.0.1:8000
+```
+
+### Claude Code setup
+
+```bash
+claude mcp add --transport stdio ascend-tools -- uvx --from ./ascend-tools ascend-tools mcp
+```
+
+The Ascend auth env vars are inherited from your shell. Verify with `/mcp` inside Claude Code.
+If Claude is launched without your shell env, add vars explicitly:
+
+```bash
+claude mcp add --transport stdio \
+  -e ASCEND_SERVICE_ACCOUNT_ID="$ASCEND_SERVICE_ACCOUNT_ID" \
+  -e ASCEND_SERVICE_ACCOUNT_KEY="$ASCEND_SERVICE_ACCOUNT_KEY" \
+  -e ASCEND_INSTANCE_API_URL="$ASCEND_INSTANCE_API_URL" \
+  ascend-tools -- uvx --from ./ascend-tools ascend-tools mcp
+```
+
+### Codex CLI setup
+
+```bash
+codex mcp add ascend-tools -- uvx --from "$(pwd)" ascend-tools mcp
+```
+
+If Codex is launched without your shell env, add vars explicitly:
+
+```bash
+codex mcp add \
+  --env "ASCEND_SERVICE_ACCOUNT_ID=$ASCEND_SERVICE_ACCOUNT_ID" \
+  --env "ASCEND_SERVICE_ACCOUNT_KEY=$ASCEND_SERVICE_ACCOUNT_KEY" \
+  --env "ASCEND_INSTANCE_API_URL=$ASCEND_INSTANCE_API_URL" \
+  ascend-tools -- uvx --from "$(pwd)" ascend-tools mcp
+```
+
+Inspect the MCP server config:
+
+```bash
+codex mcp get ascend-tools --json
+```
+
+List all configured MCP servers:
+
+```bash
+codex mcp list
+```
+
+Remove the config:
+
+```bash
+codex mcp remove ascend-tools
+```
+
+The Ascend auth env vars are inherited from your shell when Codex launches the server.
+If you have stale MCP behavior after updating code, run this once to refresh the uvx cache:
+
+```bash
+uvx --refresh --from "$(pwd)" ascend-tools --version
+```
+
+### Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_runtimes` | List runtimes with optional filters |
+| `get_runtime` | Get a runtime by UUID |
+| `resume_runtime` | Resume a paused runtime |
+| `pause_runtime` | Pause a running runtime |
+| `list_flows` | List flows in a runtime |
+| `run_flow` | Trigger a flow run (supports resume, full_refresh, components, parameters, etc.) |
+| `list_flow_runs` | List flow runs with filters |
+| `get_flow_run` | Get a flow run by name |

ascend_tools-0.2.0/pyproject.toml

@@ -0,0 +1,44 @@
+[project]
+name = "ascend-tools"
+version = "0.2.0"
+description = "Ascend CLI, SDK, MCP."
+requires-python = ">=3.13"
+license = "MIT"
+authors = [{ name = "Cody", email = "cody.peterson@ascend.io" }]
+dependencies = []
+readme = "README.md"
+
+[project.urls]
+Repository = "https://github.com/ascend-io/ascend-tools"
+Homepage = "https://github.com/ascend-io/ascend-tools"
+
+[project.scripts]
+ascend-tools = "ascend_tools:main"
+
+[dependency-groups]
+dev = ["maturin>=1.0,<2.0", "ruff>=0.9", "ipython>=9.10.0", "ty>=0.0.19"]
+
+[tool.maturin]
+module-name = "ascend_tools.core"
+python-packages = ["ascend_tools"]
+python-source = "src"
+manifest-path = "src/ascend_tools/ascend-tools-py/Cargo.toml"
+include = [{ path = "LICENSE", format = "sdist" }]
+
+[build-system]
+requires = ["maturin>=1.0,<2.0"]
+build-backend = "maturin"
+
+[tool.uv]
+cache-keys = [
+  { file = "pyproject.toml" },
+  { file = "src/ascend_tools/ascend-tools-core/**/*.rs" },
+  { file = "src/ascend_tools/ascend-tools-mcp/**/*.rs" },
+  { file = "src/ascend_tools/ascend-tools-cli/**/*.rs" },
+  { file = "src/ascend_tools/ascend-tools-py/**/*.rs" },
+]
+
+[tool.ty.src]
+# Exclude self-contained uv scripts — ty can't resolve their inline
+# script dependencies. See https://github.com/astral-sh/ty/issues/691
+exclude = ["tests/rest.py"]