@cardelli/ambit 0.1.0

package/esm/src/cli/commands/doctor.d.ts

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

package/esm/src/cli/commands/doctor.d.ts.map

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

package/esm/src/cli/commands/doctor.js

@@ -0,0 +1,141 @@
+// =============================================================================
+// Doctor Command - Verify Environment and Infrastructure Health
+// =============================================================================
+import { parseArgs } from "../../../deps/jsr.io/@std/cli/1.0.27/mod.js";
+import { bold } from "../../../lib/cli.js";
+import { createOutput } from "../../../lib/output.js";
+import { runCommand } from "../../../lib/command.js";
+import { registerCommand } from "../mod.js";
+import { createFlyProvider } from "../../providers/fly.js";
+import { isAcceptRoutesEnabled, isTailscaleInstalled, } from "../../providers/tailscale.js";
+import { requireTailscaleProvider } from "../../credentials.js";
+import { findRouterApp, getRouterMachineInfo, getRouterTailscaleInfo, listRouterApps, } from "../../discovery.js";
+import { resolveOrg } from "../../resolve.js";
+// =============================================================================
+// Doctor Command
+// =============================================================================
+const doctor = async (argv) => {
+    const args = parseArgs(argv, {
+        string: ["network", "org"],
+        boolean: ["help", "json"],
+    });
+    if (args.help) {
+        console.log(`
+${bold("ambit doctor")} - Verify Environment and Infrastructure Health
+
+${bold("USAGE")}
+  ambit doctor [--network <name>] [--org <org>] [--json]
+
+${bold("OPTIONS")}
+  --network <name>   Check a specific router (otherwise checks all)
+  --org <org>        Fly.io organization slug
+  --json             Output as JSON
+
+${bold("CHECKS")}
+  - Tailscale CLI installed and connected
+  - Accept-routes enabled
+  - Router(s) created and running
+  - Router(s) visible in tailnet
+`);
+        return;
+    }
+    const out = createOutput(args.json);
+    out.blank().header("ambit Doctor").blank();
+    const results = [];
+    const report = (name, ok, hint) => {
+        results.push({ name, ok, hint });
+        if (ok) {
+            out.ok(name);
+        }
+        else {
+            out.err(name);
+            if (hint)
+                out.dim(`    ${hint}`);
+        }
+    };
+    // =========================================================================
+    // Prerequisites (fail fast)
+    // =========================================================================
+    const fly = createFlyProvider();
+    await fly.ensureInstalled();
+    await fly.ensureAuth({ interactive: !args.json });
+    const tailscale = await requireTailscaleProvider(out);
+    const org = await resolveOrg(fly, args, out);
+    // =========================================================================
+    // Local checks
+    // =========================================================================
+    report("Tailscale Installed", await isTailscaleInstalled(), "Install from https://tailscale.com/download");
+    const tsStatus = await runCommand(["tailscale", "status", "--json"]);
+    let tsConnected = false;
+    if (tsStatus.success) {
+        try {
+            const parsed = JSON.parse(tsStatus.stdout);
+            tsConnected = parsed.BackendState === "Running";
+        }
+        catch { /* ignore */ }
+    }
+    report("Tailscale Connected", tsConnected, "Run: tailscale up");
+    report("Accept Routes Enabled", await isAcceptRoutesEnabled(), "Run: sudo tailscale set --accept-routes");
+    // =========================================================================
+    // Router checks
+    // =========================================================================
+    if (args.network) {
+        const app = await findRouterApp(fly, org, args.network);
+        report(`Router Exists (${args.network})`, app !== null, `Create with: ambit create ${args.network}`);
+        const machine = app ? await getRouterMachineInfo(fly, app.appName) : null;
+        report(`Router Running (${args.network})`, machine?.state === "started", machine ? `Machine state: ${machine.state}` : "No machine found");
+        const ts = app
+            ? await getRouterTailscaleInfo(tailscale, app.appName)
+            : null;
+        report(`Router in Tailnet (${args.network})`, ts !== null, "Router may still be starting, or check router logs");
+    }
+    else {
+        const routerApps = await listRouterApps(fly, org);
+        if (routerApps.length === 0) {
+            report("Routers Discovered", false, "Run: ambit create <network>");
+        }
+        else {
+            let runningCount = 0;
+            let inTailnetCount = 0;
+            for (const app of routerApps) {
+                const machine = await getRouterMachineInfo(fly, app.appName);
+                if (machine?.state === "started")
+                    runningCount++;
+                const ts = await getRouterTailscaleInfo(tailscale, app.appName);
+                if (ts)
+                    inTailnetCount++;
+            }
+            report("Routers Discovered", runningCount > 0, `${routerApps.length} Router(s): ${runningCount} Running, ${inTailnetCount} In Tailnet`);
+        }
+    }
+    // =========================================================================
+    // Summary
+    // =========================================================================
+    const issues = results.filter((r) => !r.ok).length;
+    if (issues === 0) {
+        out.done({ checks: results });
+    }
+    else {
+        out.fail(`${issues} Issue${issues > 1 ? "s" : ""} Found`, {
+            checks: results,
+        });
+    }
+    out.blank();
+    if (issues === 0) {
+        out.text("All Checks Passed.");
+    }
+    else {
+        out.text(`${issues} Issue${issues > 1 ? "s" : ""} Found.`);
+    }
+    out.blank();
+    out.print();
+};
+// =============================================================================
+// Register Command
+// =============================================================================
+registerCommand({
+    name: "doctor",
+    description: "Check that Tailscale and the router are working correctly",
+    usage: "ambit doctor [--network <name>] [--org <org>] [--json]",
+    run: doctor,
+});

