@cardelli/ambit 0.3.0 → 0.3.2

package/esm/cli/commands/status/app.js

@@ -0,0 +1,141 @@
+// =============================================================================
+// Status App — Show App Status
+// =============================================================================
+import { parseArgs } from "../../../deps/jsr.io/@std/cli/1.0.28/mod.js";
+import { bold } from "../../../lib/cli.js";
+import { checkArgs } from "../../../lib/args.js";
+import { createOutput } from "../../../lib/output.js";
+import { findRouterApp, findWorkloadApp, getRouterMachineInfo, getRouterTailscaleInfo, } from "../../../util/discovery.js";
+import { initSession } from "../../../util/session.js";
+import { SOCKS_PROXY_PORT } from "../../../util/constants.js";
+// =============================================================================
+// Detailed App View
+// =============================================================================
+const stageAppStatus = async (fly, tailscale, app, network, org, json) => {
+    const out = createOutput(json);
+    const workload = await findWorkloadApp(fly, org, app, network);
+    if (!workload) {
+        return out.die(`App '${app}' Not Found on Network '${network}'`);
+    }
+    const machines = await fly.machines.list(workload.appName);
+    const ips = await fly.ips.list(workload.appName);
+    const mappedMachines = machines.map((m) => ({
+        id: m.id,
+        region: m.region,
+        state: m.state,
+        privateIp: m.private_ip,
+    }));
+    const mappedIps = ips.map((ip) => ({
+        address: ip.Address,
+        type: ip.Type,
+        network: ip.Network?.Name,
+    }));
+    const router = await findRouterApp(fly, org, network);
+    out.blank()
+        .header(`Ambit Status: ${app}.${network}`)
+        .blank()
+        .text(`  App:           ${bold(app)}`)
+        .text(`  Network:       ${network}`)
+        .text(`  Fly App:       ${workload.appName}`)
+        .text(`  Status:        ${workload.status}`)
+        .blank();
+    if (machines.length === 0) {
+        out.text("  Machines:      None");
+    }
+    else {
+        out.header("  Machines").blank();
+        for (const m of machines) {
+            out.text(`    ${m.id}  ${m.region}  ${m.state}${m.private_ip ? `  ${m.private_ip}` : ""}`);
+        }
+    }
+    out.blank();
+    const flycastIps = ips.filter((ip) => ip.Type === "private_v6");
+    const publicIps = ips.filter((ip) => ip.Type !== "private_v6");
+    if (flycastIps.length > 0) {
+        out.header("  Flycast IPs").blank();
+        for (const ip of flycastIps) {
+            out.text(`    ${ip.Address}  (network: ${ip.Network?.Name ?? "default"})`);
+        }
+        out.blank();
+    }
+    if (publicIps.length > 0) {
+        out.header("  Public IPs (Warning: Ambit Apps Should Not Have Public IPs)")
+            .blank();
+        for (const ip of publicIps) {
+            out.text(`    ${ip.Address}  ${ip.Type}`);
+        }
+        out.blank();
+    }
+    if (router) {
+        const routerMachine = await getRouterMachineInfo(fly, router.appName);
+        const ts = await getRouterTailscaleInfo(tailscale, router.appName);
+        out.header("  Router").blank()
+            .text(`    App:         ${router.appName}`)
+            .text(`    State:       ${routerMachine?.state ?? "unknown"}`)
+            .text(`    Tailscale:   ${ts ? (ts.online ? "online" : "offline") : "not found"}`);
+        if (routerMachine?.privateIp) {
+            out.text(`    SOCKS Proxy: socks5://[${routerMachine.privateIp}]:${SOCKS_PROXY_PORT}`);
+        }
+    }
+    else {
+        out.text("  Router:        Not Found");
+    }
+    out.blank();
+    out.done({
+        app,
+        network,
+        flyAppName: workload.appName,
+        machines: mappedMachines,
+        ips: mappedIps,
+        router,
+    });
+    out.print();
+};
+// =============================================================================
+// Status App Subcommand
+// =============================================================================
+export const statusApp = async (argv) => {
+    const opts = {
+        string: ["org"],
+        boolean: ["help", "json"],
+    };
+    const args = parseArgs(argv, opts);
+    checkArgs(args, opts, "ambit status app");
+    if (args.help) {
+        console.log(`
+${bold("ambit status app")} - Show App Status
+
+${bold("USAGE")}
+  ambit status app <app>.<network> [--org <org>] [--json]
+
+${bold("OPTIONS")}
+  --org <org>        Fly.io organization slug
+  --json             Output as JSON
+
+${bold("EXAMPLES")}
+  ambit status app my-app.browsers
+  ambit status app my-app.browsers --json
+`);
+        return;
+    }
+    const out = createOutput(args.json);
+    const appArg = args._[0];
+    if (!appArg || typeof appArg !== "string") {
+        return out.die("Missing App Name. Usage: ambit status app <app>.<network>");
+    }
+    if (!appArg.includes(".")) {
+        return out.die(`Missing Network. Use: ambit status app ${appArg}.<network>`);
+    }
+    const parts = appArg.split(".");
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        return out.die(`'${appArg}' Should Have Exactly One Dot, Like my-app.my-network`);
+    }
+    const app = parts[0];
+    const network = parts[1];
+    const prereqOut = createOutput(args.json);
+    const { fly, tailscale, org } = await initSession(prereqOut, {
+        json: args.json,
+        org: args.org,
+    });
+    await stageAppStatus(fly, tailscale, app, network, org, args.json);
+};

