Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

Reserve @trycua/fleet and cua-fleet package names (#2236)

r33drichardsb294b3a84b2d
diff --git a/.github/workflows/cd-py-fleet.yml b/.github/workflows/cd-py-fleet.yml
new file mode 100644
index 0000000000..2a36091130
--- /dev/null
+++ b/.github/workflows/cd-py-fleet.yml
@@ -0,0 +1,69 @@
+name: "CD: cua-fleet (PyPI)"
+
+on:
+ push:
+ tags:
+ - "fleet-v*"
+ workflow_dispatch:
+ inputs:
+ version:
+ description: "Version to publish (without v prefix)"
+ required: true
+ default: "0.0.1"
+ workflow_call:
+ inputs:
+ version:
+ description: "Version to publish"
+ required: true
+ type: string
+
+permissions:
+ contents: write
+
+jobs:
+ prepare:
+ runs-on: macos-latest
+ outputs:
+ version: ${{ steps.get-version.outputs.version }}
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Determine version
+ id: get-version
+ run: |
+ if [ -n "${{ inputs.version }}" ]; then
+ VERSION=${{ inputs.version }}
+ elif [ "${{ github.event_name }}" == "push" ]; then
+ if [[ "${{ github.ref }}" =~ ^refs/tags/fleet-v([0-9]+\.[0-9]+\.[0-9]+) ]]; then
+ VERSION=${BASH_REMATCH[1]}
+ else
+ echo "Invalid tag format for cua-fleet"
+ exit 1
+ fi
+ elif [ -n "${{ github.event.inputs.version }}" ]; then
+ VERSION=${{ github.event.inputs.version }}
+ else
+ echo "ERROR: No version found!"
+ exit 1
+ fi
+ echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+ publish:
+ needs: prepare
+ uses: ./.github/workflows/py-reusable-publish.yml
+ with:
+ package_name: "fleet"
+ package_dir: "libs/python/cua-fleet"
+ version: ${{ needs.prepare.outputs.version }}
+ base_package_name: "cua-fleet"
+ secrets:
+ PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
+
+ create-release:
+ needs: [prepare, publish]
+ uses: ./.github/workflows/release-github-reusable.yml
+ with:
+ tag_name: "fleet-v${{ needs.prepare.outputs.version }}"
+ release_name: "cua-fleet v${{ needs.prepare.outputs.version }}"
+ module_path: "libs/python/cua-fleet"
+ body: ""
diff --git a/.github/workflows/cd-ts-fleet.yml b/.github/workflows/cd-ts-fleet.yml
new file mode 100644
index 0000000000..a5e6ffa805
--- /dev/null
+++ b/.github/workflows/cd-ts-fleet.yml
@@ -0,0 +1,83 @@
+name: "CD: @trycua/fleet (npm)"
+
+on:
+ push:
+ tags:
+ - "npm-fleet-v*"
+ workflow_dispatch:
+ inputs:
+ version:
+ description: "Version to publish (default: from package.json)"
+ required: false
+ default: ""
+ workflow_call:
+ inputs:
+ version:
+ description: "Version to publish (default: from package.json)"
+ required: false
+ type: string
+ default: ""
+
+permissions:
+ id-token: write
+ contents: write
+
+jobs:
+ prepare:
+ runs-on: ubuntu-latest
+ outputs:
+ version: ${{ steps.get-version.outputs.version }}
+ tag: ${{ steps.get-version.outputs.tag }}
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v4
+
+ - name: Determine version
+ id: get-version
+ run: |
+ # Check inputs.version first (works for workflow_call)
+ if [ -n "${{ inputs.version }}" ]; then
+ VERSION="${{ inputs.version }}"
+ elif [ "${{ github.event_name }}" == "push" ]; then
+ # Extract version from tag
+ if [[ "${{ github.ref }}" =~ ^refs/tags/npm-fleet-v([0-9]+\.[0-9]+\.[0-9]+) ]]; then
+ VERSION=${BASH_REMATCH[1]}
+ else
+ echo "ERROR: Invalid tag format for npm-fleet"
+ exit 1
+ fi
+ elif [ -n "${{ github.event.inputs.version }}" ]; then
+ VERSION="${{ github.event.inputs.version }}"
+ else
+ # Read from package.json
+ VERSION=$(node -p "require('./libs/typescript/fleet/package.json').version")
+ fi
+
+ echo "Fleet version: $VERSION"
+ echo "version=${VERSION}" >> $GITHUB_OUTPUT
+ echo "tag=npm-fleet-v${VERSION}" >> $GITHUB_OUTPUT
+
+ publish:
+ needs: prepare
+ uses: ./.github/workflows/ts-reusable-publish.yml
+ with:
+ package_name: "fleet"
+ package_dir: "libs/typescript/fleet"
+ package_manager: "pnpm"
+ version: ${{ needs.prepare.outputs.version }}
+ secrets:
+ NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+ create-release:
+ needs: [prepare, publish]
+ uses: ./.github/workflows/release-github-reusable.yml
+ with:
+ tag_name: ${{ needs.prepare.outputs.tag }}
+ release_name: "@trycua/fleet v${{ needs.prepare.outputs.version }}"
+ module_path: "libs/typescript/fleet"
+ body: |
+ ## Installation
+
+ ```bash
+ npm install @trycua/fleet
+ ```
diff --git a/.github/workflows/release-bump-version.yml b/.github/workflows/release-bump-version.yml
index 27640349bf..ea1ae53c19 100644
--- a/.github/workflows/release-bump-version.yml
+++ b/.github/workflows/release-bump-version.yml
@@ -18,6 +18,7 @@ on:
- pypi/computer-server
- pypi/cloud
- pypi/core
+ - pypi/fleet
- pypi/mcp-server
- pypi/sandbox
- pypi/sandbox-apps
@@ -26,6 +27,7 @@ on:
- npm/cli
- npm/computer
- npm/core
+ - npm/fleet
- npm/playground
- npm/cuabot
- lume
@@ -102,6 +104,10 @@ jobs:
echo "directory=libs/python/core" >> $GITHUB_OUTPUT
echo "type=python" >> $GITHUB_OUTPUT
;;
+ "pypi/fleet")
+ echo "directory=libs/python/cua-fleet" >> $GITHUB_OUTPUT
+ echo "type=python" >> $GITHUB_OUTPUT
+ ;;
"pypi/mcp-server")
echo "directory=libs/python/mcp-server" >> $GITHUB_OUTPUT
echo "type=python" >> $GITHUB_OUTPUT
@@ -134,6 +140,10 @@ jobs:
echo "directory=libs/typescript/core" >> $GITHUB_OUTPUT
echo "type=npm" >> $GITHUB_OUTPUT
;;
+ "npm/fleet")
+ echo "directory=libs/typescript/fleet" >> $GITHUB_OUTPUT
+ echo "type=npm" >> $GITHUB_OUTPUT
+ ;;
"npm/playground")
echo "directory=libs/typescript/playground" >> $GITHUB_OUTPUT
echo "type=npm" >> $GITHUB_OUTPUT
diff --git a/.github/workflows/release-on-merge.yml b/.github/workflows/release-on-merge.yml
index 6ef37e474f..32d803381e 100644
--- a/.github/workflows/release-on-merge.yml
+++ b/.github/workflows/release-on-merge.yml
@@ -65,6 +65,7 @@ jobs:
["libs/python/computer/"]="pypi/computer"
["libs/python/cua-cloud/"]="pypi/cloud"
["libs/python/core/"]="pypi/core"
+ ["libs/python/cua-fleet/"]="pypi/fleet"
["libs/python/som/"]="pypi/som"
["libs/python/bench-ui/"]="pypi/bench-ui"
["libs/cua-bench/"]="pypi/bench"
@@ -73,6 +74,7 @@ jobs:
["libs/typescript/cua-cli/"]="npm/cli"
["libs/typescript/computer/"]="npm/computer"
["libs/typescript/core/"]="npm/core"
+ ["libs/typescript/fleet/"]="npm/fleet"
["libs/typescript/playground/"]="npm/playground"
["libs/cuabot/"]="npm/cuabot"
["libs/xfce/"]="docker/xfce"
diff --git a/libs/python/cua-fleet/.bumpversion.cfg b/libs/python/cua-fleet/.bumpversion.cfg
new file mode 100644
index 0000000000..ee7c41b3ff
--- /dev/null
+++ b/libs/python/cua-fleet/.bumpversion.cfg
@@ -0,0 +1,14 @@
+[bumpversion]
+current_version = 0.0.1
+commit = True
+tag = True
+tag_name = fleet-v{new_version}
+message = Bump cua-fleet to v{new_version}
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
+
+[bumpversion:file:cua_fleet/__init__.py]
+search = __version__ = "{current_version}"
+replace = __version__ = "{new_version}"
diff --git a/libs/python/cua-fleet/LICENSE b/libs/python/cua-fleet/LICENSE
new file mode 100644
index 0000000000..b8b198ce3e
--- /dev/null
+++ b/libs/python/cua-fleet/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cua AI, 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.
diff --git a/libs/python/cua-fleet/README.md b/libs/python/cua-fleet/README.md
new file mode 100644
index 0000000000..6e55229ae9
--- /dev/null
+++ b/libs/python/cua-fleet/README.md
@@ -0,0 +1,21 @@
+# cua-fleet
+
+> **Name reservation** — this package name is reserved for **Cua Fleet**, an upcoming
+> component of the [Cua](https://github.com/trycua/cua) project for orchestrating fleets
+> of computer-use agents and sandboxes.
+
+This is a placeholder release: it installs an empty module and has no functionality yet.
+Watch [trycua/cua](https://github.com/trycua/cua) for the first real release.
+
+In the meantime, check out the unified Cua SDK:
+
+```bash
+pip install cua
+```
+
+## Links
+
+- Website: [cua.ai](https://cua.ai)
+- Documentation: [docs.trycua.com](https://docs.trycua.com)
+- Repository: [github.com/trycua/cua](https://github.com/trycua/cua)
+- Issues: [github.com/trycua/cua/issues](https://github.com/trycua/cua/issues)
diff --git a/libs/python/cua-fleet/cua_fleet/__init__.py b/libs/python/cua-fleet/cua_fleet/__init__.py
new file mode 100644
index 0000000000..c80b72f95e
--- /dev/null
+++ b/libs/python/cua-fleet/cua_fleet/__init__.py
@@ -0,0 +1,13 @@
+"""cua-fleet — reserved for Cua Fleet.
+
+This package name is reserved for Cua Fleet, an upcoming component of the
+Cua project (https://github.com/trycua/cua) for orchestrating fleets of
+computer-use agents and sandboxes.
+
+This is a placeholder release with no functionality yet. In the meantime,
+see the unified Cua SDK::
+
+ pip install cua
+"""
+
+__version__ = "0.0.1"
diff --git a/libs/python/cua-fleet/pyproject.toml b/libs/python/cua-fleet/pyproject.toml
new file mode 100644
index 0000000000..22b0e38471
--- /dev/null
+++ b/libs/python/cua-fleet/pyproject.toml
@@ -0,0 +1,51 @@
+[project]
+name = "cua-fleet"
+version = "0.0.1"
+description = "Reserved for Cua Fleet — fleet orchestration for computer-use agents and sandboxes"
+readme = "README.md"
+license = "MIT"
+authors = [
+ { name = "TryCua", email = "[email protected]" }
+]
+keywords = [
+ "computer-use",
+ "sandbox",
+ "agents",
+ "fleet",
+ "orchestration",
+ "automation",
+]
+classifiers = [
+ "Development Status :: 1 - Planning",
+ "Intended Audience :: Developers",
+ "License :: OSI Approved :: MIT License",
+ "Operating System :: OS Independent",
+ "Programming Language :: Python :: 3",
+ "Topic :: Software Development :: Libraries",
+]
+requires-python = ">=3.9"
+
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/trycua/cua"
+Documentation = "https://docs.trycua.com"
+Repository = "https://github.com/trycua/cua"
+Issues = "https://github.com/trycua/cua/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build]
+include = [
+ "cua_fleet/**",
+ "README.md",
+ "LICENSE",
+]
+exclude = [
+ "cua_fleet/**/__pycache__",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["cua_fleet"]
diff --git a/libs/typescript/fleet/.bumpversion.cfg b/libs/typescript/fleet/.bumpversion.cfg
new file mode 100644
index 0000000000..73b93fa5b9
--- /dev/null
+++ b/libs/typescript/fleet/.bumpversion.cfg
@@ -0,0 +1,10 @@
+[bumpversion]
+current_version = 0.0.1
+commit = True
+tag = True
+tag_name = npm-fleet-v{new_version}
+message = Bump @trycua/fleet to v{new_version}
+
+[bumpversion:file:package.json]
+search = "version": "{current_version}"
+replace = "version": "{new_version}"
diff --git a/libs/typescript/fleet/LICENSE b/libs/typescript/fleet/LICENSE
new file mode 100644
index 0000000000..b8b198ce3e
--- /dev/null
+++ b/libs/typescript/fleet/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cua AI, 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.
diff --git a/libs/typescript/fleet/README.md b/libs/typescript/fleet/README.md
new file mode 100644
index 0000000000..6b25c5a919
--- /dev/null
+++ b/libs/typescript/fleet/README.md
@@ -0,0 +1,21 @@
+# @trycua/fleet
+
+> **Name reservation** — this package name is reserved for **Cua Fleet**, an upcoming
+> component of the [Cua](https://github.com/trycua/cua) project for orchestrating fleets
+> of computer-use agents and sandboxes.
+
+This is a placeholder release: it installs an empty module and has no functionality yet.
+Watch [trycua/cua](https://github.com/trycua/cua) for the first real release.
+
+In the meantime, check out the Cua TypeScript SDK:
+
+```bash
+npm install @trycua/computer @trycua/agent
+```
+
+## Links
+
+- Website: [cua.ai](https://cua.ai)
+- Documentation: [docs.trycua.com](https://docs.trycua.com)
+- Repository: [github.com/trycua/cua](https://github.com/trycua/cua)
+- Issues: [github.com/trycua/cua/issues](https://github.com/trycua/cua/issues)
diff --git a/libs/typescript/fleet/index.d.ts b/libs/typescript/fleet/index.d.ts
new file mode 100644
index 0000000000..baaee2fd0c
--- /dev/null
+++ b/libs/typescript/fleet/index.d.ts
@@ -0,0 +1 @@
+export declare const version: string;
diff --git a/libs/typescript/fleet/index.js b/libs/typescript/fleet/index.js
new file mode 100644
index 0000000000..f36d716749
--- /dev/null
+++ b/libs/typescript/fleet/index.js
@@ -0,0 +1,5 @@
+// @trycua/fleet is reserved for Cua Fleet, an upcoming component of the Cua
+// project (https://github.com/trycua/cua) for orchestrating fleets of
+// computer-use agents and sandboxes. This is a placeholder release with no
+// functionality yet.
+export const version = '0.0.1';
diff --git a/libs/typescript/fleet/package.json b/libs/typescript/fleet/package.json
new file mode 100644
index 0000000000..ddf8ffab56
--- /dev/null
+++ b/libs/typescript/fleet/package.json
@@ -0,0 +1,39 @@
+{
+ "name": "@trycua/fleet",
+ "version": "0.0.1",
+ "packageManager": "[email protected]",
+ "description": "Reserved for Cua Fleet — fleet orchestration for computer-use agents and sandboxes. Placeholder release.",
+ "type": "module",
+ "license": "MIT",
+ "homepage": "https://github.com/trycua/cua",
+ "bugs": {
+ "url": "https://github.com/trycua/cua/issues"
+ },
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/trycua/cua.git"
+ },
+ "author": "cua",
+ "keywords": [
+ "computer-use",
+ "sandbox",
+ "agents",
+ "fleet",
+ "orchestration",
+ "automation"
+ ],
+ "files": [
+ "index.js",
+ "index.d.ts"
+ ],
+ "main": "./index.js",
+ "module": "./index.js",
+ "types": "./index.d.ts",
+ "exports": {
+ ".": "./index.js",
+ "./package.json": "./package.json"
+ },
+ "publishConfig": {
+ "access": "public"
+ }
+}