package/esm/src/cli/commands/list.d.ts

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

package/esm/src/cli/commands/list.d.ts.map

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

package/esm/src/cli/commands/list.js

@@ -0,0 +1,94 @@
+// =============================================================================
+// List Command - List All Discovered Routers
+// =============================================================================
+import { parseArgs } from "../../../deps/jsr.io/@std/cli/1.0.27/mod.js";
+import { Table } from "../../../deps/jsr.io/@cliffy/table/1.0.0/mod.js";
+import { bold } from "../../../lib/cli.js";
+import { createOutput } from "../../../lib/output.js";
+import { registerCommand } from "../mod.js";
+import { createFlyProvider } from "../../providers/fly.js";
+import { requireTailscaleProvider } from "../../credentials.js";
+import { getRouterMachineInfo, getRouterTailscaleInfo, listRouterApps, } from "../../discovery.js";
+import { resolveOrg } from "../../resolve.js";
+// =============================================================================
+// List Command
+// =============================================================================
+const list = async (argv) => {
+    const args = parseArgs(argv, {
+        string: ["org"],
+        boolean: ["help", "json"],
+    });
+    if (args.help) {
+        console.log(`
+${bold("ambit list")} - List All Discovered Routers
+
+${bold("USAGE")}
+  ambit list [--org <org>] [--json]
+
+${bold("OPTIONS")}
+  --org <org>   Fly.io organization slug
+  --json        Output as JSON
+`);
+        return;
+    }
+    const out = createOutput(args.json);
+    const fly = createFlyProvider();
+    await fly.ensureInstalled();
+    await fly.ensureAuth({ interactive: !args.json });
+    const tailscale = await requireTailscaleProvider(out);
+    const org = await resolveOrg(fly, args, out);
+    // 1. Find all router apps
+    const spinner = out.spinner("Discovering Routers");
+    const routerApps = await listRouterApps(fly, org);
+    spinner.success(`Found ${routerApps.length} Router${routerApps.length !== 1 ? "s" : ""}`);
+    if (routerApps.length === 0) {
+        out.blank()
+            .text("No Routers Found.")
+            .dim("  Create one with: ambit create <network>")
+            .blank();
+        out.done({ routers: [] });
+        out.print();
+        return;
+    }
+    // 2. Get machine + tailscale state for each
+    const routers = [];
+    for (const app of routerApps) {
+        const machine = await getRouterMachineInfo(fly, app.appName);
+        const ts = await getRouterTailscaleInfo(tailscale, app.appName);
+        routers.push({ ...app, machine, tailscale: ts });
+    }
+    // 3. Render
+    out.blank().header("Routers").blank();
+    const rows = routers.map((r) => {
+        const tsStatus = r.tailscale
+            ? r.tailscale.online ? "online" : "offline"
+            : "not found";
+        const tag = r.tailscale?.tags?.[0] ?? "unknown";
+        return [
+            r.network,
+            r.appName,
+            r.machine?.region ?? "-",
+            r.machine?.state ?? "unknown",
+            tsStatus,
+            tag,
+        ];
+    });
+    const table = new Table()
+        .header(["Network", "App", "Region", "State", "Tailscale", "Tag"])
+        .body(rows)
+        .indent(2)
+        .padding(2);
+    out.text(table.toString());
+    out.blank();
+    out.done({ routers });
+    out.print();
+};
+// =============================================================================
+// Register Command
+// =============================================================================
+registerCommand({
+    name: "list",
+    description: "List all discovered routers across networks",
+    usage: "ambit list [--org <org>] [--json]",
+    run: list,
+});

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

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

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

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

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

