gridfleet-agent 0.1.0__tar.gz

gridfleet_agent-0.1.0/.gitignore

@@ -0,0 +1,52 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.venv/
+venv/
+*.egg-info/
+*.egg
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Frontend
+frontend/node_modules/
+frontend/dist/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Playwright
+.playwright-mcp/
+
+
+# Build output
+dist/
+
+# Misc
+*.log
+.idea
+testing/screenshots
+frontend/test-results
+
+# Worktrees
+.worktrees/
+
+# Superpowers working docs
+.superpowers/

gridfleet_agent-0.1.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: gridfleet-agent
+Version: 0.1.0
+Summary: GridFleet agent — runs on each host
+Project-URL: Homepage, https://github.com/quidow/gridfleet
+Project-URL: Repository, https://github.com/quidow/gridfleet
+Project-URL: Documentation, https://github.com/quidow/gridfleet/tree/main/docs
+Project-URL: Issues, https://github.com/quidow/gridfleet/issues
+Project-URL: Security, https://github.com/quidow/gridfleet/security/advisories/new
+Author: GridFleet contributors
+License-Expression: Apache-2.0
+Keywords: appium,gridfleet,selenium,testing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: fastapi==0.136.1
+Requires-Dist: httpx==0.28.1
+Requires-Dist: packaging>=26.2
+Requires-Dist: psutil==7.2.2
+Requires-Dist: pydantic-settings==2.14.0
+Requires-Dist: uvicorn[standard]==0.46.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.20.2; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest>=9.0.3; extra == 'dev'
+Requires-Dist: ruff>=0.15.12; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# GridFleet Agent
+
+`gridfleet-agent` is the host-side service package for GridFleet device hosts.
+
+This package currently provides the runnable agent service entry point:
+
+```bash
+gridfleet-agent serve
+```
+
+It also provides a safe installer preview:
+
+```bash
+gridfleet-agent install --dry-run --manager-url http://manager.example.com:8000
+```
+
+The dry run performs host-tool discovery and renders the planned `config.env` and service definition without writing files or starting services.
+
+Real installs use a dedicated virtual environment under `/opt/gridfleet-agent/venv`:
+
+```bash
+python3 -m venv /opt/gridfleet-agent/venv
+/opt/gridfleet-agent/venv/bin/pip install gridfleet-agent
+/opt/gridfleet-agent/venv/bin/gridfleet-agent install --no-start --manager-url http://manager.example.com:8000
+```
+
+`--no-start` writes the config and service files but does not enable or start the host service yet.
+
+To also enable/start the service and poll local health:
+
+```bash
+/opt/gridfleet-agent/venv/bin/gridfleet-agent install --start --manager-url http://manager.example.com:8000
+```
+
+After local health passes, `--start` also checks whether the host appears in the manager host list. Pending registration is reported as a warning because host approval may still require operator action.
+
+For a one-command bootstrap from a release checkout or raw GitHub URL:
+
+```bash
+VERSION=0.3.0 sudo -E bash scripts/install-agent.sh --manager-url http://manager.example.com:8000
+```
+
+Inspect local installation state without changing anything:
+
+```bash
+gridfleet-agent status
+```
+
+The status command reads `config.env`, checks the local service manager when available, polls local health, and redacts stored secrets.
+
+Upgrade the dedicated agent venv package and restart the host service:
+
+```bash
+sudo -E /opt/gridfleet-agent/venv/bin/gridfleet-agent update --to 0.3.0
+```
+
+The update command waits for local Appium nodes reported by `/agent/health` to drain before upgrading the package or restarting the service. Use `gridfleet-agent update --dry-run --to 0.3.0` to preview the drain, pip upgrade, service restart, and local health-check steps.
+
+Uninstall requires explicit confirmation:
+
+```bash
+gridfleet-agent uninstall --yes
+```
+
+Use `--keep-config` or `--keep-agent-dir` when you want to preserve local configuration or downloaded runtime state.

gridfleet_agent-0.1.0/README.md

@@ -0,0 +1,65 @@
+# GridFleet Agent
+
+`gridfleet-agent` is the host-side service package for GridFleet device hosts.
+
+This package currently provides the runnable agent service entry point:
+
+```bash
+gridfleet-agent serve
+```
+
+It also provides a safe installer preview:
+
+```bash
+gridfleet-agent install --dry-run --manager-url http://manager.example.com:8000
+```
+
+The dry run performs host-tool discovery and renders the planned `config.env` and service definition without writing files or starting services.
+
+Real installs use a dedicated virtual environment under `/opt/gridfleet-agent/venv`:
+
+```bash
+python3 -m venv /opt/gridfleet-agent/venv
+/opt/gridfleet-agent/venv/bin/pip install gridfleet-agent
+/opt/gridfleet-agent/venv/bin/gridfleet-agent install --no-start --manager-url http://manager.example.com:8000
+```
+
+`--no-start` writes the config and service files but does not enable or start the host service yet.
+
+To also enable/start the service and poll local health:
+
+```bash
+/opt/gridfleet-agent/venv/bin/gridfleet-agent install --start --manager-url http://manager.example.com:8000
+```
+
+After local health passes, `--start` also checks whether the host appears in the manager host list. Pending registration is reported as a warning because host approval may still require operator action.
+
+For a one-command bootstrap from a release checkout or raw GitHub URL:
+
+```bash
+VERSION=0.3.0 sudo -E bash scripts/install-agent.sh --manager-url http://manager.example.com:8000
+```
+
+Inspect local installation state without changing anything:
+
+```bash
+gridfleet-agent status
+```
+
+The status command reads `config.env`, checks the local service manager when available, polls local health, and redacts stored secrets.
+
+Upgrade the dedicated agent venv package and restart the host service:
+
+```bash
+sudo -E /opt/gridfleet-agent/venv/bin/gridfleet-agent update --to 0.3.0
+```
+
+The update command waits for local Appium nodes reported by `/agent/health` to drain before upgrading the package or restarting the service. Use `gridfleet-agent update --dry-run --to 0.3.0` to preview the drain, pip upgrade, service restart, and local health-check steps.
+
+Uninstall requires explicit confirmation:
+
+```bash
+gridfleet-agent uninstall --yes
+```
+
+Use `--keep-config` or `--keep-agent-dir` when you want to preserve local configuration or downloaded runtime state.

gridfleet_agent-0.1.0/agent_app/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"