package/esm/cli/commands/status/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/esm/cli/commands/status/index.d.ts.map

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

package/esm/cli/commands/status/index.js

@@ -0,0 +1,68 @@
+// =============================================================================
+// Status Command - Show Network, App, and Router Status
+// =============================================================================
+import { parseArgs } from "../../../deps/jsr.io/@std/cli/1.0.28/mod.js";
+import { bold } from "../../../lib/cli.js";
+import { registerCommand } from "../../mod.js";
+import { statusNetworks } from "./networks.js";
+import { statusNetwork } from "./network.js";
+import { statusApp } from "./app.js";
+// =============================================================================
+// Top-Level Help
+// =============================================================================
+const showStatusHelp = () => {
+    console.log(`
+${bold("ambit status")} - Show Network, App, and Router Status
+
+${bold("USAGE")}
+  ambit status [options]
+  ambit status networks [options]
+  ambit status network <name> [options]
+  ambit status app <app>.<network> [options]
+
+${bold("SUBCOMMANDS")}
+  networks   Show summary of all networks — default when no subcommand given
+  network    Show detailed status for a specific network
+  app        Show a specific app's status
+
+${bold("OPTIONS")}
+  --org <org>        Fly.io organization slug
+  --json             Output as JSON
+
+${bold("EXAMPLES")}
+  ambit status
+  ambit status networks
+  ambit status network browsers
+  ambit status app my-app.browsers
+
+Run 'ambit status networks --help', 'ambit status network --help',
+or 'ambit status app --help' for details.
+`);
+};
+// =============================================================================
+// Dispatcher
+// =============================================================================
+const status = async (argv) => {
+    const subcommand = typeof argv[0] === "string" ? argv[0] : undefined;
+    if (subcommand === "networks")
+        return statusNetworks(argv.slice(1));
+    if (subcommand === "network")
+        return statusNetwork(argv.slice(1));
+    if (subcommand === "app")
+        return statusApp(argv.slice(1));
+    const args = parseArgs(argv, { boolean: ["help"] });
+    if (args.help) {
+        showStatusHelp();
+        return;
+    }
+    return statusNetworks(argv);
+};
+// =============================================================================
+// Register Command
+// =============================================================================
+registerCommand({
+    name: "status",
+    description: "Show network, app, and router status",
+    usage: "ambit status [networks|network|app] [<name>] [--org <org>] [--json]",
+    run: status,
+});

package/esm/cli/commands/status/network.d.ts