@@ -0,0 +1,148 @@
+// =============================================================================
+// Status Command - Show Router Status
+// =============================================================================
+import { parseArgs } from "../../../deps/jsr.io/@std/cli/1.0.27/mod.js";
+import { Table } from "../../../deps/jsr.io/@cliffy/table/1.0.0/mod.js";
+import { bold } from "../../../lib/cli.js";
+import { createOutput } from "../../../lib/output.js";
+import { registerCommand } from "../mod.js";
+import { createFlyProvider } from "../../providers/fly.js";
+import { requireTailscaleProvider } from "../../credentials.js";
+import { findRouterApp, getRouterMachineInfo, getRouterTailscaleInfo, listRouterApps, } from "../../discovery.js";
+import { resolveOrg } from "../../resolve.js";
+// =============================================================================
+// Status Command
+// =============================================================================
+const status = async (argv) => {
+    const args = parseArgs(argv, {
+        string: ["network", "org"],
+        boolean: ["help", "json"],
+    });
+    if (args.help) {
+        console.log(`
+${bold("ambit status")} - Show Router Status
+
+${bold("USAGE")}
+  ambit status [--network <name>] [--org <org>] [--json]
+
+${bold("OPTIONS")}
+  --network <name>   Show detailed status for a specific network
+  --org <org>        Fly.io organization slug
+  --json             Output as JSON
+
+${bold("EXAMPLES")}
+  ambit status                     Show summary of all routers
+  ambit status --network browsers  Show detailed status for one router
+`);
+        return;
+    }
+    const fly = createFlyProvider();
+    await fly.ensureInstalled();
+    await fly.ensureAuth({ interactive: !args.json });
+    if (args.network) {
+        // ========================================================================
+        // Single Router Detailed View
+        // ========================================================================
+        const out = createOutput(args.json);
+        const tailscale = await requireTailscaleProvider(out);
+        const org = await resolveOrg(fly, args, out);
+        // 1. Find the router
+        const app = await findRouterApp(fly, org, args.network);
+        if (!app) {
+            return out.die(`No Router Found for Network '${args.network}'`);
+        }
+        // 2. Get machine state
+        const machine = await getRouterMachineInfo(fly, app.appName);
+        // 3. Get tailscale state
+        const ts = await getRouterTailscaleInfo(tailscale, app.appName);
+        const tag = ts?.tags?.[0] ?? null;
+        out.blank()
+            .header("ambit Status")
+            .blank()
+            .text(`  Network:       ${bold(app.network)}`)
+            .text(`  TLD:           *.${app.network}`)
+            .text(`  Tag:           ${tag ?? "unknown"}`)
+            .blank()
+            .text(`  Router App:    ${app.appName}`)
+            .text(`  Region:        ${machine?.region ?? "unknown"}`)
+            .text(`  Machine State: ${machine?.state ?? "unknown"}`)
+            .text(`  Private IP:    ${machine?.privateIp ?? "unknown"}`)
+            .text(`  SOCKS Proxy:   ${machine?.privateIp
+            ? `socks5://[${machine.privateIp}]:1080`
+            : "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");
+        }
+        out.blank();
+        out.done({
+            network: app.network,
+            router: app,
+            machine,
+            tag,
+            tailscale: ts,
+        });
+        out.print();
+    }
+    else {
+        // ========================================================================
+        // Summary Table of All Routers
+        // ========================================================================
+        const out = createOutput(args.json);
+        const tailscale = await requireTailscaleProvider(out);
+        const org = await resolveOrg(fly, args, out);
+        // 1. Find all router apps
+        const spinner = out.spinner("Discovering Routers");
+        const routerApps = await listRouterApps(fly, org);
+        spinner.success(`Found ${routerApps.length} Router${routerApps.length !== 1 ? "s" : ""}`);
+        if (routerApps.length === 0) {
+            out.blank()
+                .text("No Routers Found.")
+                .dim("  Create one with: ambit create <network>")
+                .blank();
+            out.done({ routers: [] });
+            out.print();
+            return;
+        }
+        // 2. Get machine + tailscale state for each
+        const routers = [];
+        for (const app of routerApps) {
+            const machine = await getRouterMachineInfo(fly, app.appName);
+            const ts = await getRouterTailscaleInfo(tailscale, app.appName);
+            routers.push({ ...app, machine, tailscale: ts });
+        }
+        // 3. Render
+        out.blank().header("Router Status").blank();
+        const rows = routers.map((r) => {
+            const tsStatus = r.tailscale
+                ? r.tailscale.online ? "online" : "offline"
+                : "not found";
+            return [r.network, r.appName, r.machine?.state ?? "unknown", tsStatus];
+        });
+        const table = new Table()
+            .header(["Network", "App", "State", "Tailscale"])
+            .body(rows)
+            .indent(2)
+            .padding(2);
+        out.text(table.toString());
+        out.blank();
+        out.done({ routers });
+        out.print();
+    }
+};
+// =============================================================================
+// Register Command
+// =============================================================================
+registerCommand({
+    name: "status",
+    description: "Show router status, network, and tailnet info",
+    usage: "ambit status [--network <name>] [--org <org>] [--json]",
+    run: status,
+});

