# Smart Deploy Agent Demo Edge Agent

## Setup

```bash
python -m venv .venv
.venv\Scripts\python -m pip install -e edge-agent
```

## Run Once

```bash
set PYTHONPATH=edge-agent
.venv\Scripts\python -m app.main --once
```

## Run Loop

```bash
set PYTHONPATH=edge-agent
.venv\Scripts\python -m app.main
```

## Test

```bash
set PYTHONPATH=edge-agent
C:\Users\MH\AppData\Local\Programs\Python\Python311\python.exe -m pytest edge-agent/tests -q -p no:cacheprovider
```

## Default Runtime Notes

1. default backend url: `http://127.0.0.1:8000`
2. default edge id: `edge-shanghai-001`
3. current registered tools:
   `http_health_check`
   `check_port`
   `check_process`
   `grep_log`
   `windows_service_control`
   `linux_service_control`
4. current bootstrap implements:
   heartbeat
   pull task
   execute registered tools
   report result
   report event

## Package Scripts

Current repo includes:

1. `scripts/start-windows.ps1`
2. `scripts/start-linux.sh`
3. `scripts/package-windows.ps1`
4. `scripts/package-linux.sh`

These scripts currently prepare a portable package skeleton and startup entrypoints.
Current Windows package script already bundles a private Python runtime into:
`runtime/python/`

Current Linux package script supports bundling a private Python runtime directory passed in by argument or `EDGE_PYTHON_HOME`.

## Packaging Direction

For user-side delivery, this edge agent is intended to be bundled as:

1. Windows: `zip` portable package
2. Linux: `tar.gz` self-contained runtime directory

## Current Verification Baseline

Current edge-agent baseline: `10 passed`

## Verified Packaging

Current verified artifact:

1. Windows portable package zip has been generated and verified to include:
   `start.ps1`
   `app/main.py`
   `runtime/python/python.exe`