@@ -0,0 +1,2 @@
+export declare const statusNetwork: (argv: string[]) => Promise<void>;
+//# sourceMappingURL=network.d.ts.map

package/esm/cli/commands/status/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/status/network.ts"],"names":[],"mappings":"AAgHA,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAsChE,CAAC"}

package/esm/cli/commands/status/network.js

@@ -0,0 +1,104 @@
+// =============================================================================
+// Status Network — Show Detailed Status for a Single Network
+// =============================================================================
+import { parseArgs } from "../../../deps/jsr.io/@std/cli/1.0.28/mod.js";
+import { bold } from "../../../lib/cli.js";
+import { checkArgs } from "../../../lib/args.js";
+import { createOutput } from "../../../lib/output.js";
+import { findRouterApp, getRouterMachineInfo, getRouterTailscaleInfo, listWorkloadAppsOnNetwork, } from "../../../util/discovery.js";
+import { initSession } from "../../../util/session.js";
+import { SOCKS_PROXY_PORT } from "../../../util/constants.js";
+// =============================================================================
+// Detailed View
+// =============================================================================
+const stageNetworkStatus = async (fly, tailscale, network, org, json) => {
+    const out = createOutput(json);
+    const app = await findRouterApp(fly, org, network);
+    if (!app) {
+        return out.die(`No Router Found for Network '${network}'`);
+    }
+    const machine = await getRouterMachineInfo(fly, app.appName);
+    const ts = await getRouterTailscaleInfo(tailscale, app.appName);
+    const tag = ts?.tags?.[0] ?? null;
+    out.blank()
+        .header("Ambit Status: Network")
+        .blank()
+        .text(`  Network:       ${bold(app.network)}`)
+        .text(`  TLD:           *.${app.network}`)
+        .text(`  Tag:           ${tag ?? "unknown"}`)
+        .text(`  Status:        ${app.status}`)
+        .blank()
+        .text(`  Router App:    ${app.appName}`)
+        .text(`  Region:        ${machine?.region ?? "unknown"}`)
+        .text(`  Machine State: ${machine?.state ?? "no machines"}`)
+        .text(`  Private IP:    ${machine?.privateIp ?? "unknown"}`)
+        .text(`  SOCKS Proxy:   ${machine?.privateIp
+        ? `socks5://[${machine.privateIp}]:${SOCKS_PROXY_PORT}`
+        : "unknown"}`);
+    if (machine?.subnet) {
+        out.text(`  Subnet:        ${machine.subnet}`);
+    }
+    out.blank();
+    if (ts) {
+        out.text(`  Tailscale IP:  ${ts.ip}`)
+            .text(`  Online:        ${ts.online ? "yes" : "no"}`);
+    }
+    else {
+        out.text("  Tailscale:     Not Found in Tailnet");
+    }
+    // Show workload apps on this network
+    const workloads = await listWorkloadAppsOnNetwork(fly, org, network);
+    if (workloads.length > 0) {
+        out.blank().header("  Apps on Network").blank();
+        for (const w of workloads) {
+            const machines = await fly.machines.list(w.appName);
+            const state = machines[0]?.state ?? "no machines";
+            const region = machines[0]?.region ?? "-";
+            out.text(`    ${w.appName}  ${region}  ${state}`);
+        }
+    }
+    out.blank();
+    out.done({
+        network: app.network,
+        router: app,
+        machine,
+        tag,
+        tailscale: ts,
+    });
+    out.print();
+};
+// =============================================================================
+// Status Network Subcommand
+// =============================================================================
+export const statusNetwork = async (argv) => {
+    const opts = { string: ["org"], boolean: ["help", "json"] };
+    const args = parseArgs(argv, opts);
+    checkArgs(args, opts, "ambit status network");
+    if (args.help) {
+        console.log(`
+${bold("ambit status network")} - Show Detailed Status for a Network
+
+${bold("USAGE")}
+  ambit status network <name> [--org <org>] [--json]
+
+${bold("OPTIONS")}
+  --org <org>        Fly.io organization slug
+  --json             Output as JSON
+
+${bold("EXAMPLES")}
+  ambit status network browsers
+`);
+        return;
+    }
+    const out = createOutput(args.json);
+    const network = typeof args._[0] === "string" ? args._[0] : undefined;
+    if (!network) {
+        return out.die("Missing Network Name. Usage: ambit status network <name>");
+    }
+    const prereqOut = createOutput(args.json);
+    const { fly, tailscale, org } = await initSession(prereqOut, {
+        json: args.json,
+        org: args.org,
+    });
+    await stageNetworkStatus(fly, tailscale, network, org, args.json);
+};

package/esm/cli/commands/status/networks.d.ts

@@ -0,0 +1,2 @@
+export declare const statusNetworks: (argv: string[]) => Promise<void>;
+//# sourceMappingURL=networks.d.ts.map

package/esm/cli/commands/status/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/status/networks.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAwDjE,CAAC"}

package/esm/cli/commands/status/networks.js

@@ -0,0 +1,62 @@
+// =============================================================================
+// Status Networks — Summary Table of All Networks
+// =============================================================================
+import { parseArgs } from "../../../deps/jsr.io/@std/cli/1.0.28/mod.js";
+import { Table } from "../../../deps/jsr.io/@cliffy/table/1.0.0/mod.js";
+import { bold } from "../../../lib/cli.js";
+import { checkArgs } from "../../../lib/args.js";
+import { createOutput } from "../../../lib/output.js";
+import { discoverRouters } from "../../../util/discovery.js";
+import { initSession } from "../../../util/session.js";
+// =============================================================================
+// Status Networks Subcommand
+// =============================================================================
+export const statusNetworks = async (argv) => {
+    const opts = { string: ["org"], boolean: ["help", "json"] };
+    const args = parseArgs(argv, opts);
+    checkArgs(args, opts, "ambit status networks");
+    if (args.help) {
+        console.log(`
+${bold("ambit status networks")} - Show Status of All Networks
+
+${bold("USAGE")}
+  ambit status networks [--org <org>] [--json]
+
+${bold("OPTIONS")}
+  --org <org>        Fly.io organization slug
+  --json             Output as JSON
+`);
+        return;
+    }
+    const out = createOutput(args.json);
+    const { fly, tailscale, org } = await initSession(out, {
+        json: args.json,
+        org: args.org,
+    });
+    const routers = await discoverRouters(out, fly, tailscale, org);
+    if (routers.length === 0) {
+        out.blank()
+            .text("No Networks Found.")
+            .dim("  Create One with: ambit create <network>")
+            .blank();
+        out.done({ routers: [] });
+        out.print();
+        return;
+    }
+    out.blank().header("Network Status").blank();
+    const rows = routers.map((r) => {
+        const tsStatus = r.tailscale
+            ? (r.tailscale.online ? "online" : "offline")
+            : "not found";
+        return [r.network, r.appName, r.status, tsStatus];
+    });
+    const table = new Table()
+        .header(["Network", "App", "Status", "Tailscale"])
+        .body(rows)
+        .indent(2)
+        .padding(2);
+    out.text(table.toString());
+    out.blank();
+    out.done({ routers });
+    out.print();
+};

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "@cardelli/ambit",
-    "version": "0.3.0",
+    "version": "0.3.2",
     "description": "Deploy apps to the cloud that only you and your AI agents can reach",
     "license": "MIT",
     "tasks": {

package/esm/main.d.ts

@@ -3,8 +3,8 @@ import "./_dnt.polyfills.js";
 import "./cli/commands/create/index.js";
 import "./cli/commands/deploy/index.js";
 import "./cli/commands/share.js";
-import "./cli/commands/list.js";
-import "./cli/commands/status.js";
+import "./cli/commands/list/index.js";
+import "./cli/commands/status/index.js";
 import "./cli/commands/destroy/index.js";
 import "./cli/commands/doctor.js";
 //# sourceMappingURL=main.d.ts.map

package/esm/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,qBAAqB,CAAC;AA+B7B,OAAO,gCAAgC,CAAC;AACxC,OAAO,gCAAgC,CAAC;AACxC,OAAO,yBAAyB,CAAC;AACjC,OAAO,wBAAwB,CAAC;AAChC,OAAO,0BAA0B,CAAC;AAClC,OAAO,iCAAiC,CAAC;AACzC,OAAO,0BAA0B,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,qBAAqB,CAAC;AAkC7B,OAAO,gCAAgC,CAAC;AACxC,OAAO,gCAAgC,CAAC;AACxC,OAAO,yBAAyB,CAAC;AACjC,OAAO,8BAA8B,CAAC;AACtC,OAAO,gCAAgC,CAAC;AACxC,OAAO,iCAAiC,CAAC;AACzC,OAAO,0BAA0B,CAAC"}

package/esm/main.js

@@ -19,7 +19,10 @@ import * as dntShim from "./_dnt.shims.js";
 //
 // Examples:
 //   ambit create browsers
+//   ambit list networks
+//   ambit list apps browsers
 //   ambit status
+//   ambit status network browsers
 //   ambit destroy network browsers
 //   ambit destroy app my-app.browsers
 //   ambit doctor
@@ -30,8 +33,8 @@ import { Spinner, statusErr } from "./lib/cli.js";
 import "./cli/commands/create/index.js";
 import "./cli/commands/deploy/index.js";
 import "./cli/commands/share.js";
-import "./cli/commands/list.js";
-import "./cli/commands/status.js";
+import "./cli/commands/list/index.js";
+import "./cli/commands/status/index.js";
 import "./cli/commands/destroy/index.js";
 import "./cli/commands/doctor.js";
 // =============================================================================

package/esm/router/start.sh

@@ -5,7 +5,8 @@ set -e
 # ambit - Self-Configuring Tailscale Subnet Router
 # =============================================================================
 # State is persisted to /var/lib/tailscale via Fly volume.
-# On first run: authenticates with a pre-minted auth key, advertises routes.
+# On first run: waits for TAILSCALE_AUTHKEY (delivered by the CLI after
+# autoApprovers are in place), then authenticates and advertises routes.
 # On restart: reuses existing state, no new device created.
 # The router never receives the user's API token — only a single-use,
 # tag-scoped auth key that expires after 5 minutes.
@@ -41,10 +42,12 @@ if /usr/local/bin/tailscale status --json 2>/dev/null | jq -e '.BackendState ==
     --hostname="${FLY_APP_NAME:-ambit}" \
     --advertise-routes="${SUBNET}"
 else
-  # First run - authenticate with pre-minted auth key
+  # First run — auth key is delivered by the CLI via `fly secrets set` after
+  # autoApprovers are configured. If it's not here yet, wait for the restart
+  # that the non-staged secrets set triggers.
   if [ -z "${TAILSCALE_AUTHKEY}" ]; then
-    echo "Router: ERROR - No TAILSCALE_AUTHKEY Provided"
-    exit 1
+    echo "Router: Waiting for Auth Key (CLI will deliver via secrets)"
+    while true; do sleep 5; done
   fi
 
   echo "Router: Authenticating to Tailscale"

package/esm/schemas/fly.d.ts

@@ -3,6 +3,40 @@ export declare const FlyAuthSchema: z.ZodObject<{
     email: z.ZodString;
 }, z.core.$loose>;
 export type FlyAuth = z.infer<typeof FlyAuthSchema>;
+/** App-level status from the Fly GraphQL API / REST API (AppState enum). */
+export declare const FlyAppStatusEnum: z.ZodEnum<{
+    deployed: "deployed";
+    pending: "pending";
+    suspended: "suspended";
+}>;
+export type FlyAppStatus = z.infer<typeof FlyAppStatusEnum>;
+/**
+ * Machine-level state from the Fly Machines API.
+ * Persistent: created, started, stopped, suspended, failed
+ * Transient: creating, starting, stopping, restarting, suspending, destroying,
+ *            updating, replacing, launch_failed
+ * Terminal: destroyed, replaced, migrated
+ */
+export declare const FlyMachineStateEnum: z.ZodEnum<{
+    suspended: "suspended";
+    created: "created";
+    started: "started";
+    stopped: "stopped";
+    failed: "failed";
+    creating: "creating";
+    starting: "starting";
+    stopping: "stopping";
+    restarting: "restarting";
+    suspending: "suspending";
+    destroying: "destroying";
+    updating: "updating";
+    replacing: "replacing";
+    launch_failed: "launch_failed";
+    destroyed: "destroyed";
+    replaced: "replaced";
+    migrated: "migrated";
+}>;
+export type FlyMachineState = z.infer<typeof FlyMachineStateEnum>;
 export declare const FlyAppSchema: z.ZodObject<{
     Name: z.ZodString;
     Status: z.ZodString;
@@ -50,7 +84,25 @@ export declare const FlyMachineConfigSchema: z.ZodObject<{
 export declare const FlyMachineSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
-    state: z.ZodString;
+    state: z.ZodCatch<z.ZodEnum<{
+        suspended: "suspended";
+        created: "created";
+        started: "started";
+        stopped: "stopped";
+        failed: "failed";
+        creating: "creating";
+        starting: "starting";
+        stopping: "stopping";
+        restarting: "restarting";
+        suspending: "suspending";
+        destroying: "destroying";
+        updating: "updating";
+        replacing: "replacing";
+        launch_failed: "launch_failed";
+        destroyed: "destroyed";
+        replaced: "replaced";
+        migrated: "migrated";
+    }>>;
     region: z.ZodString;
     private_ip: z.ZodOptional<z.ZodString>;
     config: z.ZodOptional<z.ZodObject<{
@@ -77,7 +129,25 @@ export type FlyMachine = z.infer<typeof FlyMachineSchema>;
 export declare const FlyMachinesListSchema: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
-    state: z.ZodString;
+    state: z.ZodCatch<z.ZodEnum<{
+        suspended: "suspended";
+        created: "created";
+        started: "started";
+        stopped: "stopped";
+        failed: "failed";
+        creating: "creating";
+        starting: "starting";
+        stopping: "stopping";
+        restarting: "restarting";
+        suspending: "suspending";
+        destroying: "destroying";
+        updating: "updating";
+        replacing: "replacing";
+        launch_failed: "launch_failed";
+        destroyed: "destroyed";
+        replaced: "replaced";
+        migrated: "migrated";
+    }>>;
     region: z.ZodString;
     private_ip: z.ZodOptional<z.ZodString>;
     config: z.ZodOptional<z.ZodObject<{
@@ -142,7 +212,12 @@ export declare const FlyIpListSchema: z.ZodArray<z.ZodObject<{
 export declare const FlyAppInfoSchema: z.ZodObject<{
     name: z.ZodString;
     network: z.ZodString;
-    status: z.ZodString;
+    status: z.ZodCatch<z.ZodEnum<{
+        deployed: "deployed";
+        pending: "pending";
+        suspended: "suspended";
+    }>>;
+    machine_count: z.ZodOptional<z.ZodNumber>;
     organization: z.ZodOptional<z.ZodObject<{
         slug: z.ZodString;
     }, z.core.$strip>>;
@@ -153,7 +228,12 @@ export declare const FlyAppInfoListSchema: z.ZodObject<{
     apps: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         network: z.ZodString;
-        status: z.ZodString;
+        status: z.ZodCatch<z.ZodEnum<{
+            deployed: "deployed";
+            pending: "pending";
+            suspended: "suspended";
+        }>>;
+        machine_count: z.ZodOptional<z.ZodNumber>;
         organization: z.ZodOptional<z.ZodObject<{
             slug: z.ZodString;
         }, z.core.$strip>>;

package/esm/schemas/fly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fly.d.ts","sourceRoot":"","sources":["../../src/schemas/fly.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,4CAA4C,CAAC;AAM/D,eAAO,MAAM,aAAa;;iBAEhB,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAMpD,eAAO,MAAM,YAAY;;;;;;iBAMf,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,iBAAiB;;;;;;kBAAwB,CAAC;AAMvD,eAAO,MAAM,eAAe;;;;;iBAKlB,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,eAAO,MAAM,qBAAqB;;;;iBAIxB,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;iBAgBzB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;iBASnB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;kBAA4B,CAAC;AAM/D,eAAO,MAAM,aAAa,uCAAmC,CAAC;AAM9D,eAAO,MAAM,eAAe;;;iBAGlB,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAMpD,eAAO,MAAM,kBAAkB;;;;;iBAGrB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;;;iBAOd,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,eAAe;;;;;;;;;;;;kBAAuB,CAAC;AAMpD,eAAO,MAAM,gBAAgB;;;;;;;iBAKnB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAGvB,CAAC"}
+{"version":3,"file":"fly.d.ts","sourceRoot":"","sources":["../../src/schemas/fly.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,4CAA4C,CAAC;AAM/D,eAAO,MAAM,aAAa;;iBAEhB,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAMpD,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB;;;;EAA+C,CAAC;AAC7E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAkB9B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMlE,eAAO,MAAM,YAAY;;;;;;iBAMf,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,iBAAiB;;;;;;kBAAwB,CAAC;AAMvD,eAAO,MAAM,eAAe;;;;;iBAKlB,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,eAAO,MAAM,qBAAqB;;;;iBAIxB,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;iBAgBzB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASnB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA4B,CAAC;AAM/D,eAAO,MAAM,aAAa,uCAAmC,CAAC;AAM9D,eAAO,MAAM,eAAe;;;iBAGlB,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAMpD,eAAO,MAAM,kBAAkB;;;;;iBAGrB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;;;iBAOd,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,eAAe;;;;;;;;;;;;kBAAuB,CAAC;AAMpD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;iBAMnB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;iBAGvB,CAAC"}

package/esm/schemas/fly.js

@@ -9,6 +9,37 @@ export const FlyAuthSchema = z.object({
     email: z.string(),
 }).loose();
 // =============================================================================
+// State Enums
+// =============================================================================
+/** App-level status from the Fly GraphQL API / REST API (AppState enum). */
+export const FlyAppStatusEnum = z.enum(["deployed", "pending", "suspended"]);
+/**
+ * Machine-level state from the Fly Machines API.
+ * Persistent: created, started, stopped, suspended, failed
+ * Transient: creating, starting, stopping, restarting, suspending, destroying,
+ *            updating, replacing, launch_failed
+ * Terminal: destroyed, replaced, migrated
+ */
+export const FlyMachineStateEnum = z.enum([
+    "created",
+    "started",
+    "stopped",
+    "suspended",
+    "failed",
+    "creating",
+    "starting",
+    "stopping",
+    "restarting",
+    "suspending",
+    "destroying",
+    "updating",
+    "replacing",
+    "launch_failed",
+    "destroyed",
+    "replaced",
+    "migrated",
+]);
+// =============================================================================
 // App Schemas
 // =============================================================================
 export const FlyAppSchema = z.object({
@@ -52,7 +83,7 @@ export const FlyMachineConfigSchema = z.object({
 export const FlyMachineSchema = z.object({
     id: z.string(),
     name: z.string(),
-    state: z.string(),
+    state: FlyMachineStateEnum.catch("created"),
     region: z.string(),
     private_ip: z.string().optional(),
     config: FlyMachineConfigSchema.optional(),
@@ -93,7 +124,8 @@ export const FlyIpListSchema = z.array(FlyIpSchema);
 export const FlyAppInfoSchema = z.object({
     name: z.string(),
     network: z.string(),
-    status: z.string(),
+    status: FlyAppStatusEnum.catch("pending"),
+    machine_count: z.number().optional(),
     organization: z.object({ slug: z.string() }).optional(),
 }).loose();
 export const FlyAppInfoListSchema = z.object({