package/esm/src/cli/mod.d.ts

@@ -0,0 +1,13 @@
+export interface Command {
+    name: string;
+    description: string;
+    usage: string;
+    run: (args: string[]) => Promise<void>;
+}
+export declare const registerCommand: (command: Command) => void;
+export declare const getCommand: (name: string) => Command | undefined;
+export declare const getAllCommands: () => Command[];
+export declare const showHelp: () => void;
+export declare const showVersion: () => void;
+export declare const runCli: (argv: string[]) => Promise<void>;
+//# sourceMappingURL=mod.d.ts.map

package/esm/src/cli/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/cli/mod.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAQD,eAAO,MAAM,eAAe,GAAI,SAAS,OAAO,KAAG,IAElD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,OAAO,GAAG,SAEnD,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,OAAO,EAExC,CAAC;AAQF,eAAO,MAAM,QAAQ,QAAO,IA4B3B,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,IAE9B,CAAC;AAMF,eAAO,MAAM,MAAM,GAAU,MAAM,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAuCzD,CAAC"}

package/esm/src/cli/mod.js

@@ -0,0 +1,93 @@
+// =============================================================================
+// CLI Framework - Command Parser and Router
+// =============================================================================
+import * as dntShim from "../../_dnt.shims.js";
+import { parseArgs } from "../../deps/jsr.io/@std/cli/1.0.27/mod.js";
+import { bold, dim } from "../../lib/cli.js";
+// =============================================================================
+// Commands Registry
+// =============================================================================
+const commands = new Map();
+export const registerCommand = (command) => {
+    commands.set(command.name, command);
+};
+export const getCommand = (name) => {
+    return commands.get(name);
+};
+export const getAllCommands = () => {
+    return Array.from(commands.values());
+};
+// =============================================================================
+// Help Text
+// =============================================================================
+const VERSION = "0.3.0";
+export const showHelp = () => {
+    console.log(`
+${bold("ambit")} - Tailscale Subnet Router for Fly.io Custom Networks
+
+${bold("USAGE")}
+  ambit <command> [options]
+
+${bold("COMMANDS")}
+  create     Create a Tailscale subnet router on a Fly.io custom network
+  deploy     Deploy an app safely on a custom private network
+  list       List all discovered routers across networks
+  status     Show router status, network, and tailnet info
+  destroy    Tear down the router, clean up DNS and tailnet device
+  doctor     Check that Tailscale and the router are working correctly
+
+${bold("OPTIONS")}
+  --help     Show help for a command
+  --version  Show version
+
+${bold("EXAMPLES")}
+  ambit create browsers
+  ambit list
+  ambit status --network browsers
+  ambit destroy --network browsers
+  ambit doctor
+
+${dim("Run 'ambit <command> --help' for command-specific help.")}
+`);
+};
+export const showVersion = () => {
+    console.log(`ambit ${VERSION}`);
+};
+// =============================================================================
+// Main CLI Runner
+// =============================================================================
+export const runCli = async (argv) => {
+    const args = parseArgs(argv, {
+        boolean: ["help", "version"],
+        stopEarly: true,
+    });
+    if (args.version) {
+        showVersion();
+        return;
+    }
+    const commandName = args._[0];
+    if (!commandName || args.help) {
+        if (commandName) {
+            const command = getCommand(commandName);
+            if (command) {
+                console.log(`
+${bold(command.name)} - ${command.description}
+
+${bold("USAGE")}
+  ${command.usage}
+`);
+                return;
+            }
+        }
+        showHelp();
+        return;
+    }
+    const command = getCommand(commandName);
+    if (!command) {
+        console.log(`Unknown command: ${commandName}`);
+        console.log(`Run 'ambit --help' for usage.`);
+        dntShim.Deno.exit(1);
+    }
+    const commandArgs = argv.slice(1);
+    await command.run(commandArgs);
+};

