@axiom-lattice/microsandbox-service

@axiom-lattice/microsandbox-service runs an HTTP service for managing microsandbox-backed sandbox lifecycle operations.

This package is intended to be deployed as a long-running process. Its primary runtime entrypoint is the lattice-microsandbox-service CLI.

Install and Build

Build the package from the monorepo root:

pnpm --filter @axiom-lattice/microsandbox-service build

After building, you can start the service through the package CLI or the package start script.

CLI Usage

The package exposes this executable:

lattice-microsandbox-service

Supported flags:

• --host <string>
• --port <number>

Example:

lattice-microsandbox-service --host 0.0.0.0 --port 4002

Configuration

Runtime configuration is resolved in this order:

1. CLI arguments
2. Environment variables
3. Defaults

Supported environment variables:

• HOST default: 0.0.0.0
• PORT default: 4002

Example:

HOST=0.0.0.0 PORT=4002 lattice-microsandbox-service

Startup Examples

Start with CLI flags:

lattice-microsandbox-service --host 127.0.0.1 --port 4002

Start with environment variables:

HOST=127.0.0.1 PORT=4002 lattice-microsandbox-service

Start through the package script:

pnpm --filter @axiom-lattice/microsandbox-service start

Check service health:

curl http://127.0.0.1:4002/health

Process Manager Examples

systemd

[Unit]
Description=Axiom Lattice Microsandbox Service
After=network.target

[Service]
ExecStart=/usr/local/bin/lattice-microsandbox-service --host 0.0.0.0 --port 4002
Restart=on-failure
Environment=HOST=0.0.0.0
Environment=PORT=4002

[Install]
WantedBy=multi-user.target

supervisor

[program:microsandbox-service]
command=/usr/local/bin/lattice-microsandbox-service --host 0.0.0.0 --port 4002
autostart=true
autorestart=true
environment=HOST="0.0.0.0",PORT="4002"

docker

CMD ["lattice-microsandbox-service", "--host", "0.0.0.0", "--port", "4002"]

Local Development

Run the package in watch mode from the monorepo root:

pnpm --filter @axiom-lattice/microsandbox-service dev

This command watches source files, rebuilds the package, and restarts the service automatically.

Operational Notes

• Invalid startup configuration exits non-zero.
• Startup failures exit non-zero.
• SIGINT and SIGTERM trigger graceful shutdown.