@miosa/cli 0.2.0

package/README.md

@@ -0,0 +1,327 @@
+# @miosa/cli
+
+The official MIOSA command-line interface. Deploy apps and manage OpenComputers hosts from your shell.
+
+```bash
+npm install -g @miosa/cli
+```
+
+## Deploy — 60 seconds to first deploy
+
+Point the CLI at any repo and it handles the rest: framework detection, build wiring, GitHub webhook setup, and live log streaming.
+
+```
+$ cd ~/my-project
+$ miosa login
+$ miosa deploy
+
+  Detected: Next.js 15 (confidence 95%)
+  Repo:     https://github.com/me/my-project
+  Branch:   main
+
+? Deployment name: my-project
+? Branch to deploy: main
+? Build command: npm run build
+? Run command: npm start
+? Create deployment? Yes
+
+  Deployment "my-project" created (slug: my-project-x7k2)
+  Saved .miosa.json
+
+  ACTION REQUIRED — GitHub Webhook
+  The webhook secret below is shown ONCE. Store it now.
+
+  Webhook URL:   https://api.miosa.ai/api/v1/integrations/github/webhook
+  Content type:  application/json
+  Secret:        a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9
+  Events:        push
+
+  Add this at: https://github.com/me/my-project/settings/hooks/new
+
+  Initial build queued
+
+  Build log:
+  ────────────────────────────────────────────────────────────
+  > npm run build
+  > next build
+  ✓ Compiled successfully
+  ────────────────────────────────────────────────────────────
+
+  Deployed
+
+  URL:    https://my-project-x7k2.me.miosa.app
+
+  Next steps:
+    miosa deploy logs                          — tail logs
+    miosa deploy domain add example.com        — add custom domain
+    miosa deploy env set KEY=VALUE             — set env var
+```
+
+On subsequent runs from the same directory, `miosa deploy` reads `.miosa.json` and skips all prompts — just queues a rebuild and streams logs.
+
+```bash
+# Trigger a rebuild any time
+miosa deploy
+
+# Or explicitly
+miosa deploy redeploy
+```
+
+### Deploy sub-commands
+
+```bash
+miosa deploy list                          # All deployments for this tenant
+miosa deploy logs [id]                     # Tail live build logs
+miosa deploy redeploy [id]                 # Manual rebuild
+miosa deploy env set KEY=VALUE [--id id]   # Set env var
+miosa deploy env list [id]                 # Show env vars (masked)
+miosa deploy domain add example.com [id]   # Add custom domain
+miosa deploy destroy [id]                  # Tear down deployment
+```
+
+### Supported frameworks (auto-detected)
+
+| Framework | Detection | Build | Run |
+|---|---|---|---|
+| Next.js | `next` in package.json | `npm run build` | `npm start` |
+| SvelteKit | `@sveltejs/kit` in package.json | `npm run build` | `node build` |
+| Vite + React | `vite` + `react` in package.json | `npm run build` | `npx serve dist` |
+| Phoenix (Elixir) | `mix.exs` with `:phoenix` | `mix release` | `_build/prod/rel/.../bin/... start` |
+| Django | `manage.py` + `requirements.txt` | `pip install` + `collectstatic` | `gunicorn` |
+| Flask | `requirements.txt` with flask | `pip install` | `gunicorn app:app` |
+| Ruby on Rails | `Gemfile` + `config/application.rb` | `bundle install` | `rails server` |
+| Go | `go.mod` | `go build -o app .` | `./app` |
+| Rust | `Cargo.toml` | `cargo build --release` | `./target/release/<name>` |
+| Static HTML | `index.html` (no build system) | — | `npx serve .` |
+
+---
+
+## OpenComputers hosts
+
+```bash
+# Authenticate
+miosa login
+
+# List your hosts
+miosa hosts
+
+# Open an interactive terminal
+miosa ssh my-mac
+
+# Run a command
+miosa exec my-mac "npm test"
+
+# Upload a file
+miosa cp ./build.tar.gz my-mac:/tmp/
+
+# Expose a port publicly
+miosa tunnel open my-mac --port 3000
+```
+
+## Configuration
+
+Config is stored at `~/.miosa/config.json`:
+
+```json
+{
+  "endpoint": "https://api.miosa.ai",
+  "api_key": "msk_u_...",
+  "default_host": null
+}
+```
+
+Precedence: CLI flags > environment variables > config file > interactive prompt.
+
+**Environment variables:**
+
+| Variable | Description |
+|---|---|
+| `MIOSA_API_KEY` | API key (overrides config file) |
+| `MIOSA_ENDPOINT` | API endpoint (overrides config file) |
+| `MIOSA_DEBUG` | Set to any value to enable debug output |
+
+## Commands
+
+### `miosa deploy [sub-command]`
+
+Deploy a GitHub repo. See the [Deploy section](#deploy--60-seconds-to-first-deploy) above for the full flow.
+
+```bash
+miosa deploy                             # First deploy or redeploy from .miosa.json
+miosa deploy list [--json]               # List all deployments
+miosa deploy logs [id]                   # Tail live build logs
+miosa deploy redeploy [id] [--no-follow] # Manual rebuild
+miosa deploy env set KEY=VALUE [--id id] # Set env var
+miosa deploy env list [id]               # Show env vars (masked)
+miosa deploy domain add <domain> [id]    # Add custom domain
+miosa deploy destroy [id] [-f]           # Tear down deployment
+```
+
+### `miosa login [--api-key key]`
+
+Authenticate with your MIOSA API key. If no key is provided, you'll be prompted interactively.
+
+```bash
+miosa login
+miosa login --api-key msk_u_yourkey
+echo "msk_u_yourkey" | miosa login   # non-TTY / CI
+```
+
+### `miosa logout`
+
+Remove the stored API key.
+
+### `miosa hosts [--json]`
+
+List all registered hosts.
+
+```bash
+miosa hosts
+miosa hosts --json | jq '.[].name'
+```
+
+### `miosa host <name-or-id> [--json]`
+
+Show details for a specific host including live telemetry.
+
+```bash
+miosa host my-mac
+miosa host abc12345
+```
+
+### `miosa connect [name]`
+
+Register a new host interactively. Prints the install command and waits for the host to come online.
+
+```bash
+miosa connect
+miosa connect my-new-server
+```
+
+### `miosa ssh <host> [--cmd "..."]`
+
+Open an interactive PTY terminal session on a host.
+
+```bash
+miosa ssh my-mac
+miosa ssh my-mac --cmd "ls -la"
+```
+
+### `miosa exec <host> <cmd> [args...] [--cwd dir] [--env KEY=VAL] [--timeout 30s]`
+
+Run a command non-interactively and stream output. Exits with the remote exit code.
+
+```bash
+miosa exec my-mac npm test
+miosa exec my-mac ls -- -la /tmp
+miosa exec my-mac env --env NODE_ENV=production --env PORT=3000
+miosa exec my-mac make build --cwd /home/user/project --timeout 10m
+```
+
+### `miosa cp <src> <dst>`
+
+Copy files between local and remote. Use `host:/path` for remote paths.
+
+```bash
+# Upload
+miosa cp ./local.txt my-mac:/tmp/
+miosa cp -r ./dist my-mac:/var/www/
+
+# Download
+miosa cp my-mac:/var/log/app.log ./
+miosa cp my-mac:/home/user/report.pdf ~/Downloads/
+```
+
+### `miosa ls <host>:<path> [-a] [-l]`
+
+List files on a host.
+
+```bash
+miosa ls my-mac:/tmp
+miosa ls my-mac:/home/user -la
+miosa ls my-mac:/ -a
+```
+
+### `miosa rm <host>:<path> [-r] [-f]`
+
+Remove a file or directory on a host. Prompts for confirmation unless `-f`.
+
+```bash
+miosa rm my-mac:/tmp/old-build.tar.gz
+miosa rm -rf my-mac:/tmp/build-artifacts
+```
+
+### `miosa tunnel open <host> --port <n> [--name slug] [--watch]`
+
+Expose a port on a host publicly.
+
+```bash
+miosa tunnel open my-mac --port 3000
+miosa tunnel open my-mac --port 8080 --name my-app --watch
+```
+
+### `miosa tunnel list <host>`
+
+List active tunnels on a host.
+
+### `miosa tunnel close <host> <slug>`
+
+Close (revoke) a tunnel.
+
+### `miosa agent <host> "<task>" [--model] [--steps] [--timeout]`
+
+Dispatch an AI agent task. Streams thoughts, tool calls, and results live.
+
+```bash
+miosa agent my-mac "run the test suite and fix any failing tests"
+miosa agent my-mac "update all npm dependencies" --steps 20
+miosa agent my-mac "optimize the database queries" --model nemotron-3-super
+```
+
+### `miosa watch <host>`
+
+Stream live telemetry and events from a host.
+
+```bash
+miosa watch my-mac
+```
+
+### `miosa status`
+
+Show current auth, endpoint, tenant info, credits, and host count.
+
+```bash
+miosa status
+```
+
+## Exit codes
+
+| Code | Meaning |
+|---|---|
+| 0 | Success |
+| 1 | User error (bad args, not found, etc.) |
+| 2 | Network error |
+| 3 | Authentication error |
+| 4 | Server error |
+
+## Troubleshooting
+
+**"No API key configured"** — Run `miosa login`.
+
+**"Host not found"** — Check `miosa hosts` for the correct name or ID.
+
+**"Insufficient credits"** — Top up at https://miosa.ai/billing.
+
+**Network errors** — Check your connection. Use `MIOSA_DEBUG=1 miosa <cmd>` for stack traces.
+
+**Custom endpoint** — `MIOSA_ENDPOINT=https://your-instance.ai miosa hosts`
+
+## Links
+
+- Documentation: https://docs.miosa.ai/cli
+- Platform: https://miosa.ai
+- Support: support@miosa.ai
+
+## License
+
+MIT

package/dist/bin/miosa.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=miosa.d.ts.map

package/dist/bin/miosa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miosa.d.ts","sourceRoot":"","sources":["../../src/bin/miosa.ts"],"names":[],"mappings":""}

package/dist/bin/miosa.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import chalk from "chalk";
+import { MiosaError } from "../errors.js";
+// Dynamically read version from package.json so it stays in sync
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "../../package.json"), "utf8"));
+const program = new Command();
+program
+    .name("miosa")
+    .description("MIOSA CLI — application module infrastructure for the Optimal System. Manage Computers, Sandboxes, and OpenComputers hosts from your shell.")
+    .version(pkg.version, "-v, --version")
+    .addHelpText("after", `
+Examples:
+  miosa login                                   Authenticate (opens browser)
+  miosa login --api-key msk_u_...               Authenticate with an API key
+  miosa login --stdin                           Pipe an API key: echo 'msk_...' | miosa login --stdin
+  miosa whoami                                  Show current auth state (instant, cached)
+  miosa whoami --refresh                        Force live refresh of identity
+  miosa config ls                               List all config keys
+  miosa config set region us-nyc                Set a config value
+  miosa doctor                                  Diagnose CLI, auth, and toolchain
+  miosa computers list                          List all Computers
+  miosa computers vnc <id>                      Open a Computer's VNC viewer
+  miosa sandbox list                            List all Sandboxes
+  miosa sandbox exec <id> --data '{"cmd":"…"}'  Run a command in a Sandbox
+  miosa hosts                                   List all OpenComputers hosts
+  miosa ssh my-mac                              Interactive terminal on a host
+  miosa exec my-mac "npm test"                  Run a command and stream output
+  miosa cp ./file.txt my-mac:/tmp/              Upload a file
+  miosa tunnel open my-mac --port 3000          Expose a port publicly
+  miosa agent my-mac "run the tests"            Dispatch an AI agent task
+  miosa watch my-dev-box                        Stream real-time events from a Computer
+  miosa watch my-dev-box --filter exec,desktop  Watch only exec and desktop events
+  miosa watch my-dev-box --json                 Machine-readable event stream (one JSON/line)
+  miosa up                                      Smart launch (auto-detects context)
+  miosa up --computer --os ubuntu               Create a desktop computer
+  miosa up --sandbox --image python-3.12        Create a sandbox
+  miosa deploy                                  Deploy a GitHub repo (60s)
+  miosa status                                  Show auth and account info
+
+Documentation: https://miosa.ai/docs/cli/
+`);
+// Dynamically import and register all command modules
+const commandModules = [
+    "../commands/auth.js",
+    "../commands/login.js",
+    "../commands/logout.js",
+    "../commands/whoami.js",
+    "../commands/config.js",
+    "../commands/doctor.js",
+    "../commands/hosts.js",
+    "../commands/host.js",
+    "../commands/computers.js",
+    "../commands/snapshot.js",
+    "../commands/sandbox.js",
+    "../commands/connect.js",
+    "../commands/ssh.js",
+    "../commands/exec.js",
+    "../commands/cp.js",
+    "../commands/ls.js",
+    "../commands/rm.js",
+    "../commands/tunnel.js",
+    "../commands/agent.js",
+    "../commands/watch.js",
+    "../commands/status.js",
+    "../commands/up.js",
+    "../commands/deploy.js",
+    "../commands/apps.js",
+    "../commands/logs.js",
+    "../commands/releases.js",
+    "../commands/secrets.js",
+    "../commands/volumes.js",
+    "../commands/regions.js",
+    "../commands/groups.js",
+    "../commands/meshes.js",
+    "../commands/schedules.js",
+    "../commands/alerts.js",
+    "../commands/audit.js",
+    "../commands/webhooks.js",
+    "../commands/gha-runners.js",
+    "../commands/backups.js",
+    "../commands/workspaces.js",
+    "../commands/services.js",
+    "../commands/containers.js",
+    "../commands/functions.js",
+    "../commands/cron.js",
+    "../commands/shell.js",
+    "../commands/mcp.js",
+    "../commands/link.js",
+    "../commands/pull.js",
+    "../commands/dev.js",
+    "../commands/run.js",
+    "../commands/tenant.js",
+    "../commands/db.js",
+];
+async function main() {
+    // Register all commands
+    for (const mod of commandModules) {
+        const m = (await import(mod));
+        m.register(program);
+    }
+    // Global error handler — catches unhandled MiosaErrors thrown outside command actions
+    process.on("uncaughtException", (err) => {
+        if (err instanceof MiosaError) {
+            console.error(chalk.red(`Error: ${err.message}`));
+            if (err.hint)
+                console.error(chalk.dim(`  Hint: ${err.hint}`));
+            process.exit(err.exitCode);
+        }
+        console.error(chalk.red(`Fatal: ${err.message}`));
+        if (process.env["MIOSA_DEBUG"])
+            console.error(err.stack);
+        process.exit(1);
+    });
+    process.on("unhandledRejection", (reason) => {
+        if (reason instanceof MiosaError) {
+            console.error(chalk.red(`Error: ${reason.message}`));
+            if (reason.hint)
+                console.error(chalk.dim(`  Hint: ${reason.hint}`));
+            process.exit(reason.exitCode);
+        }
+        const msg = reason instanceof Error ? reason.message : String(reason);
+        console.error(chalk.red(`Fatal: ${msg}`));
+        if (process.env["MIOSA_DEBUG"] && reason instanceof Error)
+            console.error(reason.stack);
+        process.exit(1);
+    });
+    await program.parseAsync(process.argv);
+}
+main().catch((err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(chalk.red(`Fatal: ${msg}`));
+    process.exit(1);
+});
+//# sourceMappingURL=miosa.js.map