package/esm/src/credentials.d.ts

@@ -0,0 +1,13 @@
+import "../_dnt.polyfills.js";
+import { type TailscaleProvider } from "./providers/tailscale.js";
+export interface CredentialStore {
+    getTailscaleApiKey(): Promise<string | null>;
+    setTailscaleApiKey(key: string): Promise<void>;
+}
+export declare const createConfigCredentialStore: () => CredentialStore;
+export declare const getCredentialStore: () => CredentialStore;
+/** Get a TailscaleProvider or die via out.die(). Respects JSON mode. */
+export declare const requireTailscaleProvider: (out: {
+    die(msg: string): never;
+}) => Promise<TailscaleProvider>;
+//# sourceMappingURL=credentials.d.ts.map

package/esm/src/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/src/credentials.ts"],"names":[],"mappings":"AAGA,OAAO,sBAAsB,CAAC;AAQ9B,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAclC,MAAM,WAAW,eAAe;IAC9B,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAQD,eAAO,MAAM,2BAA2B,QAAO,eA0B9C,CAAC;AAMF,eAAO,MAAM,kBAAkB,QAAO,eAgBrC,CAAC;AAMF,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,GACnC,KAAK;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,KAC/B,OAAO,CAAC,iBAAiB,CAS3B,CAAC"}

package/esm/src/credentials.js

@@ -0,0 +1,72 @@
+// =============================================================================
+// Credential Store - Persistent Tailscale API Key Storage
+// =============================================================================
+import "../_dnt.polyfills.js";
+import * as dntShim from "../_dnt.shims.js";
+import { z } from "../deps/jsr.io/@zod/zod/4.3.6/src/index.js";
+import { ensureConfigDir, fileExists } from "../lib/cli.js";
+import { getConfigDir } from "./schemas/config.js";
+import { createTailscaleProvider, } from "./providers/tailscale.js";
+// =============================================================================
+// Schema
+// =============================================================================
+const CredentialsSchema = z.object({
+    apiKey: z.string(),
+});
+// =============================================================================
+// Config File Implementation
+// =============================================================================
+const getCredentialsPath = () => `${getConfigDir()}/credentials.json`;
+export const createConfigCredentialStore = () => {
+    return {
+        async getTailscaleApiKey() {
+            const path = getCredentialsPath();
+            if (!(await fileExists(path))) {
+                return null;
+            }
+            try {
+                const content = await dntShim.Deno.readTextFile(path);
+                const result = CredentialsSchema.safeParse(JSON.parse(content));
+                return result.success ? result.data.apiKey : null;
+            }
+            catch {
+                return null;
+            }
+        },
+        async setTailscaleApiKey(key) {
+            await ensureConfigDir();
+            const path = getCredentialsPath();
+            await dntShim.Deno.writeTextFile(path, JSON.stringify({ apiKey: key }, null, 2) + "\n");
+        },
+    };
+};
+// =============================================================================
+// Default Credential Store (env var → file)
+// =============================================================================
+export const getCredentialStore = () => {
+    const fileStore = createConfigCredentialStore();
+    return {
+        async getTailscaleApiKey() {
+            // Environment variable takes priority
+            const envKey = dntShim.Deno.env.get("TAILSCALE_API_KEY");
+            if (envKey)
+                return envKey;
+            return await fileStore.getTailscaleApiKey();
+        },
+        async setTailscaleApiKey(key) {
+            await fileStore.setTailscaleApiKey(key);
+        },
+    };
+};
+// =============================================================================
+// Require Tailscale Provider (fail-fast)
+// =============================================================================
+/** Get a TailscaleProvider or die via out.die(). Respects JSON mode. */
+export const requireTailscaleProvider = async (out) => {
+    const store = getCredentialStore();
+    const key = await store.getTailscaleApiKey();
+    if (!key) {
+        return out.die("Tailscale API Key Required. Run 'ambit create' or set TAILSCALE_API_KEY");
+    }
+    return createTailscaleProvider("-", key);
+};

package/esm/src/discovery.d.ts

@@ -0,0 +1,32 @@
+import "../_dnt.polyfills.js";
+import type { FlyProvider } from "./providers/fly.js";
+import type { TailscaleProvider } from "./providers/tailscale.js";
+/** A router app discovered from the Fly REST API. */
+export interface RouterApp {
+    appName: string;
+    network: string;
+    org: string;
+}
+/** Machine state for a router, from the Fly Machines API. */
+export interface RouterMachineInfo {
+    region: string;
+    state: string;
+    privateIp?: string;
+    subnet?: string;
+}
+/** Tailscale device state for a router. */
+export interface RouterTailscaleInfo {
+    ip: string;
+    online: boolean;
+    hostname: string;
+    tags?: string[];
+}
+/** List all ambit apps on custom networks in an org. */
+export declare const listRouterApps: (fly: FlyProvider, org: string) => Promise<RouterApp[]>;
+/** Find the router app for a specific network. */
+export declare const findRouterApp: (fly: FlyProvider, org: string, network: string) => Promise<RouterApp | null>;
+/** Get machine info for a router app. Returns null if no machines exist. */
+export declare const getRouterMachineInfo: (fly: FlyProvider, appName: string) => Promise<RouterMachineInfo | null>;
+/** Get tailscale device info for a router. Returns null if not found. */
+export declare const getRouterTailscaleInfo: (tailscale: TailscaleProvider, appName: string) => Promise<RouterTailscaleInfo | null>;
+//# sourceMappingURL=discovery.d.ts.map

package/esm/src/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/src/discovery.ts"],"names":[],"mappings":"AAcA,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAOlE,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAaD,wDAAwD;AACxD,eAAO,MAAM,cAAc,GACzB,KAAK,WAAW,EAChB,KAAK,MAAM,KACV,OAAO,CAAC,SAAS,EAAE,CAcrB,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,aAAa,GACxB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,SAAS,MAAM,KACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAG1B,CAAC;AAMF,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,GAC/B,KAAK,WAAW,EAChB,SAAS,MAAM,KACd,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAclC,CAAC;AAMF,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,GACjC,WAAW,iBAAiB,EAC5B,SAAS,MAAM,KACd,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAcpC,CAAC"}