package/dist/bin/miosa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miosa.js","sourceRoot":"","sources":["../../src/bin/miosa.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,74 @@
+import { type Dispatcher } from "undici";
+import type { AgentDispatchParams, BuildId, ComputerId, ComputerFsEntry, ComputerStatResult, CreateDeploymentParams, Deployment, DeploymentBuild, DeploymentId, EnvVarPreview, FsEntry, Host, HostId, Job, JobCreateParams, MiosaConfig, SseEvent, Tenant, TerminalTicket, Tunnel, TunnelCreateParams, TunnelSlug } from "./types.js";
+export declare class MiosaClient {
+    private readonly endpoint;
+    private readonly apiKey;
+    constructor(config: MiosaConfig);
+    private headers;
+    private url;
+    private parseError;
+    private get;
+    private post;
+    private delete;
+    /** Generic GET for command groups that map directly to stable API routes. */
+    apiGet<T>(path: string): Promise<T>;
+    /** Generic POST for command groups that map directly to stable API routes. */
+    apiPost<T>(path: string, body?: unknown): Promise<T>;
+    /** Generic PUT for command groups that map directly to stable API routes. */
+    apiPut<T>(path: string, body?: unknown): Promise<T>;
+    /** Generic PATCH for command groups that map directly to stable API routes. */
+    apiPatch<T>(path: string, body?: unknown): Promise<T>;
+    /** Generic DELETE for command groups that map directly to stable API routes. */
+    apiDelete<T>(path: string): Promise<T>;
+    getTenant(): Promise<Tenant>;
+    listHosts(): Promise<Host[]>;
+    getHost(idOrName: string): Promise<Host>;
+    createHost(params: {
+        name: string;
+        platform?: string;
+    }): Promise<Host>;
+    getTerminalTicket(hostId: HostId): Promise<TerminalTicket>;
+    createJob(hostId: HostId, params: JobCreateParams): Promise<Job>;
+    /** Returns a raw Response for SSE streaming */
+    streamJob(hostId: HostId, params: JobCreateParams): Promise<Dispatcher.ResponseData>;
+    listFs(hostId: HostId, path: string): Promise<FsEntry[]>;
+    downloadFile(hostId: HostId, remotePath: string): Promise<Dispatcher.ResponseData>;
+    uploadFile(hostId: HostId, remotePath: string, data: Buffer, filename: string): Promise<void>;
+    deleteFs(hostId: HostId, path: string, recursive: boolean): Promise<void>;
+    computerListFiles(computerId: ComputerId, remotePath: string): Promise<ComputerFsEntry[]>;
+    computerWriteFile(computerId: ComputerId, remotePath: string, content: Buffer | string): Promise<void>;
+    computerDownloadFile(computerId: ComputerId, remotePath: string): Promise<Dispatcher.ResponseData>;
+    computerUploadFile(computerId: ComputerId, remotePath: string, data: Buffer, filename: string): Promise<void>;
+    computerMkdir(computerId: ComputerId, remotePath: string): Promise<void>;
+    computerDeleteFile(computerId: ComputerId, remotePath: string): Promise<void>;
+    computerStat(computerId: ComputerId, remotePath: string): Promise<ComputerStatResult>;
+    computerExec(computerId: ComputerId, command: string, opts?: {
+        language?: "shell" | "python";
+    }): Promise<Dispatcher.ResponseData>;
+    listTunnels(hostId: HostId): Promise<Tunnel[]>;
+    createTunnel(hostId: HostId, params: TunnelCreateParams): Promise<Tunnel>;
+    closeTunnel(hostId: HostId, slug: TunnelSlug): Promise<void>;
+    dispatchAgent(hostId: HostId, params: AgentDispatchParams): Promise<Dispatcher.ResponseData>;
+    listDeployments(): Promise<Deployment[]>;
+    getDeployment(id: DeploymentId): Promise<Deployment>;
+    createDeployment(params: CreateDeploymentParams): Promise<{
+        data: Deployment;
+        webhook_secret: string;
+    }>;
+    deleteDeployment(id: DeploymentId): Promise<{
+        id: string;
+        deleted: boolean;
+    }>;
+    redeployDeployment(id: DeploymentId): Promise<DeploymentBuild>;
+    listBuilds(id: DeploymentId): Promise<DeploymentBuild[]>;
+    getBuild(id: DeploymentId, bid: BuildId): Promise<DeploymentBuild>;
+    /** Returns a raw SSE Response for deployment log streaming */
+    streamDeploymentLogs(id: DeploymentId): Promise<Dispatcher.ResponseData>;
+    getDeploymentEnv(id: DeploymentId): Promise<EnvVarPreview[]>;
+    setDeploymentEnv(id: DeploymentId, env: Record<string, string>): Promise<EnvVarPreview[]>;
+    watchEvents(hostId: HostId): Promise<Dispatcher.ResponseData>;
+    /** Open an SSE event stream for a Computer (Firecracker microVM). */
+    watchComputerEvents(computerId: ComputerId): Promise<Dispatcher.ResponseData>;
+}
+export declare function parseSse(body: Dispatcher.ResponseData["body"]): AsyncGenerator<SseEvent>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}